devices.esphome.io

Lanbon L9 Smart Light Switch

Lanbon L9 Smart Light Switch

Device Type: switch
Electrical Standard: us
Board: esp32
Difficulty: Plug-n-flash, 2/5

Lanbon L9 US

Drivers

  • Processor: ESP32-S3-WROOM-1U
  • Touchscreen: FT6336U
  • Display: ST7789V2
  • mmWave Prescence: MoreSense 10G Hand Sweeping Series MS10-3007D26M4
  • Power Sensor: HLW8012 (CF pin only)

GPIO Pinout

i80 Display

PinFunction
GPIO17DC Pin
GPIO21CS Pin
GPIO13WR Pin
GPIO18RD Pin
GPIO6Data D0
GPIO7Data D1
GPIO15Data D2
GPIO16Data D3
GPIO10Data D4
GPIO9Data D5
GPIO46Data D6
GPIO3Data D7

I²C (used for touchscreen)

PinFunction
GPIO0i2c SCL
GPIO35i2c SCA

General Purpose IO

PinFunction
GPIO32LCD Backlight (output, ledc)
GPIO36Load Relay (output, switch)
GPIO5HLW8012 CF Pin (input, pulse_meter)
GPIO11mmWave Proximity Sensor (input, binary_sensor)
GPIO2mmWave Proximity Sensor (output, unknown)
GPIO1mmWave Proximity Sensor (output, unknown)

Note, programming the proximity sensor for different sensitivity, etc. is not yet possible.

How to Flash

  1. Open the switch, by removing the terminal covers and the 4 small screws on the cornors.
  2. The front part of hte switch should "pop off", with a small amount of pressure.
  3. Connect a USB level shifter to the pin header on the front panel, using the pinout below. Note, you must provide 5v power, while the Tx/Rx pins use a 3.3v level.
  4. Connect the GPIO0 pin to ground to put the ESP32 into the flash boot mode.
  5. Once flashed, the screen should power up and display ESPHome, while powered via the 5v supply.

Lanbon L9 US Header

Example Configuration

Below is a hardware only configuration, that enables the display with the ESPHome test card, along with the power meter, relay, and proximity sensor.

esphome:
  name: lanbon-l9
  friendly_name: Lanbon L9


esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: esp-idf


logger:
  level: DEBUG
  baud_rate: 115200
  hardware_uart: UART0


api:
  encryption:
    key: !secret api_key


ota:
  - platform: esphome
    password: !secret ota_password


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password


psram:
  speed: 80MHz


output:
  - platform: ledc
    id: lcd_backlight_output
    pin:
      number: GPIO42
      inverted: false


light:
  - platform: monochromatic
    output: lcd_backlight_output
    name: Display Backlight
    id: display_backlight
    restore_mode: ALWAYS_ON


spi:
  type: octal
  id: display_spi
  clk_pin: GPIO21
  data_pins:
    - GPIO6
    - GPIO7
    - GPIO15
    - GPIO16
    - GPIO10
    - GPIO9
    - GPIO46
    - GPIO3


display:
  - platform: mipi_spi
    id: my_display
    model: st7789v
    spi_id: display_spi
    bus_mode: octal
    dc_pin: GPIO17
    dimensions:
      height: 320
      width: 170
      offset_height: 0
      offset_width: 35
    invert_colors: true
    show_test_card: true
    data_rate: 4MHz
    color_depth: 16BIT
    color_order: BGR
    auto_clear_enabled: false
    update_interval: 250ms


i2c:
  - id: touchscreen_i2c
    scl:
      number: GPIO0
      ignore_strapping_warning: true
    sda:
      number: GPIO35


touchscreen:
  - platform: ft63x6
    id: my_touchscreen
    display: my_display
    i2c_id: touchscreen_i2c
    calibration:
      x_min: 0
      y_min: 0
      x_max: 169
      y_max: 319


sensor:
  - platform: pulse_meter
    name: Power
    id: power_pulse_meter
    pin: GPIO5
    unit_of_measurement: 'W'
    device_class: power
    state_class: measurement
    internal_filter_mode: PULSE
    accuracy_decimals: 1
    filters:
      - filter_out: nan
      - throttle: 15s
      - multiply: 0.0813287514318442  # Calibration may be needed


binary_sensor:
  - platform: gpio
    name: Proximity Sensor
    id: proximity_sensor
    pin: GPIO11


switch:
  - platform: gpio
    name: Relay
    id: relay
    pin:
      number: GPIO36

Detailed Configuration with LVGL

Lanbon L9 with ESPHome

The following configuration implements the following features and examples from the LVGL component.

  • Button with status update based on load relay gpio
  • Screen time-out (backlight) and activation via touch or proximity
  • Load power measurement via HLW8012
  • Anti-burn
  • Header icon showing API status
  • Header label showing current time via SNTP
  • Footer for page navigation
esphome:
  name: lanbon-l9
  friendly_name: Lanbon L9


esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: esp-idf


# Enable logging
logger:
  level: DEBUG
  baud_rate: 115200
  hardware_uart: UART0


# Enable Home Assistant API
api:
  encryption:
    key: !secret api_key
  reboot_timeout: 0s
  on_client_connected:
    - lvgl.label.update:
        id: label_apistatus
        text_color: 0x00FF00
  on_client_disconnected:
    - lvgl.label.update:
        id: label_apistatus
        text_color: 0xFF0000


ota:
  - platform: esphome
    password: !secret ota_password


wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password


psram:
  speed: 80MHz


time:
  - platform: sntp
    id: my_sntp
    timezone: America/New_York
    on_time:
      - hours: 23,4
        minutes: 5
        seconds: 0
        then:
          - switch.turn_on: switch_antiburn
      - hours: 23,4
        minutes: 35
        seconds: 0
        then:
          - switch.turn_off: switch_antiburn
      - seconds: 0
        minutes: '*'
        then:
          - lvgl.label.update:
              id: label_time
              text:
                time_format: "%l:%M %p"
                time: my_sntp


output:
  - platform: ledc
    id: lcd_backlight_output
    pin:
      number: GPIO42
      inverted: false


light:
  - platform: monochromatic
    output: lcd_backlight_output
    name: Display Backlight
    id: display_backlight
    restore_mode: ALWAYS_ON


spi:
  type: octal
  id: display_spi
  clk_pin: GPIO21
  data_pins:
    - GPIO6
    - GPIO7
    - GPIO15
    - GPIO16
    - GPIO10
    - GPIO9
    - GPIO46
    - GPIO3


display:
  - platform: mipi_spi
    id: my_display
    model: st7789v
    spi_id: display_spi
    bus_mode: octal
    dc_pin: GPIO17
    dimensions:
      height: 320
      width: 170
      offset_height: 0
      offset_width: 35
    invert_colors: true
    show_test_card: false
    data_rate: 4MHz
    color_depth: 16BIT
    color_order: BGR
    auto_clear_enabled: false
    update_interval: 250ms


i2c:
  - id: touchscreen_i2c
    scl:
      number: GPIO0
      ignore_strapping_warning: true
    sda:
      number: GPIO35


touchscreen:
  - platform: ft63x6
    id: my_touchscreen
    display: my_display
    i2c_id: touchscreen_i2c
    calibration:
      x_min: 0
      y_min: 0
      x_max: 169
      y_max: 319
    on_release:
      - if:
          condition: lvgl.is_paused
          then:
            - if:
                condition: lvgl.is_paused
                then:
                  - logger.log: "LVGL resuming due to screen touch."
                  - lvgl.resume:
                  - lvgl.widget.redraw:
                  - light.turn_on: display_backlight


sensor:
  - platform: wifi_signal
    name: Wifi Signal
    update_interval: 60s
    entity_category: diagnostic


  - platform: uptime
    name: Uptime
    entity_category: diagnostic


  - platform: pulse_meter
    name: Power
    id: power_pulse_meter
    pin: GPIO5
    unit_of_measurement: 'W'
    device_class: power
    state_class: measurement
    internal_filter_mode: PULSE
    accuracy_decimals: 1
    filters:
      - filter_out: nan
      - throttle: 15s
      - multiply: 0.0813287514318442  # Calibration may be needed


binary_sensor:
  - platform: gpio
    name: Proximity Sensor
    id: proximity_sensor
    pin: GPIO11
    on_press:
      then:
        - if:
            condition: lvgl.is_paused
            then:
              - logger.log: "LVGL resuming due to proximity sensor."
              - lvgl.resume:
              - lvgl.widget.redraw:
              - light.turn_on: display_backlight


switch:
  - platform: gpio
    name: Relay
    id: relay
    pin:
      number: GPIO36
    on_turn_on:
      - lvgl.widget.update:
          id: light_switch
          state:
            checked: true
      - lvgl.label.update:
          id: label_light_switch
          text: "\U000F06E9"
          text_color: 0xFFEE00
    on_turn_off:
      - lvgl.widget.update:
          id: light_switch
          state:
            checked: false
      - lvgl.label.update:
          id: label_light_switch
          text: "\U000F0336"
          text_color: 0xFFFFFF


  - platform: template
    name: Antiburn
    id: switch_antiburn
    icon: mdi:television-shimmer
    optimistic: true
    entity_category: "config"
    turn_on_action:
      - logger.log: "Starting Antiburn"
      - if:
          condition: lvgl.is_paused
          then:
            - lvgl.resume:
            - lvgl.widget.redraw:
      - lvgl.pause:
          show_snow: true
      - light.turn_off: display_backlight
    turn_off_action:
      - logger.log: "Stopping Antiburn"
      - if:
          condition: lvgl.is_paused
          then:
            - lvgl.resume:
            - lvgl.widget.redraw:


font:
  - file: "https://github.com/Pictogrammers/pictogrammers.github.io/raw/refs/heads/main/@mdi/font/7.4.47/fonts/materialdesignicons-webfont.ttf"
    id: mdi_icons
    bpp: 4
    size: 52
    glyphs: [
      "\U000F0336",
      "\U000F06E9"
    ]


lvgl:
  displays:
    - my_display
  touchscreens:
    - my_touchscreen
  buffer_size: 25%
  log_level: WARN
  on_idle:
    timeout: 30s
    then:
      - logger.log: "LVGL is idle"
      - light.turn_off: display_backlight
      - lvgl.pause:
  style_definitions:
    - id: header_footer
      bg_color: 0x2F8CD8
      bg_grad_color: 0x005782
      bg_grad_dir: VER
      bg_opa: COVER
      border_opa: TRANSP
      radius: 0
      pad_all: 0
      pad_row: 0
      pad_column: 0
      border_color: 0x0077b3
      text_color: 0xFFFFFF
      width: 100%
      height: 30
  top_layer:
    widgets:
      - obj:
          align: TOP_MID
          styles: header_footer
          widgets:
          - label:
              text:
                time_format: "%l:%M %p"
                time: my_sntp
              id: label_time
              align: CENTER
              text_align: CENTER
              text_color: 0xFFFFFF
          - label:
              text: "\uF1EB"
              id: label_apistatus
              align: top_right
              x: -2
              y: 7
              text_align: right
              text_color: 0xFFFFFF
      - buttonmatrix:
          align: bottom_mid
          styles: header_footer
          pad_all: 0
          outline_width: 0
          id: top_layer
          items:
            styles: header_footer
          rows:
            - buttons:
              - id: page_prev
                text: "\uF053"
                on_press:
                  then:
                    lvgl.page.previous:
              - id: page_home
                text: "\uF015"
                on_press:
                  then:
                    lvgl.page.show: page_light_switch
              - id: page_next
                text: "\uF054"
                on_press:
                  then:
                    lvgl.page.next:
  pages:
    - id: page_light_switch
      widgets:
        - button:
            x: 35
            y: 60
            width: 100
            height: 200
            id: light_switch
            checkable: true
            on_click:
              switch.toggle: relay
            widgets:
              - label:
                  id: label_light_switch
                  align: CENTER
                  text: "\U000F0336"
                  text_align: CENTER
                  text_font: mdi_icons
Edit this page on GitHub

On this page