summaryrefslogtreecommitdiff
path: root/decoders/adf435x
diff options
context:
space:
mode:
authorJoel Holdsworth <joel@airwebreathe.org.uk>2017-02-12 21:44:19 -0700
committerUwe Hermann <uwe@hermann-uwe.de>2017-02-14 22:54:56 +0100
commit1d4fe1c19c0948fb67b4a91495b126a763ea7adb (patch)
treecba18dc0e68f6a4369511efe1f22ca81f391b318 /decoders/adf435x
parent2bde58c5654e7f0103a301548ac60ba294d5b649 (diff)
downloadlibsigrokdecode-1d4fe1c19c0948fb67b4a91495b126a763ea7adb.tar.gz
libsigrokdecode-1d4fe1c19c0948fb67b4a91495b126a763ea7adb.zip
Added intial ADF4350/1 decoder
Diffstat (limited to 'decoders/adf435x')
-rw-r--r--decoders/adf435x/__init__.py29
-rw-r--r--decoders/adf435x/pd.py140
2 files changed, 169 insertions, 0 deletions
diff --git a/decoders/adf435x/__init__.py b/decoders/adf435x/__init__.py
new file mode 100644
index 0000000..1c89e2d
--- /dev/null
+++ b/decoders/adf435x/__init__.py
@@ -0,0 +1,29 @@
+##
+## This file is part of the libsigrokdecode project.
+##
+## Copyright (C) 2017 Joel Holdsworth <joel@airwebreathe.org.uk>
+##
+## 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/>.
+##
+
+'''
+This decoder stacks on top of the 'spi' PD and decodes the protocol spoken
+by the Analog Devices ADF4350 and ADF4351 RF synthesizer chips.
+
+Details:
+http://www.analog.com/media/en/technical-documentation/data-sheets/ADF4350.pdf
+http://www.analog.com/media/en/technical-documentation/data-sheets/ADF4351.pdf
+'''
+
+from .pd import Decoder
diff --git a/decoders/adf435x/pd.py b/decoders/adf435x/pd.py
new file mode 100644
index 0000000..8f51ee2
--- /dev/null
+++ b/decoders/adf435x/pd.py
@@ -0,0 +1,140 @@
+##
+## This file is part of the libsigrokdecode project.
+##
+## Copyright (C) 2017 Joel Holdsworth <joel@airwebreathe.org.uk>
+##
+## 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 3 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
+
+def disabled_enabled(v):
+ return ['Disabled', 'Enabled'][v]
+
+def output_power(v):
+ return '%+ddBm' % [-4, -1, 2, 5][v]
+
+regs = {
+# reg: name offset width parser
+ 0: [
+ ('FRAC', 3, 12, None),
+ ('INT', 15, 16, lambda v: 'Not Allowed' if v < 32 else v)
+ ],
+ 1: [
+ ('MOD', 3, 12, None),
+ ('Phase', 15, 12, None),
+ ('Prescalar', 27, 1, lambda v: ['4/5', '8/9'][v]),
+ ('Phase Adjust', 28, 1, lambda v: ['Off', 'On'][v]),
+ ],
+ 2: [
+ ('Counter Reset', 3, 1, disabled_enabled),
+ ('Charge Pump Three-State', 4, 1, disabled_enabled),
+ ('Power-Down', 5, 1, disabled_enabled),
+ ('PD Polarity', 6, 1, lambda v: ['Negative', 'Positive'][v]),
+ ('LDP', 7, 1, lambda v: ['10ns', '6ns'][v]),
+ ('LDF', 8, 1, lambda v: ['FRAC-N', 'INT-N'][v]),
+ ('Charge Pump Current Setting', 9, 4, lambda v: '%0.2fmA @ 5.1kΩ' %
+ [0.31, 0.63, 0.94, 1.25, 1.56, 1.88, 2.19, 2.50,
+ 2.81, 3.13, 3.44, 3.75, 4.06, 4.38, 4.69, 5.00][v]),
+ ('Double Buffer', 13, 1, disabled_enabled),
+ ('R Counter', 14, 10, None),
+ ('RDIV2', 24, 1, disabled_enabled),
+ ('Reference Doubler', 25, 1, disabled_enabled),
+ ('MUXOUT', 26, 3, lambda v:
+ ['Three-State Output', 'DVdd', 'DGND', 'R Counter Output', 'N Divider Output',
+ 'Analog Lock Detect', 'Digital Lock Detect', 'Reserved'][v]),
+ ('Low Noise and Low Spur Modes', 29, 2, lambda v:
+ ['Low Noise Mode', 'Reserved', 'Reserved', 'Low Spur Mode'][v])
+ ],
+ 3: [
+ ('Clock Divider', 3, 12, None),
+ ('Clock Divider Mode', 15, 2, lambda v:
+ ['Clock Divider Off', 'Fast Lock Enable', 'Resync Enable', 'Reserved'][v]),
+ ('CSR Enable', 18, 1, disabled_enabled),
+ ('Charge Cancellation', 21, 1, disabled_enabled),
+ ('ABP', 22, 1, lambda v: ['6ns (FRAC-N)', '3ns (INT-N)'][v]),
+ ('Band Select Clock Mode', 23, 1, lambda v: ['Low', 'High'][v])
+ ],
+ 4: [
+ ('Output Power', 3, 2, output_power),
+ ('Output Enable', 5, 1, disabled_enabled),
+ ('AUX Output Power', 6, 2, output_power),
+ ('AUX Output Select', 8, 1, lambda v: ['Divided Output', 'Fundamental'][v]),
+ ('AUX Output Enable', 9, 1, disabled_enabled),
+ ('MTLD', 10, 1, disabled_enabled),
+ ('VCO Power-Down', 11, 1, lambda v:
+ 'VCO Powered ' + ('Down' if v == 1 else 'Up')),
+ ('Band Select Clock Divider', 12, 8, None),
+ ('RF Divider Select', 20, 3, lambda v: '÷' + str(2**v)),
+ ('Feedback Select', 23, 1, lambda v: ['Divided', 'Fundamental'][v]),
+ ],
+ 5: [
+ ('LD Pin Mode', 22, 2, lambda v:
+ ['Low', 'Digital Lock Detect', 'Low', 'High'][v])
+ ]
+}
+
+ANN_REG = 0
+
+class Decoder(srd.Decoder):
+ api_version = 2
+ id = 'adf435x'
+ name = 'ADF435x'
+ longname = 'Analog Devices ADF4350/1'
+ desc = 'Wideband synthesizer with integrated VCO.'
+ license = 'gplv3+'
+ inputs = ['spi']
+ outputs = ['adf435x']
+ annotations = (
+ # Sent from the host to the chip.
+ ('register', 'Register written to the device'),
+ )
+ annotation_rows = (
+ ('registers', 'Register writes', (ANN_REG,)),
+ )
+
+ def __init__(self):
+ self.bits = []
+
+ def start(self):
+ self.out_ann = self.register(srd.OUTPUT_ANN)
+
+ def decode_bits(self, offset, width):
+ return (sum([(1 << i) if self.bits[offset + i][0] else 0 for i in range(width)]),
+ (self.bits[offset + width - 1][1], self.bits[offset][2]))
+
+ def decode_field(self, name, offset, width, parser):
+ val, pos = self.decode_bits(offset, width)
+ self.put(pos[0], pos[1], self.out_ann, [ANN_REG,
+ ['%s: %s' % (name, parser(val) if parser else str(val))]])
+ return val
+
+ def decode(self, ss, es, data):
+
+ ptype, data1, data2 = data
+
+ if ptype == 'CS-CHANGE':
+ if data1 == 1:
+ if len(self.bits) == 32:
+ reg_value, reg_pos = self.decode_bits(0, 3)
+ self.put(reg_pos[0], reg_pos[1], self.out_ann, [ANN_REG,
+ ['Register: %d' % reg_value, 'Reg: %d' % reg_value,
+ '[%d]' % reg_value]])
+ if reg_value < len(regs):
+ field_descs = regs[reg_value]
+ for field_desc in field_descs:
+ field = self.decode_field(*field_desc)
+ self.bits = []
+ if ptype == 'BITS':
+ self.bits = data1 + self.bits