Skip to content

Commit d569f09

Browse files
authored
DOCS-2662: Add troubleshooting tip for esp32 (#3193)
1 parent dc270b0 commit d569f09

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

docs/get-started/installation/_index.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ aliases:
2323
- /installation/prepare/microcontrollers/
2424
- /get-started/installation/prepare/microcontrollers/
2525
- /build/micro-rdk/
26+
- /get-started/installation/microcontrollers/
2627
---
2728

2829
To use Viam, you need to install either the `viam-server` binary or the micro-RDK.
@@ -319,3 +320,27 @@ However, if the correct port has been selected, try the following:
319320
You can find additional assistance in the [Troubleshooting section](/appendix/troubleshooting/).
320321

321322
{{< snippet "social.md" >}}
323+
324+
#### Computer not recognizing the microcontroller
325+
326+
If you’re trying to connect a microcontroller using serial port to an Ubuntu system and the computer doesn’t seem to be recognizing the microcontroller, check if the `brltty` service or its secondary service `brltty-udev` are active (`brltty` is a service installed by default that provides access to a braille display):
327+
328+
```sh {class="command-line" data-prompt="$" data-output="2"}
329+
sudo systemctl status | grep brltty
330+
brltty-udev.service loaded active running Braille Device Support
331+
```
332+
333+
It is a known issue that this service takes ownership of cp210x devices that are used in serial communication with microcontrollers.
334+
335+
To disable the services, run the following:
336+
337+
```sh {class="command-line" data-prompt="$"}
338+
sudo systemctl stop brltty-udev.service
339+
sudo systemctl mask brltty-udev.service
340+
sudo systemctl stop brltty.service
341+
sudo systemctl disable brltty.service
342+
```
343+
344+
You may also need to reboot your system, and/or unplug the cable from the computer and re-plug it in.
345+
346+
See this [blog post](https://koen.vervloesem.eu/blog/how-to-stop-brltty-from-claiming-your-usb-uart-interface-on-linux/) and [Ubuntu bug report](https://bugs.launchpad.net/ubuntu/+source/brltty/+bug/1958224) for more.

0 commit comments

Comments
 (0)