| [title] Duet 2 Wifi only - Connect Duet to Network |
| [* blue] '''This step is for Duet 2 WiFi only!''' Use the command [[Gcode#Section_M587_Add_WiFi_host_network_to_remembered_list_or_list_remembered_networks|M587]] as shown below. Substitute the SSID and WiFi password for those of your network. Enter the '''exact''' characters of your network SSID and password, in the correct case. The simple double quote characters (not curly quotes) are needed. Once you press enter, wait for the 'ok' response. |
| [* blue] ``M587 S"your-network-ssid" P"your-network-password"`` |
| [* icon_caution] '''Note:''' Any double quotation marks must be sent as straight double quotation marks. Curly double quotations will not work, and generate an error. Also, if you are '''not''' using our recommended software to communicate with the Duet and have upper and lower case letters or apostrophe characters in the SSID or password, see the note in the [[Gcode#Section_M587_Add_WiFi_host_network_to_remembered_list_or_list_remembered_networks|Gcode dictionary entry for M587]]. |
| [* icon_caution] '''Note:''' Make sure to connect to a 2.4GHz network; the Duet 2 WiFi module will not connect to 5.0GHz networks. |
| [* red] Send command '''M552 S1''' to connect to WiFi. After a moment, the Duet will confirm the connection and the IP address of the Duet controller. The blue LED on the WiFi module will flash as it connects, then should be on constantly once connected. |
| [* icon_note] If you get an error, check the network SSID and password you entered with the M587 command. Make sure that the WiFi is in idle mode before sending M587, with M552 S0. Send '''M587''' to get a list of remembered networks, though this does not show the password.
|
| [* icon_note] '''Note:''' M587 saves the SSID and password to the Duet 2 Wifi, and is persistent. You do not need to run this command every time the board is started. M552 S1 starts the network, and this command '''does''' need to be run every time the board starts (so ensure it is in config.g so it runs automatically - editing config.g will be covered later)
|