IoT Architecture Diagram Generator
Quick Start: Select device/sensor icons → Place edge gateways → Connect to cloud services → Group into zones → Wrap in ``` `plantuml ``` fence.
⚠️ IMPORTANT: Always use ``` `plantuml `` or `` `puml `` code fence. NEVER use `` `text ``` — it will NOT render as a diagram.
Critical Rules
- Every diagram starts with
@startuml and ends with @enduml - Use
left to right direction for typical IoT data flows (Device → Edge → Cloud) - Use
mxgraph.aws4.* stencil syntax for IoT service and device icons - Default colors are applied automatically — you do NOT need to specify
fillColor or strokeColor - Use
rectangle "Zone" {...} or package "Site" {...} for grouping - Directed flows use
-->, async/event-driven flows use ..> (dashed)
Full stencil reference: See stencils/README.md for 9500+ available icons.
Mxgraph Stencil Syntax
mxgraph.aws4.<icon> "Label" as <alias>
Core IoT Stencils
| Category | Stencils | Purpose |
|---|
| IoT Platform | iot_core, internet_of_things, iot_1click | Central IoT hub / message broker |
| Edge/Gateway | greengrass, iot_device_gateway, freertos, iot_expresslink | Edge computing & device gateway |
| Greengrass | iot_greengrass_component, iot_greengrass_nucleus, iot_greengrass_stream_manager | Edge runtime components |
| Device Mgmt | iot_device_management, iot_device_defender, iot_device_tester, iot_over_the_air_update | Fleet provisioning, security, OTA |
| Analytics | iot_analytics, iot_analytics_channel, iot_analytics_pipeline, iot_analytics_dataset, iot_analytics_data_store | IoT data processing pipeline |
| Events/Rules | iot_events, iot_device_defender_iot_device_jobs | Event detection & job execution |
| Digital Twin | iot_twinmaker, iot_sitewise, iot_sitewise_asset, iot_sitewise_asset_model | Asset modeling & visualization |
| Fleet | iot_fleetwise, iot_device_management_fleet | Vehicle & device fleet telemetry |
Device & Sensor Stencils
| Category | Stencils |
|---|
| Sensors | sensor, iot_thing_temperature_sensor, iot_thing_humidity_sensor, iot_thing_vibration_sensor, iot_thing_temperature_humidity_sensor, iot_thing_temperature_vibration_sensor |
| Actuators | actuator, iot_thing_relay, iot_thing_stacklight |
| Industrial | factory, iot_thing_industrial_pc, iot_thing_plc |
| Smart Home | thermostat, alexa_enabled_device, alexa_smart_home_skill, camera, camera2 |
| Protocols | mqtt_protocol, iot_lorawan_protocol, iot_greengrass_protocol |
| Boats/Vehicles | iot_sailboat, iot_fleetwise |
| Robotics | robomaker, iot_roborunner |
Connection Types
| Syntax | Meaning | Use Case |
|---|
A --> B | Solid arrow | Sync API / data flow |
A..> B | Dashed arrow | Async telemetry / MQTT publish |
A -- B | Solid line | Physical / bidirectional link |
A --> B: "label" | Labeled connection | Describe protocol or data |
Quick Example
@startuml
left to right direction
rectangle "Factory Floor" {
mxgraph.aws4.sensor "Temp\nSensor" as s1
mxgraph.aws4.iot_thing_plc "PLC" as plc
}
mxgraph.aws4.greengrass "Greengrass\nEdge" as gg
mxgraph.aws4.iot_core "IoT Core" as core
mxgraph.aws4.iot_analytics "IoT\nAnalytics" as analytics
s1 --> gg : MQTT
plc --> gg
gg --> core
core --> analytics
@enduml
IoT Architecture Types
| Type | Purpose | Key Stencils | Example |
|---|
| Smart Factory | Industrial IoT monitoring | sensor, iot_thing_plc, greengrass, iot_sitewise | smart-factory.md |
| Smart Home | Home automation | thermostat, alexa_enabled_device, camera, iot_core | smart-home.md |
| Fleet Telemetry | Vehicle fleet tracking | iot_fleetwise, iot_core, iot_analytics | fleet-telemetry.md |
| Edge Computing | Local processing at edge | greengrass, freertos, iot_greengrass_component | edge-computing.md |
| Digital Twin | Asset modeling & simulation | iot_twinmaker, iot_sitewise_asset_model, iot_sitewise | digital-twin.md |
| Sensor Network | Distributed sensor mesh | sensor, iot_lorawan_protocol, iot_device_gateway | sensor-network.md |
| Device Management | Fleet provisioning & OTA | iot_device_management, iot_device_defender, iot_over_the_air_update | device-management.md |
| Robotics | Robot fleet orchestration | robomaker, iot_roborunner, greengrass | robotics.md |
