Package Exports

homebridge-tsvesync
homebridge-tsvesync/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (homebridge-tsvesync) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

homebridge-tsvesync

This is a Homebridge plugin that allows you to control your VeSync/Levoit/Etekcity devices through HomeKit. It provides native HomeKit integration for a wide range of VeSync-enabled devices.

Supported Devices

Air Purifiers

All air purifiers are exposed as HomeKit air purifiers with the following features:

Core200S, Core300S, Core400S, Core600S
- On/Off control
- Fan speed control
- Filter life monitoring
- Auto/Manual/Sleep mode selection
- Air quality monitoring (300S/400S/600S only)
LV-PUR131S
- On/Off control
- Air quality monitoring
- Filter life monitoring
Vital100S, Vital200S
- On/Off control
- Fan speed control (1-4)
- Mode selection (Manual, Auto, Sleep, Pet)
- Air quality monitoring
- Filter life monitoring
EverestAir
- On/Off control
- Fan speed control (1-3)
- Mode selection (Manual, Auto, Sleep, Turbo)
- Air quality monitoring
- Filter life monitoring

Humidifiers

All humidifiers are exposed as HomeKit humidifiers with the following features:

Classic300S, Classic200S
- On/Off control
- Target humidity setting
- Current humidity reading
- Auto/Manual mode selection
- Mist level control (1-9)
- Night light control (300S only)
Dual200S
- On/Off control
- Target humidity setting
- Current humidity reading
- Auto/Manual mode selection
- Mist level control (1-2)
LV600S, OasisMist Series, Superior6000S
- On/Off control
- Target humidity setting
- Current humidity reading
- Mode selection (Auto/Manual/Sleep)
- Mist level control
- Warm mist control (where supported)
- Night light control (where supported)

Smart Bulbs

All bulbs are exposed as HomeKit lights with their respective capabilities:

ESL100
- On/Off control
- Brightness control
ESL100CW
- On/Off control
- Brightness control
- Color temperature control
ESL100MC, XYD0001
- On/Off control
- Brightness control
- Full RGB color control
- Color temperature control

Smart Outlets

All outlets are exposed as HomeKit outlets with the following features:

15A Outlets (ESO15-TB, ESW15-USA)
- On/Off control
- Power/Energy monitoring
- Voltage monitoring
10A Outlets (ESW03-USA, ESW01-EU)
- On/Off control
- Power/Energy monitoring
- Voltage monitoring
7A Outlet (wifi-switch-1.3)
- On/Off control
- Basic energy usage tracking

Tower Fans

LTF-F422S Series
- On/Off control
- Fan speed control (1-12)
- Mode selection (Normal, Auto, Sleep, Turbo)
- Oscillation control

Wall Switches

ESWL01
- Basic on/off control
- Status monitoring
ESWL03
- Basic on/off control
- Status monitoring
ESWD16
- Dimming control
- RGB indicator light control
- Status monitoring

Installation

Install Homebridge if you haven't already (see homebridge.io)
Install this plugin:
```
npm install -g homebridge-tsvesync
```
Configure the plugin in your Homebridge config.json

Configuration

Add the following to your Homebridge config.json:

{
    "platforms": [
        {
            "platform": "TSVESyncPlatform",
            "name": "TSVESync",
            "username": "YOUR_VESYNC_EMAIL",
            "password": "YOUR_VESYNC_PASSWORD",
            "updateInterval": 30,
            "debug": false
        }
    ]
}

Configuration Options

platform (required): Must be set to "TSVESyncPlatform"
name (required): Can be anything, this is the name that will appear in your Homebridge log
username (required): Your VeSync account email
password (required): Your VeSync account password

Features

Automatic device discovery
Real-time status updates
Native HomeKit integration
Power consumption monitoring (supported outlets)
Air quality monitoring (supported purifiers)
Humidity control (supported humidifiers)
RGB and white color control (supported bulbs)
Fan speed and mode control (purifiers and fans)

Troubleshooting

Make sure your VeSync credentials are correct
Check the Homebridge logs for any error messages
Ensure your devices are properly set up in the VeSync app
Verify your devices are running the latest firmware
Check that your devices are online in the VeSync app

Development

Clone this repository
Install dependencies: npm install
Build the plugin: npm run build
Link it to your local Homebridge installation: npm link

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Credits

This plugin uses the tsvesync library for device communication.