Skip to content

script0803/BituoPMD

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

47 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bituo Device for Home Assistant

Installation

Install with HACS

Open BituoPMD inside your Home Assistant Community Store (HACS). 👈Click this button to install.(Recommended)

  1. Open HACS (Home Assistant Community Store).
  2. Navigate to Integrations.
  3. Click on the "" button to add a new repository.
  4. Click "Custom repositories".
  5. Enter the URL of this GitHub repository.
  6. Select the "Integration" category and click "Add".

Install manually

  1. Install this platform by creating a custom_components folder in the same folder as your configuration.yaml, if it doesn't already exist.
  2. Create another folder bituopmd in the custom_components folder. Copy all files from custom_components into the bituopmd folder. Do not copy files from master branch, download latest release (.zip).

Configuration

After connecting your ESP device to the network following the manual guide, We have three ways to add your ESP devices to HomeAssistant.

Discoverd

When you add your ESP device to the same network as Home Assistant, the device will be automatically scanned and appear in the discovered list.

After clicking 'Configure,' the following dialog box will pop up. Then, click 'Submit' to add the device.

Zeroconf scan

  1. Select 'Use Zeroconf to scan device', and click 'Submit'. The integration will start scanning for devices on the current network.

  1. The integration will list the devices it has scanned. Select the device you want to add and proceed with the addition.

Manual configure

  1. Select 'Use IP to pair devices', and click 'Submit'.

  1. Enter the device's IP address into the input field. Click the submit button.

Devices supported

Detail information

Click on the device name to enter the details page, where you can view all the parameters measured by the device.

Clicking 'View' will redirect you to the device's embedded webpage.

All entities can have their units adjusted according to Home Assistant's rules.

Device settings

Once the integration is activated, you can see the entry to the settings page in Home Assistant's sidebar.

On this page, you can adjust all the settings of the device, as well as access other functions like Zero Energy, Restart, Erase Factory, and OTA.

Click the dropdown menu at the top to select the device you want to configure.

Device OTA

The device's parameter page will display the OTA status. When 'OTA available' is shown, please proceed to the embedded web page or the integration's settings page to perform the OTA.

If 'Up to date' is displayed, it means the device is already on the latest version and no OTA is required.