Few helpful Serial API commands that can be used to manage RaZberry or UZB.
For echo commands use /dev/ttyAMA0 for RaZberry and /dev/ttyACM0 for UZB.
Commands are available in form for Z-Way API, echo commands (to be executed in the terminal) or via uSAPI (micro Serial API tool)
Switching between Static and Bridge mode
(supported on the 7th generation or newer)
- Static mode (compatibility with 5th gen firmwares):
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMESerialAPIOptionsStaticAPISet(true)- Echo command:
echo -ne "\x01\x06\x00\xF8\x04\x01\x01\x05" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F8 04 01 01" -p /dev/ttyACM0 -r 1
- Bridge mode (compatibility with 7th gen SiLabs firmware):
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMESerialAPIOptionsStaticAPISet(false)- Echo command:
echo -ne "\x01\x06\x00\xF8\x04\x01\x00\x04" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F8 04 01 00" -p /dev/ttyACM0 -r 1
Z-Wave frequency change
- EU:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(0)- Echo command:
echo -ne "\x01\x04\x00\xF2\x00\x09" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 00" -p /dev/ttyACM0 -r 1
- US:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(3)- Echo command:
echo -ne "\x01\x04\x00\xF2\x03\x0A" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 03" -p /dev/ttyACM0 -r 1
- ANZ:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(4)- Echo command:
echo -ne "\x01\x04\x00\xF2\x04\x0D" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 04" -p /dev/ttyACM0 -r 1
- IL:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(9)- Echo command:
echo -ne "\x01\x04\x00\xF2\x01\x00" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 09" -p /dev/ttyACM0 -r 1
- RU:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(1)- Echo command:
echo -ne "\x01\x04\x00\xF2\x01\x08" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 01" -p /dev/ttyACM0 -r 1
- IN:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(2)- Echo command:
echo -ne "\x01\x04\x00\xF2\x02\x0B" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 02" -p /dev/ttyACM0 -r 1
- HK:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(5)- Echo command:
echo -ne "\x01\x04\x00\xF2\x05\x0C" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 05" -p /dev/ttyACM0 -r 1
- JP:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(7)- Echo command:
echo -ne "\x01\x04\x00\xF2\x07\x0E" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 07" -p /dev/ttyACM0 -r 1
- KR:
- Z-Way API:
http://localhost:8083/JS/Run/zway.ZMEFreqChange(8)- Echo command:
echo -ne "\x01\x04\x00\xF2\x08\x01" > /dev/ttyAMA0- uSAPI:
uSAPI -b "F2 08" -p /dev/ttyACM0 -r 1
Switching between Normal and Long Range mode
(supported on the 7th generation or newer)
- Normal mode (compatibility with 5th gen and 7th gen non-Long-Range firmwares):
- Echo command:
echo -ne "\x01\x05\x00\x0B\x80\x01\x70" > /dev/ttyAMA0- uSAPI:
uSAPI -b "0B 80 01" -p /dev/ttyACM0 -r 1
- Long Range mode:
- Echo command:
echo -ne "\x01\x05\x00\x0B\x80\x02\x73" > /dev/ttyAMA0- uSAPI:
uSAPI -b "0B 80 02" -p /dev/ttyACM0 -r 1
Reboot the Z-Wave radio chip
-
- Z-Way API:
http://localhost:8083/JS/Run/zway.SerialAPISoftReset()- Echo command:
echo -ne "\x01\x03\x00\x08\xf4" > /dev/ttyAMA0- uSAPI:
uSAPI -b "08" -p /dev/ttyACM0
Reset to factory default (erase the full network information)
-
- Z-Way API:
http://localhost:8083/JS/Run/zway.SetDefault()- Echo command:
echo -ne "\x01\x04\x00\x42\x01\xB8" > /dev/ttyAMA0- uSAPI:
uSAPI -b "42 01" -p /dev/ttyACM0 -r 2
RF test mode (for FCC and CE certification)
- US (FCC)
- 916 MHz:
uSAPI -b "F8 0B 02 09 00 64 00 00 75 30" -p /dev/ttyACM0 -r 1
- 908 MHz:
uSAPI -b "F8 0B 02 09 02 64 00 00 75 30" -p /dev/ttyACM0 -r 1
- 912 MHz:
uSAPI -b "F8 0B 02 09 03 64 00 00 75 30" -p /dev/ttyACM0 -r 1
- 921 MHz:
uSAPI -b "F8 0B 02 0A 03 64 00 00 75 30" -p /dev/ttyACM0 -r 1
- Europe (CE-RED)
- 869.85 MHz:
uSAPI -b "F8 0B 02 00 00 64 00 00 75 30" -p /dev/ttyACM0 -r 1
- 868.42 MHz:
uSAPI -b "F8 0B 02 00 01 64 00 00 75 30" -p /dev/ttyACM0 -r 1
XX is emission type: 01 for carrier only, 02 for PN9 emission (polynomial sequence), 03 for 10101010101... sequence, 04 for packet with chip serial number
XX frequency: 00 for EU, 01 for US, 02 for ANZ, 03 for HK, 05 for IN, 06 for IL, 07 for RU, 08 for CN, 09 for US LR A, 0A for US LR B, 20 for JP, 21 for KR
XX Z-Wave channel (see above)
XX power 0-200 in dB
XX XX XX XX is the time in milliseconds to emit. I.e. 00 00 75 30 is 30 000 ms = 30 seconds. You can change it to other values. Use FF FF FF FF for no timeout.
