Skip to content

Initial support for LG GBBS322CEV refrigerator - #142

Open
Skarabaen wants to merge 2 commits into
anszom:masterfrom
Skarabaen:add-lg-gbbs322cev-support
Open

Initial support for LG GBBS322CEV refrigerator#142
Skarabaen wants to merge 2 commits into
anszom:masterfrom
Skarabaen:add-lg-gbbs322cev-support

Conversation

@Skarabaen

Copy link
Copy Markdown

Summary

Adds initial support for the LG GBBS322CEV refrigerator.

The appliance identifies itself as:

model_id: 2REBGLUB_2P__
device_type: 101
protocol: ThinQ2

Closes #140.

Supported features

The following features were tested with a real appliance and are exposed through Home Assistant MQTT discovery:

  • Fridge temperature setpoint
  • Freezer temperature setpoint
  • Combined door state
  • Express Cool
  • Express Freeze
  • Drawer mode:
    • Cheese
    • Fish
    • Meat
  • Raw drawer mode value for validation and debugging

Protocol details

The implementation is based on the existing 2RES1VE61NFA2 refrigerator decoder, but this appliance uses a 96-byte status block.

Observed packet formats:

AA 0x66 10 EB <96-byte status> <checksum> BB
AA 0xC6 10 EC <96-byte previous status> <96-byte current status> <checksum> BB

The existing status query also works with this model:

AA0EF0ED1211010000010400EBBB

Confirmed field mapping

fridge_setpoint:
  status_offset: 1
  formula: 8 - raw

freezer_setpoint:
  status_offset: 2
  formula: -14 - raw

express_freeze:
  status_offset: 3
  values:
    1: off
    2: on

door:
  status_offset: 7
  values:
    1: open
    2: closed

temperature_unit:
  status_offset: 8
  values:
    1: Celsius

express_cool:
  status_offset: 16
  values:
    0: off
    1: on

drawer_mode:
  status_offset: 95
  values:
    0: Cheese
    1: Fish
    2: Meat

The door field appears to be a combined state. Both the fridge door and freezer door produce the same open and closed values.

Testing

The implementation was tested using a locally built Docker image with a real LG GBBS322CEV appliance.

Confirmed in Home Assistant:

fridge_setpoint: working
freezer_setpoint: working
door: working
express_cool: working
express_freeze: working
drawer_mode: working
drawer_mode_raw: working

Automated tests use real packet captures and cover:

  • Full 0x10EB status decoding
  • Current-state extraction from 0x10EC delta packets
  • Fridge and freezer setpoints
  • Open and closed door states
  • Express Cool
  • Express Freeze
  • Cheese, Fish, and Meat drawer modes
  • Status query generation
  • Home Assistant setting packet generation
  • Invalid and unsupported packet handling

Full test suite result:

tests: 426
passed: 426
failed: 0

Files added or modified

cloud/devices/2REBGLUB_2P__.ts
cloud/ha_bridge.ts
tests/cloud/devices/2REBGLUB_2P__.test.ts

Notes

The implementation should be considered preliminary because additional appliance fields may still be unidentified.

The currently exposed features were verified against the real appliance and Home Assistant.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New device support request: LG fridge 2REBGLUB_2P__ / LG GBBS322CEV

2 participants