Site Navigation

Your Account

Choose Language

  1. Your Duet comes with the following items:
    • Your Duet comes with the following items:

    • Duet Controller

    • Connector kit

      • Wurth Elektronic WR-WTB series connectors (Molex-KK compatible)

      • Ferrules for power input, bed heater, and hotend heaters.

      • Plastic washers for isolation when mounting.

    • 100 pins for connectors

    • 3 ft. USB Cable

  2. If you are using a Windows computer, download the USB drivers for Duet here and extract the files to a suitable location.
    • If you are using a Windows computer, download the USB drivers for Duet here and extract the files to a suitable location.

    • Connect the Duet to your PC with the USB cable provided. Do not connect other power supplies at this stage.

      • To install drivers, open Device Manager by pressing Windows Key + R and type devmgmt.msc, or launch from the Start menu by typing "Device Manager".

      • Look for any devices with a yellow triangle which would indicate that the driver is not installed. If no devices have this indicator, then the driver was successfully installed.

      • If a USB device does show the yellow triangle, right click on the device. Click Install Driver and browse to the location of the driver that was downloaded at the beginning of this step. Continue setup by clicking "Next" until the device driver has been installed.

    • Mac OSX users can just connect the Duet board to their Mac with the provided USB and proceed to the next step.

    • Note there have been several hardware revisions of the Duet 2 controller. this guide applies to all Duet 2 Wifi and Ethernet, the picture of the board may be very slightly different to yours.

    Maybe having images of the Windows driver install process would be helpful?

    We need Mac and Linux equivalents at some point

    Tony - Reply

    This is planned, the computer I am using wants to recognize the board and won’t give me the option to uninstall the driver. Might have to set up a virtual machine with an older version of windows for this purpose.

    Filastruder - Reply

    The Guide needs to mention other methods of establishing Wifi networking at all (PanelDue, Pronterface with apostrophes, Setnetwork macro) .

    YAT is Windoes only - Linux and Max equivalents need to be mentioned

    Tony - Reply

    Might also be worth mentioning that you do not need to connect any sort of power to the board before hand. I could see some people being confused about this and since we don’t talk about the correct way to power the board until the next guide it might be good to call that out here.

    MSquared - Reply

    Thanks, I have added that.

    Tony -

    To open the device manager Type in devmgmt.msc, not devmgmnt

    ma do - Reply

    Thanks, I have fixed this

    Tony -

    Anybody having trouble installing the driver? I’m having some trouble …Windows can’t seem to recognize the driver

    Tony Chen - Reply

    Hi Tony. Best to discuss specific issues on the forum.

    Tony -

    I have connected the USB with my laptop. However, I have immediately found two issues:

    1. The diag red LED is off.

    2. I cannot find the USB in the device manager; hence, cannot install driver.

    Jeffrey Yu - Reply

    Hi Jeffrey. Best to discuss specific issues on the forum.

    Tony -

    • To set up a WiFi network connection, we must use a terminal emulation program. This is because 3D printer host programs (such as Pronterface) send all characters in uppercase, and your WiFi settings (SSID and password ) are case sensitive.

    • Windows users: Download YAT here. Install YAT using default options.

    • Mac OSX Users: Open Applications > Utilities > Terminal .

      • Run ls /dev/tty.*

      • Copy the result that has USB in the name. For example; /dev/tty.usbmodem1411

      • Run screen /dev/tty.usbmodem1411 115200. Replace "usbmodem1411" with the result you received. You should see a blank screen. Hit enter and you should see OK returned. You are connected successfully.

      • If you get an error, Sorry, could not find a PTY. unplug the USB, plug it back in and try again.

      • Some users have reported issues with YAT under Windows 8 not connecting properly. if YAT does not work try pronterface to confirm the computer can talk to the Duet

    Please, Ls /dev/tty.* command is not working, I send it, and nothing happens

    David - Reply

    Sorry, my mistake, I sent ls/dev/tty.* command in YAT, but is not necessary. My apologizes

    David - Reply

    • Windows Users: Open YAT, and configure the correct COM port.

      • If unsure of the COM port number, press Windows Key + R on your keyboard and type devmgmt.msc

      • Your Duet will be listed under Ports (COM & LPT) as USB Serial Device (COM#) or similar. Use COM# as the com port in YAT.

      • Also in YAT, under Text Settings set the end-of-line sequence to <LF>.

    • Mac users can skip this step.

    • After the COM port has been configured, send command "M115" to the Duet board.

    • The Duet will return the firmware version being used.

    • If using firmware version 1.19 or later, continue to the next step.

    • If using firmware version 1.18 or earlier, we recommend upgrading. See installing and upgrading firmware: Upgrading to DuetWiFiFirmware 1.19 here.

    • Mac Users: you will not see characters appear on the screen as you type. For this reason, it is easiest to copy and paste the commands to ensure correct syntax. Copy M115 and paste into terminal and then hit enter. You will see OK when a succesfull command is received. Wait a few moments and the firmware version will be displayed.

    Will not return anything. Only sends M511 but does not return any info

    arnold - Reply

    M511 is not a recognised gcode. M115 is the one to report the firmware version

    Tony -

    I’m stuck here. Why are the electronicals so difficult!

    Jeff Robertson - Reply

    • First, check the status of the Wifi or Ethernet Module by sending command "M552" to Duet.

    • If Duet returns Wifi or Ethernet module is disabled, put it into idle mode it by sending command "M552 S0". If it returns Wifi or Ethernet module is idle, proceed to the next step.

    • Use the command M587 as shown below. The simple double quote characters are needed, but substitute the SSID and WiFi password for your own network.

      • M587 S"your-network-ssid" P"your-network-password"

      • Important: enter the exact characters in the SSID and password of your network, in the correct case, except that if your SSID contains an apostrophe then enter two apostrophe characters in its place. For example, if your SSID is Pete's network then enter "Pete''s network".

    • Send command M552 S1 to connect to WiFi. (Make sure to connect 2.4GHz network , 5.0GHz network will not connect with the Duet)

      • After a moment, Duet will confirm the connection and the IP address of the Duet controller.

    • At this point your Duet 2 Wifi should be on the wifi network. To connect to it, continue to Step 9.

    • Note: The WiFi module only support 2.4Ghz not 5 Ghz Wifi bands.

    • Note: M587 saves the SSID and password to the Duet 2 Wifi. You do not need to run this command every time the board is started. M552 starts the network, this command does need to be run every time the board starts (so ensure it is in config.g so it runs automatically.

    Should this be M551 S1 or M552 S1 .. cuz M551 S1 didnt make me connect ,,,

    Steve - Reply

    Thanks, corrected

    Tony -

    Doesn’t work just says:

    M587: Failed to add SSID to remembered list<LF>ok<LF>

    Travis Butler - Reply

    Best to discuss this on the forum

    Tony -

    At this point your Duet Wifi should be on the wifi network. To connect to it, continue to Step 11. - This should say Step 9 instead of Step 11?

    tjb1 - Reply

    Thanks for pointing that out, I have fixed

    Tony -

    Please add note that the Duet will connect just to 2.4MH and its can not connect to 5MH wifi networks ,

    I spend 3 hours trying to connect it because i didn’t know that :(

    Mor Hana - Reply

    Thanks for pointing this out, we mention it elsewhere in the documentation but not here so i have added that. Sorry for the waste of time!

    Tony -

    Please forgive if this isn’t the correct place to ask, but when I type the M587 command with S"THE ACTUAL NAME OF MY SSID” P “MY ACTUAL PASSWORD” and then the m552 S1 command, I get a “WiFi reported error: no known networks found” error. The SSID and password are correct. What am I doing wrong? Thanks in advance. BTW, I’m on a 2.4MH network

    Anthony Colannino - Reply

    same with me

    Jonathan Valdez -

    Check to see the network has been added properly by M587 with no arguments. Looks like you are doing it correctly so best to ask on the forum.

    Tony -

    need help please mine says:

    M587 S"FlooNetwork" P"QuidditcH86"


    M552 S1


    WiFi reported error: no known networks found

    Wifi module is idle

    Jonathan Valdez - Reply

    This item mentioned above is referencing you connecting your duet to your local network at your home or office. It sounds as if you are setting a new username and password for the duet, rather you are logging the duet into your router in your home or office with the commands suggested. Just wanted to share this with those that may be confused.

    Martin Smith - Reply

    Noting that the SSID/password is persisted would be nice.

    Ray Tice - Reply

    I would add a link to a troubleshooting guide if the connection does not work. E.g. if the router blocks unknown MAC addresses, conflicting IP addresses etc.

    At the beginning I would add “If you have a Duet WiFi, then…”, same in Step 8. It is implicit in the title, but can be overread.

    JoergS5 - Reply

    The command to read the ESP-12S MAC address should be cited here, and no, it is no M540 (it just tells a fake MAC address). This is needed to whitelist the device when the router uses wireless MAC filtering.

    Alvaro Hermida - Reply

    Please post additional feature requests on the forum:

    Tony -

    After a moment, Duet will confirm the connection” It didn’t. I had to send M552 to have the confirmation.

    Félix Piédallu (Salamandar) - Reply

    I can only get this to work if I execute these commands as a macro. I modified the SETNETWORK macro example. Otherwise I always got the “WiFi reported error: no known networks found” message

    Benjamin - Reply

    I could not get my Duet Wifi to connect to my network and figured it was because my SSID is not broadcast. Once I typed in

    M552 S1 P”enter SSID”

    it finally connected. Hopefully this will help others.

    Skeetch - Reply

    • DHCP.If you have setup the Duet 2 Ethernet to use DHCP then when the network is enabled it will look for a DHCP server to allocate an address. Most home routers are setup to assign addresses by DHCP.

      • Send the command "M552 S1" to the board.

      • After about 30 seconds, the board should reply with Network running and the IP address that the Duet has been assigned.

    • Fixed Address If you have used a fixed IP address in config.g then when the network is enabled the Duet 2 Ethernet will use that address. Note that if you use a fixed address, care should be taken that it does not conflict with other devices on the network.

    • The Duet 2 Ethernet and Duet 2 Maestro come with a factory configured fixed address used during testing. This address will probably not work with your network and may cause conflicts. It is recommended to enable DHCP when using the RepRapFirmware configuratorto generate your configuration file.

    • Mac users: Press CRTL-A and then CRTL-D to exit screen and return to terminal. You can safely close Terminal at this point.

    Does the card need to be connected to the Ethernet cable for this step? Mine is not and it returns an IP but it is not accessible.

    Bruno Porto - Reply

    On the Ethernet, Once it returns the IP, you should connect the ethernet cable between your router and the Duet.

    Shane Granger - Reply


    when I send M552 S1 command on my Duet 2 Ethernet I get message

    “Network is enabled, configured IP address:, actual IP address:<LF>ok<LF>”

    But when I try to reach this IP ( address on browser I get error message that site cat’t be reached.

    kashyap fruitwala - Reply

    Please use the Duet3D forum for support :

    Tony -

    When I send M552 S1, the duet returns "ok <LF>”. Any suggestions? The board does not reply with Network running and the IP address that the Duet has been assigned.

    Chris Leggett - Reply

    • Open your browser and type the IP address assigned to the Duet.

    • You should now see the main control page for the Duet!

    Step 8 completed absolutely the same with the picture

    Step 9 Neither IP and duettest.local/ does not work in the few browsers, what could be the problem?

    Dmitri Plotnikov - Reply

    daemon length overflow

    Dmitri Plotnikov -

    Please use the Duet3D forum for support :

    Tony -

    • We need to be sure the networking is configured properly for the future.

    • Navigate to config.g by clicking:

      • Settings

      • System Editor

      • config.g

    • Check that there is a command "M552 S1" without a semicolon in the beginning. This sets the wifi or ethernet module to enabled.

    • Commands are processed from top to bottom, so a command at the bottom supersedes a command at the top of the file.

    • Optional: Set the IP address for the Duet controller in the M552 command.

      • Leaving this as will allow your router to assign an IP address via DHCP. This is standard for most network devices.

      • If you are not familiar with networking, you should leave this setting as

Finish Line

83 other people completed this guide.


Member since: 10/31/2017

3,299 Reputation

3 Guides authored



I never got the IP address after the account details were added and activated I looked it up via my router, Espressif Inc. was the device name. I later noticed that I could run the M552 and get the address to display as intended in the guide. Thanks for the nice guide!

Per - Reply

hello, i have 4 wifi´s remembered in my duet. how can i delete them?

Dr Taly (DrTaly) - Reply

M588: Forget WiFi host network


S"ccc" Network SSID to remove from the remembered list

The specified SSID will be removed from the remembered list and the associated password cleared out of EEPROM. If the SSID is given as "*" then all remembered networks will be forgotten.

Ricard -

Ran the M511 and it did nothing. Using Widows 10 if that helps.

arnold - Reply

M511 is not a recognised gcode.

Tony -

Received IP address but when I go to Duet web interface I get Syntax error “ JSON.parse :Invalid character at position 91

What is that mean?????????????

Pete - Reply

Hi Pete, please can you use the forum for support requests.

Tony -

Nice job on the instructions. works great!

Jude Zeman - Reply

Great instructions. thanks

Ashley Beruldsen - Reply

Very grateful for you guys work and knowledge putting this guide together for us non techno people!

RJ Myers - Reply

Duet Wifi , cannot upload the DuetWebControl-1.21.2-b1 zip file on, Upload files button to function I get "× Settings applied!" as the response

RJ Myers - Reply

In case it helps anyone, the firmware that came with my Duet Wifi claims that the firmware is 2.0(RTOS) (2018-06-05b3), and that there was an over-power problem on the first heater (despite nothing being connected). However, once I went through the Configurator steps at as a 1.21+ firmware, once I had uploaded the files the errors all went away.

Matthew Bennett-Lovesey - Reply

worked perfect first time. thank you so much.

RBTGeorge - Reply

I’m getting same response as Matthew above but I’m not sure what dimensions to enter in the configurator for my Ultibots DVS 300+. Any help is greatly apreciated. Failed to home all (G.28).

Franklin Ohrtman - Reply

Please use the Duet3D forum for support :

Tony -

When I enter command M587 S”my SSID” P”my network security key” I am getting Bad or missing parameter<LF>ok<LF>

Any ideas on how to resolve this issue? I am using a 2.4 network connect. I initially tried to connect with my 5ghz network and then realized my mistake. Initially it just said OK<LF>

Jeremy Watkins - Reply

I disconnected my USB and closed YAT. Then I reopened the program and the error did not persist.

Jeremy Watkins -

Does the Duet have a default static IP address ? I want to connect directly to my Duet using Duet <——-> Ethernet <——-> Computer. Thanks.

Robocop - Reply

It depends on what you setup in your config.g

Tony -

Step 7 needs clarification: ti should be clearly stated that the ordinary, simple double quote character (ASCII 34 decimal) must be used in the M587 command.

Reccommend that the example command be rendered in its own HTML span using a monospace font, disallowing line breaking, so that the precise syntax - showing where whitespace is needed - is clearly rendered, and to make it easy for someone to copy-paste the example and then substitute the parameters.

Martin Cribbins - Reply

Thanks, will update that step

Tony -

Note Bene:

My SSID has an apostrophe in it. I had to double the apostrophe to quote it and now it works.

Steve Johnson - Reply

For some reason the non-macro manual method doesn't always work, and I've learned that the most simple solution then, is to create a macro file with the needed info and execute the macro. Visit Fix Mac Error Code-36 for instant help regarding how to fix mac error code-36 permanently.

Tech Service - Reply

For some reason the non-macro manual method doesn't always work, and I've learned that the most simple solution then, is to create a macro file with the needed info and execute the macro. Visit Fix Mac Error Code-36 for instant help regarding how to fix mac error code-36 permanently.

Tech Service - Reply

Hello, Is there a way to work in WiFi with a hidden SSID?

John LITTLE - Reply

Sleep on it. I should have waited before asking my question, because the answer was documented in the GCode section with the enable of the network: M552 S1 P "SSID". Excelent tutorial.


View Statistics:

Past 24 Hours: 171

Past 7 Days: 1,102

Past 30 Days: 4,632

All Time: 35,100