How yashu123403/iot-telemetry-embedded-linux-gateway works
This is a laptop-runnable IoT telemetry and embedded-gateway simulation. Configured sensor nodes generate synthetic scalar or GPS readings, publish telemetry and heartbeats over MQTT, and receive remote commands. Gateway ingestion validates messages and buffers them; gateway processing aggregates readings, evaluates rules, tracks device heartbeats, and persists telemetry and alerts. Operators monitor status through terminal or web dashboards. The README documents these capabilities; source excerpts do not show every internal call, so unsampled relationships are omitted.
Main entry points: gateway_app.py Gateway process · rest_api.py Web dashboard API · ingestion.py Ingestion service · main.py Runtime entry
Components 22
Simulated devices
- Fleet factory
src/sensors/fleet_factory.py - Scalar sensors
src/sensors/scalar_sensors.py - GPS sensor
src/sensors/gps_sensor.py - Fault injection
src/sensors/fault_injector.py - Sensor node
src/sensors/sensor_node.py
MQTT transport
- Wire schemas
src/protocols/schemas.py - MQTT topics
src/protocols/topics.py - MQTT client
src/protocols/mqtt_client_wrapper.py - Embedded broker
src/gateway/embedded_broker.py
Gateway processing
- Ingestion service
src/gateway/ingestion.py - Bounded buffers
src/gateway/buffer.py - Gateway process
src/gateway/gateway_app.py - Rule engine
src/gateway/rule_engine.py - Window aggregation
src/gateway/aggregator.py - Device registry
src/gateway/device_registry.py - SQLite storage
src/gateway/storage.py - System monitor
src/gateway/system_monitor.py
Monitoring interfaces
- Runtime entry
src/main.py - Web dashboard API
dashboard/rest_api.py - Terminal dashboard
dashboard/cli_dashboard.py
Other components
- Operator
- MQTT broker
Connections 35
- Runtime entry → Embedded broker: starts
src/main.py - Runtime entry → Gateway process: starts
src/main.py - Runtime entry → Fleet factory: builds fleet
src/main.py - Runtime entry → Web dashboard API: starts
src/main.py - Runtime entry → Terminal dashboard: selects
README.md - Fleet factory → Scalar sensors: constructs
src/sensors/fleet_factory.py - Fleet factory → GPS sensor: constructs
src/sensors/fleet_factory.py - Fleet factory → Fault injection: configures
src/sensors/fleet_factory.py - Fleet factory → Sensor node: constructs
src/sensors/fleet_factory.py - Scalar sensors → Fault injection: uses
- GPS sensor → Fault injection: uses
src/sensors/gps_sensor.py - Sensor node → Wire schemas: creates messages
src/sensors/sensor_node.py - Sensor node → MQTT topics: publishes on
src/sensors/sensor_node.py - Sensor node → MQTT client: publishes through
src/sensors/sensor_node.py - MQTT client → MQTT broker: connects
README.md - Embedded broker → MQTT broker: hosts
README.md - Ingestion service → MQTT client: subscribes through
src/gateway/ingestion.py - Ingestion service → Wire schemas: validates
src/gateway/ingestion.py - Ingestion service → MQTT topics: subscribes to
src/gateway/ingestion.py - Ingestion service → Bounded buffers: pushes messages
src/gateway/ingestion.py - Gateway process → Ingestion service: starts
src/gateway/gateway_app.py - Gateway process → Bounded buffers: drains
src/gateway/gateway_app.py - Gateway process → Rule engine: evaluates readings
src/gateway/gateway_app.py - Gateway process → Window aggregation: adds samples
src/gateway/gateway_app.py - Gateway process → Device registry: records heartbeats
src/gateway/gateway_app.py - Gateway process → SQLite storage: persists results
src/gateway/gateway_app.py - Gateway process → System monitor: reports resources
src/gateway/gateway_app.py - Web dashboard API → Gateway process: reads status
dashboard/rest_api.py - Web dashboard API → Device registry: reads devices
dashboard/rest_api.py - Web dashboard API → SQLite storage: reads recent data
dashboard/rest_api.py - Web dashboard API → Window aggregation: reads aggregates
dashboard/rest_api.py - Web dashboard API → Ingestion service: sends commands
dashboard/rest_api.py - Terminal dashboard → Gateway process: displays status
dashboard/cli_dashboard.py - Operator → Web dashboard API: monitors
README.md - Operator → Terminal dashboard: monitors
README.md