├── .gitignore
├── README.md
├── Images
    ├── images
    │   ├── MWT Logo.png
    │   └── post_box_node_red.png
    └── thumbnails
    │   ├── HABB.png
    │   ├── GROVE3.png
    │   ├── kiosk.png
    │   ├── AlexaPt2.png
    │   ├── BrizeBox.png
    │   ├── 3tvnotifications.png
    │   └── Smart Desk Controller 5.png
├── Home Assistant Button Box
    ├── Diagrams
    │   ├── habb diagram.png
    │   └── ESP32-Pinout.webp
    ├── Enclosure Files
    │   ├── MWT H.A.B.B.3mf
    │   └── MWT Taller Button Box.stl
    ├── README.md
    └── MWT HABB.yaml
├── HOW TO - DIY Smart Desk Controller
    ├── MWT Desk Mount.STL
    ├── Diagrams
    │   ├── ESP32-Pinout.webp
    │   ├── Desk Controller Diagram.png
    │   └── Nextion to FT232 Pinout.jpg
    ├── Nextion Files
    │   ├── MWTController.HMI
    │   ├── MWTController.tft
    │   └── Images
    │   │   ├── Layer 1.png
    │   │   ├── Layer 2.png
    │   │   ├── Layer 3.png
    │   │   ├── Layer 4.png
    │   │   ├── Layer 5.png
    │   │   ├── Layer 6.png
    │   │   ├── desk one.png
    │   │   ├── desk two.png
    │   │   ├── desk up.png
    │   │   ├── desk down.png
    │   │   ├── desk four.png
    │   │   ├── desk stop.png
    │   │   ├── desk three.png
    │   │   ├── Bulb Black on.png
    │   │   ├── Home Black On.png
    │   │   ├── desk up black.png
    │   │   ├── Bulb Black Off.png
    │   │   ├── desk down black.png
    │   │   └── Large Light Black On.png
    ├── README.md
    └── DeskController.yaml
├── Smart Post Box Notifications (Part 1)
    └── README.md
├── ALEXA in HOME ASSISTANT (Part 2)
    └── README.md
├── 3 TV Automations YOU NEED!
    └── README.md
├── Creating a Smart Post Box (Part 1 - Notifications)
    └── README.md
├── A DIY Home Assistant Kiosk
    └── README.md
└── VPE Grove Port Sensors
    └── README.md


/.gitignore:
--------------------------------------------------------------------------------
1 | *.bak
2 | Patreon Uploads
3 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # MarkWattTech-Tutorials
2 | A Collection of Code from Various MarkWattTech Videos
3 | 


--------------------------------------------------------------------------------
/Images/images/MWT Logo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/images/MWT Logo.png


--------------------------------------------------------------------------------
/Images/thumbnails/HABB.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/HABB.png


--------------------------------------------------------------------------------
/Images/thumbnails/GROVE3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/GROVE3.png


--------------------------------------------------------------------------------
/Images/thumbnails/kiosk.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/kiosk.png


--------------------------------------------------------------------------------
/Images/thumbnails/AlexaPt2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/AlexaPt2.png


--------------------------------------------------------------------------------
/Images/thumbnails/BrizeBox.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/BrizeBox.png


--------------------------------------------------------------------------------
/Images/images/post_box_node_red.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/images/post_box_node_red.png


--------------------------------------------------------------------------------
/Images/thumbnails/3tvnotifications.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/3tvnotifications.png


--------------------------------------------------------------------------------
/Images/thumbnails/Smart Desk Controller 5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Images/thumbnails/Smart Desk Controller 5.png


--------------------------------------------------------------------------------
/Home Assistant Button Box/Diagrams/habb diagram.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Home Assistant Button Box/Diagrams/habb diagram.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/MWT Desk Mount.STL:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/MWT Desk Mount.STL


--------------------------------------------------------------------------------
/Home Assistant Button Box/Diagrams/ESP32-Pinout.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Home Assistant Button Box/Diagrams/ESP32-Pinout.webp


--------------------------------------------------------------------------------
/Home Assistant Button Box/Enclosure Files/MWT H.A.B.B.3mf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Home Assistant Button Box/Enclosure Files/MWT H.A.B.B.3mf


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Diagrams/ESP32-Pinout.webp:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Diagrams/ESP32-Pinout.webp


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/MWTController.HMI:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/MWTController.HMI


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/MWTController.tft:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/MWTController.tft


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 1.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 1.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 2.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 2.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 3.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 3.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 4.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 4.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 5.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 5.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 6.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Layer 6.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk one.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk one.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk two.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk two.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk up.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk up.png


--------------------------------------------------------------------------------
/Home Assistant Button Box/Enclosure Files/MWT Taller Button Box.stl:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/Home Assistant Button Box/Enclosure Files/MWT Taller Button Box.stl


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Diagrams/Desk Controller Diagram.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Diagrams/Desk Controller Diagram.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Diagrams/Nextion to FT232 Pinout.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Diagrams/Nextion to FT232 Pinout.jpg


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk down.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk down.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk four.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk four.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk stop.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk stop.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk three.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk three.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Bulb Black on.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Bulb Black on.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Home Black On.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Home Black On.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk up black.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk up black.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Bulb Black Off.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Bulb Black Off.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk down black.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/desk down black.png


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Large Light Black On.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/MarkWattTech/MarkWattTech-Tutorials/HEAD/HOW TO - DIY Smart Desk Controller/Nextion Files/Images/Large Light Black On.png


--------------------------------------------------------------------------------
/Smart Post Box Notifications (Part 1)/README.md:
--------------------------------------------------------------------------------
 1 |   <br>
 2 |   <h1 align="center">Creating a Smart Post Box (Part 1 - Notifications)</h1>
 3 |   <br>
 4 |  <h2 align="center">
 5 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/AlexaPt2.png" width="500">
 6 |   </br>
 7 |                                                                                                                                           
 8 | <p>This is the first video in my Smart Post Box Mini series. In this video I am adding some sensors to the Brizebox Post Box to allow it to notify me when I have post.<a href="https://youtu.be/M3-m2fDttmg" target="_blank">Here</a></p> 
 9 | </h2>	
10 | 
11 | 
12 | `TTS Notification` - A small example that will play the message on a targeted device
13 | ``` yaml
14 | # TTS Notification
15 | service: notify.alexa_media_office_desk_sonos
16 | data:
17 |   data:
18 |     type: tts
19 |   message: Hey
20 | ```
21 | 
22 | </br>
23 | 
24 | 


--------------------------------------------------------------------------------
/ALEXA in HOME ASSISTANT (Part 2)/README.md:
--------------------------------------------------------------------------------
 1 |   <br>
 2 |   <h1 align="center">ALEXA in HOME ASSISTANT (Part 2)</h1>
 3 |   <br>
 4 |  <h2 align="center">
 5 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/AlexaPt2.png" width="500">
 6 |   </br>
 7 |                                                                                                                                           
 8 | <p>In this one we are focusing on all the "SOUND" things that I utilise. Check the video out <a href="https://youtu.be/M3-m2fDttmg" target="_blank">Here</a></p> 
 9 | </h2>	
10 | 
11 | 
12 | `TTS Notification` - A small example that will play the message on a targeted device
13 | ``` yaml
14 | # TTS Notification
15 | service: notify.alexa_media_office_desk_sonos
16 | data:
17 |   data:
18 |     type: tts
19 |   message: Hey
20 | ```
21 | 
22 | </br>
23 | 
24 | `Sequence` - A small example that will play a preset sequence on a targeted device
25 | ``` yaml
26 | # SEQUENCE
27 | service: media_player.play_media
28 | data:
29 |   media_content_type: sequence
30 |   media_content_id: Alexa.Joke.Play
31 | target:
32 |   entity_id: media_player.office_desk_sonos
33 | ```
34 | </br>
35 | 
36 | `Sound` - A small example that will play a sound effect on a targeted device
37 | ``` yaml
38 | # SOUND
39 | service: media_player.play_media
40 | data:
41 |   media_content_type: sound
42 |   media_content_id: amzn_sfx_doorbell_chime_01
43 | target:
44 |   entity_id: media_player.office_desk_sonos
45 | ```
46 | 
47 | </br>
48 | 
49 | `Sound (Dev Sounds)` - A small example that will play one of the dev sound effects on a targeted device
50 | ``` yaml
51 | # DEV SOUND
52 | service: notify.alexa_media_office_desk_sonos
53 | data:
54 |   message: <audio src="soundbank://soundlibrary/doors/doors_glass/glass_02"/>
55 |   data:
56 |     type: tts
57 |  ```   
58 | </br>
59 | 
60 | `Custom MP3` - A small example that allow you to play a custom Alexa Converted Mp3 on a Nabu Casa Hosted HA
61 | ``` yaml
62 | # CUSTOM Mp3
63 | service: notify.alexa_media_office_desk_sonos
64 | data:
65 |   message: >-
66 |     <audio
67 |     src='https://yourURL.ui.nabu.casa/local/mp3/potato.mp3'/>
68 |   data:
69 |     type: tts
70 | ```
71 | 
72 | </br>
73 | 
74 | `Announcement` - A small example will give you an idea of how to use Announcements
75 | ``` yaml
76 | # ANNOUNCEMENT
77 | service: notify.alexa_media
78 | data:
79 |   message: hello
80 |   target: media_player.all_echos
81 |   data:
82 |     type: announce
83 | ```
84 | 


--------------------------------------------------------------------------------
/3 TV Automations YOU NEED!/README.md:
--------------------------------------------------------------------------------
 1 |   <br>
 2 |   <h1 align="center">3 TV Automations YOU NEED!</h1>
 3 |   <br>
 4 |  <h2 align="center">
 5 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/3tvnotifications.png" width="500">
 6 |   </br>
 7 |                                                                                                                                           
 8 | <p>In this one I show you 3 TV based automations that I utilise in my personal setup. Check the video out <a href="https://youtu.be/PCNm-UypO5o" target="_blank">Here</a></p> 
 9 | </h2>	
10 | 
11 | <h2> ADB Command for Netflix </h2>
12 | 
13 | `ADB Command Play Video On Netflix` - This script will play a targeted program on Netflix
14 | ``` yaml
15 | # Play Peppa Pig on Netflix
16 | alias: Shield TV Play Peppa
17 | sequence:
18 |   - service: androidtv.adb_command
19 |     data:
20 |       command: >-
21 |         input keyevent MENU && am start -n com.netflix.ninja/.MainActivity  -a
22 |         android.intent.action.VIEW -d https://www.netflix.com/watch/{PROGRAM-ID} -f
23 |         0x10808000 -e source 30 && input keyevent 23 && input keyevent 23 &&
24 |         input keyevent 23
25 |     target:
26 |       entity_id: media_player.android_tv_192_168_0_104
27 | mode: single
28 | 
29 | # E.g. ID - 80025592 = Peppa Pig. Change {PROGRAM-ID} to your chosen ID
30 | 
31 | ```
32 | 
33 | `Copy Just The Command`
34 | ``` yaml
35 |         input keyevent MENU && am start -n com.netflix.ninja/.MainActivity  -a
36 |         android.intent.action.VIEW -d https://www.netflix.com/watch/{PROGRAM-ID} -f
37 |         0x10808000 -e source 30 && input keyevent 23 && input keyevent 23 &&
38 |         input keyevent 23
39 | ```
40 | </br>
41 | 
42 | <h2> ADB Command for Disney Plus </h2>
43 | 
44 | `ADB Command Play Bluey on Disney Plus` - A small script to play Bluey on Disney Plus
45 | ``` yaml
46 | # Play Bluey on Disney Plus
47 | alias: Shield TV Play Bluey
48 | sequence:
49 |   - service: androidtv.adb_command
50 |     data:
51 |       command: >-
52 |         input keyevent MENU &&  am start -a
53 |         "android.search.action.GLOBAL_SEARCH" --es query "play bluey on disney
54 |         plus" -e source 30 && input keyevent 23 && input keyevent 23 && input
55 |         keyevent 23
56 |     target:
57 |       entity_id: media_player.android_tv_192_168_0_104
58 |   - delay:
59 |       hours: 0
60 |       minutes: 0
61 |       seconds: 2
62 |       milliseconds: 0
63 |   - service: androidtv.adb_command
64 |     data:
65 |       command: input keyevent 23
66 |     target:
67 |       entity_id: media_player.android_tv_192_168_0_104
68 | mode: single
69 | # You can replace "Play Bluey on Disney Plus" with anything you want to launch. E.g "Show me Eufy Cameras", "Open MarkWattTech on YouTube"
70 | ```
71 | 
72 | `Copy Just The Command`
73 | ``` yaml
74 |         input keyevent MENU &&  am start -a
75 |         "android.search.action.GLOBAL_SEARCH" --es query "play bluey on disney
76 |         plus" -e source 30 && input keyevent 23 && input keyevent 23 && input
77 |         keyevent 23
78 | ```
79 | </br>
80 | <h2> Find TV Remote Command </h2>
81 | </br>
82 | 
83 | `Copy Just The Command`
84 | ``` yaml
85 |         am start -a android.intent.action.VIEW -d -n com.nvidia.remotelocator/.ShieldRemoteLocatorActivity
86 | ```
87 | 


--------------------------------------------------------------------------------
/Creating a Smart Post Box (Part 1 - Notifications)/README.md:
--------------------------------------------------------------------------------
  1 |   <br>
  2 |   <h1 align="center">Building a Smart Post Box (Notifications)</h1>
  3 |   <br>
  4 |  <h2 align="center">
  5 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/BrizeBox.png" width="500">
  6 |   </br>
  7 |                                                                                                                                           
  8 | <p>This is the first video in my Smart Post Box Mini series. In this video I am adding some sensors to the Brizebox Post Box to allow it to notify me when I have post. Watch the full video <a href="" target="_blank">Here</a></p> 
  9 | </h2>	
 10 | 
 11 | <p> My post box has two methods for receiving post : </p>
 12 |  <ul>
 13 |   <li>Letterbox</li>
 14 |   <li>Mail draw</li>
 15 | </ul>
 16 |     <p>The only way to get the post out of the box is via the locked backdoor (Brizebox doors are reversible so it can be on the front if you wish).</p>
 17 |  <p> The simplest soloution I had was to attatch contact sensors to each three openings (letterbox, mail draw, backdoor). This allows me to then detect which input is open. I created a toggle helper entity called "<b>Post to Collect</b>". This acts as a switch to tell me if there is any post to collect.</p>
 18 |  
 19 |  <p> Opening the letterbox or mail draw runs an automation that turns the <b>Post to collect</b> boolean on. This signals there is post to be collected.</p>
 20 |  
 21 | 
 22 | `Turn on Post to Collect` - An automation to turn on the post to collect boolean if the letterbox or mail draw is opened
 23 | ``` yaml
 24 | # Post Box Mail Draw Opened
 25 | mode: single
 26 | trigger:
 27 |   - platform: state
 28 |     entity_id:
 29 |       - binary_sensor.post_box_maildraw_contact
 30 |     to: "on"
 31 | condition: []
 32 | action:
 33 |   - service: input_boolean.turn_on
 34 |     data: {}
 35 |     target:
 36 |       entity_id: input_boolean.post_to_collect
 37 | 
 38 | # Post Box Letterbox Opened
 39 | mode: single
 40 | trigger:
 41 |   - platform: state
 42 |     entity_id:
 43 |       - binary_sensor.post_box_letter_contact
 44 |     to: "on"
 45 | condition: []
 46 | action:
 47 |   - service: input_boolean.turn_on
 48 |     data: {}
 49 |     target:
 50 |       entity_id: input_boolean.post_to_collect
 51 | ```
 52 | </br>
 53 | 
 54 | <p> Since creating the video I have opted to move post box notifications into a node red flow to make them visually easier to see.</p>
 55 | </br>
 56 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/images/post_box_node_red.png" width="500">
 57 | </br>
 58 | 
 59 | 
 60 | `Announcements for Mail` - An automation to send a series of announcements/notifications in parallel on mail delivery
 61 | 
 62 | ``` yaml
 63 | # Announcements for mail
 64 | alias: You have mail announcement
 65 | description: ""
 66 | trigger:
 67 |   - platform: state
 68 |     entity_id:
 69 |       - input_boolean.post_to_collect
 70 |     to: "on"
 71 | condition: []
 72 | action:
 73 |   - service: notify.mobile_app_marks_iphone
 74 |     data:
 75 |       message: There's some post waiting for you.
 76 |       title: You have mail!
 77 |   - service: tts.cloud_say
 78 |     data:
 79 |       entity_id: media_player.kitchen_sonos
 80 |       message: "Congratulations, you have mail! "
 81 |   - service: notify.mobile_app_rachels_iphone_11pro_2
 82 |     data:
 83 |       message: >-
 84 |         You have some post to collect from the outside postbox. Maybe you could
 85 |         collect it? 
 86 |       title: You have Post!
 87 |   - service: notify.marks_lametric
 88 |     data:
 89 |       message: There's Post in the Postbox!
 90 |       data:
 91 |         icon: "2659"
 92 |         sound: positive2
 93 |         cycles: 0
 94 | mode: parallel
 95 | max: 10
 96 | ```
 97 | </br>
 98 | <h2> Post Box Wall Panel Icon</h2>
 99 | <p> The wall panel icon is created using the custom button card (you will need to install this via HACS).</p>
100 | 
101 | `Wall Panel Icon` - A visual representation to show if theres any post and what time post arrived.
102 | 
103 | ``` yaml
104 |   - type: custom:button-card
105 |     entity: input_boolean.post_to_collect
106 |     color: white
107 |     show_state: false
108 |     tap_action:
109 |       action: more-info
110 |     state:
111 |       - value: 'off'
112 |         icon: mdi:email-off-outline
113 |         name: No Post
114 |         color: rgba(0,0,0,0.3)
115 |       - value: 'on'
116 |         icon: mdi:email-alert
117 |         name: |
118 |           [[[
119 |             var time_delivered = states["input_datetime.post_time"].state;
120 |             return 'Post arrived at ' + time_delivered 
121 |           ]]] 
122 | ```
123 | <p> To display the time on the button card I am capturing the time from a date time helper called <b>input_datetime.post_time</b></p>
124 | 


--------------------------------------------------------------------------------
/A DIY Home Assistant Kiosk/README.md:
--------------------------------------------------------------------------------
  1 |   <br>
  2 |   <h1 align="center">A DIY Raspberry Pi Kiosk (HOME ASSISTANT)</h1>
  3 |   <br>
  4 |  <h2 align="center">
  5 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/kiosk.png" width="500">
  6 |   </br>
  7 |                                                                                                                                           
  8 | <p>In this one I show you how to setup and build your own DIY Home Assistant Kiosk. Check the video out <a href="https://youtu.be/4hN0_yGVdUQ" target="_blank">Here</a></p> 
  9 | </h2>	
 10 | 
 11 | <h2> Commands for Pi (In order of Use) </h2>
 12 | <p> Use the below commands in combination with my tutorial video to help setup a working Raspberry Pi Kiosk. </p>
 13 | </br>
 14 | 
 15 | `SSH` - Connect to our Pi using Secure Shell
 16 | ```
 17 | ssh pi@touchpi.local
 18 | # You will need to ammend this to be your username and hostname values.
 19 | 
 20 | ssh username@hostname.local 
 21 | #local as we are on the same network
 22 | 
 23 | # You can also use the IP address
 24 | ssh username@192.xxx.x.xx
 25 | ```
 26 | 
 27 | 
 28 | `Command 1` - Check and Update our Pi
 29 | ```
 30 | sudo apt-get update -y
 31 | sudo apt-get upgrade -y
 32 | ```
 33 | 
 34 | </br>
 35 | 
 36 | `Command 2` - Install minimum GUI components (GUI kit used for Chomium)
 37 | ```
 38 | sudo apt-get install --no-install-recommends xserver-xorg x11-xserver-utils xinit openbox
 39 | ```
 40 | 
 41 | </br>
 42 | 
 43 | `Command 3` - Install Chromium Web browser (We are using Chromium to display webpage - you can use others)
 44 | ```
 45 | sudo apt-get install --no-install-recommends chromium-browser
 46 | ```
 47 | 
 48 | </br>
 49 | 
 50 | `Command 4` - Edit Openbox config (Openbox Window manager edits)
 51 | ```
 52 | sudo nano /etc/xdg/openbox/autostart
 53 | 
 54 | #In the nano editor you will then need to paste in the following config (tip use right click to paste)
 55 | 
 56 | # If you want to use XFCE config tools...
 57 | #
 58 | #xfce-mcs-manager &
 59 | xset -dpms            # turn off display power management system
 60 | xset s noblank        # turn off screen blanking
 61 | xset s off            # turn off screen saver
 62 | 
 63 | 
 64 | # Remove exit errors from the config files that could trigger a warning
 65 | 
 66 | sed -i 's/"exited_cleanly":false/"exited_cleanly":true/' ~/.config/chromium/'Local State'
 67 | 
 68 | sed -i 's/"exited_cleanly":false/"exited_cleanly":true/; s/"exit_type":"[^"]\+"/"exit_type":"Normal"/' ~/.config/chromium/Default/Preferences
 69 | 
 70 | # Run Chromium in kiosk mode
 71 | chromium-browser  --noerrdialogs --disable-infobars --enable-features=OverlayScrollbar --kiosk $KIOSK_URL --check-for-update-interval=31536000
 72 | ```
 73 | 
 74 | </br>
 75 | 
 76 | `Command 5` - Setup Openbox environment (The URL we want to pass in)
 77 | ```
 78 | sudo nano /etc/xdg/openbox/environment
 79 | 
 80 | # use the above command to enter the nano editor for the environment and paste in the following line
 81 | 
 82 | export KIOSK_URL=https://YourHomeAssistant_URL:8123
 83 | ```
 84 | 
 85 | </br>
 86 | 
 87 | `Command 6` - Start the X server on boot
 88 | ```
 89 | # Check if bash_profile exists (If it does just directly edit it)
 90 | ls -la ~/.bash_profile
 91 | 
 92 | #If it doesn't exist (Create it)
 93 | touch ~/.bash_profile
 94 | ```
 95 | 
 96 | </br>
 97 | 
 98 | `Command 7` - Edit Bash Profile
 99 | ```
100 | sudo nano ~/.bash_profile
101 | 
102 | # After running the above command enter the following line in the file
103 | [[ -z $DISPLAY && $XDG_VTNR -eq 1 ]] && startx -- -nocursor
104 | ```
105 | 
106 | </br>
107 | 
108 | `Command 8` - Check ~/.bash_profile
109 | ```
110 | source ~/.bash_profile
111 | ```
112 | 
113 | </br>
114 | 
115 | `Command 9` - Reboot Pi (To a hopefully working Kiosk!)
116 | ```
117 | sudo reboot
118 | ```
119 | 
120 | 
121 | </br>
122 | <p> The code for this guide was based off <a href="https://desertbot.io/blog/raspberry-pi-touchscreen-kiosk-setup" target="_blank">Desertbots</a></p>  Kiosk guide. I modified the commands and config to suit the 7inch screen for the TS7 Pro
123 | and to remove some other things like hiding scroll bars.</p>
124 | 
125 | </br>
126 | 
127 | `SHELL COMMAND` - shell_commands.yaml
128 | ```
129 | shutdown_pitouch: "ssh -i /config/ssh_keys/id_rsa_homeassistant -o 'StrictHostKeyChecking=no' homeassistant@pitouch.local sudo shutdown -h now"
130 | ```
131 | <p> For the above command you will also need to include `shell_commands.yaml` in your HA includes in your config.yaml file. SSH between HA and your remote Pi must also be configured.
132 | 
133 | If all of the above sounds like gibberish then there is a great written guide available <a href="https://www.creatingsmarthome.com/index.php/2022/02/12/guide-start-up-and-shut-down-remote-linux-pc-using-home-assistant/" target="_blank">here</a></p>
134 | 
135 | </br>
136 | <h2> Don't forget to drop me a like if you would like to see more content like this!</h2>
137 | 


--------------------------------------------------------------------------------
/Home Assistant Button Box/README.md:
--------------------------------------------------------------------------------
  1 | # 🔘 Home Assistant Button Box – Community Spotlight  
  2 | 
  3 | <p>This project combines an ESP32, a small OLED screen, and some buttons into a compact button box for Home Assistant. Designed originally by <a href="https://makerworld.com/en/models/1478816-habb-home-assistant-button-box-esphome#profileId-1543829">Akelyte</a> 
  4 |   (full credit to them), I’ve put my own spin on it with added features, a new enclosure, and extra ESPHome tweaks. Watch the full video <a href="https://youtu.be/0jHDhyW68ow" target="_blank">here</a>.</p>  
  5 | 
  6 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/HABB.png" width="500">  
  7 | <br>  
  8 | 
  9 | ## 📦 Features  
 10 | 
 11 | - Trigger **Home Assistant automations/scenes** with physical buttons  
 12 | - **OLED feedback display** for status, page number, and wake/sleep state  
 13 | - **Multi-page support** → up to **16 actions** from just 4 buttons  
 14 | - **Customisable screen timeout** (prevents OLED burn-in)  
 15 | - **Screen power toggle** (manual on/off)  
 16 | - **Guard press** – requires first press to wake screen before triggering  
 17 | - **Unique device binding** so multiple boxes don’t conflict  
 18 | - **Blueprint included** for simple setup & automation linking  
 19 | - Expandable → add a bigger screen, extra buttons, NFC, sensors, or even use it as a base for a DIY alarm keypad  
 20 | <br>  
 21 | 
 22 | ## 🧰 Hardware Required  
 23 | 
 24 | | Item                | Notes                                   | Affiliate Link |
 25 | |---------------------|-----------------------------------------|----------------|
 26 | | ESP32 Dev Board     | ESP-WROOM-32 or similar                 | [Buy on Amazon](https://amzn.to/4mvzI6H) |
 27 | | SH1106 OLED Display | 1.3" I²C display                        | [Buy on Amazon](https://amzn.to/45TSo9l) |
 28 | | Membrane Keypad     | 1x4 keypad                              | [Buy on Amazon](https://amzn.to/4fPqJuC) |
 29 | | Dupont Wires        | Jumper cables for connections           | [Buy on Amazon](https://amzn.to/41jYiz3) |
 30 | | 3D Printed Enclosure| Original design by Akelyte, modded by me | [MakerWorld Link](https://makerworld.com/en/models/1478816-habb-home-assistant-button-box-esphome#profileId-1543829) |
 31 | 
 32 | 💡 Don’t have a 3D printer? Services like **PCBWay** offer on-demand printing — just upload the STL, pick your material/finish, and get it shipped.  
 33 | <br>  
 34 | 
 35 | ## 💻 Software Requirements  
 36 | 
 37 | | Software          | Purpose |
 38 | |-------------------|---------|
 39 | | [Home Assistant](https://www.home-assistant.io/) | Smart home hub & automations |
 40 | | [ESPHome](https://esphome.io/) | Firmware & HA integration |
 41 | | [My ESPHome YAML](./HABB.yaml) | Modified config with extra features |
 42 | 
 43 | A ready-to-use **Home Assistant blueprint** is included to simplify automation setup.  
 44 | <br>  
 45 | 
 46 | ## ⚙️ ESPHome Setup  
 47 | 
 48 | 1. Flash the provided YAML (`HABB.yaml`) to your ESP32 via ESPHome  
 49 | 2. Connect OLED & keypad using I²C + GPIOs (see wiring diagram)  
 50 | 3. Add the device to Home Assistant  
 51 | 4. Use the **HABB Blueprint** to quickly configure scenes/automations  
 52 | 5. (Optional) Adjust substitutions to tweak sleep timer, pages, etc.  
 53 | <br>  
 54 | 
 55 | ## 🔌 Wiring Diagram  
 56 | 
 57 | Here’s how to wire the ESP32, OLED display, and keypad together:  
 58 | 
 59 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Home%20Assistant%20Button%20Box/Diagrams/habb%20diagram.png" width="600">  
 60 | <br>  
 61 | 
 62 | ## 🧠 Custom Logic Highlights  
 63 | 
 64 | - **Multi-page actions** → Hold button to cycle pages (displayed in corner)  
 65 | - **Guard press** → Screen-off mode prevents accidental triggers  
 66 | - **Exposed HA sensors** → Page, screen state, last action, etc.  
 67 | - **Device-unique actions** → Multiple button boxes won’t conflict  
 68 | <br>  
 69 | 
 70 | ## 🖼 Enclosure  
 71 | 
 72 | - Original slimline case: Akelyte’s MakerWorld project  
 73 | - My mod: Taller body to fit Wago clips → no soldering, no header cutting (In my final version I actually only used the dupont wires)  
 74 | - Optional **magnet or bracket mount** for walls/racks  
 75 | 
 76 | 🔗 [Download Enclosure STL Files](https://github.com/MarkWattTech/MarkWattTech-Tutorials/tree/main/Home%20Assistant%20Button%20Box/Enclosure%20Files)  
 77 | <br>  
 78 | 
 79 | ## 💻 Code  
 80 | 
 81 | - 🔗 [ESPHome YAML (MWT HABB.yaml)](https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Home%20Assistant%20Button%20Box/MWT%20HABB.yaml)  
 82 | 
 83 | - 🧩 Home Assistant Blueprint  
 84 |   [![Import Blueprint to My Home Assistant](https://my.home-assistant.io/badges/blueprint_import.svg)](https://my.home-assistant.io/redirect/blueprint_import/?blueprint_url=https%3A%2F%2Fgist.githubusercontent.com%2FMarkWattTech%2Fd9bf68718d88fa20dbc0921470079b23%2Fraw)  
 85 |   <sub>Direct link (fallback): https://gist.github.com/MarkWattTech/d9bf68718d88fa20dbc0921470079b23</sub>
 86 | 
 87 | 
 88 | ## 📢 Credits  
 89 | 
 90 | - Original project & enclosure: [Akelyte](https://makerworld.com/en/models/1478816-habb-home-assistant-button-box-esphome#profileId-1543829)  
 91 | - Modified code, features, and box: [Mark Watt Tech](https://youtube.com/@MarkWattTech)  
 92 | - Community spotlight video: [Watch here](https://youtu.be/0jHDhyW68ow)  
 93 | 
 94 | <br>  
 95 | 
 96 | ## ☕ Support My Work  
 97 | 
 98 | If you enjoyed this project and want to support me:  
 99 | 
100 | - 🔗 [YouTube](https://youtube.com/@MarkWattTech)  
101 | - ☕ [Buy Me a Coffee](https://www.buymeacoffee.com/markwatttech)  
102 | - 💸 [PayPal.me](https://paypal.me/markwatttech)  
103 | - ❤️ [Patreon](https://www.patreon.com/markwatttech)  
104 | 
105 | Thanks for helping me keep making these open-source smart home builds! 🚀  
106 | 


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/README.md:
--------------------------------------------------------------------------------
  1 | # 🛠 HOW TO - Create a Smart Touchscreen Desk Controller
  2 | 
  3 | <p>This ESPHome project turns your ESP32 and Nextion display into a full-fledged control center for your standing desk, smart lights, fan, and more. Perfect for creators, makers, and smart home enthusiasts who want to add additional functionality to there desks. Watch the full video <a href="https://youtu.be/jZzNDveuDVY" target="_blank">Here</a></p> 
  4 | </h2>	
  5 | <img src="https://github.com/MarkWattTech/MarkWattTech-Tutorials/blob/main/Images/thumbnails/Smart%20Desk%20Controller%205.png" width="500">
  6 | <br>
  7 | 
  8 | ## 📦 Features
  9 | 
 10 | - Control **desk up/down/presets** via UART
 11 | - View and control **smart lights, fan, and devices** from Home Assistant
 12 | - Sync **real-time notifications** to a dedicated Nextion page
 13 | - Multi-page touchscreen UI for seamless navigation
 14 | - Custom height range with Home Assistant integration
 15 | - Auto screen brightness via virtual switch
 16 | - Built-in desk height number entity
 17 | <br>
 18 | <br>
 19 | 
 20 | ## 🧰 Hardware Required
 21 | 
 22 | | Item                | Example / Notes                          | Affiliate Link             |
 23 | |---------------------|-------------------------------------------|-----------------------------|
 24 | | ESP32 Dev Board     | ESP-WROOM-32 or similar                  | [Buy on Amazon](https://amzn.to/4cER4tZ)         |
 25 | | Nextion Display     | 3.2" Basic (NX4024T032)                  | [Buy on Amazon](https://amzn.to/3Gf7gps)         |
 26 | | Nextion Display     | 3.2" Basic (NX4024T032)                  | [Buy on Amazon](https://amzn.to/4iZkVzL)         |
 27 | | Nextion Display     | 2.4" Basic (NX4024T032)                  | [Buy on Amazon](https://amzn.to/424bzvi)         |
 28 | | Flexispot Desk      | E7Q (or any using LoctekMotion protocol) | [Buy on Amazon](https://amzn.to/4ilDzk9)                               |
 29 | | USB to TTL          | FT232 (DSD Tech)                         | [Buy on Amazon](https://amzn.to/4l0A0lO)         |
 30 | | Dupont Wires        | Wires used for connecting esp32          | [Buy on Amazon](https://amzn.to/41UTSiZ)         |
 31 | | Wago Connectors     | Optional for attatching wires            | [Buy on Amazon](https://amzn.to/3Y2zF8d)         |
 32 | | RJ45 Pinout         | Board for ethernet pinout                | [Buy on Amazon](https://amzn.to/4jkL5gp)         |
 33 | | SD Card             | Optional                                 | [Buy on Amazon](https://amzn.to/3EvchK8)         |
 34 | 
 35 | *The above are affiliate links. Using these doesn't cost you anything extra, but it helps support the channel — thanks!* 💙
 36 | <br>
 37 | <br>
 38 | 
 39 | ## 💻 Software Requirements
 40 | 
 41 | The following software must be installed and set up:
 42 | 
 43 | | Software          | Description |
 44 | |-------------------|-------------|
 45 | | [Nextion Editor](https://nextion.tech/nextion-editor/) | Used to design and build the touchscreen interface (HMI file). |
 46 | | [Home Assistant](https://www.home-assistant.io/)       | Central hub that manages devices, automations, and the interface for notifications and toggles. |
 47 | | [ESPHome](https://esphome.io/)                          | Used to compile and upload firmware to the ESP32, and bridge communication between hardware and Home Assistant. |
 48 | 
 49 | All three are essential for full functionality.
 50 | <br>
 51 | <br>
 52 | 
 53 | ## ✅ Compatible Desks
 54 | 
 55 | The following software must be installed and set up:
 56 | 
 57 | | Desk               | Controller Model Number |
 58 | |--------------------|-------------------------|
 59 | | [Flexispot E7Q](https://flexispot.co.uk/4-leg-standing-desk-e7q) | U                       |
 60 | 
 61 | 
 62 | <br>
 63 | 
 64 | 
 65 | ## ⚙️ The ESPHome Section
 66 | 
 67 | 1. **Clone this repo** or copy the `DeskController.yaml` file into your ESPHome dashboard
 68 | 2. Edit the substitution values (5 sections):
 69 |    ```yaml
 70 |    substitutions:
 71 |      min_height: "79"    # Your desk's min height + 0.1
 72 |      max_height: "113"   # Your desk's max height - 0.1
 73 |    ```
 74 | 3. Replace these Home Assistant entities with your own:
 75 |    - `light.left_key_light`
 76 |    - `light.right_key_light`
 77 |    - `light.ring_light`
 78 |    - `switch.playroom_light`
 79 |    - `fan.office_fan`
 80 | 4. Flash to your ESP32 via USB or OTA
 81 | 5. Connect your Nextion display (TX/RX/GND) to GPIOs 4 and 5 (adjust as needed)
 82 | 6. Optionally update or load the `.hmi` file to match your screen layout
 83 | <br>
 84 | <br>
 85 | 
 86 | ## 🔌 Wiring Guide
 87 | 
 88 | | Component        | ESP32 Pin | Notes                       |
 89 | |------------------|-----------|-----------------------------|
 90 | | Desk UART TX     | GPIO17    | Desk control TX             |
 91 | | Desk UART RX     | GPIO16    | Desk control RX             |
 92 | | Nextion TX       | GPIO5     | From Nextion to ESP         |
 93 | | Nextion RX       | GPIO4     | From ESP to Nextion         |
 94 | | Nextion GND      | GND       | Shared ground               |
 95 | | Nextion VCC      | 5V        | Use USB or regulated source |
 96 | 
 97 | 
 98 | See additional diagrams in the diagram folder
 99 | <br>
100 | <br>
101 | 
102 | ## 💡 Nextion Pages
103 | 
104 | | Page ID | Page Name         | Description                  |
105 | |---------|-------------------|------------------------------|
106 | | 0       | Home              | Navigation overview          |
107 | | 1       | Lights            | Toggle lights/fan/buttons    |
108 | | 2       | Desk              | Stand/sit/presets/display cm |
109 | | 3       | Notification      | Title + message from HA      |
110 | <br>
111 | <br>
112 | 
113 | ## 🧠 Custom Logic Highlights
114 | 
115 | - Page detection via `on_page:` callback to sync UI with ESP state
116 | - UART commands to move desk or trigger presets
117 | - Home Assistant `text_sensor` to display HA input_text entities on Nextion
118 | - `cover` component used to represent desk with proper open/close/stop
119 | <br>
120 | <br>
121 | 
122 | ## 📢 Credits
123 | 
124 | - Desk control: [@iMicknl](https://github.com/iMicknl/LoctekMotion_IoT)
125 | - Project and code: [Mark Watt Tech](https://youtube.com/@MarkWattTech)
126 | <br>
127 | <br>
128 | 
129 | ## 🧪 Want to Contribute?
130 | 
131 | PRs welcome! Add new pages, UI improvements, or other desk models. Let's make this the best Flexispot control stack out there 💪
132 | 
133 | ---
134 | <br>
135 | 
136 | ### 💬 Questions / Support
137 | 
138 | Drop an issue in the GitHub repo or hit me up on Twitter/X or YouTube comments!
139 | 
140 | 
141 | ---
142 | <br>
143 | 
144 | ### ☕ Support My Work
145 | 
146 | If you found this helpful and want to keep the projects coming, you can support me here:
147 | 
148 | - 🔗 [YouTube](https://youtube.com/@MarkWattTech)
149 | - 🐦 [Twitter / X](https://twitter.com/MarkWattTech)
150 | - 💬 [Discord](https://discord.gg/yourserverlink)
151 | - 📘 [Facebook](https://facebook.com/MarkWattTech)
152 | - ☕ [Buy Me a Coffee](https://www.buymeacoffee.com/markwatttech)
153 | - 💸 [PayPal.me](https://paypal.me/markwatttech)
154 | - ❤️ [Patreon](https://www.patreon.com/markwatttech)
155 | 
156 | Thanks for the support! You’re helping me build more open, hackable, and awesome projects.
157 | 
158 | 


--------------------------------------------------------------------------------
/VPE Grove Port Sensors/README.md:
--------------------------------------------------------------------------------
  1 | # 🌱 Expand Your Home Assistant VPE with Grove Sensors
  2 | 
  3 | This ESPHome project shows you how to unlock the hidden potential of the **Home Assistant Voice Panel (VPE)** using its onboard **Grove port**. With simple plug-and-play sensors, no soldering, and native ESPHome support, your VPE can become a powerful, modular smart sensor hub.
  4 | 
  5 | [📺 Watch the full video walkthrough here](https://youtu.be/bxOYuOmHW1A)
  6 | 
  7 | ---
  8 | 
  9 | ## 📦 Features
 10 | 
 11 | * Plug-and-play Grove sensor integration
 12 | * Fully wireless firmware updates using ESPHome
 13 | * Supports **temperature**, **humidity**, **gas/VOC**, and other I2C-based Grove modules
 14 | * Works with **Seeed Studio**, **M5Stack**, and other Grove-compatible devices
 15 | * Expand beyond I2C using internal GPIO headers
 16 | * Optional support for custom 3D-printed enclosures to expose extra ports
 17 | 
 18 | ---
 19 | 
 20 | ## 🧰 Hardware Required
 21 | 
 22 | | Item                       | Example / Notes                    | Buy Link                                                                     |
 23 | | -------------------------- | ---------------------------------- | ---------------------------------------------------------------------------- |
 24 | | Home Assistant VPE         | Voice Assistant Panel              | [Buy from Nabu Casa](https://www.home-assistant.io/voice/)                   |
 25 | | Grove Sensor (AHT20)       | Temperature and Humidity Sensor    | [Seeed AHT20](https://www.seeedstudio.com/)                                  |
 26 | | Grove Sensor (SGP30)       | VOC + eCO2 Sensor                  | [Seeed SGP30](https://www.seeedstudio.com/)                                  |
 27 | | Grove I2C Hub              | 6-Port Expansion Hub               | [Seeed Grove Hub](https://www.seeedstudio.com/)                              |
 28 | | Grove Cables               | For connecting sensors             | Included with most sensors                                                   |
 29 | | 3D Printed Case (optional) | Custom VPE case with Grove cutouts | [Download STL from MakerWorld](https://makerworld.com/en/models/885769-home-assistant-voice-preview-edition-enclosure#profileId-840903) |
 30 | 
 31 | *Affiliate links support the channel at no extra cost. Thanks!* 💙
 32 | 
 33 | ---
 34 | 
 35 | ## 💻 Software Requirements
 36 | 
 37 | | Software                                                                   | Description                      |
 38 | | -------------------------------------------------------------------------- | -------------------------------- |
 39 | | [ESPHome](https://esphome.io/)                                             | To configure and upload firmware |
 40 | | [Home Assistant](https://www.home-assistant.io/)                           | Central smart home platform      |
 41 | | [ESPHome Dashboard](https://esphome.io/guides/getting_started_hassio.html) | UI for managing devices          |
 42 | 
 43 | ---
 44 | 
 45 | ## ⚙️ Getting Started
 46 | 
 47 | 1. **Take control of your VPE in ESPHome Dashboard**
 48 | 2. Add the I2C configuration for the Grove port:
 49 | 
 50 | ```yaml
 51 | i2c:
 52 |   sda: 8
 53 |   scl: 9
 54 |   scan: true
 55 | ```
 56 | 
 57 | 3. Add your sensors (example for AHT20):
 58 | 
 59 | ```yaml
 60 | sensor:
 61 |   - platform: aht10
 62 |     temperature:
 63 |       name: "VPE Temperature"
 64 |     humidity:
 65 |       name: "VPE Humidity"
 66 |     update_interval: 60s
 67 | ```
 68 | 
 69 | 4. Save and install wirelessly to your VPE
 70 | 5. Connect the sensor to the Grove port (access through rear plastic tab)
 71 | 
 72 | ---
 73 | 
 74 | ## 🔌 Add Multiple Sensors
 75 | 
 76 | To expand with multiple sensors:
 77 | 
 78 | 1. Use a Grove I2C Hub
 79 | 2. Connect all sensors into the hub
 80 | 3. Update ESPHome config to include new devices:
 81 | 
 82 | ```yaml
 83 | sensor:
 84 |   - platform: sgp30
 85 |     eco2:
 86 |       name: "VPE eCO2"
 87 |     tvoc:
 88 |       name: "VPE TVOC"
 89 |     baseline:
 90 |       eco2_baseline: 0x8C5C
 91 |       tvoc_baseline: 0x8ACB
 92 | ```
 93 | 
 94 | *NOTE: Let the SGP30 run for \~12 hours before setting the baseline values.*
 95 | 
 96 | ---
 97 | 
 98 | ## FULL VPE Code
 99 | 
100 | ```yaml
101 | substitutions:
102 |   name: home-assistant-voice-091a18
103 |   friendly_name: Office VPE
104 | 
105 | packages:
106 |   Nabu Casa.Home Assistant Voice PE: github://esphome/home-assistant-voice-pe/home-assistant-voice.yaml
107 |   grove-i2c: github://esphome/home-assistant-voice-pe/modules/grove-i2c.yaml
108 | 
109 | esphome:
110 |   name: ${name}
111 |   name_add_mac_suffix: false
112 |   friendly_name: ${friendly_name}
113 | 
114 | api:
115 |   encryption:
116 |     key: opg1IIG0TjOcf3y34CrmkTnK6486y4xTb/GL7QCyxtI=
117 | 
118 | wifi:
119 |   ssid: !secret wifi_ssid
120 |   password: !secret wifi_password
121 | 
122 | logger:
123 |   level: DEBUG  # Detailed logging for I2C and sensor diagnostics
124 | 
125 | sensor:
126 |   - platform: aht10
127 |     i2c_id: grove_i2c
128 |     variant: AHT20
129 |     address: 0x38
130 |     temperature:
131 |       name: "Office Temperature"
132 |       id: office_temperature
133 |     humidity:
134 |       name: "Office Humidity"
135 |       id: office_humidity
136 |     update_interval: 60s
137 | 
138 |   - platform: sgp30
139 |     i2c_id: grove_i2c
140 |     address: 0x58
141 |     eco2:
142 |       name: "Office eCO2"
143 |       id: office_eco2
144 |     tvoc:
145 |       name: "Office TVOC"
146 |       id: office_tvoc
147 |     update_interval: 1s
148 |     baseline:
149 |       eco2_baseline: 0  # Update after 12-hour burn-in
150 |       tvoc_baseline: 0  # Update after 12-hour burn-in
151 | ```
152 | 
153 | ## 🧠 Beyond the Grove Port
154 | 
155 | If you want to go further:
156 | 
157 | * Open your VPE and access the exposed **GPIO pin headers**
158 | * Connect motion sensors, relays, or addressable LEDs
159 | * Add sensor logic via ESPHome as normal
160 | 
161 | Refer to the GPIO documentation: [VPE GPIO Guide](https://support.nabucasa.com/hc/en-us/articles/25938342327581)
162 | 
163 | ---
164 | 
165 | ## 🖨️ Custom Enclosures
166 | 
167 | Home Assistant provides 3D-printable STL files for custom cases:
168 | 
169 | * Add cutouts for Grove + GPIO headers
170 | * Modify layout to suit your wiring needs
171 | 
172 | Print it yourself or use a service like **PCBWay** to manufacture your parts.
173 | 
174 | ---
175 | 
176 | ## 🧪 Tips & Notes
177 | 
178 | * Use **right-angled connectors** for better clearance inside the case
179 | * If your Grove sensor isn’t detected, check pull-up resistors or use external power
180 | * Sensors must use I2C protocol only (Grove analog/digital not supported directly)
181 | 
182 | ---
183 | 
184 | ## 🙌 Credits
185 | 
186 | * VPE Project: [Home Assistant Team](https://www.home-assistant.io/voice/)
187 | * Sensor Logic: [ESPHome](https://esphome.io/)
188 | * Guide & Video: [MarkWattTech YouTube](https://youtube.com/@MarkWattTech)
189 | 
190 | ---
191 | 
192 | ## 💬 Community & Support
193 | 
194 | * [💬 Join the Discord](https://discord.gg/DAG2yf7Ev3)
195 | * [🐦 X / Twitter](https://x.com/MarkWattTech)
196 | * [📺 YouTube](https://www.youtube.com/@MarkWattTech)
197 | 
198 | ---
199 | 
200 | ## ☕ Support This Project
201 | 
202 | If you found this helpful, consider supporting the channel:
203 | 
204 | * 💙 [Buy Me a Coffee](https://www.buymeacoffee.com/markwatttech)
205 | * 🛒 [Amazon Storefront](https://www.amazon.co.uk/shop/markwatttech)
206 | * 🧡 [Patreon](https://www.patreon.com/markwatttech)
207 | * 💸 [PayPal](https://www.paypal.com/paypalme/markwatttech)
208 | 
209 | Thanks for helping build a smarter, more hackable smart home! 🏡
210 | 
211 | 


--------------------------------------------------------------------------------
/Home Assistant Button Box/MWT HABB.yaml:
--------------------------------------------------------------------------------
  1 | substitutions:
  2 |   # Custom version number
  3 |   version_number: "1.0.0"
  4 |   
  5 |   # ==== Page 1 labels ====
  6 |   p1_b1_label: "1: Spots"
  7 |   p1_b2_label: "2: KL Left"
  8 |   p1_b3_label: "3: Ring Light"
  9 |   p1_b4_label: "4: KL Right"
 10 | 
 11 |   # ==== Page 2 labels ====
 12 |   p2_b1_label: "1: Heating"
 13 |   p2_b2_label: "2: Cooling"
 14 |   p2_b3_label: "3: Away"
 15 |   p2_b4_label: "4: Home"
 16 | 
 17 |   # ==== Page 3 labels ====
 18 |   p3_b1_label: "1: Office Fan"
 19 |   p3_b2_label: "2: Desk Lamp"
 20 |   p3_b3_label: "3: Monitor"
 21 |   p3_b4_label: "4: PC"
 22 | 
 23 |   # ==== Page 4 labels ====
 24 |   p4_b1_label: "1: Movie"
 25 |   p4_b2_label: "2: Chill"
 26 |   p4_b3_label: "3: Party"
 27 |   p4_b4_label: "4: Off All"
 28 | 
 29 | esphome:
 30 |   name: esphome-web-9c6ec8
 31 |   friendly_name: HAAB
 32 |   min_version: 2025.5.0
 33 |   name_add_mac_suffix: false
 34 | 
 35 | esp32:
 36 |   board: esp32dev
 37 |   framework:
 38 |     type: esp-idf
 39 | 
 40 | logger:
 41 | api:
 42 | ota:
 43 |   platform: esphome
 44 | 
 45 | wifi:
 46 |   ssid: !secret wifi_ssid
 47 |   password: !secret wifi_password
 48 |   ap:
 49 |     password: "${wifi_ap_password}"
 50 | 
 51 | # =========================
 52 | # Globals & Settings
 53 | # =========================
 54 | globals:
 55 |   - id: current_page
 56 |     type: int
 57 |     restore_value: yes
 58 |     initial_value: '1'
 59 |   - id: screen_on
 60 |     type: bool
 61 |     restore_value: yes
 62 |     initial_value: 'true'
 63 |   - id: auto_sleep_enabled
 64 |     type: bool
 65 |     restore_value: yes
 66 |     initial_value: 'true'
 67 |   - id: screen_timeout_s
 68 |     type: int
 69 |     restore_value: yes
 70 |     initial_value: '60'
 71 |   - id: show_activate_enabled
 72 |     type: bool
 73 |     restore_value: yes
 74 |     initial_value: 'true'
 75 |   - id: display_message
 76 |     type: bool
 77 |     restore_value: no
 78 |     initial_value: 'false'
 79 |   - id: message_line1
 80 |     type: std::string
 81 |     restore_value: no
 82 |     initial_value: '""'
 83 |   - id: message_line2
 84 |     type: std::string
 85 |     restore_value: no
 86 |     initial_value: '""'
 87 |   - id: homeassistant_event_triggered
 88 |     type: bool
 89 |     restore_value: no
 90 |     initial_value: 'false'
 91 | 
 92 | # =========================
 93 | # User-facing controls in HA
 94 | # =========================
 95 | switch:
 96 |   - platform: template
 97 |     name: "Keypad: Screen Power"
 98 |     id: sw_screen_power
 99 |     restore_mode: RESTORE_DEFAULT_ON
100 |     optimistic: true
101 |     lambda: |-
102 |       return id(screen_on);
103 |     turn_on_action:
104 |       - lambda: |-
105 |           id(screen_on) = true;
106 |       - script.execute: restart_sleep_timer
107 |     turn_off_action:
108 |       - lambda: |-
109 |           id(screen_on) = false;
110 | 
111 |   - platform: template
112 |     name: "Keypad: Auto Sleep"
113 |     id: sw_auto_sleep
114 |     restore_mode: RESTORE_DEFAULT_ON
115 |     optimistic: true
116 |     lambda: |-
117 |       return id(auto_sleep_enabled);
118 |     turn_on_action:
119 |       - lambda: |-
120 |           id(auto_sleep_enabled) = true;
121 |       - script.execute: restart_sleep_timer
122 |     turn_off_action:
123 |       - lambda: |-
124 |           id(auto_sleep_enabled) = false;
125 | 
126 |   - platform: template
127 |     name: "Keypad: Show Activation Message"
128 |     id: sw_show_activation
129 |     restore_mode: RESTORE_DEFAULT_ON
130 |     optimistic: true
131 |     lambda: |-
132 |       return id(show_activate_enabled);
133 |     turn_on_action:
134 |       - lambda: |-
135 |           id(show_activate_enabled) = true;
136 |     turn_off_action:
137 |       - lambda: |-
138 |           id(show_activate_enabled) = false;
139 | 
140 | number:
141 |   - platform: template
142 |     name: "Keypad: Screen Timeout (s)"
143 |     id: nb_timeout
144 |     optimistic: true
145 |     restore_value: true
146 |     min_value: 5
147 |     max_value: 600
148 |     step: 5
149 |     initial_value: 60
150 |     set_action:
151 |       - lambda: |-
152 |           id(screen_timeout_s) = (int) x;
153 |       - script.execute: restart_sleep_timer
154 | 
155 | # =========================
156 | # Sleep timer (auto-off)
157 | # =========================
158 | script:
159 |   - id: restart_sleep_timer
160 |     mode: restart
161 |     then:
162 |       - if:
163 |           condition:
164 |             lambda: 'return id(screen_on) && id(auto_sleep_enabled);'
165 |           then:
166 |             - delay: !lambda 'return (uint32_t) id(screen_timeout_s) * 1000u;'
167 |             - if:
168 |                 condition:
169 |                   lambda: 'return id(screen_on) && id(auto_sleep_enabled);'
170 |                 then:
171 |                   - lambda: |-
172 |                       id(screen_on) = false;
173 |                       id(sw_screen_power).publish_state(false);
174 | 
175 |   - id: show_activation
176 |     parameters:
177 |       button: int
178 |     mode: single
179 |     then:
180 |       - if:
181 |           condition:
182 |             lambda: 'return id(show_activate_enabled);'
183 |           then:
184 |             - lambda: |-
185 |                 auto get_label = [](int page, int btn) -> std::string {
186 |                   switch (page) {
187 |                     case 1:
188 |                       if (btn == 1) return std::string("${p1_b1_label}");
189 |                       if (btn == 2) return std::string("${p1_b2_label}");
190 |                       if (btn == 3) return std::string("${p1_b3_label}");
191 |                       if (btn == 4) return std::string("${p1_b4_label}");
192 |                       break;
193 |                     case 2:
194 |                       if (btn == 1) return std::string("${p2_b1_label}");
195 |                       if (btn == 2) return std::string("${p2_b2_label}");
196 |                       if (btn == 3) return std::string("${p2_b3_label}");
197 |                       if (btn == 4) return std::string("${p2_b4_label}");
198 |                       break;
199 |                     case 3:
200 |                       if (btn == 1) return std::string("${p3_b1_label}");
201 |                       if (btn == 2) return std::string("${p3_b2_label}");
202 |                       if (btn == 3) return std::string("${p3_b3_label}");
203 |                       if (btn == 4) return std::string("${p3_b4_label}");
204 |                       break;
205 |                     case 4:
206 |                       if (btn == 1) return std::string("${p4_b1_label}");
207 |                       if (btn == 2) return std::string("${p4_b2_label}");
208 |                       if (btn == 3) return std::string("${p4_b3_label}");
209 |                       if (btn == 4) return std::string("${p4_b4_label}");
210 |                       break;
211 |                   }
212 |                   return std::string("");
213 |                 };
214 |                 std::string label = get_label(id(current_page), button);
215 |                 size_t pos = label.find(": ");
216 |                 if (pos != std::string::npos) {
217 |                   id(message_line1) = label.substr(pos + 2);
218 |                 } else {
219 |                   id(message_line1) = label;
220 |                 }
221 |                 id(message_line2) = "Activated";
222 |                 id(display_message) = true;
223 |             - delay: 2s
224 |             - lambda: |-
225 |                 id(display_message) = false;
226 | 
227 | # =========================
228 | # Expose state to Home Assistant
229 | # =========================
230 | sensor:
231 |   - platform: template
232 |     name: "Keypad Current Page"
233 |     id: sensor_page
234 |     lambda: |-
235 |       return (float) id(current_page);
236 |     update_interval: 1s
237 | 
238 | text_sensor:
239 |   - platform: template
240 |     name: "Keypad Current Page Label"
241 |     id: ts_page_label
242 |     lambda: |-
243 |       char buf[3];
244 |       snprintf(buf, sizeof(buf), "P%d", id(current_page));
245 |       return {buf};
246 |     update_interval: 1s
247 |   - platform: template
248 |     name: "Keypad Firmware Version"
249 |     id: sensor_version
250 |     lambda: |-
251 |       return {"${version_number}"};
252 |     update_interval: 60s
253 | 
254 | # =========================
255 | # SPI + Fonts + Display
256 | # =========================
257 | spi:
258 |   clk_pin: GPIO18
259 |   mosi_pin: GPIO23
260 | 
261 | font:
262 |   - file: "gfonts://Roboto"
263 |     id: font_small
264 |     size: 14
265 |   - file: "gfonts://Roboto"
266 |     id: font_big
267 |     size: 18
268 | 
269 | display:
270 |   - platform: ssd1306_spi
271 |     model: "SH1106 128x64"
272 |     cs_pin: GPIO5
273 |     dc_pin: GPIO16
274 |     reset_pin: GPIO17
275 |     id: oled_display
276 |     rotation: 180
277 |     update_interval: 500ms
278 |     pages:
279 |       - id: page_main
280 |         lambda: |-
281 |           if (!id(screen_on)) return;
282 | 
283 |           if (id(display_message)) {
284 |             it.print(64, 20, id(font_small), TextAlign::BASELINE_CENTER, id(message_line1).c_str());
285 |             it.print(64, 40, id(font_small), TextAlign::BASELINE_CENTER, id(message_line2).c_str());
286 |           } else {
287 |             const int y1 = -2;
288 |             const int y2 = 12;
289 |             const int y3 = 26;
290 |             const int y4 = 40;
291 | 
292 |             auto get_label = [](int page, int btn) -> std::string {
293 |               switch (page) {
294 |                 case 1:
295 |                   if (btn == 1) return std::string("${p1_b1_label}");
296 |                   if (btn == 2) return std::string("${p1_b2_label}");
297 |                   if (btn == 3) return std::string("${p1_b3_label}");
298 |                   if (btn == 4) return std::string("${p1_b4_label}");
299 |                   break;
300 |                 case 2:
301 |                   if (btn == 1) return std::string("${p2_b1_label}");
302 |                   if (btn == 2) return std::string("${p2_b2_label}");
303 |                   if (btn == 3) return std::string("${p2_b3_label}");
304 |                   if (btn == 4) return std::string("${p2_b4_label}");
305 |                   break;
306 |                 case 3:
307 |                   if (btn == 1) return std::string("${p3_b1_label}");
308 |                   if (btn == 2) return std::string("${p3_b2_label}");
309 |                   if (btn == 3) return std::string("${p3_b3_label}");
310 |                   if (btn == 4) return std::string("${p3_b4_label}");
311 |                   break;
312 |                 case 4:
313 |                   if (btn == 1) return std::string("${p4_b1_label}");
314 |                   if (btn == 2) return std::string("${p4_b2_label}");
315 |                   if (btn == 3) return std::string("${p4_b3_label}");
316 |                   if (btn == 4) return std::string("${p4_b4_label}");
317 |                   break;
318 |               }
319 |               return std::string("");
320 |             };
321 | 
322 |             it.print(6, y1, id(font_small), get_label(id(current_page), 1).c_str());
323 |             it.print(6, y2, id(font_small), get_label(id(current_page), 2).c_str());
324 |             it.print(6, y3, id(font_small), get_label(id(current_page), 3).c_str());
325 |             it.print(6, y4, id(font_small), get_label(id(current_page), 4).c_str());
326 | 
327 |             char buf[8];
328 |             snprintf(buf, sizeof(buf), "P%d", id(current_page));
329 |             it.print(110, 54, id(font_big), TextAlign::BOTTOM_RIGHT, buf);
330 |           }
331 | 
332 | # =========================
333 | # Optional soft buttons to force page
334 | # =========================
335 | button:
336 |   - platform: template
337 |     name: "Keypad: Set Page 1"
338 |     on_press:
339 |       - lambda: |-
340 |           id(current_page) = 1;
341 |       - script.execute: restart_sleep_timer
342 |   - platform: template
343 |     name: "Keypad: Set Page 2"
344 |     on_press:
345 |       - lambda: |-
346 |           id(current_page) = 2;
347 |       - script.execute: restart_sleep_timer
348 |   - platform: template
349 |     name: "Keypad: Set Page 3"
350 |     on_press:
351 |       - lambda: |-
352 |           id(current_page) = 3;
353 |       - script.execute: restart_sleep_timer
354 |   - platform: template
355 |     name: "Keypad: Set Page 4"
356 |     on_press:
357 |       - lambda: |-
358 |           id(current_page) = 4;
359 |       - script.execute: restart_sleep_timer
360 | 
361 | # =========================
362 | # Binary sensors (merged)
363 | # =========================
364 | binary_sensor:
365 |   - platform: template
366 |     name: "Keypad Screen Awake"
367 |     id: bs_screen_awake
368 |     lambda: |-
369 |       return id(screen_on);
370 |     device_class: power
371 |   - platform: gpio
372 |     internal: true
373 |     pin:
374 |       number: GPIO12
375 |       mode:
376 |         input: true
377 |         pullup: true
378 |       inverted: true
379 |     name: "Key 1"
380 |     filters:
381 |       - delayed_on: 10ms
382 |       - delayed_off: 10ms
383 |     on_multi_click:
384 |       - timing:
385 |           - ON for at least 2000ms
386 |         then:
387 |           - lambda: |-
388 |               if (!id(screen_on)) {
389 |                 id(screen_on) = true;
390 |                 id(sw_screen_power).publish_state(true);
391 |               }
392 |               id(current_page) = 1;
393 |           - script.execute: restart_sleep_timer
394 |       - timing:
395 |           - ON for at most 350ms
396 |           - OFF for at least 120ms
397 |         then:
398 |           - lambda: |-
399 |               bool was_screen_off = !id(screen_on);
400 |               if (was_screen_off) {
401 |                 id(screen_on) = true;
402 |                 id(sw_screen_power).publish_state(true);
403 |                 return;
404 |               }
405 |               id(homeassistant_event_triggered) = true;
406 |           - if:
407 |               condition:
408 |                 lambda: 'return id(homeassistant_event_triggered);'
409 |               then:
410 |                 - homeassistant.event:
411 |                     event: esphome.keypad_event
412 |                     data:
413 |                       page: !lambda 'return to_string(id(current_page));'
414 |                       button: "1"
415 |                       click: "single"
416 |                 - if:
417 |                     condition:
418 |                       lambda: 'return id(show_activate_enabled);'
419 |                     then:
420 |                       - script.execute:
421 |                           id: show_activation
422 |                           button: !lambda 'return 1;'
423 |           - lambda: |-
424 |               id(homeassistant_event_triggered) = false;
425 |           - script.execute: restart_sleep_timer
426 |   - platform: gpio
427 |     internal: true
428 |     pin:
429 |       number: GPIO13
430 |       mode:
431 |         input: true
432 |         pullup: true
433 |       inverted: true
434 |     name: "Key 2"
435 |     filters:
436 |       - delayed_on: 10ms
437 |       - delayed_off: 10ms
438 |     on_multi_click:
439 |       - timing:
440 |           - ON for at least 2000ms
441 |         then:
442 |           - lambda: |-
443 |               if (!id(screen_on)) {
444 |                 id(screen_on) = true;
445 |                 id(sw_screen_power).publish_state(true);
446 |               }
447 |               id(current_page) = 2;
448 |           - script.execute: restart_sleep_timer
449 |       - timing:
450 |           - ON for at most 350ms
451 |           - OFF for at least 120ms
452 |         then:
453 |           - lambda: |-
454 |               bool was_screen_off = !id(screen_on);
455 |               if (was_screen_off) {
456 |                 id(screen_on) = true;
457 |                 id(sw_screen_power).publish_state(true);
458 |                 return;
459 |               }
460 |               id(homeassistant_event_triggered) = true;
461 |           - if:
462 |               condition:
463 |                 lambda: 'return id(homeassistant_event_triggered);'
464 |               then:
465 |                 - homeassistant.event:
466 |                     event: esphome.keypad_event
467 |                     data:
468 |                       page: !lambda 'return to_string(id(current_page));'
469 |                       button: "2"
470 |                       click: "single"
471 |                 - if:
472 |                     condition:
473 |                       lambda: 'return id(show_activate_enabled);'
474 |                     then:
475 |                       - script.execute:
476 |                           id: show_activation
477 |                           button: !lambda 'return 2;'
478 |           - lambda: |-
479 |               id(homeassistant_event_triggered) = false;
480 |           - script.execute: restart_sleep_timer
481 |   - platform: gpio
482 |     internal: true
483 |     pin:
484 |       number: GPIO27
485 |       mode:
486 |         input: true
487 |         pullup: true
488 |       inverted: true
489 |     name: "Key 3"
490 |     filters:
491 |       - delayed_on: 10ms
492 |       - delayed_off: 10ms
493 |     on_multi_click:
494 |       - timing:
495 |           - ON for at least 2000ms
496 |         then:
497 |           - lambda: |-
498 |               if (!id(screen_on)) {
499 |                 id(screen_on) = true;
500 |                 id(sw_screen_power).publish_state(true);
501 |               }
502 |               id(current_page) = 3;
503 |           - script.execute: restart_sleep_timer
504 |       - timing:
505 |           - ON for at most 350ms
506 |           - OFF for at least 120ms
507 |         then:
508 |           - lambda: |-
509 |               bool was_screen_off = !id(screen_on);
510 |               if (was_screen_off) {
511 |                 id(screen_on) = true;
512 |                 id(sw_screen_power).publish_state(true);
513 |                 return;
514 |               }
515 |               id(homeassistant_event_triggered) = true;
516 |           - if:
517 |               condition:
518 |                 lambda: 'return id(homeassistant_event_triggered);'
519 |               then:
520 |                 - homeassistant.event:
521 |                     event: esphome.keypad_event
522 |                     data:
523 |                       page: !lambda 'return to_string(id(current_page));'
524 |                       button: "3"
525 |                       click: "single"
526 |                 - if:
527 |                     condition:
528 |                       lambda: 'return id(show_activate_enabled);'
529 |                     then:
530 |                       - script.execute:
531 |                           id: show_activation
532 |                           button: !lambda 'return 3;'
533 |           - lambda: |-
534 |               id(homeassistant_event_triggered) = false;
535 |           - script.execute: restart_sleep_timer
536 |   - platform: gpio
537 |     internal: true
538 |     pin:
539 |       number: GPIO14
540 |       mode:
541 |         input: true
542 |         pullup: true
543 |       inverted: true
544 |     name: "Key 4"
545 |     filters:
546 |       - delayed_on: 10ms
547 |       - delayed_off: 10ms
548 |     on_multi_click:
549 |       - timing:
550 |           - ON for at least 2000ms
551 |         then:
552 |           - lambda: |-
553 |               if (!id(screen_on)) {
554 |                 id(screen_on) = true;
555 |                 id(sw_screen_power).publish_state(true);
556 |               }
557 |               id(current_page) = 4;
558 |           - script.execute: restart_sleep_timer
559 |       - timing:
560 |           - ON for at most 350ms
561 |           - OFF for at least 120ms
562 |         then:
563 |           - lambda: |-
564 |               bool was_screen_off = !id(screen_on);
565 |               if (was_screen_off) {
566 |                 id(screen_on) = true;
567 |                 id(sw_screen_power).publish_state(true);
568 |                 return;
569 |               }
570 |               id(homeassistant_event_triggered) = true;
571 |           - if:
572 |               condition:
573 |                 lambda: 'return id(homeassistant_event_triggered);'
574 |               then:
575 |                 - homeassistant.event:
576 |                     event: esphome.keypad_event
577 |                     data:
578 |                       page: !lambda 'return to_string(id(current_page));'
579 |                       button: "4"
580 |                       click: "single"
581 |                 - if:
582 |                     condition:
583 |                       lambda: 'return id(show_activate_enabled);'
584 |                     then:
585 |                       - script.execute:
586 |                           id: show_activation
587 |                           button: !lambda 'return 4;'
588 |           - lambda: |-
589 |               id(homeassistant_event_triggered) = false;
590 |           - script.execute: restart_sleep_timer


--------------------------------------------------------------------------------
/HOW TO - DIY Smart Desk Controller/DeskController.yaml:
--------------------------------------------------------------------------------
  1 | substitutions:
  2 |   #-------------------------------
  3 |   # Section 1 - Device Naming
  4 |   #-------------------------------
  5 |   display_name: Nextion Key Light and Desk Control
  6 |   device_name: Flexispot E7Q
  7 |   name: flexispot_e7q
  8 |   
  9 |   #-------------------------------
 10 |   # Section 2 - Desk Height Limits (in cm)
 11 |   #-------------------------------
 12 |   min_height: "79"  # Min height + 0.1
 13 |   max_height: "113" # Max height - 0.1
 14 |   
 15 |   #-------------------------------
 16 |   # Section 3 - Credentials
 17 |   #-------------------------------
 18 |   wifi_ssid: !secret wifi_ssid
 19 |   wifi_password: !secret wifi_password
 20 |   wifi_ap_ssid: "Combined Fallback Hotspot"
 21 |   wifi_ap_password: "Ss8DFnbVgti"
 22 |   
 23 |   # API Encryption Key
 24 |   api_key: "JJmgHTG3pewaU9/nobHzRBrekgVb/Zf6qhXyXY/oT0g="
 25 |   
 26 |   # OTA Password
 27 |   ota_password: "99ab8b62c4de8d68b556b5ac2a13e750"
 28 |   
 29 |   #-------------------------------
 30 |   # Section 4 - HA Entity IDs for Notifications
 31 |   #-------------------------------
 32 |   
 33 |   ha_notification_title: input_text.notification_title
 34 |   ha_notification_message: input_text.notification_message
 35 |   ha_virtual_screen: switch.virtual_screen
 36 |   
 37 |   #-------------------------------
 38 |   # Section 5 - HA Entity IDs for Buttons on Lights Page
 39 |   #-------------------------------
 40 |   
 41 |   button_1: light.left_key_light      # Button 1: Left Key Light
 42 |   button_2: light.right_key_light     # Button 2: Right Key Light
 43 |   button_3: light.ring_light          # Button 3: Ring Light
 44 |   button_4: switch.playroom_light     # Button 4: Playroom Light
 45 |   button_5: fan.office_fan            # Button 5: Office Fan
 46 | 
 47 | # ESPHome Configuration
 48 | esphome:
 49 |   name: ${name}
 50 | 
 51 | # Global Variables
 52 | globals:
 53 |   - id: current_page
 54 |     type: int
 55 |     restore_value: no
 56 |     initial_value: '0'  # Tracks the current Nextion page
 57 | 
 58 | # Text Sensors for Notifications and Page Labels
 59 | text_sensor:
 60 |   # Notification Title from Home Assistant
 61 |   - platform: homeassistant
 62 |     entity_id: ${ha_notification_title}
 63 |     id: notification_title
 64 |     on_value:
 65 |       then:
 66 |         - lambda: |-
 67 |             if (id(current_page) == 3) {  // Update only on Notification Page
 68 |               id(my_nextion).send_command(("t0.txt=\"" + id(notification_title).state + "\"").c_str());
 69 |             }
 70 |   # Notification Message from Home Assistant
 71 |   - platform: homeassistant
 72 |     entity_id: ${ha_notification_message}
 73 |     id: notification_message
 74 |     on_value:
 75 |       then:
 76 |         - lambda: |-
 77 |             if (id(current_page) == 3) {  // Update only on Notification Page
 78 |               id(my_nextion).send_command(("t1.txt=\"" + id(notification_message).state + "\"").c_str());
 79 |             }
 80 |   # Current Page Label for Debugging
 81 |   - platform: template
 82 |     name: "Current Page Label"
 83 |     id: current_page_label
 84 |     lambda: |-
 85 |       switch (id(current_page)) {
 86 |         case 0: return std::string("Home Page");
 87 |         case 1: return std::string("Lights Page");
 88 |         case 2: return std::string("Desk Page");
 89 |         case 3: return std::string("Notification Page");
 90 |         default: return std::string("Unknown Page");
 91 |       }
 92 |     update_interval: never
 93 | 
 94 | # ESP32 Board Configuration
 95 | esp32:
 96 |   board: esp32dev
 97 | 
 98 | # WiFi Configuration
 99 | wifi:
100 |   ssid: ${wifi_ssid}
101 |   password: ${wifi_password}
102 |   ap:
103 |     ssid: ${wifi_ap_ssid}
104 |     password: ${wifi_ap_password}
105 | 
106 | captive_portal:
107 | 
108 | # Home Assistant API Integration
109 | api:
110 |   encryption:
111 |     key: ${api_key}
112 | 
113 | # Over-the-Air Updates
114 | ota:
115 |   platform: esphome
116 |   password: ${ota_password}
117 | 
118 | # Logging (Disabled Serial Logging to Free UART)
119 | logger:
120 |   baud_rate: 0
121 | 
122 | # External Component for Desk Control
123 | external_components:
124 |   source: github://iMicknl/LoctekMotion_IoT@v2
125 |   components: [ loctekmotion_desk_height ]
126 | 
127 | # UART Configuration
128 | uart:
129 |   - id: desk_uart
130 |     tx_pin: GPIO17  # Desk TX Pin
131 |     rx_pin: GPIO16  # Desk RX Pin
132 |     baud_rate: 9600
133 |   - id: nextion_uart
134 |     tx_pin: GPIO4   # Nextion TX Pin
135 |     rx_pin: GPIO5   # Nextion RX Pin
136 |     baud_rate: 9600
137 | 
138 | # Time Synchronization
139 | time:
140 |   - platform: sntp
141 |     id: sntp_time
142 | 
143 | # Sensors
144 | sensor:
145 |   # Desk Height Sensor
146 |   - platform: loctekmotion_desk_height
147 |     uart_id: desk_uart
148 |     id: desk_height
149 |     name: Desk Height
150 |     on_value_range:
151 |       - below: ${min_height}
152 |         then:
153 |           - switch.turn_off: switch_down  # Stop if below min height
154 |       - above: ${max_height}
155 |         then:
156 |           - switch.turn_off: switch_up    # Stop if above max height
157 |     on_value:
158 |       then:
159 |         - cover.template.publish:
160 |             id: desk_cover
161 |             position: !lambda |-
162 |               float position = (float(x) - float(${min_height})) / (float(${max_height}) - float(${min_height}));
163 |               return position;  // Calculate position as 0-1 range
164 |         - component.update: set_desk_height
165 |         - lambda: |-
166 |             char buf[30];
167 |             sprintf(buf, "t0.txt=\"%.1f cm\"", x);
168 |             if (id(current_page) == 2) {  // Update label on Desk Page
169 |               id(my_nextion).send_command(buf);
170 |             }
171 |   # WiFi Signal Strength
172 |   - platform: wifi_signal
173 |     name: "WiFi Signal"
174 |     update_interval: 60s
175 |   # Raw Uptime Sensor
176 |   - platform: uptime
177 |     name: "Uptime Raw"
178 |     id: raw_uptime
179 |   # Pretty Uptime (Hours * 100 + Minutes)
180 |   - platform: template
181 |     name: "Uptime"
182 |     lambda: |-
183 |       int seconds = (int) id(raw_uptime).state;
184 |       int minutes = (seconds / 60) % 60;
185 |       int hours = seconds / 3600;
186 |       return hours * 100 + minutes;
187 |     update_interval: 60s
188 |     id: uptime_pretty
189 | 
190 | # Switches
191 | switch:
192 |   # Desk Up Control
193 |   - platform: uart
194 |     name: "Desk Up"
195 |     id: switch_up
196 |     data: [0x9b, 0x06, 0x02, 0x01, 0x00, 0xfc, 0xa0, 0x9d]
197 |     uart_id: desk_uart
198 |     send_every: 108ms
199 |   # Desk Down Control
200 |   - platform: uart
201 |     name: "Desk Down"
202 |     id: switch_down
203 |     data: [0x9b, 0x06, 0x02, 0x02, 0x00, 0x0c, 0xa0, 0x9d]
204 |     uart_id: desk_uart
205 |     send_every: 108ms
206 |   # Virtual Screen Switch
207 |   - platform: gpio
208 |     name: "Virtual Screen"
209 |     pin:
210 |       number: GPIO23
211 |       mode: OUTPUT
212 |     restore_mode: ALWAYS_ON
213 |     entity_category: "config"
214 |     on_turn_on:
215 |       then:
216 |         - button.press: btn_display_on   # Turn on Nextion display
217 |     on_turn_off:
218 |       then:
219 |         - button.press: btn_display_off  # Turn off Nextion display
220 | 
221 | # Binary Sensors
222 | binary_sensor:
223 |   # Virtual Screen State from Home Assistant
224 |   - platform: homeassistant
225 |     entity_id: ${ha_virtual_screen}
226 |     id: ha_virtual_screen
227 |     on_state:
228 |       then:
229 |         - lambda: |-
230 |             if (id(ha_virtual_screen).state) {
231 |               id(my_nextion).send_command("dim=100");  // Screen on
232 |             } else {
233 |               id(my_nextion).send_command("dim=0");    // Screen off
234 |             }
235 |   # Button 3: Ring Light Toggle
236 |   - platform: nextion
237 |     page_id: 1
238 |     component_id: 3
239 |     id: p2
240 |     filters:
241 |       - delayed_off: 100ms
242 |     on_press:
243 |       then:
244 |         - logger.log: "Nextion Button 3 Pressed, toggling ring light."
245 |         - homeassistant.service:
246 |             service: light.toggle
247 |             data:
248 |               entity_id: ${button_3}
249 |   # Button 4: Playroom Light Toggle
250 |   - platform: nextion
251 |     page_id: 1
252 |     component_id: 4
253 |     id: p3
254 |     filters:
255 |       - delayed_off: 100ms
256 |     on_press:
257 |       then:
258 |         - logger.log: "Nextion Button 4 Pressed, toggling playroom light."
259 |         - homeassistant.service:
260 |             service: switch.toggle
261 |             data:
262 |               entity_id: ${button_4}
263 |   # Button 5: Office Fan Toggle
264 |   - platform: nextion
265 |     page_id: 1
266 |     component_id: 5
267 |     id: p4
268 |     filters:
269 |       - delayed_off: 100ms
270 |     on_press:
271 |       then:
272 |         - logger.log: "Nextion Button 5 Pressed, toggling office fan."
273 |         - homeassistant.service:
274 |             service: fan.toggle
275 |             data:
276 |               entity_id: ${button_5}
277 |   # Button 1: Left Key Light Toggle
278 |   - platform: nextion
279 |     page_id: 1
280 |     component_id: 1
281 |     id: p0
282 |     filters:
283 |       - delayed_off: 100ms
284 |     on_press:
285 |       then:
286 |         - logger.log: "Nextion Button Pressed, toggling left key light."
287 |         - homeassistant.service:
288 |             service: light.toggle
289 |             data:
290 |               entity_id: ${button_1}
291 |   # Button 2: Right Key Light Toggle
292 |   - platform: nextion
293 |     page_id: 1
294 |     component_id: 2
295 |     id: p1
296 |     filters:
297 |       - delayed_off: 100ms
298 |     on_press:
299 |       then:
300 |         - logger.log: "Nextion Button 2 Pressed, toggling right key light."
301 |         - homeassistant.service:
302 |             service: light.toggle
303 |             data:
304 |               entity_id: ${button_2}
305 |   # Button 1 State Sync
306 |   - platform: homeassistant
307 |     entity_id: ${button_1}
308 |     id: ha_button_1
309 |     on_state:
310 |       then:
311 |         - lambda: |-
312 |             if (id(current_page) == 1) {
313 |               if (id(ha_button_1).state) {
314 |                 id(my_nextion).send_command("p0.pic=1");  // On icon
315 |               } else {
316 |                 id(my_nextion).send_command("p0.pic=0");  // Off icon
317 |               }
318 |             }
319 |   # Button 2 State Sync
320 |   - platform: homeassistant
321 |     entity_id: ${button_2}
322 |     id: ha_button_2
323 |     on_state:
324 |       then:
325 |         - lambda: |-
326 |             if (id(current_page) == 1) {
327 |               if (id(ha_button_2).state) {
328 |                 id(my_nextion).send_command("p1.pic=1");  // On icon
329 |               } else {
330 |                 id(my_nextion).send_command("p1.pic=0");  // Off icon
331 |               }
332 |             }
333 |   # Button 3 State Sync
334 |   - platform: homeassistant
335 |     entity_id: ${button_3}
336 |     id: ha_button_3
337 |     on_state:
338 |       then:
339 |         - lambda: |-
340 |             if (id(current_page) == 1) {
341 |               if (id(ha_button_3).state) {
342 |                 id(my_nextion).send_command("p2.pic=1");  // On icon
343 |               } else {
344 |                 id(my_nextion).send_command("p2.pic=0");  // Off icon
345 |               }
346 |             }
347 |   # Button 4 State Sync
348 |   - platform: homeassistant
349 |     entity_id: ${button_4}
350 |     id: ha_button_4
351 |     on_state:
352 |       then:
353 |         - lambda: |-
354 |             if (id(current_page) == 1) {
355 |               if (id(ha_button_4).state) {
356 |                 id(my_nextion).send_command("p3.pic=1");  // On icon
357 |               } else {
358 |                 id(my_nextion).send_command("p3.pic=0");  // Off icon
359 |               }
360 |             }
361 |   # Button 5 State Sync
362 |   - platform: homeassistant
363 |     entity_id: ${button_5}
364 |     id: ha_button_5
365 |     on_state:
366 |       then:
367 |         - lambda: |-
368 |             if (id(current_page) == 1) {
369 |               if (id(ha_button_5).state) {
370 |                 id(my_nextion).send_command("p4.pic=1");  // On icon
371 |               } else {
372 |                 id(my_nextion).send_command("p4.pic=0");  // Off icon
373 |               }
374 |             }
375 |   # Desk Stand Preset Button
376 |   - platform: nextion
377 |     page_id: 2
378 |     component_id: 1
379 |     id: btn_desk_stand
380 |     filters:
381 |       - delayed_off: 100ms
382 |     on_release:
383 |       then:
384 |         - logger.log: "Standing Desk Stand button pressed."
385 |         - script.execute: desk_stand_script
386 |   # Desk Sit Preset Button
387 |   - platform: nextion
388 |     page_id: 2
389 |     component_id: 2
390 |     id: btn_desk_sit
391 |     filters:
392 |       - delayed_off: 100ms
393 |     on_release:
394 |       then:
395 |         - logger.log: "Standing Desk Sit button pressed."
396 |         - script.execute: desk_sit_script
397 |   # Desk Preset 3 Button
398 |   - platform: nextion
399 |     page_id: 2
400 |     component_id: 3
401 |     id: btn_desk_preset_3
402 |     filters:
403 |       - delayed_off: 100ms
404 |     on_release:
405 |       then:
406 |         - logger.log: "Standing Desk Preset 3 button pressed."
407 |         - script.execute: desk_preset3_script
408 |   # Desk Preset 4 Button
409 |   - platform: nextion
410 |     page_id: 2
411 |     component_id: 4
412 |     id: btn_desk_preset_4
413 |     filters:
414 |       - delayed_off: 100ms
415 |     on_release:
416 |       then:
417 |         - logger.log: "Standing Desk Preset 4 button pressed."
418 |         - script.execute: desk_preset4_script
419 | 
420 | # Desk Cover Entity for Height Control
421 | cover:
422 |   - platform: template
423 |     id: "desk_cover"
424 |     icon: mdi:desk
425 |     name: "Desk"
426 |     device_class: blind
427 |     has_position: true
428 |     position_action:
429 |       - if:
430 |           condition:
431 |             - lambda: !lambda |-
432 |                 return pos > id(desk_cover).position;
433 |           then:
434 |             - cover.open: desk_cover
435 |             - wait_until:
436 |                 lambda: |-
437 |                   return id(desk_cover).position >= pos;
438 |             - cover.stop: desk_cover
439 |           else:
440 |             - cover.close: desk_cover
441 |             - wait_until:
442 |                 lambda: |-
443 |                   return id(desk_cover).position <= pos;
444 |             - cover.stop: desk_cover
445 |     stop_action:
446 |       - switch.turn_off: switch_up
447 |       - switch.turn_off: switch_down
448 |     open_action:
449 |       - switch.turn_off: switch_down
450 |       - switch.turn_on: switch_up
451 |     close_action:
452 |       - switch.turn_off: switch_up
453 |       - switch.turn_on: switch_down
454 |     optimistic: false
455 | 
456 | # Buttons for Navigation and Display Control
457 | button:
458 |   # Turn On Nextion Display
459 |   - platform: template
460 |     name: "Nextion Display On"
461 |     id: btn_display_on
462 |     on_press:
463 |       then:
464 |         - uart.write:
465 |             id: nextion_uart
466 |             data: ["0x64", "0x69", "0x6d", "0x3d", "0x31", "0x30", "0x30", "0xff", "0xff", "0xff"]
467 |   # Turn Off Nextion Display
468 |   - platform: template
469 |     name: "Nextion Display Off"
470 |     id: btn_display_off
471 |     on_press:
472 |       then:
473 |         - uart.write:
474 |             id: nextion_uart
475 |             data: ["0x64", "0x69", "0x6d", "0x3d", "0x30", "0xff", "0xff", "0xff"]
476 |   # Go to Home Page
477 |   - platform: template
478 |     name: "Go to Home Page"
479 |     icon: mdi:home
480 |     on_press:
481 |       then:
482 |         - lambda: |-
483 |             id(my_nextion).send_command("page 0");
484 |             id(current_page) = 0;
485 |             id(current_page_label).publish_state("Home Page");
486 |             ESP_LOGI("nextion", "Switched to page 0");
487 |   # Go to Lights Page
488 |   - platform: template
489 |     name: "Go to Lights Page"
490 |     icon: mdi:lightbulb-group
491 |     on_press:
492 |       then:
493 |         - lambda: |-
494 |             id(my_nextion).send_command("page 1");
495 |             id(current_page) = 1;
496 |             id(current_page_label).publish_state("Lights Page");
497 |             ESP_LOGI("nextion", "Switched to page 1");
498 |             if (id(ha_button_1).state) {
499 |               id(my_nextion).send_command("p0.pic=1");  // Button 1 on
500 |             } else {
501 |               id(my_nextion).send_command("p0.pic=0");  // Button 1 off
502 |             }
503 |             if (id(ha_button_2).state) {
504 |               id(my_nextion).send_command("p1.pic=1");  // Button 2 on
505 |             } else {
506 |               id(my_nextion).send_command("p1.pic=0");  // Button 2 off
507 |             }
508 |             if (id(ha_button_3).state) {
509 |               id(my_nextion).send_command("p2.pic=1");  // Button 3 on
510 |             } else {
511 |               id(my_nextion).send_command("p2.pic=0");  // Button 3 off
512 |             }
513 |             if (id(ha_button_4).state) {
514 |               id(my_nextion).send_command("p3.pic=1");  // Button 4 on
515 |             } else {
516 |               id(my_nextion).send_command("p3.pic=0");  // Button 4 off
517 |             }
518 |             if (id(ha_button_5).state) {
519 |               id(my_nextion).send_command("p4.pic=1");  // Button 5 on
520 |             } else {
521 |               id(my_nextion).send_command("p4.pic=0");  // Button 5 off
522 |             }
523 |   # Go to Desk Page
524 |   - platform: template
525 |     name: "Go to Desk Page"
526 |     icon: mdi:desk
527 |     on_press:
528 |       then:
529 |         - lambda: |-
530 |             id(my_nextion).send_command("page 2");
531 |             id(current_page) = 2;
532 |             id(current_page_label).publish_state("Desk Page");
533 |             ESP_LOGI("nextion", "Switched to page 2");
534 |             char buf[30];
535 |             sprintf(buf, "t0.txt=\"%.1f cm\"", id(desk_height).state);
536 |             id(my_nextion).send_command(buf);
537 |   # Go to Notification Page
538 |   - platform: template
539 |     name: "Go to Notification Page"
540 |     icon: mdi:bell
541 |     on_press:
542 |       then:
543 |         - lambda: |-
544 |             id(my_nextion).send_command("page 3");
545 |             id(current_page) = 3;
546 |             id(current_page_label).publish_state("Notification Page");
547 |             ESP_LOGI("nextion", "Switched to page 3");
548 |             id(my_nextion).send_command(("t0.txt=\"" + id(notification_title).state + "\"").c_str());
549 |             id(my_nextion).send_command(("t1.txt=\"" + id(notification_message).state + "\"").c_str());
550 | 
551 | # Desk Height Number Control
552 | number:
553 |   - platform: template
554 |     name: "Desk Height"
555 |     id: set_desk_height
556 |     min_value: ${min_height}
557 |     max_value: ${max_height}
558 |     icon: mdi:ruler
559 |     unit_of_measurement: "cm"
560 |     device_class: "distance"
561 |     step: 0.1
562 |     lambda: |-
563 |       return id(desk_height).state;
564 |     set_action:
565 |       - if:
566 |           condition:
567 |             - lambda: |-
568 |                 return x > id(desk_height).state;
569 |           then:
570 |             - cover.open: desk_cover
571 |             - wait_until:
572 |                 lambda: |-
573 |                   return id(desk_height).state >= x;
574 |             - cover.stop: desk_cover
575 |           else:
576 |             - cover.close: desk_cover
577 |             - wait_until:
578 |                 lambda: |-
579 |                   return id(desk_height).state <= x;
580 |             - cover.stop: desk_cover
581 | 
582 | # Nextion Display Configuration
583 | display:
584 |   - platform: nextion
585 |     id: my_nextion
586 |     uart_id: nextion_uart
587 |     update_interval: 700ms
588 |     on_page:
589 |       then:
590 |         - lambda: |-
591 |             id(current_page) = x;
592 |             switch (x) {
593 |               case 0:
594 |                 id(current_page_label).publish_state("Home Page");
595 |                 ESP_LOGI("nextion", "Nextion switched to page 0");
596 |                 break;
597 |               case 1:
598 |                 id(current_page_label).publish_state("Lights Page");
599 |                 ESP_LOGI("nextion", "Nextion switched to page 1");
600 |                 if (id(ha_button_1).state) {
601 |                   id(my_nextion).send_command("p0.pic=1");  // Button 1 on
602 |                 } else {
603 |                   id(my_nextion).send_command("p0.pic=0");  // Button 1 off
604 |                 }
605 |                 if (id(ha_button_2).state) {
606 |                   id(my_nextion).send_command("p1.pic=1");  // Button 2 on
607 |                 } else {
608 |                   id(my_nextion).send_command("p1.pic=0");  // Button 2 off
609 |                 }
610 |                 if (id(ha_button_3).state) {
611 |                   id(my_nextion).send_command("p2.pic=1");  // Button 3 on
612 |                 } else {
613 |                   id(my_nextion).send_command("p2.pic=0");  // Button 3 off
614 |                 }
615 |                 if (id(ha_button_4).state) {
616 |                   id(my_nextion).send_command("p3.pic=1");  // Button 4 on
617 |                 } else {
618 |                   id(my_nextion).send_command("p3.pic=0");  // Button 4 off
619 |                 }
620 |                 if (id(ha_button_5).state) {
621 |                   id(my_nextion).send_command("p4.pic=1");  // Button 5 on
622 |                 } else {
623 |                   id(my_nextion).send_command("p4.pic=0");  // Button 5 off
624 |                 }
625 |                 break;
626 |               case 2:
627 |                 id(current_page_label).publish_state("Desk Page");
628 |                 ESP_LOGI("nextion", "Nextion switched to page 2");
629 |                 char buf[30];
630 |                 sprintf(buf, "t0.txt=\"%.1f cm\"", id(desk_height).state);
631 |                 id(my_nextion).send_command(buf);
632 |                 break;
633 |               case 3:
634 |                 id(current_page_label).publish_state("Notification Page");
635 |                 ESP_LOGI("nextion", "Nextion switched to page 3");
636 |                 id(my_nextion).send_command(("t0.txt=\"" + id(notification_title).state + "\"").c_str());
637 |                 id(my_nextion).send_command(("t1.txt=\"" + id(notification_message).state + "\"").c_str());
638 |                 break;
639 |               default:
640 |                 id(current_page_label).publish_state("Unknown Page");
641 |                 ESP_LOGI("nextion", "Nextion switched to unknown page");
642 |                 break;
643 |             }
644 | 
645 | # Scripts for Desk Presets
646 | script:
647 |   # Sit Position
648 |   - id: desk_sit_script
649 |     then:
650 |       - uart.write:
651 |           id: desk_uart
652 |           data: [0x9b, 0x06, 0x02, 0x08, 0x00, 0xac, 0xa6, 0x9d]
653 |   # Stand Position
654 |   - id: desk_stand_script
655 |     then:
656 |       - uart.write:
657 |           id: desk_uart
658 |           data: [0x9b, 0x06, 0x02, 0x04, 0x00, 0xac, 0xa3, 0x9d]
659 |   # Preset 3
660 |   - id: desk_preset3_script
661 |     then:
662 |       - uart.write:
663 |           id: desk_uart
664 |           data: [0x9b, 0x06, 0x02, 0x00, 0x01, 0xac, 0x60, 0x9d]
665 |   # Preset 4
666 |   - id: desk_preset4_script
667 |     then:
668 |       - uart.write:
669 |           id: desk_uart
670 |           data: [0x9b, 0x06, 0x02, 0x10, 0x00, 0xac, 0xac, 0x9d]


--------------------------------------------------------------------------------