Skip to content

Commit f3d4101

Browse files
authored
Update FAQ.md (#697)
Used Node.js installation method. Faced permission issues accessing device. Tried the suggested method in the FAQ with no success. Found this esp8266/source-code-examples#26 forum that provided the following approach: Add user to the `uucp ` , `tty ` , `dialout ` groups: ``` sudo usermod -a -G uucp $USER sudo usermod -a -G tty $USER sudo usermod -a -G dialout $USER ``` The particular group that would make it work depends on the type of serial connection and linux distribution. I think this would be a more simple solution but just wanted to bring some light to this with the hopes that someone more knowledgeable could provide a more educated opinion. Cheers!
1 parent 0436c7e commit f3d4101

File tree

1 file changed

+19
-2
lines changed

1 file changed

+19
-2
lines changed

docs/information/FAQ.md

+19-2
Original file line numberDiff line numberDiff line change
@@ -98,9 +98,13 @@ In this example the correct `port` would be `/dev/ttyACM0`.
9898
### Verify that the user you run Zigbee2MQTT as has write access to the port
9999
This can be tested by executing: `test -w [PORT] && echo success || echo failure` (e.g. `test -w /dev/ttyACM0 && echo success || echo failure`).
100100

101-
If it outputs `failure`. Assign write acces by executing: `sudo chown [USER] [PORT]` (e.g. `sudo chown pi /dev/ttyACM0`).
101+
If it outputs `failure` it could mean your user does not have access to the port. To test assign write acces by executing: `sudo chown [USER] [PORT]` (e.g. `sudo chown pi /dev/ttyACM0`).
102102

103-
You need to apply this on every reboot. To fix this you can use a 'udev' rule:
103+
if it outputs `failure`, then you need to permanently give your user permission to the device.
104+
105+
#### Method 1: Give your user permissions on every reboot. ####
106+
107+
You can create a 'udev' rule yo give your user permissions after every reboot:
104108

105109
1. `udevadm info -a -n /dev/ttyACM0 | grep 'serial'`
106110
get the serial to your device `YOURSERIAL`
@@ -120,6 +124,19 @@ serial:
120124
`
121125

122126
After reboot your dedvice will have the right permissions and always the same name.
127+
128+
#### Method 2: Add your user to specific groups ####
129+
130+
As mentioned on https://github.com/esp8266/source-code-examples/issues/26 , depending on your linux installation, various groups could have ownership of the device.
131+
132+
Add your user to the `uucp ` , `tty ` , `dialout ` groups:
133+
134+
```
135+
sudo usermod -a -G uucp $USER
136+
sudo usermod -a -G tty $USER
137+
sudo usermod -a -G dialout $USER
138+
```
139+
Reboot your device and now your user should have access to the device.
123140

124141
### Error: `Coordinator failed to start, probably the panID is already in use, try a different panID or channel`
125142
- In case you are migrating from another adapter see: [How do I migrate from a CC2531 to a more powerful coordinator (e.g. ZZH)?](#how-do-i-migrate-from-a-cc2531-to-a-more-powerful-coordinator-eg-zzh)

0 commit comments

Comments
 (0)