ESPHome, bluetooth proxy, and airthings-ble with Airthings Corentium 2? | Home Assistant | Page 1

frozen laurel Oct 25, 2025, 1:44 AM

#

Anybody here doing ESPHome with Bluetooth proxy mode?

I got an Airthings Corentium 2 sensor, which is (allegedly) supported by the airthings-ble integration.

I set up an esp device in bluetooth proxy mode, and deployed the firmware to the esp32. However if I try to add the airthings-ble integration I get the old "No devices found on the network" error.

I see people usually use the airthings wave plus and successfully use it either via bluetooth proxy, or by having the esp32 use the native airthings client. I'm curious if anybody has a working config either using the proxy or via native esp driver (and if using the native esp package, what settings did you use for the corentium 2? the project only supports a few of their devices and the corentium 2 is not on the list...)

drifting sun Oct 25, 2025, 1:48 AM

#

frozen laurel Anybody here doing ESPHome with Bluetooth proxy mode? I got an Airthings Coren...

is your proxy showing under the bluetooth integration?

frozen laurel Oct 25, 2025, 1:55 AM

#

the device is showing under the bluetooth integratio, but I'm not sure how I make sure that it is registered (or whatever the term is) as a proxy.

drifting sun Oct 25, 2025, 1:57 AM

#

frozen laurel the device is showing under the bluetooth integratio, but I'm not sure how I mak...

https://my.home-assistant.io/redirect/bluetooth_advertisement_monitor/

frozen laurel Oct 25, 2025, 1:58 AM

#

yeah, it does show a lot of bluetooth advertisements

drifting sun Oct 25, 2025, 1:58 AM

#

the visualisation tab is cool btw 😛

#

but in any case, the proxy is seeing stuff

frozen laurel Oct 25, 2025, 1:59 AM

#

and yes i do see the airthings device under the advertisement list (its mac adress shows up)

#

yet, if I try to add the airthings-ble integration, I still see the "no devices found on the network" message

drifting sun Oct 25, 2025, 2:03 AM

#

the documentation supported device list does seem to be limited and not include the "Corentium 2"

#

did you see somewhere that the model is specifically supported/working?

frozen laurel Oct 25, 2025, 2:04 AM

#

yeah, here: https://github.com/Airthings/airthings-ble . but possibly the airthings official integration is not the version that homeassistant's available integration actually uses....

GitHub

GitHub - Airthings/airthings-ble: Library to control Airthings devi...

Library to control Airthings devices through BLE, primarily meant to be used in Home Assistant. - Airthings/airthings-ble

#

the airthings official supported device list is:


This library supports the following Airthings devices:

    Corentium Home 2
    Wave Enhance
    Wave Gen 1
    Wave Mini
    Wave Plus
    Wave Radon

I should probably dig through the home assistant code to see if ha actually uses this version of the integration though....

drifting sun Oct 25, 2025, 2:05 AM

#

it seems its using the up to date library
"requirements": ["airthings-ble==1.1.1"]
https://github.com/home-assistant/core/blob/dev/homeassistant/components/airthings_ble/manifest.json

GitHub

core/homeassistant/components/airthings_ble/manifest.json at dev ·...

:house_with_garden: Open source home automation that puts local control and privacy first. - home-assistant/core

#

do you have latest HA version installed?

frozen laurel Oct 25, 2025, 2:07 AM

#

ah I am two months out of date I guess, 2025.8.2. will upgrade.

#

kinda wish there was a way for me to see which version of the package my ha version was trying to snag. if it's the 1.1.1 version then I don't think this will help?

#

but worth a try 😉

drifting sun Oct 25, 2025, 2:10 AM

#

couldn't hurt to update. however to be fair I think the 1.1.1 update might not be in latest

frozen laurel Oct 25, 2025, 2:11 AM

#

heh yep I think you're right:

changelog shows the corentium home 2 support was brought into HA just 3 weeks ago: https://github.com/home-assistant/core/commit/9640ebb593f5a20178f898f1a5b83a7e0799cd13

GitHub

Add support for Wave Enhance and Corentium Home 2 in Airthings BLE ...

…tegration (#153780)

#

kinda funny. i've had the sensor for a few months now and tinkered with it on and off since then. i hadn't paid attention to the ha side of the integration, just looked at the airthings project before.

drifting sun Oct 25, 2025, 2:14 AM

#

#

yeah latest is still using 0.9.2

frozen laurel Oct 25, 2025, 2:15 AM

#

after the upgrade still no dice. even after rebooting the ha machine.

#

oh interesting

drifting sun Oct 25, 2025, 2:16 AM

#

support was added in 1.1.0 https://github.com/Airthings/airthings-ble/releases/tag/1.1.0

GitHub

Release 1.1.0 · Airthings/airthings-ble

What's Changed

Add support for Corentium home 2 by @LaStrada in #54
Update dependencies by @LaStrada in #55
Update README.md by @LaStrada in #56

Full Changelog: 1.0.0...1.1.0

#

looks like there's a bunch of other PR'S to the integration recently. looks like there were some other cchanges that went along with the bump

#

my general recomendation would be that you sit tight until 2025.11 if thats an option?

frozen laurel Oct 25, 2025, 2:22 AM

#

sure why not ;-). if there's a handy way of installing an out of band version of the package I'd be willing to give it a go, but I can wait too.

drifting sun Oct 25, 2025, 2:22 AM

#

you could edit the manigest and requirements file to bump it but given theres a few other things happening in and around it. it looks like you might break stuff without everything together

#

you could manually bump the entire compnent but its not "simple"

frozen laurel Oct 25, 2025, 2:23 AM

#

what fun. well, it's running on top of a vmserver so I can always snapshot it and try to tinker, if I'm feeling like hating myself ;-).

drifting sun Oct 25, 2025, 2:25 AM

#

you "COULD" run nightly if you were adventurous...

frozen laurel Oct 25, 2025, 2:26 AM

#

kind of annoying, the terminal/ssh server seems to not work on my server any longer. sigh.

#

ohwell, this has been educational, thanks!

drifting sun Oct 25, 2025, 2:28 AM

#

no worries, if it were me and its non-critical then I would leave it

frozen laurel Oct 25, 2025, 2:29 AM

#

yeah HA for me is more of a goofy tinkering and data logging thing. radon in my basement isn't at levels that will kill me. yet. ;-).

drifting sun Oct 25, 2025, 2:29 AM

#

at least we figured out that your proxy works 😛

frozen laurel Oct 25, 2025, 2:30 AM

#

yeah. the ux is a little weird for looking at the observed devices.

drifting sun Oct 25, 2025, 2:30 AM

#

yeah its hidden a bit

frozen laurel Oct 25, 2025, 2:30 AM

#

seems to be: click on bluetooth, then click on the esp32 adapter's mac address.

drifting sun Oct 25, 2025, 2:31 AM

#

have to hit the cog on a BT device to get to the menu which is a bit strange

#

BT proxies are fun though

frozen laurel Oct 25, 2025, 2:32 AM

#

an yeah that works too. i found it via this:

drifting sun Oct 25, 2025, 2:33 AM

#

if you get a bunch of them you can track where a device is by its signal strength

#

here gets you to menu for BT stuff

frozen laurel Oct 25, 2025, 2:34 AM

#

heh yep. i saw a honda infotainment system pop up as a car drove by. hah.

I was messing around a bit ago with a rtl_433 temperature sensor (no ha access to that data yet either, that'll be another project). but watching the vehicle tpms go by is kind of amusing.

drifting sun Oct 25, 2025, 2:34 AM

#

#

I see 1000+ devices daily with my net of proxies

frozen laurel Oct 25, 2025, 2:35 AM

#

what fun. yeah i just have the one bluetooth proxy (in the basement, so it doesn't see quite as much of my neighbor's stuff)

drifting sun Oct 25, 2025, 2:36 AM

#

i can tell which room a smartphone/smartwatch is based on it so can see which room a person is likely in

frozen laurel Oct 25, 2025, 2:36 AM

#

spiffy

#

makes sense, given the short range of a lot of this ble stuff

drifting sun Oct 25, 2025, 2:37 AM

#

most shelly devices having built in proxies is super nice too

frozen laurel Oct 25, 2025, 2:38 AM

#

what's a shelly device?

drifting sun Oct 25, 2025, 2:38 AM

#

they make power monitoring/switching stuff

frozen laurel Oct 25, 2025, 2:38 AM

#

ah

drifting sun Oct 25, 2025, 2:38 AM

#

https://www.shelly.com/

Shelly Europe

Shelly provides advanced smart home automation solutions for seamless control of lighting, temperature, and energy. Make your home smarter today.

frozen laurel Oct 25, 2025, 2:39 AM

#

future project is energy monitoring yeah.

i used to use a little clamp on ct on my mains, along with an industrial revenue meter to watch current flow

drifting sun Oct 25, 2025, 2:39 AM

#

highly recommend if your in the market for that sort of thing. they activly work with the project for support

frozen laurel Oct 25, 2025, 2:39 AM

#

haven't done anything to monitor power in the new house though

drifting sun Oct 25, 2025, 2:40 AM

#

frozen laurel future project is energy monitoring yeah. i used to use a little clamp on ct on...

they have stuff that does that

frozen laurel Oct 25, 2025, 2:40 AM

#

might do. i'm guessing homeassistant doesn't have dnp3 protocol support (hah)

drifting sun Oct 25, 2025, 2:42 AM

#

it has modbus, but no idea if anyone has made dnp3 work

frozen laurel Oct 25, 2025, 2:42 AM

#

modbus is spiffy enough

#

this shelly company looks neat though, and some of these relay+power monitors with wired ethernet is a plus.

drifting sun Oct 25, 2025, 2:45 AM

#

they have so many options for stuff. i have a bunch of things

#

the gen4 stuff can support zigbee. and they also have z-wave versions of some of the stuff too

frozen laurel Oct 25, 2025, 3:21 AM

#

i have never poked around ha internals much before. scapy? hehe, this is fun.

#

now i need to know what integrations rely on that ;-).

drifting sun Oct 25, 2025, 3:24 AM

#

ha, welcome to the dark side! you are here forever now 🙂

frozen laurel Oct 25, 2025, 3:07 PM

#

i am kind of curious about playing with this new airthings integration, but I'm a little lost at these instructions: https://github.com/Airthings/airthings-ble/wiki/Testing-with-Home-Assistant .

what exactly is 'core'? I assume that this is some kind of developer package which must be installed inside of the homeassistant docker container somehow?

GitHub

Testing with Home Assistant

Library to control Airthings devices through BLE, primarily meant to be used in Home Assistant. - Airthings/airthings-ble

drifting sun Oct 25, 2025, 9:26 PM

#

frozen laurel i am kind of curious about playing with this new airthings integration, but I'm ...

core is the main "core" of home assistant including all configuration and the default integrations. (it doesn't fully fit but "backend" sort of works as a descriptor too)
I would say that the page you linked is outdated and should not be used.

frozen laurel Oct 25, 2025, 9:50 PM

#

bummer ;-). Yeah I was trying to see what it meant by directory layout and didn't see anything like it on either the main hosty os or inside of the homeassistant docker container. ohwell.

#

/usr/local/lib/python3.13/site-packages/mashumaro/core
/usr/local/lib/python3.13/site-packages/numpy/core
/usr/local/lib/python3.13/site-packages/poetry/core
/usr/local/lib/python3.13/site-packages/imageio/core
/usr/local/lib/python3.13/site-packages/crownstone_uart/core
/usr/local/lib/python3.13/site-packages/crownstone_core/core
/usr/local/lib/python3.13/site-packages/xknx/core
/usr/local/lib/python3.13/site-packages/pubsub/core
/usr/local/lib/python3.13/site-packages/pandas/core
/usr/local/lib/python3.13/site-packages/psnawp_api/core
/usr/local/lib/python3.13/site-packages/oauthlib/openid/connect/core
/usr/local/lib/python3.13/site-packages/authlib/oidc/core
/usr/local/lib/python3.13/site-packages/pyatv/core
/usr/local/lib/python3.13/site-packages/netaddr/tests/core
/usr/local/lib/python3.13/site-packages/azure/core
/usr/local/lib/python3.13/site-packages/fritzconnection/core
/usr/local/lib/python3.13/site-packages/synology_dsm/api/core
/usr/local/lib/python3.13/site-packages/hamcrest/core
/usr/local/lib/python3.13/site-packages/hamcrest/core/core
/usr/local/lib/python3.13/site-packages/elevenlabs/core```

negative I guess 😉

drifting sun Oct 25, 2025, 10:02 PM

#

frozen laurel bummer ;-). Yeah I was trying to see what it meant by directory layout and didn'...

in a simplified breakdown the main components are
HAOS - is the OS
Supervisor - is the container platform
Core - is the main parts of the software
Frontend - is the webui etc...

not all install types use them all but that's the general idea.

drifting sun Oct 25, 2025, 10:04 PM

#

frozen laurel bummer ;-). Yeah I was trying to see what it meant by directory layout and didn'...

you could look at unhacs it allows to install a package from another source. in this case still the main repo but the dev branch which has been updated. although I think you might still have to update the global requirements text files.

#

or go balls to the wall and just run dev directly from the nightly builds

#

#

can always switch back to normal stream when 2025.11 hits. or even switch to beta stream when beta hits in a few days.

frozen laurel Oct 25, 2025, 10:23 PM

#

ooh, might give it a try when im back home.

frozen laurel Oct 26, 2025, 3:19 PM

#

🎉

#

thanks for the tips. took me a little tinkering to switch to the dev branch. i'm still not sure why, but the 8123 port forwarding didn't start even after I rebooted the main/host os (I don't really know the term for that, but the main host os being the one that runs all the docker containers). i was hunting around the docker config files to answer why, everything looked fine, so i rebooted again and the port forwarding magically started working? (I didn't change anything!). hurumph.

#

next stop: getting the rtl_433 doohickey integrated into ha. i think this will be a bit easier on the ha side, but means i get to write my own mqtt client doohickey.

frozen laurel Oct 26, 2025, 5:15 PM

#

I suspect there is a conversion area and that it is showing becquerels per cubic meter and not pci/liter as it states.

#

also pretty silly, the thing only stays connected to bluetooth for a few minutes, then disappears. have to press the little bluetooth sync button on the sensor each time. i should read only how ble actually works...i assumed homeassistant would send some kind of 'subscribe' message to the sensor, then the sensor would send data packets every once in a while. it seems like ha connects to the device, issues a few commands, then goes idle...then the sensor, not seeing any commands for a while, decides nobody is using bluetooth so shuts the interface off.

frozen laurel Oct 26, 2025, 7:26 PM

#

okay, solved the problem. I think.

the airthings device shuts off its ble interface after 10 minutes.

i installed the ios app (grrr, having to sign up for an account). I did this thinking that maybe there was a firmware update available for the corentium. there isn't. but I am pretty sure that the ios app must send a command to the corentium which says "keep your ble interface on always". because now the ble interface on the corentium does not shut off after ten minutes, even after I turned the bluetooth interface off on my mobile device.

my guess is the airthings-ble homeassistant integration needs to send this same command (whatever it is) to direct the silly thing to keep its ble interface on.

#

yeah it's been running for an hour now, pretty sure this is the answer. opened a ticket on their github page describing how to reproduce and probably how to solve the problem.

drifting sun Oct 26, 2025, 9:17 PM

#

frozen laurel I suspect there is a conversion area and that it is showing becquerels per cubic...

you can likely change the unit in it's entity options but i haven't messed with this kind of unit before

#

I recommend switching back to stable branch when you no longer need dev (you can do this in the UI) as it will help ensure a stable enviroment. but its up to you

#

it seems that fine times are being had all the same though 🙂

frozen laurel Oct 26, 2025, 11:04 PM

#

yeah, I'll switch off dev once the patches are in.

i showed the airthings folks where they had a conversion error too. they forgot to apply the becquerels per cubic meter => picocuries per liter conversion factor for the method that gets data off my device. it's kind of funny since homeassistant says 93pci/l. this would signify that I had a bit of processed uranium ore in my basement (i don't). they apply the "is this dangerous" method to the number before conversion, so my sensor says this level is still low/normal/fine by US limits.

#

anyway they agree with both my findings and already have a patch for the unit conversion. they're not sure how to make the device keep its ble interface on full-time, they seem to think that would be a homeassistant-core responsibility? which seems odd to me, but I don't know much at all about BLE. perhaps there is a generic command that you tell a ble device to keep the transmitter enabled. if so I'll figure that out before too long.

#

and yeah lots of fun.

drifting sun Oct 26, 2025, 11:25 PM

#

frozen laurel anyway they agree with both my findings and already have a patch for the unit co...

I don't know enough about the specifics of how BLE works at that level. if you can get more details together and their explanation of why its a core issue then you could raise an issue on the core repo and see what happens there.

frozen laurel Oct 26, 2025, 11:39 PM

#

ah i misunderstood what they even said. i think i read a reply to a different ticket. i think for them it is more of an issue of whether they want to put the necessary command to turn on ble full-time in their open source integration. i suspect it's a GATT command that they have to send, and they might not want to make the command publicly known...

open jetty Jan 19, 2026, 11:11 PM

#

Thanks @frozen laurel and @drifting sun for your exchange... made me realize I'm not crazy and once I had my proxy visible & rebooted twice I could run the AirthingsBLE integration and it popped up.
Now to replicate the fancy graph...

frozen laurel Jan 20, 2026, 12:36 AM

#

i need to see if i can move my HA back to the not-beta version. the airthings people made some patches based on my feedback, i'm not sure if those changes have made their way into the standard HA releases yet.

#ESPHome, bluetooth proxy, and airthings-ble with Airthings Corentium 2?