This is a Home Assistant integration for AirSend boxes, which can capture and control more than 350 equipements (Remote Switchs, Lights, Shutters, Gate... ) from 50 brands (Dio, Faac, Nice, Somfy...) by RF433 or RF868 radio commands.
- AirSend (RF433)
- AirSend Duo (RF433 & RF868)
Each AirSend device is represented as a proper Home Assistant device with its associated entities (cover, switch, button, light, sensor).
Install and start the AirSend addon.
Export your devices from airsend.cloud → Import/Export → Export YAML (select spurl for local connection).
Place the exported airsend.yaml in your /config folder.
Add your AirSend local connection string to secrets.yaml:
spurl: sp://**************@[fe80::xxxx:xxxx:xxxx:xxxx]?gw=0&rhost=192.168.xxx.xxxExample airsend.yaml:
devices:
AirSend box:
type: 0
spurl: !secret spurl
sensors: true # enables temperature and illuminance sensors
bind: 1
refresh: 300
Volet salon:
id: 12345
type: 4098
apiKey: !secret apiKey
spurl: !secret spurl
channel:
id: 25455
source: 94311
Lumiere pergola:
id: 65838
type: 4100 # dimmable light
apiKey: !secret apiKey
spurl: !secret spurl
wait: true
channel:
id: 26848
source: 1442421508- Download the latest release from GitHub releases.
- Copy the
custom_components/airsenddirectory into yourcustom_componentsfolder. - Restart Home Assistant.
- Go to Settings → Integrations → Add integration and search for
AirSend.
- Ensure HACS is installed.
- Search for
AirSendin HACS and install it, or use the button below. - Restart Home Assistant.
- Go to Settings → Integrations → Add integration and search for
AirSend.
After the integration added, the internal URL of the addon will be auto-detected. Confirm and your devices will appear automatically.
To reload devices after modifying airsend.yaml, use the Reconfigure option on the integration.
| Option | Description |
|---|---|
type |
Device type (see table above) |
id |
AirSend cloud device ID |
apiKey |
AirSend cloud API key |
spurl |
Local connection string |
channel |
RF channel definition (id, source, mac, seed) |
wait |
Wait for RF confirmation before returning (true/false) |
sensors |
Enable temperature and illuminance sensors for AirSend box (true/false) |
bind |
Channel ID to bind for incoming RF messages |
refresh |
Poll interval in seconds (default: 300) |
This integration requires the AirSend addon to communicate with your AirSend hardware locally.
For local connection, the AirSend IPv4 address is required, you can find it in your router or Airsend App for Windows.
If you DO NOT provide ?gw=0&rhost=... then you may face unexpected HTTP/500 status code or HTTP/262 status code at Home Assistant level.
| Type | Value | Description |
|---|---|---|
| AirSend box | 0 |
The AirSend hardware box (state, temperature, illuminance) |
| Sensor | 1 |
Generic RF sensor |
| Cover | 4098 |
Roller shutter, blind (open/close/stop) |
| Cover with position | 4099 |
Roller shutter with position control (0-100%) |
| Switch | 4097 |
On/Off switch |
| Button | 4096 |
Single-action button (toggle) |
| Light | 4100 |
Dimmable light (0-100%) |
