2 * This file is part of the libsigrok project.
4 * Copyright (C) 2012 Alexandru Gagniuc <mr.nuke.me@gmail.com>
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 3 of the License, or
9 * (at your option) any later version.
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.
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/>.
23 #define MAX_PACKET_LEN 22
25 /* Flags passed from the DMM. */
27 gboolean is_low_batt, is_decibel, is_duty_cycle, is_hertz, is_amp;
28 gboolean is_beep, is_ohm, is_fahrenheit, is_celsius, is_capacitance;
29 gboolean is_diode, is_volt, is_dc, is_ac;
32 struct bm850_command {
42 struct brymen_header {
56 * We only have one command because we only support the BM-857. However, the
57 * driver is easily extensible to support more models, as the protocols are
61 BM_CMD_REQUEST_READING = 0x00,
64 static int bm_send_command(uint8_t command, uint8_t arg1, uint8_t arg2,
65 struct sr_serial_dev_inst *serial)
67 struct bm850_command cmdout;
75 cmdout.checksum = arg1 ^ arg2;
79 /* TODO: How to compute the checksum? Hardware seems to ignore it. */
81 /* Request reading. */
82 written = serial_write_blocking(serial, &cmdout, sizeof(cmdout), 0);
83 if (written != sizeof(cmdout))
89 SR_PRIV int brymen_packet_request(struct sr_serial_dev_inst *serial)
91 return bm_send_command(BM_CMD_REQUEST_READING, 0, 0, serial);
94 SR_PRIV int brymen_packet_length(const uint8_t *buf, int *len)
96 struct brymen_header *hdr;
103 /* Did we receive a complete header yet? */
104 if (buflen < sizeof(*hdr))
105 return PACKET_NEED_MORE_DATA;
107 if (hdr->dle != 0x10 || hdr->stx != 0x02)
108 return PACKET_INVALID_HEADER;
110 /* Our packet includes the header, the payload, and the tail. */
111 packet_len = sizeof(*hdr) + hdr->len + sizeof(struct brymen_tail);
113 /* In case we pick up an invalid header, limit our search. */
114 if (packet_len > MAX_PACKET_LEN) {
115 sr_spew("Header specifies an invalid payload length: %i.",
117 return PACKET_INVALID_HEADER;
121 sr_spew("Expecting a %d-byte packet.", *len);
122 return PACKET_HEADER_OK;
125 SR_PRIV gboolean brymen_packet_is_valid(const uint8_t *buf)
127 struct brymen_header *hdr;
128 struct brymen_tail *tail;
133 payload = (uint8_t *)(buf + sizeof(struct brymen_header));
136 tail = (void *)(payload + hdr->len);
138 for (i = 0; i< hdr->len; i++)
139 chksum ^= payload[i];
141 if (tail->checksum != chksum) {
142 sr_dbg("Packet has invalid checksum 0x%.2x. Expected 0x%.2x.",
143 chksum, tail->checksum);
150 static int parse_value(const char *strbuf, int len, float *floatval)
155 if (strstr(strbuf, "OL")) {
156 sr_dbg("Overlimit.");
157 *floatval = INFINITY;
161 memset(str, 0, sizeof(str));
162 /* Spaces may interfere with parsing the exponent. Strip them. */
163 for (s = 0, d = 0; s < len; s++) {
164 if (strbuf[s] != ' ')
165 str[d++] = strbuf[s];
167 if (sr_atof_ascii(str, floatval) != SR_OK)
173 static void parse_flags(const uint8_t *buf, struct brymen_flags *info)
175 info->is_low_batt = (buf[4 + 3] & (1 << 7)) != 0;
177 info->is_decibel = (buf[4 + 1] & (1 << 5)) != 0;
178 info->is_duty_cycle = (buf[4 + 1] & (1 << 3)) != 0;
179 info->is_hertz = (buf[4 + 1] & (1 << 2)) != 0;
180 info->is_amp = (buf[4 + 1] & (1 << 1)) != 0;
181 info->is_beep = (buf[4 + 1] & (1 << 0)) != 0;
183 info->is_ohm = (buf[4 + 0] & (1 << 7)) != 0;
184 info->is_fahrenheit = (buf[4 + 0] & (1 << 6)) != 0;
185 info->is_celsius = (buf[4 + 0] & (1 << 5)) != 0;
186 info->is_diode = (buf[4 + 0] & (1 << 4)) != 0;
187 info->is_capacitance = (buf[4 + 0] & (1 << 3)) != 0;
188 info->is_volt = (buf[4 + 0] & (1 << 2)) != 0;
189 info->is_dc = (buf[4 + 0] & (1 << 1)) != 0;
190 info->is_ac = (buf[4 + 0] & (1 << 0)) != 0;
193 SR_PRIV int brymen_parse(const uint8_t *buf, float *floatval,
194 struct sr_datafeed_analog *analog, void *info)
196 struct brymen_flags flags;
197 struct brymen_header *hdr;
204 bfunc = (uint8_t *)(buf + sizeof(struct brymen_header));
208 /* Give some debug info about the package. */
209 asciilen = hdr->len - 4;
210 sr_dbg("DMM flags: %.2x %.2x %.2x %.2x",
211 bfunc[3], bfunc[2], bfunc[1], bfunc[0]);
212 /* Value is an ASCII string. */
213 sr_dbg("DMM packet: \"%.*s\"", asciilen, bfunc + 4);
215 parse_flags(buf, &flags);
216 if (parse_value((const char *)(bfunc + 4), asciilen, floatval) != SR_OK)
220 analog->mq = SR_MQ_VOLTAGE;
221 analog->unit = SR_UNIT_VOLT;
224 analog->mq = SR_MQ_CURRENT;
225 analog->unit = SR_UNIT_AMPERE;
229 analog->mq = SR_MQ_CONTINUITY;
231 analog->mq = SR_MQ_RESISTANCE;
232 analog->unit = SR_UNIT_OHM;
234 if (flags.is_hertz) {
235 analog->mq = SR_MQ_FREQUENCY;
236 analog->unit = SR_UNIT_HERTZ;
238 if (flags.is_duty_cycle) {
239 analog->mq = SR_MQ_DUTY_CYCLE;
240 analog->unit = SR_UNIT_PERCENTAGE;
242 if (flags.is_capacitance) {
243 analog->mq = SR_MQ_CAPACITANCE;
244 analog->unit = SR_UNIT_FARAD;
246 if (flags.is_fahrenheit) {
247 analog->mq = SR_MQ_TEMPERATURE;
248 analog->unit = SR_UNIT_FAHRENHEIT;
250 if (flags.is_celsius) {
251 analog->mq = SR_MQ_TEMPERATURE;
252 analog->unit = SR_UNIT_CELSIUS;
254 if (flags.is_capacitance) {
255 analog->mq = SR_MQ_CAPACITANCE;
256 analog->unit = SR_UNIT_FARAD;
260 * The high-end Brymen models have a configurable reference impedance.
261 * When the reference impedance is changed, the DMM sends one packet
262 * with the value of the new reference impedance. Both decibel and ohm
263 * flags are set in this case, so we must be careful to correctly
264 * identify the value as ohm, not dBmW.
266 if (flags.is_decibel && !flags.is_ohm) {
267 analog->mq = SR_MQ_POWER;
268 analog->unit = SR_UNIT_DECIBEL_MW;
270 * For some reason, dBm measurements are sent by the multimeter
271 * with a value three orders of magnitude smaller than the
278 analog->mqflags |= SR_MQFLAG_DIODE;
279 /* We can have both AC+DC in a single measurement. */
281 analog->mqflags |= SR_MQFLAG_AC;
283 analog->mqflags |= SR_MQFLAG_DC;
285 if (flags.is_low_batt)
286 sr_info("Low battery!");