first draft of workshop presentation

docs/workshop/README.md

@@ -2,12 +2,188 @@
 marp: true
 ---
 
-# IoT Prototype
+# Fab City Dashboard
 
-Start writing!
+This is a prototype of data management platform for Fab City Hamburg based on existing open source solutions.
+
+![](https://code.curious.bio/curious.bio/iot-backend/raw/branch/main/docs/workshop/images/architecure.svg)
 
 ---
 
-# Next slide
+# Features
+
+* Eclipse Mosquitto: MQTT broker
+* Node-RED: Flow-based development tool for visual programming and data flow automation
+* InfluxDB: High-performance data storage
+* Grafana: Real-time data visualization and monitoring dashboard
+
+---
+
+# Today's Goal
+
+* install the stack
+* configure one or two data sources
+* transform data and store them in a database
+* visualize data stored in the database
+
+--- 
+
+# Architecture
+
+* Data is collected by IoT devices, e.g. an ESP32 based power monitor. These devices publish their data via MQTT into a topic in a message broker. We use Eclipse Mosquitto as a MQTT message broker.
+
+* Node-RED is used to read and transform or combine data and to implement more sophicsticated use cases like notifications or worksflow. Node-RED subscribes to topics in Mosquitto and can be used to save transformed data into a database.
+
+* As our data is bases on time, we are using a time series database to store information. We used InfluxDB as this database.
+
+* Dashboards can already be created in Node-RED, but to be more flexible (and include more options) we are using Grafana. Grafana reads data from our database and other sources (like CSV files on the Internet) and displays them in a nice dashboard.
+
+
+---
+
+# Sensor level: Physical acquisition of measured values
+
+Sensors can be build or bought:
+
+* Sensor head
+    * ESP32 or equivalent
+    * OpenHardware or COTS (commercially of the self)
+    * Analog/Digital acquisition
+    * Communication gateway via WLAN / MQTT 
+
+* Examples measurements
+     * Energy measurement
+     * Temperature sensor -> temperature measurement
+     * Pulse sensor -> incremental measurement of filament
+
+
+---
+
+# Example sensor - Open Engergy Montior
+
+![](https://code.curious.bio/curious.bio/smart-energy-monitor/media/branch/main/docs/images/breadboard.png)
+![](https://code.curious.bio/curious.bio/smart-energy-monitor/media/branch/main/docs/images/clamp1.jpeg)
+
+---
+
+# Example sensor - Shelly Plug 
+![](https://code.curious.bio/curious.bio/smart-energy-monitor/media/branch/main/docs/images/shelly_plug_s_1-1.jpg)
+
+---
+
+# Example sensor - GCode Sender
+![](https://pad.fabcity.hamburg/uploads/586181bc-6de2-46b8-9eba-8a11fbb59a5f.png)
+
+---
+
+# MQTT (Message Queuing Telemetry Transport)
+
+* publish-subscribe, machine to machine network protocol 
+* designed for connections with remote locations  
+    * devices with resource constraints 
+    * limited network bandwidth
+    * Internet of Things (IoT)
+* runs on top of TCP/IP, QUIC (UDP) or Bluetooth
+
+
+---
+
+# MQTT - Components
+
+* one message broker (Mosquito) and many clients
+* broker receives published messages from clients
+* routes them to subcribed clients 
+* clients subscribe to topic patterns
+
+![](https://upload.wikimedia.org/wikipedia/commons/8/82/MQTT_protocol_example_without_QoS.svg)
+
+
+---
+
+# Flow - Node-RED
+
+The idea behind it is to make it very easy to connect APIs, hardware devices, and anything else accessible over some type of network connection.
+
+![](https://nodered.org/images/nr-image-1.png)
+* open-source
+* low-code
+* visual programming tool
+* flow-based development
+
+---
+
+# Node-RED - Core Concepts
+
+Nodes are the important part of Node-Red. 
+
+*  are triggered by either receiving a message object from a previous node or an external event like an MQTT event 
+*  processes the message or event and then passes it on to the next node
+
+A node can:
+
+* Inject: Starts a flow by injecting a message or a payload.
+* Change: Here you can do basic transformation or modification on the message object.
+* Debug: Can be used to help developing flows by sending messages to the side bar.
+* Switch: Here you can add logic (like sending the message to different nodes).
+* Function: Add custom JavaScript for uses cases where simple nodes do not do the trick.
+
+---
+
+# Node-RED - Plugins
+
+Node-RED uses plugins:
+
+* extend functionality (like dashboard)
+* connectors (like influxdb)
+* libraries (like aggregating watts and traosnform them to khw)
+
+---
+
+# Node-RED - Simple Flow
+
+![](https://code.curious.bio/curious.bio/iot-backend/media/branch/main/docs/flow/docs/images/influx-flow.png)
+
+---
+
+# Database - InfluxDB
+
+InfluxDB is a database for any time series data.
+
+![](https://code.curious.bio/curious.bio/iot-backend/media/branch/main/docs/flow/docs/images/influx-data-explorer.png)
+
+---
+
+# Dashboard - Grafana
+
+Grafana is an open source analytics and interactive visualization tool. 
+
+* charts
+* graphs
+* alerts for the web when connected to supported data sources.
+
+As a visualization tool, Grafana is a popular component in monitoring stacks, often used in combination with time series databases such as InfluxDB.
+
+---
+
+# Dashboard - Example
  
-And this will be the next slide.
+![](https://code.curious.bio/curious.bio/iot-backend/raw/branch/main/docs/workshop/images/sampledashboard.png)
+
+
+---
+
+# Let's start
+
+* Check installation of
+    * 64bit environment (AMD64, ARM64)
+    * Docker
+    * Docker-Compose
+* Checkout the repository: 
+    * https://code.curious.bio/curious.bio/iot-backend
+* Let's follow the README, together
+
+---
+
+# Where can I find this presentation?
+
+* https://code.curious.bio/curious.bio/iot-backend/src/branch/main/docs/workshop