Duet3D

Site Navigation

Your Account

Choose Language

1.) Getting Connected to your Duet

Written By: Filastruder (and 12 other contributors)
  • Comments: 135
  • Favorites: 3
  • Completions: 216

Difficulty

Moderate

Steps

12

Time Required

00:10:00 - 00:15:00

Sections

1

Flags

0

Introduction

This document is relevant to: Duet 2 WiFi / Ethernet, Duet 2 Maestro, Duet 3 MB6HC in Stand alone mode

Firmware versions: All versions

This guide covers getting a basic USB connection to your Duet, setting it up to be connected to your network, and connecting to the Duet Web Console using a browser. If you have any problems with your Duet when using this guide, rather than posting comments, please use our support forum: https://forum.duet3d.com/

  1. Your Duet comes with the following items:

    • Your Duet comes with the following items:

    • Duet Controller

    • Connector kit

    • Würth 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

    Edit

  2. Note there have been several hardware revisions of the Duet 2 controller. This guide applies to all Duet 2 Wifi, Ethernet and Maestro boards. The picture of the board may be different to yours. Connect the Duet to your PC with the USB cable provided. Do not connect other power supplies at this stage.

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

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

    • Windows users, download the USB drivers for Duet here and extract the files to a suitable location.

    • 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". On Windows 10, you can right-click on the Start icon and click on "Device Manager".

    • Look for any devices with a yellow triangle, or for any "Generic USB" devices which would indicate that the Duet driver is not installed.

    • If a USB device does show the yellow triangle, or as a Generic USB device, 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 cable and proceed to the next step.

    Edit

  3. To set up a network connection, we must use a terminal emulation program to talk to the Duet via the USB cable. We recommend using YAT in Windows. 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. Setup YAT to use <LF> as the end of line character. Go to "Terminal" Menu -> "Settings" -> "Text Settings" -> "EOL sequence:" set to <LF>

    • To set up a network connection, we must use a terminal emulation program to talk to the Duet via the USB cable. We recommend using YAT in Windows. 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.

    • Setup YAT to use <LF> as the end of line character. Go to "Terminal" Menu -> "Settings" -> "Text Settings" -> "EOL sequence:" set to <LF>

    • 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

    Edit

  4. 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

    • 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.

    Edit

  6. Windows users: After the COM port has been configured, send command M115 to the Duet board.

    • Windows users:

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

    • The Duet will return the firmware version being used.

    • 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 succesful command is received. Wait a few moments and the firmware version will be displayed.

    • Once you know the firmware version your Duet is using, check for the latest version of the firmware in our Github repository here. Use the 'Latest release', not any 'pre-release', 'beta' or 'RC' version until you are familiar with Duet.

    • If your Duet is using an old firmware version, we recommend upgrading. See Installing and Updating Firmware documentation.

    • Mac Users: Any double quotation marks must be sent as straight double quotation marks. Curly double quotations will not work. To enable straight double quotation marks go to System Preferences > Keyboard > Text. Then under the Double Quotes drop down, select straight double quotations.

    Edit

  7. For Duet 2 WiFi: The WiFi module has a blue LED on it, just next to the Micro SD card holder. This should flash once when power is connected to the board, but will only be lit permanently when connected to a WiFi network. Duets with an external antenna use a different WiFi module with no LED; if you have one of these, don't forget to plug in the external antenna! You may find you are getting a lot of messages like &quot;WiFi reported error: no known networks found&quot;. The default configuration turns on the WiFi, but it is not finding a network to connect to. To stop the WiFi, send M552 S-1.

    • For Duet 2 WiFi:

    • The WiFi module has a blue LED on it, just next to the Micro SD card holder. This should flash once when power is connected to the board, but will only be lit permanently when connected to a WiFi network. Duets with an external antenna use a different WiFi module with no LED; if you have one of these, don't forget to plug in the external antenna!

    • You may find you are getting a lot of messages like "WiFi reported error: no known networks found". The default configuration turns on the WiFi, but it is not finding a network to connect to. To stop the WiFi, send M552 S-1.

    • Send M552 to check the status. It should say "WiFi module is disabled". Now put it into idle mode by sending command M552 S0. Send M552 again to check it's in idle, then proceed to the next step.

    • For Duet 2 Ethernet and Duet 2 Maestro:

    • Send M552 to check the network module status.

    • It may report that the module is disabled or enabled. Put it into disabled mode by sending command M552 S0. Send M552 again to check it is disabled, then proceed to the next step.

    Edit

  8. This step is for Duet 2 WiFi only! Use the command 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. M587 S&quot;your-network-ssid&quot; P&quot;your-network-password&quot; Note: If you are not using YAT to communicate with the Duet and have upper and lower case letters or apostrophe characters in the SSID or password, see the first note in the Gcode dictionary entry for M587.

    • This step is for Duet 2 WiFi only! Use the command 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.

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

    • Note: If you are not using YAT to communicate with the Duet and have upper and lower case letters or apostrophe characters in the SSID or password, see the first note in the Gcode dictionary entry for M587.

    • Note: Make sure to connect to a 2.4GHz network; the Duet 2 WiFi module will not connect to 5.0GHz networks.

    • 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.

    • 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.

    • At this point your Duet 2 Wifi should be on the wifi network. To connect to the Duet Web Control (DWC) interface, continue to Step 9.

    • 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)

    Edit

  9. This step is for Duet 2 Ethernet/Maestro and Duet 3 (standalone) only! Plug an ethernet cable into the Duet's ethernet port and connect the other end of the cable to a free ethernet port on your router/network hub.

    • This step is for Duet 2 Ethernet/Maestro and Duet 3 (standalone) only! Plug an ethernet cable into the Duet's ethernet port and connect the other end of the cable to a free ethernet port on your router/network hub.

    • The Duet 2 Ethernet and Duet 2 Maestro come with a factory-configured fixed IP address for testing. This is unlikely to work for you setup!

    • So you need to change the network settings. There are two options:

    • DHCP: Most home routers are setup to assign IP addresses by DHCP. Send M552 S0 to disable networking, then M552 S1 P0.0.0.0 to enable networking and have your router assign an IP address.

    • Fixed Address: You can set the Duet to use a fixed IP address. Note that if you use a fixed address, care should be taken that it does not conflict with other devices on the network. Send M552 S0 to disable networking, then M552 S1 Px.x.x.x to enable networking, where "x.x.x.x" is the IP address you want to use, eg 192.168.1.15.

    • In both cases, after 10-30 seconds the board should reply with Network running and the IP address the Duet is using. Send M552 to check the settings.

    • Note: these network settings are temporary! They will be lost when you restart and will have to be re-entered. Step 10 and 11 explain how to set it up permanently.

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

    Edit

  10. Duet Web Control (also known as DWC) is the user interface used over a network connection in a browser to configure and control a Duet. The manual for the use of the DWC is here: Duet Web Control v1 (DWC) Manual Open your browser and type the IP address assigned to the Duet, eg 192.168.1.90

    • Duet Web Control (also known as DWC) is the user interface used over a network connection in a browser to configure and control a Duet. The manual for the use of the DWC is here: Duet Web Control v1 (DWC) Manual

    • Open your browser and type the IP address assigned to the Duet, eg 192.168.1.90

    • You may also be able to access the Duet by typing "http://duettest.local/" into your address bar. This is the easiest way to connect to your Duet if you are using a dynamic IP address (via DHCP).

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

    Edit

  11. We need to be sure the networking is configured properly for the future. Navigate to config.g by clicking:

    • 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.

    • This version of the config.g configuration file will be replaced in the next section of the instructions. This version will be used for now, so making these changes will enable you to access the Duet until you do replace the config.g with a version that is more tailored for your machine.

    Edit

  12. The Duet 2 Ethernet / Maestro come with a factory-configured fixed IP address for testing. In step 8 you set up network access temporarily. You now need to change the config.g (and for Duet 3 in standalone mode) so you can access the Duet Web Console (DWC) following a power cycle.

    • The Duet 2 Ethernet / Maestro come with a factory-configured fixed IP address for testing. In step 8 you set up network access temporarily. You now need to change the config.g (and for Duet 3 in standalone mode) so you can access the Duet Web Console (DWC) following a power cycle.

    • For DHCP:

    • Most home routers are setup to assign IP addresses by DHCP. Change the M552 P192.168.1.14 line in config.g to M552 P0.0.0.0 to have your router assign an IP address via DHCP. This is standard for most network devices. Any other network settings are set automatically.

    • If you are not familiar with networking, you should change this setting to M552 P0.0.0.0

    • For Fixed IP address:

    • You can set the Duet to use a fixed IP address. Note that if you use a fixed address, care should be taken that it does not conflict with other devices on the network. Change the M552 P192.168.1.14 line to the IP address you want to use, eg M552 P192.168.0.15

    • You may also need to change the M554 (Gateway) and M553 (Netmask) commands to match your network.

    Edit

    • Congratulations - you are now connected to your Duet! You may continue to 2.) Wiring your Duet.

    • This guide assumes that you connect your Duet via WiFi or Ethernet to your network router, to make it accessible to your network. This may be impractical for your setup, so the Duet offers alternative connection methods:

    • The Duet 2 WiFi offers an "Access Point" mode that allows a direct WiFi connection to the Duet. See M589 and M552 in the Gcode dictionary.

    • The Duet 2 Ethernet and Duet 2 Maestro can be configured to connect directly to an available ethernet port on your PC. See this thread on the forum for details.

    Edit
Finish Line

216 other people completed this guide.

Author

with 12 other contributors

Filastruder

Member since: 10/31/2017

4,953 Reputation

3 Guides authored

41 Comments

Add a comment

Hi

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

Parameters:

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

Add Comment

View Statistics:

Past 24 Hours: 165

Past 7 Days: 1,175

Past 30 Days: 4,829

All Time: 137,811