QuackStart

how to get up and running with some clusterducks with least effort.

PREREQs

• any "esp32 with a lora chip" boards should do.

• • check platformio.ini for existing board definitions.
• • 3+ ducks are a good start. (2 will work, but thats the most boring mesh ever)

• assumes you have some kind of nixoid buildhost you know how to use.

• • used examples are fedora and raspi.
• • anything linux or mac should work, including linux-on-a-windows vms.

serial port access

• google a distro specific guide.
• generally mucking around with udev and/or regular unix permission management.

fedora

sudo usermod -a -G dialout user

install PIO

https://docs.platformio.org/en/latest/core/installation.html#installer-script

install PIO on fedora

wget https://raw.githubusercontent.com/platformio/platformio-core-installer/master/get-platformio.py -O get-platformio.py
python3 get-platformio.py

echo 'export PATH="$PATH:~/.platformio/penv/bin"' >> ~/.bashrc
export PATH="$PATH:~/.platformio/penv/bin"

install QS + CDP + RL

git clone https://github.com/gozu42/QuackStart
cd QuackStart

pio lib -g install https://github.com/jgromes/RadioLib
pio lib -g install https://github.com/Code-and-Response/ClusterDuck-Protocol

build for a board

pio run -e heltec_wifi_lora_32_V2

install to boards

pio run -e heltec_wifi_lora_32_V2 -t upload --upload-port /dev/ttyUSB0

testing

• keep (at least) one duck connected to the buildhost

stty -F /dev/ttyUSB0 115200 raw -echo ; perl -pe '$|=1;$a=time;print"$a "' /dev/ttyUSB0