Initial wiki

bashy 2026-05-27 11:21:37 +03:00
commit 50a7fd541b
4 changed files with 96 additions and 0 deletions

37
Docker-Resources.md Normal file

@ -0,0 +1,37 @@
# Docker / Infrastructure Resources
## Reference
- [Compose file reference](https://docs.docker.com/compose/compose-file/)
- [Docker Hub](https://hub.docker.com/)
- [Awesome Selfhosted](https://github.com/awesome-selfhosted/awesome-selfhosted) — image lookup
## Services to containerize
### VPS
| Service | Image | Status | Notes |
|---|---|---|---|
| Forgejo | `codeberg.org/forgejo/forgejo` | done | Running on port 8929 → Apache |
| Listmonk | `listmonk/listmonk` | planned | App only, connects to host PostgreSQL 17 |
| Nextcloud | `nextcloud` | planned | App + Redis, connects to host PostgreSQL 17 |
| bashybot | custom | planned | Discord bot |
| TeamSpeak 3 | `teamspeak` | planned | Ports 9987/udp, 30033/tcp, 10011/tcp |
### Home server
| Service | Image | Status | Notes |
|---|---|---|---|
| Navidrome | `deluan/navidrome` | planned | Music streaming |
| Jellyfin | `jellyfin/jellyfin` | planned | Media server |
| Grafana | `grafana/grafana` | planned | Dashboards |
| Prometheus | `prom/prometheus` | planned | Metrics scraper |
| InfluxDB | `influxdb` | planned | Time series DB |
| ChirpStack | `chirpstack/chirpstack` | planned | LoRaWAN network server |
| Mosquitto | `eclipse-mosquitto` | planned | MQTT broker |
| Node-RED | `nodered/node-red` | planned | IoT data pipelines |
## Compose patterns
- Read-only bind mounts for media libraries (`ro` flag)
- Named volumes for all persistent data
- `depends_on` + `healthcheck` for DB-dependent services
- `127.0.0.1:PORT:PORT` binding — never expose directly to internet
- `restart: unless-stopped` on all services
- Env vars for secrets — never hardcode credentials in compose files

7
Home.md Normal file

@ -0,0 +1,7 @@
# Roadmap
Learning roadmap across three parallel tracks: Yocto / Embedded Linux, IoT protocols, and Docker infrastructure.
- [[Yocto-Resources]]
- [[IoT-Resources]]
- [[Docker-Resources]]

25
IoT-Resources.md Normal file

@ -0,0 +1,25 @@
# IoT Resources
## Bluetooth / BLE
- [BlueZ](http://www.bluez.org/) — official Linux Bluetooth stack
- [bleak](https://bleak.readthedocs.io/) — async Python BLE client (cross-platform)
- [GATT Assigned Numbers](https://www.bluetooth.com/specifications/assigned-numbers/) — standard UUIDs
- Tools: `bluetoothctl`, `btmon`, `hcidump` / `hcitool`, `gatttool`
## WiFi Embedded
- [hostapd](https://w1.fi/hostapd/) — AP daemon docs and example configs
- [wpa_supplicant](https://w1.fi/wpa_supplicant/) — client daemon docs
- [systemd-networkd](https://www.freedesktop.org/software/systemd/man/systemd.network.html) — lightweight network management
## Meshtastic
- [Meshtastic Docs](https://meshtastic.org/docs/) — firmware, hardware, config
- [Python API](https://python.meshtastic.org/) — programmatic node control
- [Supported Hardware](https://meshtastic.org/docs/hardware/devices/) — board compatibility
- Recommended boards: **TTGO LoRa32 v2.1**, **Heltec WiFi LoRa 32 v3**
- Radio: SX1276 (v1) / SX1262 (v3 boards) on 868 MHz (EU)
## LoRaWAN (existing background from thesis)
- ChirpStack running on home server
- Dragino LPS8 gateway
- TTN used during thesis (can re-add as second network server)
- Node-RED data pipeline already built

27
Yocto-Resources.md Normal file

@ -0,0 +1,27 @@
# Yocto / Embedded Linux Resources
## Official
- [Yocto Project Documentation](https://docs.yoctoproject.org/)
- [Yocto Mega-Manual](https://docs.yoctoproject.org/singleindex.html) — single-page reference
- [OpenEmbedded Layer Index](https://layers.openembedded.org/) — find layers by name
- [meta-st-stm32mp](https://github.com/STMicroelectronics/meta-st-stm32mp) — ST BSP layer
## Learning
- [Bootlin Yocto Training](https://bootlin.com/training/yocto/) — free slides PDF, highly recommended
- [Bootlin Embedded Linux Training](https://bootlin.com/training/embedded-linux/) — broader context
- *Mastering Embedded Linux Programming* — Chris Simmonds (Packt, 3rd ed.)
## Key CLI tools
| Command | What it does |
|---|---|
| `bitbake-layers show-layers` | Inspect current layer stack |
| `bitbake -e <recipe> \| grep ^VAR` | Expand variables for a recipe |
| `devtool modify <recipe>` | Edit a recipe source in-place |
| `recipetool create <url>` | Generate a recipe from source |
| `bitbake -c devshell <recipe>` | Drop into build environment shell |
## Hardware notes
- **Board:** STM32MP157C DK2 (Cortex-A7 + Cortex-M4 MPU)
- **Display expansion:** MB1407 (availability TBD — see issue)
- **Serial console:** ST-LINK UART on CN11, 115200 8N1
- **MACHINE value:** `stm32mp157c-dk2`