X-Git-Url: https://sigrok.org/gitweb/?p=libsigrokdecode.git;a=blobdiff_plain;f=decoders%2Fonewire_network%2Fonewire_network.py;h=2dba54ac90aadaa6a8a2a0e349a204b20021204d;hp=18e95256225cbd0d98ffbfa5e566764a96cc8a7a;hb=5d7c5bcca4f770280cd4b58a8ea383fe97cf4a32;hpb=a81787f62362e7ab8471c4c01baa6a806d624d58 diff --git a/decoders/onewire_network/onewire_network.py b/decoders/onewire_network/onewire_network.py index 18e9525..2dba54a 100644 --- a/decoders/onewire_network/onewire_network.py +++ b/decoders/onewire_network/onewire_network.py @@ -18,25 +18,27 @@ ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA ## -# 1-Wire protocol decoder +# 1-Wire protocol decoder (network layer) import sigrokdecode as srd -# 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" ]} +# 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' ], + 0x69: ['OVERDRIVE MATCH ROM' , 'GET ROM' ], +} class Decoder(srd.Decoder): api_version = 1 id = 'onewire_network' name = '1-Wire network layer' - longname = '1-Wire serial communication bus' + longname = '1-Wire serial communication bus (network layer)' desc = 'Bidirectional, half-duplex, asynchronous serial bus.' license = 'gplv2+' inputs = ['onewire_link'] @@ -45,124 +47,144 @@ class Decoder(srd.Decoder): optional_probes = [] options = {} annotations = [ - ['Network', 'Network layer events (device addressing)'], + ['Text', 'Human-readable text'], ] def __init__(self, **kwargs): - # Event timing variables - self.net_beg = 0 - self.net_end = 0 - # Network layer variables - self.state = 'COMMAND' + self.beg = 0 + self.end = 0 + self.state = 'COMMAND' self.bit_cnt = 0 - self.search = "P" - self.data_p = 0x0 - self.data_n = 0x0 - self.data = 0x0 - self.net_rom = 0x0000000000000000 + self.search = 'P' + self.data_p = 0x0 + self.data_n = 0x0 + self.data = 0x0 + self.rom = 0x0000000000000000 def start(self, metadata): self.out_proto = self.add(srd.OUTPUT_PROTO, 'onewire_network') - self.out_ann = self.add(srd.OUTPUT_ANN , 'onewire_network') + self.out_ann = self.add(srd.OUTPUT_ANN, 'onewire_network') def report(self): pass + def putx(self, data): + # Helper function for most annotations. + self.put(self.beg, self.end, self.out_ann, data) + + def puty(self, data): + # Helper function for most protocol packets. + self.put(self.beg, self.end, self.out_proto, data) + def decode(self, ss, es, data): - [code, val] = data + code, val = data # State machine. - if (code == "RESET/PRESENCE"): - self.search = "P" + if code == 'RESET/PRESENCE': + 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_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)): - 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, [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, [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, [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) + self.state = 'COMMAND' + return + # For now we're only interested in 'RESET/PRESENCE' and 'BIT' packets. + if code != 'BIT': + return + + if self.state == 'COMMAND': + # Receiving and decoding a ROM command. + if self.onewire_collect(8, val, ss, es) == 0: + return + if self.data in command: + self.putx([0, ['ROM command: 0x%02x \'%s\'' + % (self.data, command[self.data][0])]]) + self.state = command[self.data][1] + else: + self.putx([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 (1 byte) + serial number (6 bytes) + CRC (1 byte) + if self.onewire_collect(64, val, ss, es) == 0: + return + self.rom = self.data & 0xffffffffffffffff + self.putx([0, ['ROM: 0x%016x' % self.rom]]) + self.puty(['ROM', self.rom]) + self.state = 'TRANSPORT' + elif self.state == 'SEARCH ROM': + # A 64 bit device address is searched for. + # Family code (1 byte) + serial number (6 bytes) + CRC (1 byte) + if self.onewire_search(64, val, ss, es) == 0: + return + self.rom = self.data & 0xffffffffffffffff + self.putx([0, ['ROM: 0x%016x' % self.rom]]) + self.puty(['ROM', self.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) == 0: + return + self.putx([0, ['Data: 0x%02x' % self.data]]) + self.puty(['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) == 0: + return + self.putx([0, ['ROM error data: 0x%02x' % self.data]]) + else: + raise Exception('Invalid state: %s' % self.state) - # Link/Network layer data collector - def onewire_collect (self, length, val, ss, es): - # Storing the sampe this sequence begins with - if (self.bit_cnt == 1): - self.net_beg = ss + # Data collector. + def onewire_collect(self, length, val, ss, es): + # Storing the sample this sequence begins with. + if self.bit_cnt == 1: + self.beg = ss self.data = self.data & ~(1 << self.bit_cnt) | (val << self.bit_cnt) - self.bit_cnt = self.bit_cnt + 1 - # Storing the sampe this sequence ends with - # In case the full length of the sequence is received, return 1 - if (self.bit_cnt == length): - self.net_end = es - self.data = self.data & ((1<