Skip to content

Commit 882a7c4

Browse files
committed
docs: fix MQTT figures and add MQTT bullet to Networking wrap-up
mqtt-fanout.svg: three fan-out arrows now share a common origin at the broker's right-edge midpoint (470, 165) instead of fanning out from three nearby Y points. Arrowhead polygons on the diagonal arrows aligned perpendicular to each line's direction. The "forward" label nudged off the middle arrow line. mqtt-publish-packet.svg: shortened the top-row labels for the first three byte sections so they fit inside their byte-column widths -- "type | flags" -> "PUBLISH", "7 bytes left" -> "= 7", "topic is 3 bytes" -> "= 3". The labels were colliding horizontally in the previous version. networking/wrap-up: add a bullet for the MQTT subsection between the Encryption bullet and the closer, framing MQTT as the worked example that ties together every layer below it.
1 parent 3d4cf5f commit 882a7c4

3 files changed

Lines changed: 21 additions & 9 deletions

File tree

docs/openmvcam/tutorial/networking/mqtt/figures/mqtt-fanout.svg

Lines changed: 6 additions & 6 deletions
Loading

docs/openmvcam/tutorial/networking/mqtt/figures/mqtt-publish-packet.svg

Lines changed: 3 additions & 3 deletions
Loading

docs/openmvcam/tutorial/networking/wrap-up.rst

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,18 @@ world:
8585
DTLS (TLS over UDP) uses the same module the same
8686
way.
8787

88+
* **A real application protocol** -- MQTT as the
89+
worked example of every layer below it wired
90+
together. A 1-byte type-and-flags byte, a
91+
variable-length remaining-length field, a length-
92+
prefixed UTF-8 topic, and the payload, all
93+
travelling over TCP (and optionally inside TLS) to
94+
a broker that fans the message out to every
95+
subscriber on the topic. The bundled :mod:`mqtt`
96+
client wraps the wire format in a
97+
``connect`` / ``publish`` / ``subscribe`` API
98+
small enough to read in one sitting.
99+
88100
That is enough to write camera applications that talk
89101
to other machines, publish data to remote services,
90102
accept connections from clients on the local network,

0 commit comments

Comments
 (0)