====== Page Ideas ======

//**Status Aug 2026:** ✔ = implemented (link points to the actual page — some names differ from the original plan below), ◐ = partially covered, ○ = still open.//

^ Planned page ^ Status ^ Actual page / notes ^
| start | ✔ | [[en:start]] (incl. documentation overview and group order) |
| hardware:receiver | ○ | board reference (ESP32-C5, versions, jumpers) still to be written |
| hardware:power | ◐ | covered in [[en:getting_started]] (power supply, PoE jumper) and the jumper table in [[en:faq]] |
| hardware:antennas | ✔ | [[en:hardware:antennas]] |
| hardware:enclosure | ✔ | [[en:hardware:enclosure]] |
| hardware:leds | ○ | LED table in [[en:faq]] exists but the meanings are still blank |
| hardware:build-your-own | ○ | waiting for content (the German ''empfaenger_bauen'' is a stub as well) |
| software:first-steps | ✔ | [[en:getting_started]] |
| software:connectivity | ✔ | [[en:software:transmission_methods]] |
| software:mobile-setup | ◐ | partially in [[en:getting_started]] (WLAN / mobile operation) and [[en:faq]] (USB tethering) |
| software:node-registration | ✔ | [[en:node_registration]] |
| software:mqtt | ✔ | [[en:software:mqtt]] (incl. topic reference) |
| software:home-assistant | ✔ | [[en:software:home_assistant]] |
| reception:* | ✔ | merged into a single page: [[en:reception]] (placement, interference, thermal) |
| c-its | ✔ | [[en:c-its:start]] — message types: [[en:c-its:messages:cam|CAM]], [[en:c-its:messages:denm|DENM]], [[en:c-its:messages:mapem|MAPEM]], [[en:c-its:messages:spatem|SPATEM]], [[en:c-its:messages:ivim|IVIM]] |
| c-its:senders | ✔ | [[en:c-its:senders]] |
| sightings | ◐ | landing page [[en:sightings]] exists — per-city sub-pages (at:vienna, at:graz, de:aachen, vehicles) still open |
| api | ○ | map/data API, endpoints, data formats (''api'' is still a stub) |
| faq | ✔ | [[en:faq]] |
| community:contributing | ✔ | [[en:contributing]] |
| community:order | ◐ | covered by the group order section on [[en:start]] |

===== Original plan =====

start                        → Landing page (what/why, live map, links, order status)

hardware:                    → HARDWARE
  hardware:receiver          → The OTM node (ESP32-C5 board, versions v2, jumpers)
  hardware:power             → Power: USB (either port, common +5V rail) vs PoE
                               (802.3af active / passive 7–58V, jumper positions)
  hardware:antennas          → Standard PCB antenna + external antenna options,
                               connector type, gain, 5.9 GHz band notes
  hardware:enclosure         → 3D-printed case (ASA), bottom.stl, screws M4x12 TX20,
                               LAN grommet, weatherproof mounting
  hardware:leds              → LED meanings (SYS blink states, LAN-port LEDs),
                               brightness control, disabling LEDs
  hardware:build-your-own    → DIY receiver (fill empfaenger_bauen): dev-board build,
                               Gerber/BOM/CPL, PCB fab

software:                    → SOFTWARE & CONNECTIVITY
  software:first-steps       → (migrate erste_schritte) unboxing, power + internet,
                               DHCP, minimal working setup
  software:connectivity      → How to get data online: SPI-Ethernet (W5500/ENC28J60)
                               direct, USB→Raspberry Pi, USB→Android (cits-to-go),
                               FritzBox 3390, v2x2map, ESPHome/Home Assistant
  software:mobile-setup      → Phone tethering: USB-Ethernet dongle + cable
                               (node cannot emulate a NIC), enable tethering AFTER
                               node is powered & linked, Android Auto use
  software:node-registration → (keep) Self-Service Portal, MQTT connection string,
                               friendly name, show-on-map, heatmap
  software:mqtt              → MQTT topics (its/nodeXXX/packet/json, .../stats),
                               subscribing to own node, live-stream vs buffering,
                               why C-ITS is real-time (paho-mqtt caveats)
  software:home-assistant    → HA integration, sub-pub proxy / bridge pattern,
                               monitoring the node

reception:                   → RECEPTION & PLACEMENT
  reception:optimal-placement→ Height, line-of-sight, urban vs quiet areas
  reception:interference     → 5 GHz Wi-Fi AP interference near 5.9 GHz, filters,
                               vertical separation, front-end desensitisation
  reception:thermal          → Heat (>60 °C reports), causes, mitigation

c-its:                       → C-ITS BACKGROUND (fill c-its)
  c-its                      → What is C-ITS, message types (CAM, MAPEM, SPATEM…)
  c-its:senders              → Which vehicles/infra send C-ITS (VW/Volvo, ASFINAG
                               retrofits, trams, Car2x traffic lights, signatures)
                               
sightings:                       → SIGHTINGS / FIELD FINDINGS
  sightings                      → Landing: was gehört hier rein, wie eintragen,
                                   Legende (signatur ja/nein, OBU-only, etc.)
  sightings:at:vienna            → Wien: Trams (Linie 2, MAC, ZN/Kurs), Ampeln, …
  sightings:at:graz              → Graz: …
  sightings:de:aachen            → Aachen: …
  sightings:vehicles             → Fahrzeugmodelle die senden (Audi A5, VW-Pakete,
                                   Volvo) — modellbezogen statt ortsbezogen                               

api:                         → (fill api) map/data API, endpoints, data formats

faq                          → FAQ (see below)

community:                   → CONTRIBUTING
  community:contributing     → How to get edit rights, style, language policy
  community:order            → Group order / Pretix, pickup (realraum Graz), shipping
  
  
FAQ:

  *  What do the LEDs mean? (SYS blinking = no connection yet)
  * Does it matter which USB-C port powers it? (No — both share one +5V rail)
  * My phone won't do USB tethering — why? (Node can't emulate a NIC; use USB-Ethernet dongle + cable; enable tethering after the node is up)
  * Is there a data buffer when offline? (No — MQTT live-stream by design; only position/MAPEM are sensible cache candidates)
  * Which antennas can I use? (→ hardware:antennas)
  * Why is my node so hot? (→ reception:thermal)
  * Why is reception poor despite good height? (→ reception:interference — nearby 5 GHz APs)
  * How do I monitor my node in Home Assistant? (→ software:home-assistant)
  * PoE vs USB / jumper settings? (→ hardware:power)