Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.5 KiB
Budka link — a Chytra Budka as a sensor source
A Chytra Budka (ESP32-S3 bird box) sends its readings over a one-way UART line
to a XIAO nRF52840 running simple_sensor; the sensor serves them as
CayenneLPP telemetry to anyone on the mesh. The line format and the budka side
are documented in the chytra-budka repo, firmware/MESHCORE.md.
Build
BudkaLinkSensorManager (src/helpers/sensors/) replaces the variant's
EnvironmentSensorManager when the env defines BUDKA_LINK_RX_PIN; every
other env is unchanged.
[env:Xiao_x1_budka] ; platformio.local.ini
extends = env:Xiao_nrf52_sensor
build_flags =
${env:Xiao_nrf52_sensor.build_flags}
${test_radio.build_flags} ; bench: test band only
-D BUDKA_LINK_RX_PIN=0 ; D0 = the only pad LoRa + I²C leave free
Optional: BUDKA_LINK_TX_PIN (default LED_GREEN — nothing is ever sent, the
idle-high line keeps that LED dark), BUDKA_LINK_BAUD (115200),
BUDKA_LINK_METERS (3), BUDKA_LINK_STALE_MS (120 s).
Wiring
Budka mc_tx pad → XIAO D0, GND ↔ GND, each board on its own USB. A
1 kΩ series resistor protects against back-powering when one side is off.
Telemetry layout
| channel | content |
|---|---|
| 1 | the node itself |
| next | budka: temperature, humidity, pressure, motion count (generic sensor) |
| next + k | UC96 meter k: voltage, current, power (analog input), energy (kWh) |
A line with a bad checksum is dropped whole; a value not refreshed for 2 min is left out. Meter channels stay reserved while a meter is missing.
Read it with tools/budka_telem.py <companion-port> <sensor-name>. The sensor
answers only clients in its ACL — a request from anyone else is dropped
(recv matches no peers in a MESH_DEBUG build). Add the companion from the
sensor's USB console with setperm <companion-pubkey> 1, or log in as admin.
The port may be a pyserial URL (socket://… for an openHop companion), and the
name may be the sensor's public key when the companion does not have it yet.
Bench result (13. 10. 2026)
x1 (sensor, test band) fed by the bench budka; x4 as USB companion:
ch2 temp_C 25.3 humidity_% 59.0 generic 29
ch3 voltage_V 4.94 current_A 0.10 analog_in 0.49 energy_kWh 0.111
ch4 voltage_V 4.94 current_A 0.18 analog_in 0.89 energy_kWh 0.311
Not done
Alerts (reed opened, budka WiFi down) and the return direction (mesh → budka).
The sensor build has no dfu console command — reflash with
pio run -t upload, one touch per power session.