index 5428947c6845025cc497d263f30d3d867cad1929..4014dc6e920ef7fae860df17dfef8b8d724c2488 100644 (file)
@@ -12,22 +12,31 @@ tic2json: an ENEDIS TIC protocol parser and converter 
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU General Public License for more details.
+More info: http://hacks.slashdirt.org/sw/tic2json/
+
 Dependencies: gcc flex bison
 To build, run 'make'
+Note: the build can be adjusted through the top Makefile variables.
+In particular, it is possible to build support for only specific version(s) of the TIC.
+
+Implementing other types of outputs (XML, etc) should be trivial given the implementation.
+
 TIC output from electronic meters is either:
 - 7E1@1200bps for "historique" mode
 - 7E1@9600bps for "standard" mode
-The current implementation only supports TIC version 02 at this time.
+The current implementation supports TIC version 01 and 02.
 A tty interfaced to the meter TIC output can be set using the following `stty`
 settings:
-1:0:9ad:0:3:1c:7f:15:4:5:1:0:11:13:1a:0:12:f:17:16:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0:0
-The output of this tool is suitable for feeding a Telegraf socket_listener
-configured as follows:
+stty -F <serial_tty> <speed> raw evenp
+
+Where <serial_tty> is the target tty (e.g. /dev/ttyS0) and <speed> is either 1200 or 9600.
+
+For reference, the output of this tool is suitable for feeding a Telegraf 'socket_listener' configured as follows:
 [[inputs.socket_listener]]
  service_address = "udp://:8094"
  tag_keys = ["id"]
 The following command line can be used to send adequate data:
-stdbuf -oL ./tic2json < /dev/ttyS0 2>/dev/null | while read line; do echo "$line" | nc -q 0 -u telegraf_host 8094; done
+stdbuf -oL ./tic2json -2 < /dev/ttyS0 2>/dev/null | while read line; do echo "$line" | nc -q 0 -u telegraf_host 8094; done