Merge pull request #48 from KasunThushara/main

Update: hailo and thingsboard car park demo

Author: KasunThushara

articles/Chapter_6-RaspberryPi_and_AIoT/Car_Park_Solution_Management_with_Thingsboard.md

@@ -82,10 +82,10 @@ class user_app_callback_class(app_callback_class):
 # -----------------------------------------------------------------------------------------------
 # MQTT Setup
 # -----------------------------------------------------------------------------------------------
-BROKER = "192.168.8.195"  # Replace with your MQTT broker's IP address
-CLIENT_ID = "Car_Park"
+BROKER = "192.168.8.195"  # ThingsBoard Host-Name 
+CLIENT_ID = "Car_Park" # The Client ID which you give in the Thingsboard End 
 PORT = 1883
-TOPIC = "v1/devices/me/telemetry"  # Adjust to match your topic
+TOPIC = "v1/devices/me/telemetry"  # Topic For Sending data to ThingsBoard 
 
 mqtt_client = mqtt.Client(CLIENT_ID)
 
@@ -140,19 +140,106 @@ if __name__ == "__main__":
 
 ## Step 4: Install ThingsBoard and Add a Device
 
-[ThingsBoard](https://thingsboard.io/) is an open-source IoT platform designed for device management, data collection, processing, and visualization. It supports various communication protocols such as **MQTT, CoAP, and HTTP**, making it versatile for integrating IoT devices and systems. The platform enables users to **create interactive dashboards, monitor devices in real-time, and analyze data through advanced visualization tools. With its rule engine, ThingsBoard automates workflows and event processing**, simplifying the implementation of IoT use cases across industries. Its scalability and flexibility make it suitable for projects of any size, from small prototypes to large-scale deployments.
+[ThingsBoard](https://thingsboard.io/) is an open-source IoT platform designed for device management, data collection, processing, and visualization. It supports various communication protocols such as **MQTT, CoAP, and HTTP**, making it versatile for integrating IoT devices and systems. The platform enables users to **create interactive dashboards, monitor devices in real-time, and analyze data through advanced visualization tools. With its rule engine, ThingsBoard automates workflows and event processing**, simplifying the implementation of IoT use cases across industries. Its scalability and flexibility make it suitable for projects of any size, from small prototypes to large-scale deployments.Additionally, you can use their [cloud solution](https://thingsboard.io/products/paas/) for easier deployment and management.
+
+
 
 We have provided instructions on [installing the ThingsBoard Community Edition](https://wiki.seeedstudio.com/recomputer_r1000_thingsboard_ce/) and the Edge version. You can refer to this wiki lesson for guidance.
 
-After installing ThingsBoard, you need to add a device. [This lesson](https://wiki.seeedstudio.com/recomputer_r1000_thingsboard_dashboard/) also explains how to create widgets and build dashboards using MQTT credentials. When adding a device, specify the client name in the device configuration and ensure the client name and broker settings in the above code match your ThingsBoard platform configuration.
 
-Since this is a demo, **we have not added a username or password when creating the device**.
+## Step 5: Provision a Device
+
+1. Navigate to the **Devices** page under the **Entities** section.
+
+![tb1](../../pictures/Chapter6/tb1.png)
+
+2. Click the **'+'** icon in the top right corner of the table and select **'Add new device'** from the drop-down menu.
+
+![tb2](../../pictures/Chapter6/tb2.png)
+
+3. Enter the **device name**, **Client ID**, **Password**, and **Username**. 
+Since this is a demo, we have not added a username or password when creating the device.
+
+4. Click **Add**.
+
+![tb3](../../pictures/Chapter6/tb3.png)
+
+5. As you add more devices, they will appear at the top of the table. The table automatically sorts devices by creation time, with the newest ones listed first.
+
+![tb5](../../pictures/Chapter6/tb5.png)
+
+
+## Step 6: Connect the Device
+
+1. Click on your device and then click the **Check connectivity** button in the **Device details** window.
+![tb6](../../pictures/Chapter6/tb6.png)
+
+2. In the opened window, select the messaging protocol and your operating system:
+   - **Operating System:** Linux
+   - **Protocol:** MQTT
+
+![tb7](../../pictures/Chapter6/tb7.png)
+
+3. Make sure to install the required client tools.
+4. Execute the copied command. Once the temperature readings are published successfully, the device state will change from **"Inactive"** to **"Active"**. You will also see the published temperature readings.
+
+![tb8](../../pictures/Chapter6/tb8.png)
+
+## Run the Code
 
 ```bash
-BROKER = "192.168.8.195"  # Replace with your MQTT broker's IP address
-CLIENT_ID = "Car_Park"     # Replace with your client ID
+cd hailo-rpi5-examples
+
+source setup_env.sh
+
+cd basic_pipelines
+
+python park_object_detection.py --labels-json /home/pi/Desktop/hailo-custom/config.json --hef-path /home/pi/Desktop/hailo-custom/yolov8n_renamed_carpark.hef -i /dev/video0
 ```
 
+## Create a Dashboard
+### Create an Empty Dashboard
+1. Navigate to the Dashboards page from the main menu on the left side of the screen.
+
+
+2. Click the `+` sign in the upper right corner of the screen and select 'Create new dashboard' from the drop-down menu.
+![tb9](../../pictures/Chapter6/tb9.png)
+3. In the dialog box, enter a title for the dashboard (the description is optional).
+
+4. Click Add.
+![tb10](../../pictures/Chapter6/tb10.png)
+5. After creating the dashboard, it will open automatically, and you can start adding widgets.
+6. To save the dashboard, click the Save button in the upper right corner.
+![tb11](../../pictures/Chapter6/tb11.png)
+
+7. Your first dashboard is now created. As you add more dashboards, they will appear at the top of the list, sorted by the creation timestamp.
+
+![tb12](../../pictures/Chapter6/tb12.png)
+
+
+
+## Add a Chart Widget
+1. Enter edit mode and click the `Add new widget` button at the top of the screen.
+![tb13](../../pictures/Chapter6/tb13.png)
+![tb14](../../pictures/Chapter6/tb14.png)
+
+2. Find the `Charts` widget bundle and click on it.
+![tb15](../../pictures/Chapter6/tb15.png)
+
+3. Select the `Time series chart` widget.
+![tb16](../../pictures/Chapter6/tb16.png)
+
+4. In the `Device` field, specify the device you created earlier as the data source.
+5. In the `Series` section, enter the data key `Available`,`Park`,`Improper` to monitor the car park related values of a device.
+![tb16](../../pictures/Chapter6/tb_chart.png)
+
+6. Resize the widget and apply the changes.
+7. Click Add.
+
+You can explore additional [dashboard widgets](https://thingsboard.io/docs/user-guide/dashboards/) in the system.
+
+
+
 ## Demo 
 
 ![demo](../../pictures/Chapter6/demo-thingsboard.gif)