Make documentation standalone and generalize examples

This commit is contained in:
Melvin Strobl
2026-10-25 14:43:20 +01:00
parent 13bf0f76d7
commit bdb18b99da
57 changed files with 553 additions and 481 deletions
+10 -10
View File
@@ -501,13 +501,13 @@ start and renames the file `panels.json.migrated`.
### A screen without a browser
The openpanel firmware, kept in its own repository, draws dashboards as native
widgets on an ESP32-P4 wall panel (Waveshare ESP32-P4-WIFI6-Touch-LCD-7B,
1024×600). Once its config page points it at this instance (the device's link
works too, the device keeps only its address), it shows the pairing code itself; enter it as in step 5. It reads the same published
dashboards and live values and draws every widget type with two exceptions,
both shown as a placeholder: a website tile that embeds a page (image tiles
work), and a chart of runs, which a device credential may not read. Media tiles
Compatible device firmware can draw dashboards as native widgets without a
browser. For example, openpanel supports ESP32-P4 wall panels. Once its
config page points it at this instance, it shows a pairing code; enter it as
in step 5. The device's link works too, since the device keeps only the
instance address. It reads the same published dashboards and live values.
Embedded website tiles and run charts show placeholders; image tiles work,
and device credentials cannot read runs. Media tiles
play MJPEG streams, pushed frames, images, and H.264 Baseline or MJPEG clips up
to 640×360. Re-encode other clips with the [clip recipe](../code/nodes.md#making-clips-playable-on-an-lvgl-panel).
@@ -625,9 +625,9 @@ A camera device (openpanel on a NANO) reports these ports:
dashboard tile, the preview on the device's page, a screen through the
portal), or a node of a running flow reads its message. Once its flow wires
`camera`, the device's page shows a **Camera** preview. A flow that reads
`camera` keeps it sending all the time, about 300 GB a month through a cloud
instance, so the Device node warns when a node in its flow reads a port that
sends on demand. Have flows read `snapshot` or `person` instead. To keep the
`camera` keeps it sending continuously. Traffic depends on resolution, frame
rate and image quality, so the Device node warns when a flow node reads an
on-demand port. For occasional updates, read `snapshot` or `person`. To keep the
picture of whoever came by, a node reading `snapshot` can hand it on to a
message of its own, which a media tile shows until the next one: