From: Iztok Jeras Date: Sun, 15 Jul 2012 15:46:20 +0000 (+0200) Subject: onewire: added transport layer decoder, it does not do much for now X-Git-Tag: libsigrokdecode-0.1.1~49 X-Git-Url: https://sigrok.org/gitaction?a=commitdiff_plain;h=a81787f62362e7ab8471c4c01baa6a806d624d58;p=libsigrokdecode.git onewire: added transport layer decoder, it does not do much for now --- diff --git a/configure.ac b/configure.ac index 768e19b..76f7103 100644 --- a/configure.ac +++ b/configure.ac @@ -172,6 +172,7 @@ AC_CONFIG_FILES([Makefile decoders/usb_protocol/Makefile decoders/onewire_link/Makefile decoders/onewire_network/Makefile + decoders/onewire_transport/Makefile ]) AC_OUTPUT diff --git a/decoders/Makefile.am b/decoders/Makefile.am index 82e6b83..87e9040 100644 --- a/decoders/Makefile.am +++ b/decoders/Makefile.am @@ -43,5 +43,6 @@ SUBDIRS = \ usb_signalling \ usb_protocol \ onewire_link \ - onewire_network + onewire_network \ + onewire_transport diff --git a/decoders/onewire_network/onewire_network.py b/decoders/onewire_network/onewire_network.py index d2b86a0..18e9525 100644 --- a/decoders/onewire_network/onewire_network.py +++ b/decoders/onewire_network/onewire_network.py @@ -22,19 +22,15 @@ import sigrokdecode as srd -# Annotation feed formats -ANN_NETWORK = 0 -ANN_TRANSPORT = 1 - -# a dictionary of ROM commands and their names -rom_command = {0x33: "READ ROM", - 0x0f: "CONDITIONAL READ ROM", - 0xcc: "SKIP ROM", - 0x55: "MATCH ROM", - 0xf0: "SEARCH ROM", - 0xec: "CONDITIONAL SEARCH ROM", - 0x3c: "OVERDRIVE SKIP ROM", - 0x6d: "OVERDRIVE MATCH ROM"} +# a dictionary of ROM commands and their names, next state +command = {0x33: ["READ ROM" , "GET ROM" ], + 0x0f: ["CONDITIONAL READ ROM" , "GET ROM" ], + 0xcc: ["SKIP ROM" , "TRANSPORT" ], + 0x55: ["MATCH ROM" , "GET ROM" ], + 0xf0: ["SEARCH ROM" , "SEARCH ROM"], + 0xec: ["CONDITIONAL SEARCH ROM", "SEARCH ROM"], + 0x3c: ["OVERDRIVE SKIP ROM" , "TRANSPORT" ], + 0x6d: ["OVERDRIVE MATCH ROM" , "GET ROM" ]} class Decoder(srd.Decoder): api_version = 1 @@ -50,7 +46,6 @@ class Decoder(srd.Decoder): options = {} annotations = [ ['Network', 'Network layer events (device addressing)'], - ['Transport', 'Transport layer events'], ] def __init__(self, **kwargs): @@ -78,52 +73,48 @@ class Decoder(srd.Decoder): # State machine. if (code == "RESET/PRESENCE"): - self.state = "COMMAND" self.search = "P" self.bit_cnt = 0 + self.put(ss, es, self.out_ann, [0, ['RESET/PRESENCE: %s' % ('True' if val else 'False')]]) + self.put(ss, es, self.out_proto, ['RESET/PRESENCE', val]) + self.state = "COMMAND" elif (code == "BIT"): if (self.state == "COMMAND"): # Receiving and decoding a ROM command if (self.onewire_collect(8, val, ss, es)): - self.put(self.net_beg, self.net_end, self.out_ann, [ANN_NETWORK, - ['ROM COMMAND: 0x%02x \'%s\'' % (self.data, rom_command[self.data])]]) - if (self.data == 0x33): # READ ROM - self.state = "GET ROM" - elif (self.data == 0x0f): # CONDITIONAL READ ROM - self.state = "GET ROM" - elif (self.data == 0xcc): # SKIP ROM - self.state = "TRANSPORT" - elif (self.data == 0x55): # MATCH ROM - self.state = "GET ROM" - elif (self.data == 0xf0): # SEARCH ROM - self.state = "SEARCH ROM" - elif (self.data == 0xec): # CONDITIONAL SEARCH ROM - self.state = "SEARCH ROM" - elif (self.data == 0x3c): # OVERDRIVE SKIP ROM - self.state = "TRANSPORT" - elif (self.data == 0x69): # OVERDRIVE MATCH ROM - self.state = "GET ROM" + if (self.data in command): + self.put(self.net_beg, self.net_end, self.out_ann, [0, + ['ROM COMMAND: 0x%02x \'%s\'' % (self.data, command[self.data][0])]]) + self.state = command[self.data][1] + else: + self.put(self.net_beg, self.net_end, self.out_ann, [0, + ['ROM COMMAND: 0x%02x \'%s\'' % (self.data, 'UNRECOGNIZED')]]) + self.state = "COMMAND ERROR" elif (self.state == "GET ROM"): # A 64 bit device address is selected # family code (1B) + serial number (6B) + CRC (1B) if (self.onewire_collect(64, val, ss, es)): self.net_rom = self.data & 0xffffffffffffffff - self.put(self.net_beg, self.net_end, self.out_ann, [ANN_NETWORK, ['ROM: 0x%016x' % self.net_rom]]) + self.put(self.net_beg, self.net_end, self.out_ann, [0, ['ROM: 0x%016x' % self.net_rom]]) + self.put(self.net_beg, self.net_end, self.out_proto, ['ROM', self.net_rom]) self.state = "TRANSPORT" elif (self.state == "SEARCH ROM"): # A 64 bit device address is searched for # family code (1B) + serial number (6B) + CRC (1B) if (self.onewire_search(64, val, ss, es)): self.net_rom = self.data & 0xffffffffffffffff - self.put(self.net_beg, self.net_end, self.out_ann, [ANN_NETWORK, ['ROM: 0x%016x' % self.net_rom]]) + self.put(self.net_beg, self.net_end, self.out_ann, [0, ['ROM: 0x%016x' % self.net_rom]]) + self.put(self.net_beg, self.net_end, self.out_proto, ['ROM', self.net_rom]) self.state = "TRANSPORT" elif (self.state == "TRANSPORT"): # The transport layer is handled in byte sized units if (self.onewire_collect(8, val, ss, es)): - self.put(self.net_beg, self.net_end, self.out_ann, [ANN_NETWORK , ['TRANSPORT: 0x%02x' % self.data]]) - self.put(self.net_beg, self.net_end, self.out_ann, [ANN_TRANSPORT, ['TRANSPORT: 0x%02x' % self.data]]) - self.put(self.net_beg, self.net_end, self.out_proto, ['transfer', self.data]) - # TODO: Sending translort layer data to 1-Wire device models + self.put(self.net_beg, self.net_end, self.out_ann, [0, ['DATA: 0x%02x' % self.data]]) + self.put(self.net_beg, self.net_end, self.out_proto, ['DATA', self.data]) + elif (self.state == "COMMAND ERROR"): + # Since the command is not recognized, print raw data + if (self.onewire_collect(8, val, ss, es)): + self.put(self.net_beg, self.net_end, self.out_ann, [0, ['ROM ERROR DATA: 0x%02x' % self.data]]) else: raise Exception('Invalid state: %s' % self.state) diff --git a/decoders/onewire_transport/Makefile.am b/decoders/onewire_transport/Makefile.am new file mode 100644 index 0000000..982525d --- /dev/null +++ b/decoders/onewire_transport/Makefile.am @@ -0,0 +1,26 @@ +## +## This file is part of the sigrok project. +## +## Copyright (C) 2012 Uwe Hermann +## +## This program is free software; you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 2 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software +## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +## + +pkgdatadir = $(DECODERS_DIR)/onewire_transport + +dist_pkgdata_DATA = __init__.py onewire_transport.py + +CLEANFILES = *.pyc + diff --git a/decoders/onewire_transport/__init__.py b/decoders/onewire_transport/__init__.py new file mode 100644 index 0000000..28db017 --- /dev/null +++ b/decoders/onewire_transport/__init__.py @@ -0,0 +1,76 @@ +## +## This file is part of the sigrok project. +## +## Copyright (C) 2012 Uwe Hermann +## +## This program is free software; you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 2 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software +## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +## + +''' +1-Wire protocol decoder. + +The 1-Wire protocol enables bidirectional communication over a single wire (and +ground) between a single master and one or multiple slaves. The protocol is +layered, the provided parser decodes the next layers: +- Link layer (reset, presence detection, reading/writing bits) +- Network layer (skip, search, match device ROM addresses) +The higher layers (transport, presentation) are not decoded, since they are +mostly device specific and it would take a lot of code to interpret them. + +Sample rate: +A high enough sample rate is required to properly detect all the elements of +the protocol. A lower sample rate can be used if the master does not use +overdrive communication speed. The next minimal values should be used: +- overdrive available: 2MHz minimum, 5MHz suggested +- overdrive not available: 400kHz minimum, 1MHz suggested + +Probes: +1-Wire requires a single signal, but some master implementations might have a +separate signal use to deliver power to the bus during temperature conversion +as an example. This power signal is currently not parsed. +- owr (1-Wire bus) +- pwr (1-Wire power) + +Options: +1-Wire is an asynchronous protocol, so the decoder must know the sample rate. +The timing for sampling bits, presence and reset is calculated by the decoder, +but in case the user wishes to use different values, it is possible to +configure the next timing values (number of sample rate periods): +- overdrive (if active the decoder will be prepared for overdrive) +- cnt_normal_bit (time for normal mode sample bit) +- cnt_normal_presence (time for normal mode sample presence) +- cnt_normal_reset (time for normal mode reset) +- cnt_overdrive_bit (time for overdrive mode sample bit) +- cnt_overdrive_presence (time for overdrive mode sample presence) +- cnt_overdrive_reset (time for overdrive mode reset) +This options should be configured only on very rare cases and the user should +read the decoder source code to understand them correctly. + +Annotations: +Annotations can be shown for each layer of the protocol separately: +- link (the value of each transmitted bit is shown separately) +- network (the ROM command, and address are shown) +- transport (only transport layer byte transfers are shown) +If link layer annotations are shown, possible issues with sample rate and sample +timing are also shown. + +TODO: +- add CRC checks for network layer +- add transport layer code +- review link layer code, to check for protocol correctness +- define output protocol +''' + +from .onewire_transport import * diff --git a/decoders/onewire_transport/onewire_transport.py b/decoders/onewire_transport/onewire_transport.py new file mode 100644 index 0000000..bc9efbb --- /dev/null +++ b/decoders/onewire_transport/onewire_transport.py @@ -0,0 +1,84 @@ +## +## This file is part of the sigrok project. +## +## Copyright (C) 2012 Iztok Jeras +## +## This program is free software; you can redistribute it and/or modify +## it under the terms of the GNU General Public License as published by +## the Free Software Foundation; either version 2 of the License, or +## (at your option) any later version. +## +## This program is distributed in the hope that it will be useful, +## but WITHOUT ANY WARRANTY; without even the implied warranty of +## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +## GNU General Public License for more details. +## +## You should have received a copy of the GNU General Public License +## along with this program; if not, write to the Free Software +## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +## + +# 1-Wire protocol decoder + +import sigrokdecode as srd + +command = {0x44: "TEMPERATURE CONVERSION", + 0xbe: "READ SCRATCHPAD"} + +class Decoder(srd.Decoder): + api_version = 1 + id = 'onewire_transport' + name = '1-Wire transport layer' + longname = '1-Wire serial communication bus' + desc = 'Bidirectional, half-duplex, asynchronous serial bus.' + license = 'gplv2+' + inputs = ['onewire_network'] + outputs = [] + probes = [] + optional_probes = [] + options = {} + annotations = [ + ['Transport', 'Transport layer events'], + ] + + def __init__(self, **kwargs): + # Event timing variables + self.trn_beg = 0 + self.trn_end = 0 + # Transport layer variables + self.state = 'ROM' + self.rom = 0x0000000000000000 + + def start(self, metadata): + self.out_ann = self.add(srd.OUTPUT_ANN , 'onewire_transport') + + def report(self): + pass + + def decode(self, ss, es, data): + [code, val] = data + + # State machine. + if (code == "RESET/PRESENCE"): + self.put(ss, es, self.out_ann, [0, ['RESET/PRESENCE: %s' % ('True' if val else 'False')]]) + self.state = "ROM" + elif (code == "ROM"): + self.rom = val + self.put(ss, es, self.out_ann, [0, ['ROM: 0x%016x' % (val)]]) + self.state = "COMMAND" + elif (code == "DATA"): + if (self.state == "COMMAND"): + if (val in command): + self.put(ss, es, self.out_ann, [0, ['FUNCTION COMMAND: 0x%02x \'%s\'' % (val, command[val])]]) + self.state = command[val] + else: + self.put(ss, es, self.out_ann, [0, ['FUNCTION COMMAND: 0x%02x \'%s\'' % (val, 'UNRECOGNIZED')]]) + self.state = "UNRECOGNIZED" + elif (self.state == "READ SCRATCHPAD"): + self.put(ss, es, self.out_ann, [0, ['SCRATCHPAD DATA: 0x%02x' % (val)]]) + elif (self.state == "TEMPERATURE CONVERSION"): + self.put(ss, es, self.out_ann, [0, ['TEMPERATURE CONVERSION STATUS: 0x%02x' % (val)]]) + elif (self.state == "UNRECOGNIZED"): + self.put(ss, es, self.out_ann, [0, ['UNRECOGNIZED: 0x%02x' % (val)]]) + else: + raise Exception('Invalid state: %s' % self.state)