HA-Home-Remote

KO | EN

gitlite — search

#markdown #cpp #go #pytorch #reactjs #large-language-models #android #awesome #framework #github

(★ 9)

Home Remote for Home Assistant that uses esphome

파일 탐색기

ZIP 다운로드

- - background_header.png
  - color_wheel.png
  - home_screen_day_header.png
  - home_screen_day_rain_header.png
  - home_screen_header.png
  - home_screen_header_example.png
  - home_screen_night_header.png
  - home_screen_night_rain_header.png
  - images.yaml
  - plain_background.png
  - plex_screen.png
  - settings_screen.png
  - splash.png
  - youtube_screen.png
- - main.yaml
- - ble.yaml
  - ha_entities.yaml
  - hardware.yaml
  - online_images.yaml
  - scripts.yaml
  - sensors.yaml
  - theme.yaml
  - wifi_api.yaml
home-remote.yaml
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Home Remote for Home Assistant that uses esphome

Config and structures might not be exactly the same as below 
═══════════════════════════════════════════════════════════════
  HOME REMOTE — Hardware, software layout & HA integration
  ESP32-S3-N16R8 · Waveshare 2" ST7789 + CST816 · ESPHome LVGL
  Document matches current project (home-remote / home_remote/)
═══════════════════════════════════════════════════════════════

═══════════════════════════════════════════════════════════════
                         POWER SECTION
═══════════════════════════════════════════════════════════════
     2 × 1200 mAh LiPo in SERIES (2S)
     ┌────────n─────┐
     │ +         -  │
     └───┬───────┬──┘
         │       │
         │ BAT+  │ BAT–
         ▼       ▼
    ┌────────────────────┐
    │ CN3302             │
    │ 2S Charger         │
    │ USB-C Input        │
    │ Charges to 8.4 V   │
    └─────────┬──────────┘
              │ Pack voltage (≈6.0–8.4 V)
              ▼
    ┌────────────────────┐
    │ Pololu 3781        │
    │ D36V28F3           │
    │ VIN = Pack         │
    │ VOUT = 3.3 V       │
    │ EN = High          │
    │ GND = GND          │
    └─────────┬──────────┘
              │
         3.3 V Rail
              │
    ┌─────────┴────────────────────────────────────────────┐
    │                                                      │
    ▼                                                      ▼
  ESP32-S3-N16R8 Module                          All peripherals

Power-saving notes (software):
  • Deep sleep: MPU6050 Wake-on-Motion (GPIO3 RISING)
  • CST816 / display sleep + backlight off before sleep
  • WiFi power_save LIGHT; flash power-down in deep sleep (sdkconfig)
  • Optional hardware: remove onboard power LED / USB-UART for lower idle draw

═══════════════════════════════════════════════════════════════
                    ESP32-S3-N16R8 MODULE
═══════════════════════════════════════════════════════════════
 Module Pin     Signal              Destination
 ─────────────────────────────────────────────────────────────
  3V3           3.3 V               ← Pololu 3781 VOUT
  GND           GND                 Common ground
  GPIO12        SPI SCK             → Display CLK
  GPIO11        SPI MOSI            → Display DIN
  GPIO10        SPI CS              → Display CS
  GPIO9         SPI DC              → Display DC
  GPIO8         SPI RST             → Display RST
  GPIO7         Backlight PWM       → Display BL (LEDC)
  GPIO5         I²C SDA             → Touch TP_SDA, MCP23017, MPU6050
  GPIO6         I²C SCL             → Touch TP_SCL, MCP23017, MPU6050
  GPIO4         Touch INT           → CST816 INT (activity / wake helper)
  GPIO3         MPU6050 INT         → Deep-sleep wake (WoM, active HIGH)
  GPIO15        MCP23017 INT        → MCP INT (activity; not primary wake pin)
  GPIO2         IR Drive            → A2SHB / SI2302 gate
  GPIO1         Button Vol Up       → Button → GND (pull-up)
  GPIO13        Button Settings     → Button → GND (short=TV settings, long=remote settings)
  GPIO14        Button Home         → Button → GND (UI home + TV home)
  GPIO21        Button Power        → Button → GND (short=TV power, long=force sleep)
  GPIO47        Button Source       → Button → GND
  GPIO16        Button Up           → Button → GND  *** GPIO48 was unreliable; use GPIO16 ***
  GPIO17        Battery ADC         → Voltage divider mid-point (2S pack sense)

═══════════════════════════════════════════════════════════════
                         FREE / SPARE PINS
═══════════════════════════════════════════════════════════════
GPIO    Notes
GPIO18  Free
GPIO38  Free
GPIO39  Free
GPIO40  Free
GPIO41  Free
GPIO42  Free
GPIO48  Avoid for buttons on this board (unreliable) — Up moved to GPIO16

═══════════════════════════════════════════════════════════════
                 WAVESHARE 2" DISPLAY (ST7789 240×320)
═══════════════════════════════════════════════════════════════
 Display Pin        Connection
 ──────────────────────────────────────
 VCC                3.3 V
 GND                GND
 SCL / CLK          GPIO12
 SDA / DIN / MOSI   GPIO11
 CS                 GPIO10
 DC                 GPIO9
 RST                GPIO8
 BL                 GPIO7 (PWM backlight)
 TP_SDA             GPIO5
 TP_SCL             GPIO6
 TP_INT             GPIO4 (CST816, addr 0x15)

ESPHome: platform mipi_spi / ST7789V, invert_colors, BGR, 40 MHz SPI
 Touch: platform cst816, on_release → screen_wake

═══════════════════════════════════════════════════════════════
                      MCP23017 (addr 0x20)
═══════════════════════════════════════════════════════════════
 MCP23017 Pin   Connection
 ──────────────────────────────────────
 VDD            3.3 V
 VSS            GND
 SDA            GPIO5
 SCL            GPIO6
 RESET          3.3 V
 A0,A1,A2       GND (address 0x20)
 INTA           GPIO15 (open-drain / active low; configured in software)

GPA0 → Button 1  Right
 GPA1 → Button 2  Select/Enter
 GPA2 → Button 3  Volume Down
 GPA3 → Button 4  Mute
 GPA4 → Button 5  Covers (UI page)
 GPA5 → Button 6  Security / Cameras
 GPA6 → Button 7  Movie Mode
 GPA7 → Button 8  YouTube
 GPB0 → Button 9  Plex
 GPB1 → Button 10 Netflix
 GPB2 → Button 11 Home Assistant (Devices page)
 GPB3 → Button 12 Lights (All lights page)
 GPB4 → Button 13 Play/Pause
 GPB5 → Button 14 Back
 GPB6 → Button 15 Left
 GPB7 → Button 16 Down

interrupt: CHANGE on expander pins; INT line used for activity (deep-sleep
 primary wake remains MPU GPIO3).

═══════════════════════════════════════════════════════════════
                         MPU6050 (addr 0x68)
═══════════════════════════════════════════════════════════════
 MPU6050 Pin    Connection
 ──────────────────────────────────────
 VCC            3.3 V
 GND            GND
 SDA            GPIO5
 SCL            GPIO6
 INT            GPIO3 (Wake-on-Motion, active HIGH, latched)
 AD0            GND (address 0x68)

Software: registers armed in script mpu_motion_enable before deep sleep
 (threshold, duration, cycle mode). Motion clears INT + screen_wake when awake.

═══════════════════════════════════════════════════════════════
                      IR TRANSMITTER
═══════════════════════════════════════════════════════════════
 GPIO2 ─────── Gate of A2SHB (SI2302)
                  │
                Source ── GND
                  │
                Drain ── IR LED Cathode
                           │
                      47–68 Ω
                           │
                        3.3 V

remote_transmitter: pin GPIO2, non_blocking: true

═══════════════════════════════════════════════════════════════
            BATTERY VOLTAGE (2S pack via divider)
═══════════════════════════════════════════════════════════════
 Pack+ ── R1 (110 kΩ) ──┬── GPIO17 (ADC1)
                        │
                     R2 (62 kΩ)
                        │
                       GND

Ratio ≈ 62/(110+62) ≈ 0.3605 → multiply ≈ 2.7742 (in sensors.yaml)
 Max pack 8.4 V → ADC ≈ 3.03 V (under 3.3 V)

Template battery %: 8.30 V → 100%, 6.40 V → 0% (linear between)

═══════════════════════════════════════════════════════════════
                    BUTTON SUMMARY (22 total)
═══════════════════════════════════════════════════════════════
 Buttons 1–16  → MCP23017 GPA0–GPB7 (active low, pull-up)
 Buttons 17–22 → ESP32 GPIO1, 13, 14, 21, 47, 16 (active low, pull-up)
                 (Vol Up, Settings, Home, Power, Source, Up)

All buttons use internal pull-ups (no external resistors needed).

═══════════════════════════════════════════════════════════════
              TV CONTROL (floor-aware via Bermuda)
═══════════════════════════════════════════════════════════════
 Floor from HA: sensor.home_remote_floor (text_sensor ha_floor)

If floor name contains "Up" / "up" → Main Bedroom TV scripts
 Else (Downstairs / unknown)       → Living Room TV scripts

Living room scripts (examples):
   script.livingroom_tv_back / dpad_* / home / toggle_mute /
   open_netflix|plex|youtube / play_pause / power /
   source_select / volume_up|down / quick_settings

Main bedroom scripts:
   script.mainbedroom_tv_back / dpad_* / home / mute /
   open_netflix|plex|youtube / play_pause / power /
   source_select / volume_up|down / quick_settings

Local ESPHome scripts: tv_back, tv_dpad_*, tv_home, tv_mute, tv_netflix,
 tv_plex, tv_youtube, tv_play_pause, tv_power, tv_source, tv_vol_*, tv_settings

═══════════════════════════════════════════════════════════════
                         NOTES
═══════════════════════════════════════════════════════════════
• All logic at 3.3 V — no level shifters.
• Keep SPI traces (GPIO12/11/10/9/8) under ~100 mm.
• Decouple 100 nF + 10 µF at ESP32 3V3, display VCC, MCP23017, MPU6050.
• Pololu EN enabled (high / floating per module).
• Common GND everywhere.
• GPIO3 is a strapping pin — used carefully as MPU INT only.
• BLE: Bermuda iBeacon advertising for room/floor tracking.

═══════════════════════════════════════════════════════════════
                    ESPHOME PROJECT LAYOUT
═══════════════════════════════════════════════════════════════
 /config/esphome/
 ├── home-remote.yaml          ← dashboard device (substitutions, packages, on_boot)
 ├── secrets.yaml
 │
 └── home_remote/
     ├── packages/
     │   ├── hardware.yaml     buses, display, touch, MCP, IR, buttons
     │   ├── ble.yaml          Bermuda tracking
     │   ├── wifi_api.yaml     WiFi, API, OTA, logger
     │   ├── sensors.yaml      battery ADC, MPU (internal), WiFi RSSI
     │   ├── scripts.yaml      idle/sleep, UI refresh, TV routing, theme, cams
     │   ├── theme.yaml        colours + fonts (Roboto + MDI icons)
     │   ├── ha_entities.yaml  HA state mirrors
     │   └── online_images.yaml
     │
     ├── lvgl/
     │   ├── main.yaml         LVGL root (styles, splash entry)
     │   └── pages/
     │       ├── splash.yaml, home.yaml, rooms.yaml, rooms_up.yaml
     │       ├── living / dining / kitchen / outside
     │       ├── main_bed / noah / work / study
     │       ├── lights.yaml, lights_up.yaml
     │       ├── devices.yaml, devices_up.yaml
     │       ├── covers.yaml + cover_*.yaml
     │       ├── security.yaml (cameras)
     │       ├── plex / youtube / media_generic
     │       ├── rgb_wled / rgb_tvback / dim_*
     │       └── settings / settings_theme / settings_screen / settings_sleep
     │
     └── images/
         ├── images.yaml
         ├── splash.png, plain_background.png, background_header.png
         ├── home_screen_day_header.png, home_screen_day_rain_header.png
         ├── home_screen_night_header.png, home_screen_night_rain_header.png
         ├── plex_screen.png, youtube_screen.png, settings_screen.png
         ├── color_wheel.png, img remote floor asset
         └── (Plex poster loaded online from HA /local/images/media/…)

═══════════════════════════════════════════════════════════════
                         UI BEHAVIOUR
═══════════════════════════════════════════════════════════════
• Splash on boot → Home after connect / wake path
• Home: solar/temps overview, day/night+rain backgrounds, floor icon (Bermuda),
  Rooms + Media buttons
• Rooms / Lights / Devices pages switch Upstairs vs Downstairs by floor sensor
• Covers same all floors; Security cameras stream to LR or bedroom TV by floor
• Overrides: lights + covers icons on Rooms / Lights / Covers pages
• Theme settings: pick category + colour wheel; colours persisted in globals
• Screen: bright → dim → off → deep sleep (HA-adjustable numbers, restore_value)
• No swipe-to-go-back (conflicts with sliders); Back + Home icon buttons on pages
• WiFi icons: full ≥−55 dBm, half −56…−63, alert <−63, off if disconnected

═══════════════════════════════════════════════════════════════
                    ROOMS (UI navigation)
═══════════════════════════════════════════════════════════════
 Downstairs: Living Room · Dining Room · Kitchen Laundry · Outside
 Upstairs:   Main Bedroom · Noah's Room · Work Room · Study

═══════════════════════════════════════════════════════════════
                    ENTITIES (HA ↔ remote)
═══════════════════════════════════════════════════════════════

Lights (toggle) — downstairs examples
  light.living_room_strip_lights
  light.living_room_down_light
  light.dining_room_down_light
  light.kitchen
  light.laundry_light
  light.stairs_bottom_light
  light.guest_bathroom_light
  light.court_yard_light
  light.garage_light
  light.driveway_light
  light.patio_light
  light.pool_light

RGB / effects / dimmable
  light.drop_ceiling                    Ambient WLED (+ rgb/hs attributes)
  light.tv_wall_lights_dreyer_sign      Dreyer Sign (dim)
  light.tv_wall_lights_tv_wall_backlight TV backlight RGB
  light.front_garden_floodlight         Garden flood (+ color_temp_kelvin)

Upstairs lights
  light.main_bedroom
  light.main_bathroom_light
  light.bedside_lamp_bedside_lamp       (dimmable)
  light.noah_s_bedroom_light
  light.noah_bathroom_light
  light.noah_s_lamp_noah_s_lamp         (dimmable)
  light.work_room_light
  light.study_light
  light.stairs_top_light

Covers
  cover.living_room_blinds
  cover.dining_room_blinds
  cover.kitchen_blinds
  cover.sliding_door_curtains

Devices
  switch.geyser_power
  input_boolean.geyser_on_timer
  switch.oven_switch
  switch.pool_pump_switch
  input_boolean.dog_feed
  switch.power_plug                     (upstairs devices page)

Overrides
  input_boolean.strip_lights_overide
  input_boolean.living_room_curtain_overide

Climate / solar (home screen)
  sensor.solar_weather_station_solar_weather_temp   (outside)
  sensor.living_room_climate_temperature
  sensor.pool_temperature_temperature
  (+ solar load / PV / battery SOC entities as configured in ha_entities)

Weather / time for backgrounds
  sensor.time_of_day
  weather.system_forecast_home

Floor tracking
  sensor.home_remote_floor

Media
  media_player.living_room_tv           (+ attributes duration/position/title/artist/app)
  media_player.living_room_tv_2         (on/off for camera stream target)
  media_player.main_bedroom_tv_2

Cameras (scripts; TV on check then stream)
  Downstairs:
    script.stream_pool_garden_camera_to_livingroom_tv
    script.stream_court_yardcamera_to_livingroom_tv
  Upstairs:
    script.stream_pool_garden_camera_to_bedroom_tv
    script.stream_court_yardcamera_to_bedroom_tv

═══════════════════════════════════════════════════════════════
                 PHYSICAL BUTTON → ACTION MAP
═══════════════════════════════════════════════════════════════
 MCP Right / Left / Up / Down / Select → TV dpad (floor-aware)
 MCP Vol Down / ESP Vol Up             → TV volume
 MCP Mute                              → TV mute / toggle_mute
 MCP Back                              → TV back
 MCP Home (expander) — see product labels; ESP Home opens UI home + TV home
 MCP Play/Pause, Netflix, Plex, YouTube → TV app scripts
 MCP Covers                            → page_all_covers
 MCP Lights                            → open_lights_page (floor-aware)
 MCP Home Assistant                    → open_devices_page (floor-aware)
 MCP Security                          → page_security (cameras)
 ESP Settings short                    → TV quick settings
 ESP Settings long                     → page_settings (theme / screen / sleep)
 ESP Power short                       → TV power
 ESP Power long                        → force_sleep
 ESP Source                            → TV source select

HA-Home-Remote

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README