Skip to content
This repository has been archived by the owner on Oct 8, 2019. It is now read-only.
/ miio-go Public archive

An implementation of the miIO home protocol by Xiaomi written in Golang.

License

Notifications You must be signed in to change notification settings

nickw444/miio-go

Repository files navigation

miio-go

Coverage Status

An implementation of the miIO home protocol by Xiaomi written in Golang. Heavily inspired by:

This implementation has been design with the following concerns:

  • Testability
  • Development without a miIO device handy (or performing any real network operations)
  • A simple event-based API.

Supported Devices

At the moment, only the following devices are officially supported by this library. Feel free to submit a pull request, I'd be more than happy to have more devices supported by this library.

  • Xiaomi Mi Smart WiFi Socket (v1 - no USB) (chuangmi.plug.m1)
  • Xiamoi Yeelight (yeelink.light.color1)

Simulator

A device simulator/emulator exists in the simulator package. It takes advantage of the low level network used to communicate with real devices to emulate hardware devices.

Give it a try!

Tokens

Documentation coming soon...

Examples

Documentation coming soon...

CLI

A CLI exists to allow controlling devices using this library.

usage: miio-go CLI [<flags>] <command> [<args> ...]

CLI application to manually test miio-go functionality

Flags:
  --help            Show context-sensitive help (also try --help-long and --help-man).
  --local           Send broadcast to 127.0.0.1 instead of 255.255.255.255 (For use with locally hosted simulator)
  --log-level=warn  Set MiiO to a specific log level

Commands:
  help [<command>...]
    Show help.


  control brightness <brightness>
    Set device brightness


  control power <state>
    Set device power


  control color hsv <hue> <saturation>
    Set color using HSV values


  control color rgb <red> <green> <blue>
    Set color using RGB values


  discover
    Discover devices on the local network

About

An implementation of the miIO home protocol by Xiaomi written in Golang.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published