eco2 showing up as volatile_organic_compounds_parts using zigbee2mqtt in Home Assistant

[AndyHowell]

I added the aircube.mjs to my zigbee2mqtt configuration. Zigbee2mqtt recognizes the device through the external config, but the eco2 shows up with the wrong description and device class.

VOC details:

ECO2 details:

MQTT Explorer shows I'm getting the values:

{
  "analog_output_10": 60.000003814697266,
  "aqi": 39,
  "eco2": 400,
  "humidity": 54.5,
  "linkquality": 51,
  "temperature": 22.52,
  "voc": 0
}

Looking at the aircube.mjs, it seems like it should do the right thing:

    exposes: [
        e.numeric('eco2', exposes.access.STATE)
            .withUnit('ppm')
            .withDescription('Equivalent carbon dioxide concentration')
            .withValueMin(400)
            .withValueMax(8192),
        e.numeric('voc', exposes.access.STATE)
            .withUnit('ppb')
            .withDescription('Total volatile organic compounds')
            .withValueMin(0)
            .withValueMax(65535),
        e.numeric('aqi', exposes.access.STATE)
            .withUnit('')
            .withDescription('Air Quality Index')
            .withValueMin(0)
            .withValueMax(500),
    ],

What is odd, is the eco2 has the correct units. Its 'ppm' vs the 'ppb' for the voc. Its also getting the right value, ie, 400. That leads me to think that the aircube.mjs is seeing the eco2 correctly.

I've tried deleting the device in zigbee2mqtt, restarting it, and adding it again. The first time I added it, I didn't have the aircube.mjs installed.

I'm using Zigbee2mqtt version 2.10.1. and Home Assistant 2025.5.0

Any ideas?

Thanks, Andy

[AndyHowell]

I think my issue lies elsewhere. I put zigbee2mqtt in debug mode and got this:

{
  "data": {
    "definition": {
      "description": "AirCube air quality monitor",
      "exposes": [
        {
          "access": 1,
          "description": "Equivalent carbon dioxide concentration",
          "label": "Eco2",
          "name": "eco2",
          "property": "eco2",
          "type": "numeric",
          "unit": "ppm",
          "value_max": 8192,
          "value_min": 400
        },
        {
          "access": 1,
          "description": "Total volatile organic compounds",
          "label": "Voc",
          "name": "voc",
          "property": "voc",
          "type": "numeric",
          "unit": "ppb",
          "value_max": 65535,
          "value_min": 0
        },
        {
          "access": 1,
          "description": "Air Quality Index",
          "label": "Aqi",
          "name": "aqi",
          "property": "aqi",
          "type": "numeric",
          "unit": "",
          "value_max": 500,
          "value_min": 0
        },
        {
          "access": 5,
          "description": "Measured temperature value",
          "label": "Temperature",
          "name": "temperature",
          "property": "temperature",
          "type": "numeric",
          "unit": "°C"
        },
        {
          "access": 5,
          "description": "Measured relative humidity",
          "label": "Humidity",
          "name": "humidity",
          "property": "humidity",
          "type": "numeric",
          "unit": "%"
        },
        {
          "access": 1,
          "category": "diagnostic",
          "description": "Link quality (signal strength)",
          "label": "Linkquality",
          "name": "linkquality",
          "property": "linkquality",
          "type": "numeric",
          "unit": "lqi",
          "value_max": 255,
          "value_min": 0
        }
      ],
      "model": "AirCube",
      "options": [
        {
          "access": 2,
          "description": "Calibrates the voc value (absolute offset), takes into effect on next report of device.",
          "label": "Voc calibration",
          "name": "voc_calibration",
          "property": "voc_calibration",
          "type": "numeric",
          "value_step": 0.1
        },
        {
          "access": 2,
          "description": "Calibrates the temperature value (absolute offset), takes into effect on next report of device.",
          "label": "Temperature calibration",
          "name": "temperature_calibration",
          "property": "temperature_calibration",
          "type": "numeric",
          "value_step": 0.1
        },
        {
          "access": 2,
          "description": "Number of digits after decimal point for temperature, takes into effect on next report of device. This option can only decrease the precision, not increase it.",
          "label": "Temperature precision",
          "name": "temperature_precision",
          "property": "temperature_precision",
          "type": "numeric",
          "value_max": 3,
          "value_min": 0
        },
        {
          "access": 2,
          "description": "Calibrates the humidity value (absolute offset), takes into effect on next report of device.",
          "label": "Humidity calibration",
          "name": "humidity_calibration",
          "property": "humidity_calibration",
          "type": "numeric",
          "value_step": 0.1
        },
        {
          "access": 2,
          "description": "Number of digits after decimal point for humidity, takes into effect on next report of device. This option can only decrease the precision, not increase it.",
          "label": "Humidity precision",
          "name": "humidity_precision",
          "property": "humidity_precision",
          "type": "numeric",
          "value_max": 3,
          "value_min": 0
        }
      ],
      "source": "external",
      "supports_ota": false,
      "vendor": "StuckAtPrototype",
      "version": "0.0.0"
    },
    "friendly_name": "0x744dbdfffe6911bd",
    "ieee_address": "0x744dbdfffe6911bd",
    "status": "successful",
    "supported": true
  },
  "type": "device_interview"
}

It looks like zigbee2mqtt is getting the eco2 properties correctly. I'll post again once I figure this out. Sorry for the spam.

[AndyHowell]

zigbee2mqtt in home assistant is showing the correct "Exposes"

I can't figure out why this is not making it into Home Assistant.

[AndyHowell]

Tried updating to release 1.4.2. No change. I removed and re-added the device in Zigbee2MQTT app, but that didn't help. I also deleted the default device name in hex.

[StuckAtPrototype]

Hi @AndyHowell

Looks like you are missing the correct converter. There are two, one for HA 2025 and older, and one for HA 2026 and newer.
https://github.com/StuckAtPrototype/AirCube/blob/master/HOME_ASSISTANT.md#b5----add-the-aircube-converter

Actually, re-reading this again, you should be able to use the latest one without issues. Make sure your paths are correct.

Could you please screenshot your editor paths? Make sure not to expose anything sensitive

[AndyHowell]

Not sure if this is what you are after:

My problems may be because I added the converter after the initial install. I deleted the device in Zigbee2mqtt and re-added it again. Then Zigbee2mqtt was showing the correct items in the 'exposes' tab.

I've ordered two more Air Cubes. The first one arrived really quickly. I'm 45 minutes south of you. I'll give this another go when they arrive. I enjoyed your video on the trials and tribulations in developing the Air Cube.

I did notice one peculiarity that I saw someone else mention; maybe on Facebook? This morning it was green, but then went red when I was near it. Even with ventilation and time, it stayed red. I power cycled it and it went back to green.

Thanks for making this cool device.