diff --git a/docs/demos/assets/smart-home-demo-arch.png b/docs/demos/assets/smart-home-demo-arch.png
new file mode 100755
index 0000000000000000000000000000000000000000..2e94ff1c797c8c1d913e906f9fd8526f6cd98360
Binary files /dev/null and b/docs/demos/assets/smart-home-demo-arch.png differ
diff --git a/docs/demos/assets/smart-home-demo-arch.puml b/docs/demos/assets/smart-home-demo-arch.puml
new file mode 100644
index 0000000000000000000000000000000000000000..82c71a6130967b12d80fb39ba0a58046adf3a336
--- /dev/null
+++ b/docs/demos/assets/smart-home-demo-arch.puml
@@ -0,0 +1,22 @@
+' SPDX-FileCopyrightText: Huawei Inc.
+'
+' SPDX-License-Identifier: CC-BY-4.0
+
+@startuml smarthome-demo-arch
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+
+HIDE_STEREOTYPE()
+
+title SmartHome demo architecture
+
+Person(user, "User")
+System(dashboard, "Dashboard", "Home Assistant software running on Avenger96 board, interfacing with the user via a touchscreen")
+
+System_Ext(sensors_board, "Sensors board", "96Boards Nitrogen with the Sensors Mezzanine adapter and selected sensors connected")
+System_Ext(smart_bulb, "Smart bulb/LED", "96Boards Nitrogen with the Sensors Mezzanine adapter and LED connected")
+
+Rel(user, dashboard, "Uses")
+Rel_Back(dashboard, sensors_board, "Sends sensors readings", "BLE")
+Rel_Neighbor(dashboard, sensors_board, "Reads out sensors", "BLE")
+Rel(dashboard, smart_bulb, "Controls", "BLE")
+@enduml
diff --git a/docs/demos/smart-panel.rst b/docs/demos/smart-panel.rst
index 55bd52bf014c2acae6cbe2773bd7d6a3649a2ca0..81858728eaefd165c619046aa54a602903329ae3 100644
--- a/docs/demos/smart-panel.rst
+++ b/docs/demos/smart-panel.rst
@@ -20,6 +20,8 @@ HomeAssistant. The gateway also provides UI as a browser connected to the
 localhost HomeAssistant server. The gateway is connected over Bluetooth to two
 Nitrogen boards exposing sensors and/or emulating device (e.g. light bulbs).
 
+.. image:: assets/smart-home-demo-arch.png
+
 How to build
 ************