The uecho-c includes some sample implementations for controller and device of ECHONET Lite in the examples directory.
The uechosearch is a sample controller to search all ECHONET Lite nodes in the same local area network, and the usage is below.
Usage : uechosearch [options]
-v : Enable verbose output
-d : Enable debug output
-h : Print this message
The uechosearch searches all ECHONET Lite device and profile objects in the local area network, and prints all found objects with the IP address as the following:
$ uechosearch
192.168.xxx.aaa [0] 0EF001 [1] 05FF01 --> (Node Profile Object, Controller Object)
192.168.xxx.bbb [0] 0EF001 [1] 029101 --> (Node Profile Object, Mono Functional Lighting)
In the verbose mode, the uechosearch prints all required read property data of the found objects as the following:
$ uechosearch -v
192.168.xxx.bbb (xxxxxxxxxx)
[0] 0EF001 (Node profile)
[0] [0] 80 (Operating status) 30
[0] [1] 82 (Version information) 010A0100
[0] [2] 83 (Identification number) FE00000B00000EF00100C08FFFFE5E20D3
[0] [5] 8A (Manufacturer code) 00000B
[0] [10] 9D (Status change announcement property map) 0480D5F0FA
[0] [11] 9E (Set property map) 09F1F2F4F5F6F7F8F9FF
[0] [12] 9F (Get property map) 19818081A1A080A0A08080018081820202
[0] [14] D3 (Number of self-node instances) 000002
[0] [15] D4 (Number of self-node classes) 0003
[0] [17] D6 (Self-node instance list S) 020F2001029101
[0] [18] D7 (Self-node class list S) 020F200291
[1] 029101 (Mono functional lighting)
[1] [0] 80 (Operation status) 30
The uechopost is a sample controller to post a message to a ECHONET Lite node in the same local area network, and the usage is below.
Usage : uechopost [options] <address> <obj> <esv> <property (epc, pdc, edt) ...>
-v : Enable verbose output
-n : Disable unicast server
-d : Enable debug output
-h : Print this message
The uechopost can send any request message of ECHONET Lite to an object in the node, and prints the response message. The following example get the standard information from a ECHONET Lite device, and control the power status.
$ uechopost
Usage : echopost <address> <obj> <esv> <property (epc, pdc, edt) ...>
$ uechopost 192.168.xxx.bb 029101 62 8A00 --> READ REQ : Manufacturer code (=0x8A)
192.168.xxx.bb 029101 72 8A0300000B --> READ RES : Panasonic (=0x00000B)
$ uechopost 192.168.xxx.bb 029101 62 8200 --> READ REQ : Standard Version (=0x82)
192.168.xxx.bb 029101 72 820400004600 --> READ RES : Appenddix F (=0x46)
$ uechopost 192.168.xxx.bb 029101 62 8000 --> READ REQ : Operation status (=0x80)
192.168.xxx.bb 029101 72 800131 --> READ RES : OFF (=0x31)
$ uechopost 192.168.xxx.bb 029101 61 800130 --> WRITE REQ : Operation status ON (=0x30)
192.168.xxx.bb 029101 71 8000 --> WRITE RES : (No Data)
$uechopost 192.168.xxx.bb 029101 62 8000 --> READ REQ : Operation status (=0x80)
192.168.xxx.bb 029101 72 800131 --> READ RES : ON (=0x30)
The uechodump is a sample controller to print all multicast messages of ECHONET Lite in the same local area network, and the usage is below.
Usage : uechodump [options]
-n : Disable unicast server
-d : Enable debug output
-h : Print this message
The uechodump prints all multicast packets of announce and notification messages from other node as the following:
$ uechodump
172.20.10.2 10 81 00 EF001 EF001 73 1 D5
172.20.10.2 10 81 00 EF001 EF001 73 1 D5
172.20.10.2 10 81 01 EF001 EF001 62 1 D6
....
The uecholight is an implementation example of the standard mono functional light device object which is specified in the ECHONET Lite, and the usage is below.
Usage : uecholight
-v : Enable verbose output
-m XXXXXX : Set Manufacturer code
-h : Print this message
The example device object is specified as the 'Requirements for mono functional lighting class' in the Detailed Requirements for ECHONET Device objects[1], and the object code is below.
- mono functional lighting class
- Class group code : 0x02
- Class code : 0x91
- Instance code 0x01
The uecholight outputs power status messages when the write requests are received form other nodes or controllers as the following:
$ uecholight
ESV = 80 : 30 (1)
POWER = ON
ESV = 80 : 31 (1)
POWER = OFF
For Raspberry Pi, uecholight outputs the lighting power status into the specified GPIO port.
To enable the GPIO function for Raspberry Pi, compile with UECHO_PLATFORM_RASPBIAN option and run uecholight with root privileges.