SonoffBasic 0.0.1

basic package to control sonoff switches

SonoffBasic

Itead Sonoff is a smart wifi switch to control electronics power supply. SonoffBasic allows to control sonoff switch via the cloud, with a very basic features.

⚠️ Project was tested on sonoff basic only. Other devices will be tested and adjust in the future.

requirements

• Sonoff switch must be connected to ewelink app SONOFF Basic USER GUIDE.
• Username is email address.
• Ewelink account region must be one of 'us', 'eu' or 'cn'.

How to use ✨

• Create an instance of Sonoff with ewelink. available params (all values in string format):

  • username - email address (required)
  • password (required)
  • region (optional) default 'us'
  • timezone (optional) default 'US/Pacific'

  >>> from SonoffBasic import sonoff
  >>> sonoff = sonoff.Sonoff(username='[e-mail]',
                      password='my_pass',
                      timezone='US/Pacific',
                      region='us')
  

• Search the required device

  >>> print(sonoff.devices)
  [{'name': 'taco', 'deviceid': '1000157898', 'status': 'on'}, 
  {'name': 'Irrigation', 'deviceid': '100015b23r', 'status': 'off'}]
  

• Control the device

  >>> sonoff.change_device_status(statusid = '1000157898',
                                  new_status = 'off')            
  deviceid: 1000157898 status successfully changed to off
  

Special Thanks

Thanks to @AlexxIT. cloud connection to eWeLink was inspired by SonoffLAN project.