C3MA/DD3-Lora-Bridge-Raspi-Debugger
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update README to reflect current runtime and install behavior

Browse Source
This commit is contained in:
acidburns
2026-02-13 02:51:29 +01:00
parent 4f6ee83a1b
commit 680ed7044e
1 changed files with 17 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@@ -11,20 +11,27 @@ Headless Raspberry Pi Zero W project:
## Current State ## Current State
Current implementation status: Current implementation status:
- Boot flow restores system time from RTC (`hwclock -s`) before starting logging. - Boot flow restores system time from RTC (`hwclock -s`) before starting services.
- If WLAN + internet is unavailable, AP fallback starts on `wlan0`: - RTC device auto-detection checks: configured device, `/dev/rtc`, `/dev/rtc0`, `/dev/rtc1`.
- If WLAN is disconnected for ~60s, AP fallback starts on `wlan0`:
- SSID: `serial` - SSID: `serial`
- Password: `serialserial` - Password: `serialserial`
- AP IP: `192.168.4.1/24` - AP IP: `192.168.4.1/24`
- DHCP range: `192.168.4.10` to `192.168.4.200` - DHCP range: `192.168.4.10` to `192.168.4.200`
- Web portal is available on port `80`: - Web portal is available on port `80`:
- `/` WiFi scan + connect UI - `/` WiFi scan + connect UI + system actions (reboot/shutdown)
- `/serial` live serial console (SSE via `/events/serial`) - `/serial` live serial console (SSE via `/events/serial`)
- `/api/status` polling is reduced/throttled (15s) for Pi Zero W performance
- ESP32 serial bridge: - ESP32 serial bridge:
- Auto-detects `/dev/ttyUSB*`, `/dev/ttyACM*`, `/dev/serial/by-id/*` - Auto-detects `/dev/ttyUSB*`, `/dev/ttyACM*`, `/dev/serial/by-id/*`
- Reconnects automatically on unplug/replug - Reconnects automatically on unplug/replug
- Daily log rollover at midnight with datetime filename - Daily log rollover at midnight with datetime filename
- No log file is created while no serial device is connected
- Once internet is available, NTP sync runs and writes corrected time back to RTC (`hwclock -w`). - Once internet is available, NTP sync runs and writes corrected time back to RTC (`hwclock -w`).
- After boot is ready, power/activity LED is set to 1 Hz blink (`timer`, 500ms on / 500ms off), if LED sysfs control is available.
Note:
- Reboot/shutdown actions in the web UI currently have no authentication. Restrict access to trusted networks only.
Runtime check commands: Runtime check commands:
```bash ```bash
@@ -62,7 +69,7 @@ sudo reboot
Verify: Verify:
```bash ```bash
ls -l /dev/rtc0 ls -l /dev/rtc*
sudo i2cdetect -y 1 sudo i2cdetect -y 1
sudo hwclock -r sudo hwclock -r
``` ```
@@ -74,7 +81,12 @@ chmod +x install.sh
sudo ./install.sh sudo ./install.sh
``` ```
Then reboot: Installer behavior:
- First run: full install (apt packages, venv, pip deps, configs, services).
- Re-run/update: fast path, skips apt and pip when not needed.
- `pip install` runs only when `requirements.txt` hash changed (or venv missing).
Optional reboot after first install or low-level config changes:
```bash ```bash
sudo reboot sudo reboot