[libsigrokdecode.git] / decoders / eeprom93xx / pd.py

##
## This file is part of the libsigrokdecode project.
##
## Copyright (C) 2017 Kevin Redon <kingkevin@cuvoodoo.info>
##
## 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, see <http://www.gnu.org/licenses/>.
##

import sigrokdecode as srd

class Decoder(srd.Decoder):
    api_version = 3
    id = 'eeprom93xx'
    name = '93xx EEPROM'
    longname = '93xx Microwire EEPROM'
    desc = '93xx series Microwire EEPROM protocol.'
    license = 'gplv2+'
    inputs = ['microwire']
    outputs = []
    tags = ['IC', 'Memory']
    options = (
        {'id': 'addresssize', 'desc': 'Address size', 'default': 8},
        {'id': 'wordsize', 'desc': 'Word size', 'default': 16},
        {'id': 'format', 'desc': 'Data format', 'default': 'hex',
            'values': ('ascii', 'hex')},
    )
    annotations = (
        ('si-data', 'SI data'),
        ('so-data', 'SO data'),
        ('warning', 'Warning'),
    )
    annotation_rows = (
        ('data', 'Data', (0, 1)),
        ('warnings', 'Warnings', (2,)),
    )

    def __init__(self):
        self.reset()

    def reset(self):
        self.frame = []

    def start(self):
        self.out_ann = self.register(srd.OUTPUT_ANN)
        self.addresssize = self.options['addresssize']
        self.wordsize = self.options['wordsize']

    def put_address(self, data):
        # Get address (MSb first).
        a = 0
        for b in range(len(data)):
            a += (data[b].si << (len(data) - b - 1))
        self.put(data[0].ss, data[-1].es, self.out_ann,
                 [0, ['Address: 0x%x' % a, 'Addr: 0x%x' % a, '0x%x' % a]])

    def put_word(self, si, data):
        # Decode word (MSb first).
        word = 0
        for b in range(len(data)):
            d = data[b].si if si else data[b].so
            word += (d << (len(data) - b - 1))
        idx = 0 if si else 1

        if self.options['format'] == 'ascii':
            word_str = ''
            for s in range(0, len(data), 8):
                c = 0xff & (word >> s)
                if c in range(32, 126 + 1):
                    word_str = chr(c) + word_str
                else:
                    word_str = '[{:02X}]'.format(c) + word_str
            self.put(data[0].ss, data[-1].es,
                    self.out_ann, [idx, ['Data: %s' % word_str, '%s' % word_str]])
        else:
            self.put(data[0].ss, data[-1].es,
                    self.out_ann, [idx, ['Data: 0x%x' % word, '0x%x' % word]])

    def decode(self, ss, es, data):
        if len(data) < (2 + self.addresssize):
            self.put(ss, es, self.out_ann, [2, ['Not enough packet bits']])
            return

        opcode = (data[0].si << 1) + (data[1].si << 0)

        if opcode == 2:
            # READ instruction.
            self.put(data[0].ss, data[1].es,
                     self.out_ann, [0, ['Read word', 'READ']])
            self.put_address(data[2:2 + self.addresssize])

            # Get all words.
            word_start = 2 + self.addresssize
            while len(data) - word_start > 0:
                # Check if there are enough bits for a word.
                if len(data) - word_start < self.wordsize:
                    self.put(data[word_start].ss, data[len(data) - 1].es,
                             self.out_ann, [2, ['Not enough word bits']])
                    break
                self.put_word(False, data[word_start:word_start + self.wordsize])
                # Go to next word.
                word_start += self.wordsize
        elif opcode == 1:
            # WRITE instruction.
            self.put(data[0].ss, data[1].es,
                     self.out_ann, [0, ['Write word', 'WRITE']])
            self.put_address(data[2:2 + self.addresssize])
            # Get word.
            if len(data) < 2 + self.addresssize + self.wordsize:
                self.put(data[2 + self.addresssize].ss,
                         data[len(data) - 1].ss,
                         self.out_ann, [2, ['Not enough word bits']])
            else:
                self.put_word(True, data[2 + self.addresssize:2 + self.addresssize + self.wordsize])
        elif opcode == 3:
            # ERASE instruction.
            self.put(data[0].ss, data[1].es,
                     self.out_ann, [0, ['Erase word', 'ERASE']])
            self.put_address(data[2:2 + self.addresssize])
        elif opcode == 0:
            if data[2].si == 1 and data[3].si == 1:
                # WEN instruction.
                self.put(data[0].ss, data[2 + self.addresssize - 1].es,
                         self.out_ann, [0, ['Write enable', 'WEN']])
            elif data[2].si == 0 and data[3].si == 0:
                # WDS instruction.
                self.put(data[0].ss, data[2 + self.addresssize - 1].es,
                         self.out_ann, [0, ['Write disable', 'WDS']])
            elif data[2].si == 1 and data[3].si == 0:
                # ERAL instruction.
                self.put(data[0].ss, data[2 + self.addresssize - 1].es,
                         self.out_ann, [0, ['Erase all memory',
                                            'Erase all', 'ERAL']])
            elif data[2].si == 0 and data[3].si == 1:
                # WRAL instruction.
                self.put(data[0].ss, data[2 + self.addresssize - 1].es,
                         self.out_ann, [0, ['Write all memory',
                                            'Write all', 'WRAL']])
                # Get word.
                if len(data) < 2 + self.addresssize + self.wordsize:
                    self.put(data[2 + self.addresssize].ss,
                             data[len(data) - 1].ss,
                             self.out_ann, [2, ['Not enough word bits']])
                else:
                    self.put_word(True, data[2 + self.addresssize:2 + self.addresssize + self.wordsize])
Commit	Line	Data
3a9c517e KR	1	##
	2	## This file is part of the libsigrokdecode project.
	3	##
	4	## Copyright (C) 2017 Kevin Redon <kingkevin@cuvoodoo.info>
	5	##
	6	## This program is free software; you can redistribute it and/or modify
	7	## it under the terms of the GNU General Public License as published by
	8	## the Free Software Foundation; either version 2 of the License, or
	9	## (at your option) any later version.
	10	##
	11	## This program is distributed in the hope that it will be useful,
	12	## but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	## GNU General Public License for more details.
	15	##
	16	## You should have received a copy of the GNU General Public License
	17	## along with this program; if not, see <http://www.gnu.org/licenses/>.
	18	##
	19
	20	import sigrokdecode as srd
	21
	22	class Decoder(srd.Decoder):
b197383c	23	api_version = 3
e1eacaab UH	24	id = 'eeprom93xx'
	25	name = '93xx EEPROM'
	26	longname = '93xx Microwire EEPROM'
	27	desc = '93xx series Microwire EEPROM protocol.'
3a9c517e KR	28	license = 'gplv2+'
3a9c517e KR	29	inputs = ['microwire']
6cbba91f	30	outputs = []
d6d8a8a4	31	tags = ['IC', 'Memory']
3a9c517e KR	32	options = (
	33	{'id': 'addresssize', 'desc': 'Address size', 'default': 8},
	34	{'id': 'wordsize', 'desc': 'Word size', 'default': 16},
9b61fbd1 SP	35	{'id': 'format', 'desc': 'Data format', 'default': 'hex',
9b61fbd1 SP	36	'values': ('ascii', 'hex')},
3a9c517e KR	37	)
	38	annotations = (
	39	('si-data', 'SI data'),
	40	('so-data', 'SO data'),
	41	('warning', 'Warning'),
	42	)
	43	annotation_rows = (
	44	('data', 'Data', (0, 1)),
	45	('warnings', 'Warnings', (2,)),
	46	)
	47
	48	def __init__(self):
10aeb8ea GS	49	self.reset()
	50
	51	def reset(self):
3a9c517e KR	52	self.frame = []
	53
	54	def start(self):
	55	self.out_ann = self.register(srd.OUTPUT_ANN)
	56	self.addresssize = self.options['addresssize']
	57	self.wordsize = self.options['wordsize']
	58
	59	def put_address(self, data):
	60	# Get address (MSb first).
	61	a = 0
	62	for b in range(len(data)):
941e7a64	63	a += (data[b].si << (len(data) - b - 1))
5f914c47	64	self.put(data[0].ss, data[-1].es, self.out_ann,
3a9c517e KR	65	[0, ['Address: 0x%x' % a, 'Addr: 0x%x' % a, '0x%x' % a]])
	66
	67	def put_word(self, si, data):
	68	# Decode word (MSb first).
	69	word = 0
	70	for b in range(len(data)):
941e7a64 UH	71	d = data[b].si if si else data[b].so
941e7a64 UH	72	word += (d << (len(data) - b - 1))
b13ced31	73	idx = 0 if si else 1
9b61fbd1 SP	74
	75	if self.options['format'] == 'ascii':
	76	word_str = ''
	77	for s in range(0, len(data), 8):
	78	c = 0xff & (word >> s)
	79	if c in range(32, 126 + 1):
	80	word_str = chr(c) + word_str
	81	else:
	82	word_str = '[{:02X}]'.format(c) + word_str
	83	self.put(data[0].ss, data[-1].es,
	84	self.out_ann, [idx, ['Data: %s' % word_str, '%s' % word_str]])
	85	else:
	86	self.put(data[0].ss, data[-1].es,
	87	self.out_ann, [idx, ['Data: 0x%x' % word, '0x%x' % word]])
3a9c517e KR	88
	89	def decode(self, ss, es, data):
	90	if len(data) < (2 + self.addresssize):
	91	self.put(ss, es, self.out_ann, [2, ['Not enough packet bits']])
	92	return
	93
941e7a64	94	opcode = (data[0].si << 1) + (data[1].si << 0)
3a9c517e KR	95
	96	if opcode == 2:
	97	# READ instruction.
5f914c47	98	self.put(data[0].ss, data[1].es,
3a9c517e KR	99	self.out_ann, [0, ['Read word', 'READ']])
	100	self.put_address(data[2:2 + self.addresssize])
	101
	102	# Get all words.
	103	word_start = 2 + self.addresssize
	104	while len(data) - word_start > 0:
	105	# Check if there are enough bits for a word.
	106	if len(data) - word_start < self.wordsize:
5f914c47	107	self.put(data[word_start].ss, data[len(data) - 1].es,
3a9c517e KR	108	self.out_ann, [2, ['Not enough word bits']])
	109	break
	110	self.put_word(False, data[word_start:word_start + self.wordsize])
	111	# Go to next word.
	112	word_start += self.wordsize
	113	elif opcode == 1:
	114	# WRITE instruction.
5f914c47	115	self.put(data[0].ss, data[1].es,
3a9c517e KR	116	self.out_ann, [0, ['Write word', 'WRITE']])
	117	self.put_address(data[2:2 + self.addresssize])
	118	# Get word.
	119	if len(data) < 2 + self.addresssize + self.wordsize:
941e7a64 UH	120	self.put(data[2 + self.addresssize].ss,
941e7a64 UH	121	data[len(data) - 1].ss,
3a9c517e KR	122	self.out_ann, [2, ['Not enough word bits']])
	123	else:
	124	self.put_word(True, data[2 + self.addresssize:2 + self.addresssize + self.wordsize])
	125	elif opcode == 3:
	126	# ERASE instruction.
5f914c47	127	self.put(data[0].ss, data[1].es,
3a9c517e KR	128	self.out_ann, [0, ['Erase word', 'ERASE']])
	129	self.put_address(data[2:2 + self.addresssize])
	130	elif opcode == 0:
941e7a64	131	if data[2].si == 1 and data[3].si == 1:
3a9c517e	132	# WEN instruction.
5f914c47	133	self.put(data[0].ss, data[2 + self.addresssize - 1].es,
3a9c517e	134	self.out_ann, [0, ['Write enable', 'WEN']])
941e7a64	135	elif data[2].si == 0 and data[3].si == 0:
3a9c517e	136	# WDS instruction.
5f914c47	137	self.put(data[0].ss, data[2 + self.addresssize - 1].es,
3a9c517e	138	self.out_ann, [0, ['Write disable', 'WDS']])
941e7a64	139	elif data[2].si == 1 and data[3].si == 0:
3a9c517e	140	# ERAL instruction.
5f914c47	141	self.put(data[0].ss, data[2 + self.addresssize - 1].es,
3a9c517e KR	142	self.out_ann, [0, ['Erase all memory',
3a9c517e KR	143	'Erase all', 'ERAL']])
941e7a64	144	elif data[2].si == 0 and data[3].si == 1:
3a9c517e	145	# WRAL instruction.
5f914c47	146	self.put(data[0].ss, data[2 + self.addresssize - 1].es,
3a9c517e KR	147	self.out_ann, [0, ['Write all memory',
	148	'Write all', 'WRAL']])
	149	# Get word.
	150	if len(data) < 2 + self.addresssize + self.wordsize:
941e7a64 UH	151	self.put(data[2 + self.addresssize].ss,
941e7a64 UH	152	data[len(data) - 1].ss,
3a9c517e KR	153	self.out_ann, [2, ['Not enough word bits']])
	154	else:
	155	self.put_word(True, data[2 + self.addresssize:2 + self.addresssize + self.wordsize])