| - | [* black] This step is for ***Linux*** users only! Windows and Mac OS users skip this step. |
|---|
| - | [* black] Most likely, the first thing you will need to do on a Linux installation is to add the user to the 'dialout' group, to allow permission to connect to the Duet. Do this by opening a Terminal window and sending ***sudo adduser [your_username] dialout***. Following this, you will need to log out and back in, or possibly restart, to enable this. |
|---|
| - | [* black] Next, check that the Duet is showing up as connected. Open a Terminal window and send ***lsusb***, which should show an entry for the Duet, then ***ls /dev/tty****, which amongst the list should show an entry ending 'ACM[number]'. This is the port the Duet is using. |
|---|
| - | [* black] There are many options to connect using Linux. Our favourite is to use CuteCom, which is a GUI serial terminal. It's available in most package repositories, or install with ***sudo apt install cutecom***. It should automatically detect the correct port (usually /dev/ttyACM0), and is configured correctly out of the box. Click 'Open' to connect. |
|---|
| - | [* black] Alternatively, you can use a text-based serial terminal application such as Minicom. Install with ***sudo apt install minicom***. |
|---|
| + | [* icon_caution] This step is for ***Linux*** users only! See Step 2 to check the Duet is connected and the Serial Port name. Windows and Mac OS users skip this step. |
|---|
| + | [* blue] Most likely, the first thing you will need to do on a Linux installation is to add the user to the 'dialout' group, to allow permission to connect to the Duet. Do this by opening a Terminal window and sending ***sudo adduser [your_username] dialout***. Following this, you will need to log out and back in, or possibly restart, to enable this. |
|---|
| + | [* blue] There are many options to connect using Linux. Our favourite is to use CuteCom, which is a GUI serial terminal. It's available in most package repositories, or install with ***sudo apt install cutecom***. It should automatically detect the correct port (usually /dev/ttyACM0), and is configured correctly out of the box. Click 'Open' to connect. |
|---|
| + | [* blue] Alternatively, you can use a text-based serial terminal application such as Minicom. Install with ***sudo apt install minicom***, and run from a Terminal window with ***minicom -s***, which starts it in setup mode. |
|---|
| - | [* black] Finally, you can use the built-in 'screen' terminal. However, you cannot see the commands you type in, and the responses from the Duet are not formatted nicely on the screen. If you want to use 'screen', do this: |
|---|
| - | [* black] Run ***screen /dev/ttyACM0 115200***. (Replace "ttyACM0" with the port name if it's different.). You should see a blank screen. If you are connecting for the first time to a Duet 2 WiFi, you will see lots of "WiFi reported error: no known networks found" messages. Don't worry, that's normal. Press return and you should get 'ok'. |
|---|
| + | [* blue] Finally, you can use the built-in 'screen' terminal. However, you cannot see the commands you type in, and the responses from the Duet are not formatted nicely on the screen. If you want to use 'screen', do this: |
|---|
| + | [* black] Run ***screen /dev/ttyACM0 115200***. (Replace "ttyACM0" with the port name if it's different.). You should see a blank screen, but see note on Duet 2 WiFi below. |
|---|
| + | [* icon_note] No matter which connection method you use, if you are connecting to a ***Duet 2 WiFi***, you may see lots of ''"WiFi reported error: no known networks found"'' messages. Don't worry, that's normal, and it means that the Duet is working! |
|---|