Module to work with NooLite/NooLite-F modules via MTRF-64/MTRF-64-USB adapter
Project description
NooLite-F
Python module to work with NooLite-F (MTRF-64-USB, MTRF-64) You can find more details about MTRF-64/MTRF-64-USB api on official NooLite site:
https://noo.by/images/instructions/Adaptery%20i%20moduli/mtrf-64-usb.pdf
https://noo.by/images/instructions/Adaptery%20i%20moduli/rukovodstvo-po-ekspluatatsii-mtrf-64-a.pdf
https://noo.by/images/instructions/Adaptery%20i%20moduli/mtrf-64.pdf
Supported Python versions: Python 3.5 and later
Send commands to modules
There are possible three ways of sending commands to modules:
Using adapter
You can work directly with adapter:
adapter = MTRF64USBAdapter("COM3") request = Request() request.action = Action.SEND_COMMAND request.mode = Mode.TX request.channel = 60 request.command = Command.TEMPORARY_ON request.format = 6 request.data[0] = 1 response = adapter.send(request) print(response) request = Request() request.action = Action.SEND_COMMAND_TO_ID request.mode = Mode.TX_F request.id = 0x5023 request.command = Command.SWITCH response = adapter.send(request) print(response)
Note: Request and response directly maps to low-level api for adapter.
Using controller
You can use MTRF64Controller and abstract from manual request data creating. Just call appropriate function:
controller = MTRF64Controller("COM3") controller.set_brightness(channel=60, brightness=0.3, module_mode=ModuleMode.NOOLITE) controller.switch(module_id=0x5435, module_mode=ModuleMode.NOOLITE_F)
Controller supports following commands:
on - turn on the module
off - turn off the module
switch - switch module state
temporary_on - turn on the module for a specified time
set_temporary_on_mode - enable/disable “temporary on” mode
bright_tune - start to increase/decrease brightness
bright_tune_back - invert direction of the brightness change
bright_tune_stop - stop brightness changing
bright_tune_custom - start to increase/decrease brightness with a specified speed
bright_step - increase/decrease brightness once with a specified step
set_brightness - set brightness
load_preset - load saved module state from preset
save_preset - save current module state as preset
roll_rgb_color - start color changing (only for RGB Led modules)
switch_rgb_color - switch color (only for RGB Led modules)
switch_rgb_mode - switch color changing modes (only for RGB Led modules)
switch_rgb_mode_speed - switch speed of the color changing (only for RGB Led modules)
set_rgb_brightness - set brightness for each rgb color (only for RGB Led modules)
read_state - read module state (only for NooLite-F modules)
read_extra_state - read additional module state (only for NooLite-F modules)
read_channels_state - read information about available channels for binding (only for NooLite-F modules)
read_module_config - read current module configuration (only for NooLite-F modules)
write_module_config - write new module configuration (only for NooLite-F modules)
read_dimmer_correction - read dimmer corrections values (only for NooLite-F modules)
write_dimmer_correction - write new dimmer corrections values (only for NooLite-F modules)
bind - send bind command to module
unbind - send unbind command to module
set_service_mode - turn on/off the service mode on module (only for NooLite-F modules)
Each command can accept following parameters:
module_id: the module id. The command will be send to module with specified id (used only for NOOLITE-F modules).
channel: the number of the channel. The command will be send to all modules that are binded with selected channel. If module_id is also specified then command will be send only to appropriate device in channel.
broadcast: broadcast mode. If True then command will be send simultaneously to all modules that are binded with selected channel (default - False). If module_id is specified or mode is NOOLITE then broadcast parameter will be ignored.
module_mode: module work mode, used to determine adapter mode for send command (default - NOOLITE_F).
Some commands require additional parameters. For more details see inline help.
In response for each command returns:
for nooLite-F modules returns array which contains command result, module info and it state for each module that are binded with selected channel.
for nooLite modules returns nothing.
Command result equals True if command send successfully, otherwise False. Module info contains information about module: module, id, type, firmware version. Module state contains information about module state: (on/off/temporary on), current brightness and bind mode (on/off):
[ [(True, <ModuleInfo (0x57f72f0), id: 0x5bce, type: 5, firmware: 0>, <ModuleBaseStateInfo (0x57f73d0), state: ModuleState.ON, brightness: 0.050980392156862744, service mode: ServiceModeState.BIND_OFF>)], [(True, <ModuleInfo (0x57f72f0), id: 0x5bce, type: 5, firmware: 0>, <ModuleBaseStateInfo (0x57f73d1), state: ModuleState.ON, brightness: 0.050980392156862744, service mode: ServiceModeState.BIND_OFF>)] ]
Some state and config command can return extra info about module state/config. If command result is False, then module info and state are None.:
[(False, None, None)]
Using module wrappers
You can use special classes that are wrappers around controller. Each class is representation of the concrete module or modules assigned with specific channel:
controller = MTRF64Controller("COM3") dimmer = Dimmer(controller, channel=62, module_mode=ModuleMode.NOOLITE) dimmer.set_brightness(0.4) switch = Switch(controller, channel=60, module_mode=ModuleMode.NOOLITE) switch.on() switch = Switch(controller, module_id=0x5023, module_mode=ModuleMode.NOOLITE_F) switch.switch()
Available module wrappers:
Switch - supports on/off, toggle, preset. Also supports services methods for bind/unbind.
ExtendedSwitch - In additional to Switch, supports temporary on.
Dimmer - In additional to ExtendedSwitch supports brightness managing.
RGBLed - supports toggle, brightness management, rgb color management.
Fan - the same as Dimmer, uses for manage fans (thanks to mrukavishnikov ( https://github.com/mrukavishnikov )).
Receiving commands from remote controls
You can also use several ways to receive data from remote controllers and sensors.
Using adapter listener
You can receive data from remote controllers using MTRF64USBAdapter directly. For it you should pass a listener method into adapter constructor. This method will be call each time when adapter get data from sensors or remote controls:
def on_receive_data(incoming_data: IncomingData): print("data: {0}".format(incoming_data)) adapter = MTRF64USBAdapter("COM3", on_receive_data)
Using controller listener
You can create special command listener and assign it with concrete channel in controller. The controller get incoming data, handle it and call appropriate method in listener. So you should not worry about it:
controller = MTRF64Controller("COM3") switch = Dimmer(controller, channel=62, module_mode=ModuleMode.NOOLITE) class MyRemoteController(RemoteControllerListener): def on_on(self): switch.on() def on_off(self): switch.off() def on_switch(self): switch.switch() def on_brightness_tune(self, direction: BrightnessDirection): switch.brightness_tune(direction) def on_brightness_tune_stop(self): switch.brightness_tune_stop() def on_brightness_tune_back(self): switch.brightness_tune_back() class MySensor(RemoteControllerListener): def on_temp_humi(self, temp: float, humi: int, battery: BatteryState, analog: float): print("temp: {0}, humidity: {1}".format(temp, humi)) remoteController = MyRemoteController() sensor = MySensor() controller.add_listener(1, remoteController) controller.add_listener(2, sensor) while True: sleep(60)
Using sensor wrappers
And in the end you can use a special wrappers around Controller and RemoteControllerListener. Just create it, set channel and appropriate listeners:
def on_temp(temp, humi, battery, analog): print("temp: {0}, humi: {1}, battery_state: {2}, analog: {3}".format(temp, humi, battery, analog)) def on_battery(): print("battery") def on_switch(): print("switch") def on_tune_back(): print("tune back") def on_tune_stop(): print("tune stop") def on_roll_color(): print("roll color") def on_switch_color(): print("switch color") def on_switch_mode(): print("switch mode") def on_switch_speed(): print("switch speed") controller = MTRF64Controller("COM3") tempSensor = TempHumiSensor(controller, 9, on_temp, on_battery) rgb = RGBRemoteController(controller, 63, on_switch, on_tune_back, on_tune_stop, on_roll_color, on_switch_color, on_switch_mode, on_switch_speed, on_battery) while True: sleep(60)
Available wrappers:
TempHumiSensor - supports receiving data from temperature and humidity sensors.
MotionSensor - supports receiving data from motion sensor.
BinarySensor - supports receiving data from wet and opening sensor.
RemoteController - supports receiving commands from standard NooLite remote controllers.
RGBRemoteController - supports receiving commands from RGB Remote controller.
Note
Tested with MTRF-64-USB adapter and modules:
SLF-1-300 (NooLite-F, switch module)
SRF-1-3000 (NooLite-F, smart power socket)
SD-1-180 (NooLite, RGB Module)
SU-1-500 (NooLite, switch module)
SUF-1-300 (NooLite-F, switch module)
PM112 (NooLite, motion sensor)
PT111 (NooLite, temperature and humidity sensor)
PB211 (NooLite, remote controller)
PK315 (Noolite, remote controller)
PU112-2 (NooLite, RGB remote controller)
Breaking changes:
v0.1.0
change parameters order in TempHumi sensor callback from (temp, humi, battery, analog) to (temp, humi, analog, battery)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for NooLite_F-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e37b2a54b607de4b9433d66a2b1b049aa228420f83204b0a5e892ffc3a515f83 |
|
MD5 | 54015f98836be3ee1b55ebed1ec0b516 |
|
BLAKE2b-256 | f2b7c6c3919be54566f12e8e20b7399a82b579b49270585f031c7a0d1ebff0c4 |