aboutsummaryrefslogtreecommitdiffstats
path: root/docs/FAQ.md
diff options
context:
space:
mode:
authorKevin O'Connor <kevin@koconnor.net>2018-06-01 17:18:12 -0400
committerKevin O'Connor <kevin@koconnor.net>2018-06-01 17:22:03 -0400
commit2c4ca8888784dc9af1d917df33193b6c35196761 (patch)
tree336ab3351f59ec6ded4a484da1bc5ed3187bd7dc /docs/FAQ.md
parent404cd376b5d15f91b94a79f6515ebfaa53462b1f (diff)
downloadkutter-2c4ca8888784dc9af1d917df33193b6c35196761.tar.gz
kutter-2c4ca8888784dc9af1d917df33193b6c35196761.tar.xz
kutter-2c4ca8888784dc9af1d917df33193b6c35196761.zip
docs: Update documentation to note use of /dev/serial/by-path/
When using multiple micro-controllers it may be necessary to use an id from /dev/serial/by-path/ instead of /dev/serial/by-id/. Also, emphasize that in config/example-multi-mcu.cfg. Signed-off-by: Kevin O'Connor <kevin@koconnor.net>
Diffstat (limited to 'docs/FAQ.md')
-rw-r--r--docs/FAQ.md10
1 files changed, 7 insertions, 3 deletions
diff --git a/docs/FAQ.md b/docs/FAQ.md
index 351701cb..d2fc3ccd 100644
--- a/docs/FAQ.md
+++ b/docs/FAQ.md
@@ -38,7 +38,7 @@ The general way to find a USB serial port is to run `ls -l
/dev/serial/by-id/` from an ssh terminal on the host machine. It will
likely produce output similar to the following:
```
-lrwxrwxrwx 1 root root 13 Jan 3 22:15 usb-UltiMachine__ultimachine.com__RAMBo_12345678912345678912-if00 -> ../../ttyACM0
+lrwxrwxrwx 1 root root 13 Jun 1 21:12 usb-1a86_USB2.0-Serial-if00-port0 -> ../../ttyUSB0
```
The name found in the above command is stable and it is possible to
@@ -46,18 +46,22 @@ use it in the config file and while flashing the micro-controller
code. For example, a flash command might look similar to:
```
sudo service klipper stop
-make flash FLASH_DEVICE=/dev/serial/by-id/usb-UltiMachine__ultimachine.com__RAMBo_12345678912345678912-if00
+make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
sudo service klipper start
```
and the updated config might look like:
```
[mcu]
-serial: /dev/serial/by-id/usb-UltiMachine__ultimachine.com__RAMBo_12345678912345678912-if00
+serial: /dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0
```
Be sure to copy-and-paste the name from the "ls" command that you ran
above as the name will be different for each printer.
+If you are using multiple micro-controllers and they do not have
+unique ids (common on boards with a CH340 USB chip) then follow the
+directions above using the directory `/dev/serial/by-path/` instead.
+
### When the micro-controller restarts the device changes to /dev/ttyUSB1
Follow the directions in the