Blame

52c0db David Marsh 2026-04-17 00:11:57
1
# Linux
2
b33fbf David Marsh 2026-04-17 01:05:03
3
## Update your OS
4
e921be David Marsh 2026-04-17 00:24:16
5
First, update your OS
6
52c0db David Marsh 2026-04-17 00:11:57
7
```
8
sudo apt update
9
sudo apt upgrade
10
```
e921be David Marsh 2026-04-17 00:24:16
11
b33fbf David Marsh 2026-04-17 01:05:03
12
## Access to USB Serial
13
72069a David Marsh 2026-04-17 01:00:29
14
Add your user to the dialout group, change `$USER` to your user name. This allows your user to access the USB serial device.
e921be David Marsh 2026-04-17 00:24:16
15
16
```
17
sudo usermod -a -G dialout $USER
18
```
686c59 David Marsh 2026-04-17 01:05:45
19
a367b3 David Marsh 2026-04-22 12:24:24
20
You'll need to logout and back in again.
ee4d9c David Marsh 2026-04-20 03:28:56
21
22
## Flash the companion
23
243f38 David Marsh 2026-04-22 12:26:02
24
> [!NOTE]
25
> If you've already flashed your companion with the MeshCore firmware you can skip this step.
15c48d David Marsh 2026-04-22 11:55:42
26
a367b3 David Marsh 2026-04-22 12:24:24
27
> [!IMPORTANT]
28
> Make sure you flash with "Companion USB" not "Companion Bluetooth"
29
15c48d David Marsh 2026-04-22 11:55:42
30
TODO
31
32
## Install needed software
33
34
Install pipx then meshcore-cli
35
36
```
37
sudo apt install pipx
38
pipx install meshcore-cli
39
```
a367b3 David Marsh 2026-04-22 12:24:24
40
41
Logout and back in again.
42
43
## Find the USB device
44
45
```
46
meshcli -l
47
```
48
49
Output probably looks like this, you'll want to use the USB one:
50
51
```
52
BLE devices:
53
No BLE HW
54
55
Serial ports:
56
/dev/ttyS0 n/a [n/a]
57
/dev/ttyUSB0 CP2102 USB to UART Bridge Controller - CP2102 USB to UART Bridge Controller [USB VID:PID=10C4:EA60 SER=0001 LOCATION=1-1]
58
```
e188ea David Marsh 2026-04-22 13:26:30
59
## Configure node
60
61
```
62
set radio 915.800,250,11,5
63
set name "🦷 dave test"
64
```