Integration for BeHome (formerly Bemfa) smart home devices.
This integration provides cloud-based control of BeHome/Bemfa IoT devices through Home Assistant.
English | 简体中文
- OAuth2 Authentication: Secure authentication with BeHome cloud
- Multi-Platform Support: Control various device types including:
- Switches and outlets
- Lights with dimming support
- Fans with speed control
- Climate devices (air conditioners)
- Covers (curtains/blinds)
- Water heaters
- Media players (TVs)
- Air purifiers
- Sensors
- Real-time Updates: Device state polling every minute
- Area Integration: Automatic mapping to Home Assistant areas
- Open HACS in Home Assistant
- Go to "Integrations"
- Click "Explore & Download Repositories"
- Search for "BeHome"
- Download and restart Home Assistant
- Using the tool of choice open the directory (folder) for your HA configuration (where you find
configuration.yaml) - If you do not have a
custom_componentsdirectory (folder) there, you need to create it - In the
custom_componentsdirectory (folder) create a new folder calledbehome - Download all the files from the
custom_components/behome/directory (folder) in this repository - Place the files you downloaded in the new directory (folder) you created
- Restart Home Assistant
Only users who log in using OAuth2 need to configure this. Users who log in using their private key do not need to configure this.
Before adding the integration, you need to configure OAuth2 credentials in Home Assistant:
- Go to Settings → Devices & Services → Helpers tab
- Click "Create Helper" → "Application Credentials"
- Fill in the following information:
- Name:
BeHome(or any custom name you prefer) - Domain:
behome - Client ID:
88ac425b4558463aa813aed1690db730 - Client Secret: Enter your custom secret (you can use any secure string)
- Name:
- Click "Create"
- Go to Settings → Devices & Services → Integrations
- Click "+ Add Integration" and search for "BeHome"
- Select the BeHome integration
- Choose the application credentials you created in Step 1
- Follow the OAuth2 authentication flow to authorize Home Assistant
- Your BeHome devices will be automatically discovered and added
Once authenticated, all your BeHome devices will be automatically imported and configured. The integration will:
- Create entities for each device based on their type
- Map devices to appropriate Home Assistant areas (if area names match)
- Set up automatic status polling every minute
The integration automatically maps BeHome device types to appropriate Home Assistant platforms:
| BeHome Type | Home Assistant Platform | Description |
|---|---|---|
| outlet | switch | Smart outlets and switches |
| light | light | Smart lights with dimming |
| fan | fan | Fans with speed control |
| aircondition | climate | Air conditioners |
| curtain | cover | Curtains and blinds |
| waterheater | water_heater | Water heaters |
| television | media_player | TVs and media devices |
| airpurifier | air_purifier | Air purifiers |
| sensor | sensor | Various sensors |
Contributions are welcome! Please read our contributing guidelines and submit pull requests to help improve this integration.