]>
Commit | Line | Data |
---|---|---|
5cc2d7bb | 1 | ## |
50bd5d25 | 2 | ## This file is part of the libsigrokdecode project. |
5cc2d7bb | 3 | ## |
5b2b0b0d | 4 | ## Copyright (C) 2012-2013 Uwe Hermann <uwe@hermann-uwe.de> |
5cc2d7bb UH |
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, write to the Free Software | |
18 | ## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA | |
19 | ## | |
20 | ||
5dd1c937 | 21 | # Panasonic PAN1321 Bluetooth module protocol decoder |
5cc2d7bb | 22 | |
677d597b | 23 | import sigrokdecode as srd |
5cc2d7bb | 24 | |
d9c0d0a3 UH |
25 | # ... |
26 | RX = 0 | |
27 | TX = 1 | |
28 | ||
677d597b | 29 | class Decoder(srd.Decoder): |
a2c2afd9 | 30 | api_version = 1 |
5cc2d7bb | 31 | id = 'pan1321' |
3d3da57d UH |
32 | name = 'PAN1321' |
33 | longname = 'Panasonic PAN1321' | |
a465436e | 34 | desc = 'Bluetooth RF module with Serial Port Profile (SPP).' |
5cc2d7bb UH |
35 | license = 'gplv2+' |
36 | inputs = ['uart'] | |
37 | outputs = ['pan1321'] | |
9a12a6e7 | 38 | probes = [] |
b77614bc | 39 | optional_probes = [] |
9a12a6e7 | 40 | options = {} |
e97b6ef5 | 41 | annotations = [ |
e1f5df5b | 42 | ['Text (verbose)', 'Human-readable text (verbose)'], |
ee3e279c | 43 | ['Text', 'Human-readable text'], |
6bbd2a8a | 44 | ['Warnings', 'Human-readable warnings'], |
5cc2d7bb UH |
45 | ] |
46 | ||
47 | def __init__(self, **kwargs): | |
5dd1c937 | 48 | self.cmd = ['', ''] |
f9b0356b | 49 | self.ss_block = None |
5cc2d7bb | 50 | |
8915b346 | 51 | def start(self): |
be465111 BV |
52 | # self.out_proto = self.register(srd.OUTPUT_PYTHON) |
53 | self.out_ann = self.register(srd.OUTPUT_ANN) | |
5cc2d7bb | 54 | |
f9b0356b UH |
55 | def putx(self, data): |
56 | self.put(self.ss_block, self.es_block, self.out_ann, data) | |
57 | ||
58 | def handle_host_command(self, rxtx, s): | |
2d3f496e | 59 | if s.startswith('AT+JAAC'): |
84f33bc7 | 60 | # AT+JAAC=<auto_accept> (0 or 1) |
2d3f496e UH |
61 | p = s[s.find('=') + 1:] |
62 | if p not in ('0', '1'): | |
63 | self.putx([2, ['Warning: Invalid JAAC parameter "%s"' % p]]) | |
64 | return | |
65 | x = 'Auto' if (p == '1') else 'Don\'t auto' | |
66 | self.putx([0, ['%s-accept new connections' % x]]) | |
67 | self.putx([1, ['%s-accept connections' % x]]) | |
68 | elif s.startswith('AT+JPRO'): | |
84f33bc7 | 69 | # AT+JPRO=<mode> (0 or 1) |
5b2b0b0d | 70 | p = s[s.find('=') + 1:] |
6bbd2a8a UH |
71 | if p not in ('0', '1'): |
72 | self.putx([2, ['Warning: Invalid JPRO parameter "%s"' % p]]) | |
6bbd2a8a | 73 | return |
5b2b0b0d UH |
74 | onoff = 'off' if (p == '0') else 'on' |
75 | x = 'Leaving' if (p == '0') else 'Entering' | |
76 | self.putx([0, ['%s production mode' % x]]) | |
77 | self.putx([1, ['Production mode = %s' % onoff]]) | |
78 | elif s.startswith('AT+JRES'): | |
84f33bc7 | 79 | # AT+JRES |
6bbd2a8a UH |
80 | if s != 'AT+JRES': # JRES has no params. |
81 | self.putx([2, ['Warning: Invalid JRES usage.']]) | |
6bbd2a8a | 82 | return |
5b2b0b0d UH |
83 | self.putx([0, ['Triggering a software reset']]) |
84 | self.putx([1, ['Reset']]) | |
b1f2d25f | 85 | elif s.startswith('AT+JSDA'): |
84f33bc7 UH |
86 | # AT+JSDA=<l>,<d> (l: length in bytes, d: data) |
87 | # l is (max?) 3 decimal digits and ranges from 1 to MTU size. | |
88 | # Data can be ASCII or binary values (l bytes total). | |
b1f2d25f UH |
89 | l, d = s[s.find('=') + 1:].split(',') |
90 | if not l.isnumeric(): | |
91 | self.putx([2, ['Warning: Invalid data length "%s".' % l]]) | |
92 | if int(l) != len(d): | |
93 | self.putx([2, ['Warning: Data length mismatch (%d != %d).' % \ | |
94 | (int(l), len(d))]]) | |
84f33bc7 UH |
95 | # TODO: Warn if length > MTU size (which is firmware-dependent |
96 | # and is negotiated by both Bluetooth devices upon connection). | |
b1f2d25f UH |
97 | b = ''.join(['%02x ' % ord(c) for c in d])[:-1] |
98 | self.putx([0, ['Sending %d data bytes: %s' % (int(l), b)]]) | |
99 | self.putx([1, ['Send %d = %s' % (int(l), b)]]) | |
5b2b0b0d | 100 | elif s.startswith('AT+JSEC'): |
84f33bc7 UH |
101 | # AT+JSEC=<secmode>,<linkkey_info>,<pintype>,<pinlen>,<pin> |
102 | # secmode: Security mode 1 or 3 (default). | |
103 | # linkkey_info: Must be 1 or 2. Has no function according to docs. | |
104 | # pintype: 1: variable pin (default), 2: fixed pin. | |
105 | # pinlen: PIN length (2 decimal digits). Max. PIN length is 16. | |
106 | # pin: The Bluetooth PIN ('pinlen' chars). Used if pintype=2. | |
107 | # Note: AT+JSEC (if used) must be the first command after reset. | |
108 | # TODO: Parse all the other parameters. | |
fd4aa8aa | 109 | pin = s[-4:] |
5b2b0b0d | 110 | self.putx([0, ['Host set the Bluetooth PIN to "' + pin + '"']]) |
e1f5df5b | 111 | self.putx([1, ['PIN = ' + pin]]) |
5dd1c937 | 112 | elif s.startswith('AT+JSLN'): |
84f33bc7 UH |
113 | # AT+JSLN=<namelen>,<name> |
114 | # namelen: Friendly name length (2 decimal digits). Max. len is 18. | |
115 | # name: The Bluetooth "friendly name" ('namelen' ASCII characters). | |
fd4aa8aa | 116 | name = s[s.find(',') + 1:] |
5b2b0b0d | 117 | self.putx([0, ['Host set the Bluetooth name to "' + name + '"']]) |
e1f5df5b | 118 | self.putx([1, ['BT name = ' + name]]) |
5dd1c937 | 119 | else: |
f9b0356b | 120 | self.putx([0, ['Host sent unsupported command: %s' % s]]) |
e1f5df5b | 121 | self.putx([1, ['Unsupported command: %s' % s]]) |
5dd1c937 | 122 | |
f9b0356b | 123 | def handle_device_reply(self, rxtx, s): |
fd4aa8aa | 124 | if s == 'ROK': |
f9b0356b | 125 | self.putx([0, ['Device initialized correctly']]) |
e1f5df5b | 126 | self.putx([1, ['Init']]) |
fd4aa8aa | 127 | elif s == 'OK': |
f9b0356b | 128 | self.putx([0, ['Device acknowledged last command']]) |
e1f5df5b | 129 | self.putx([1, ['ACK']]) |
5dd1c937 UH |
130 | elif s.startswith('ERR'): |
131 | error = s[s.find('=') + 1:] | |
f9b0356b | 132 | self.putx([0, ['Device sent error code ' + error]]) |
e1f5df5b | 133 | self.putx([1, ['ERR = ' + error]]) |
5dd1c937 | 134 | else: |
f9b0356b | 135 | self.putx([0, ['Device sent an unknown reply: %s' % s]]) |
e1f5df5b | 136 | self.putx([1, ['Unknown reply: %s' % s]]) |
5dd1c937 | 137 | |
5cc2d7bb | 138 | def decode(self, ss, es, data): |
d9c0d0a3 | 139 | ptype, rxtx, pdata = data |
5cc2d7bb UH |
140 | |
141 | # For now, ignore all UART packets except the actual data packets. | |
b9e44d1e | 142 | if ptype != 'DATA': |
5cc2d7bb UH |
143 | return |
144 | ||
f9b0356b UH |
145 | # If this is the start of a command/reply, remember the start sample. |
146 | if self.cmd[rxtx] == '': | |
147 | self.ss_block = ss | |
148 | ||
5dd1c937 UH |
149 | # Append a new (ASCII) byte to the currently built/parsed command. |
150 | self.cmd[rxtx] += chr(pdata) | |
5cc2d7bb UH |
151 | |
152 | # Get packets/bytes until an \r\n sequence is found (end of command). | |
72a6cad4 | 153 | if self.cmd[rxtx][-2:] != '\r\n': |
5cc2d7bb UH |
154 | return |
155 | ||
5dd1c937 | 156 | # Handle host commands and device replies. |
fd4aa8aa | 157 | # We remove trailing \r\n from the strings before handling them. |
db9ebbc2 | 158 | self.es_block = es |
5dd1c937 | 159 | if rxtx == RX: |
f9b0356b | 160 | self.handle_device_reply(rxtx, self.cmd[rxtx][:-2]) |
5dd1c937 | 161 | elif rxtx == TX: |
f9b0356b | 162 | self.handle_host_command(rxtx, self.cmd[rxtx][:-2]) |
5cc2d7bb | 163 | else: |
decde15e | 164 | raise Exception('Invalid rxtx value: %d' % rxtx) |
5cc2d7bb | 165 | |
db9ebbc2 UH |
166 | self.cmd[rxtx] = '' |
167 |