rippleon.yaml

substitutions:
  device_name: rippleon
  friendly_name: Rippleon EV Charger

esphome:
  name: ${device_name}
  friendly_name: ${friendly_name}
  platformio_options:
    board_build.f_cpu: 120000000L
    # FC41D's BK7231N has no flash encryption key set (eFuse = all zeros).
    # LibreTiny's Tuya variant pre-encrypts the image with the Tuya XOR
    # coefficient, expecting the chip to reverse it at read time. FC41D
    # doesn't, so we override to zero coeffs → image written as plaintext.
    board_build.bkcrypt_coeffs: "00000000000000000000000000000000"

bk72xx:
  board: generic-bk7231n-qfn32-tuya

# LibreTiny default debug UART on BK7231N is UART2 (P0/P1) = FC41D pins
# 25/26. MCU link uses UART1 (P10/P11) = pins 19/20, no collision.
logger:
  level: DEBUG

# BK7231N UART1 (P10/P11) = FC41D pins 19 (MCU→module RX) / 20 (module→MCU TX).
uart:
  id: mcu_uart
  tx_pin: P11
  rx_pin: P10
  baud_rate: 115200

external_components:
  # rippleon-side AT emulator + protocol layer live in a sibling repo.
  - source:
      type: git
      url: https://github.com/RAR/esphome-rippleon-ev
      ref: main
    refresh: always
    components: [rippleon_at, rippleon_charger]
  # OCPP component — this repo. Pin to `main` here; users tracking a
  # specific commit should pin a SHA instead.
  - source:
      type: git
      url: https://github.com/RAR/esphome-ocpp-server
      ref: main
    refresh: always
    components: [ocpp]

rippleon_at:
  id: rippleon_mcu
  uart_id: mcu_uart
  ble_mtu: 517  # MCU never tells us peer-negotiated MTU; 517 matches stock.

rippleon_charger:
  id: rippleon_proto
  rippleon_at_id: rippleon_mcu
  heartbeat_interval: 20s
  auto_connect: true

sensor:
  - platform: rippleon_charger
    voltage_a:
      id: rippleon_voltage
      name: "Voltage"
    current_a:
      id: rippleon_current
      name: "Current"
    power:
      id: rippleon_power
      name: "Power"
    charge_energy:
      id: rippleon_charge_energy
      name: "Session Energy"
    charge_time:
      name: "Session Time"
    appt_remaining:
      name: "Scheduled Start"
    system_temp:
      name: "System Temp"
    gun_temp:
      name: "Gun Temp"
    signal:
      name: "Signal"

binary_sensor:
  - platform: rippleon_charger
    plugged:
      name: "Plugged"

text_sensor:
  - platform: rippleon_charger
    state:
      name: "State"
    fault:
      name: "Fault"
    serial:
      name: "Serial"
    status:
      id: rippleon_status
      name: "Status"

number:
  - platform: rippleon_charger
    target_duration:
      name: "Target Duration"
    target_energy:
      name: "Target Energy"
    sched_start_hour:
      name: "Schedule Start Hour"
    sched_start_min:
      name: "Schedule Start Minute"
    sched_end_hour:
      name: "Schedule End Hour"
    sched_end_min:
      name: "Schedule End Minute"
    max_current:
      name: "Max Charge Current"

switch:
  - platform: rippleon_charger
    sched_enabled:
      name: "Schedule Enabled"
    plug_and_charge:
      name: "Plug and Charge"

select:
  - platform: rippleon_charger
    sched_type:
      name: "Schedule Type"
    sched_weekdays:
      name: "Schedule Weekdays"
    light_mode:
      name: "LED Mode"
    leakage_mode:
      name: "Leakage Detection Mode"
    pairing_mode:
      name: "Pairing Mode"

button:
  - platform: rippleon_charger
    start_time:
      name: "Start (Time)"
    start_energy:
      name: "Start (Energy)"
    stop:
      name: "Stop"
    restart:
      name: "Restart Device"
      entity_category: diagnostic
    factory_reset:
      name: "Factory Reset"
      entity_category: diagnostic
    get_schedule:
      name: "Read Schedule"
      entity_category: diagnostic
    apply_schedule:
      name: "Apply Schedule"
    sync_time:
      name: "Sync Time"
      entity_category: diagnostic

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

api:
  on_client_connected:
    - delay: 2s
    - lambda: id(rippleon_proto)->refresh_ui();
ota:
  - platform: esphome

time:
  - platform: homeassistant
    id: ha_time

# OCPP 1.6J Charge Point — registers against a Central System (SteVe for dev,
# see sibling esphome-ocpp-server/server/README.md). GPLv3 from MicroOcpp.
ocpp:
  id: ocpp_cp
  csms_url: !secret ocpp_csms_url
  charge_point_id: !secret ocpp_charge_point_id
  vendor: Rippleon
  model: ROC001
  # Single-phase EVSE — tag V/I as L1 so evcc's PhaseCurrents/PhaseVoltages
  # getters resolve. nominal_voltage is the regional line voltage used as
  # the Power.Offered fallback (120 US outlet / 230 EU 1ϕ / 240 US split /
  # 400 EU 3ϕ L-L). phase_switching_supported=false suppresses evcc's
  # "Phase switch: yes" UI heuristic for non-1p3p hardware.
  phase: L1
  nominal_voltage: 240.0
  phase_switching_supported: false
  meter_values:
    voltage: rippleon_voltage
    current: rippleon_current
    power: rippleon_power
    energy: rippleon_charge_energy
  status_from: rippleon_status
  status_mapping:
    "Not Connected": Available
    "Ready to Charge": Preparing
    "Waiting for Car": SuspendedEV
    "Charging": Charging
  on_remote_start:
    - lambda: id(rippleon_proto)->start_charge_time_s(id(rippleon_proto)->target_duration_s());
  on_remote_stop:
    - lambda: id(rippleon_proto)->stop_charge();
  on_reset:
    - lambda: id(rippleon_proto)->restart_device();