2 * This file is part of the libsigrok project.
4 * Copyright (C) 2015 Daniel Glöckner <daniel-gl@gmx.net>
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/>.
25 static const uint32_t scanopts[] = {
29 static const uint32_t drvopts[] = {
33 static const uint32_t devopts[] = {
34 SR_CONF_CONN | SR_CONF_GET,
35 SR_CONF_LIMIT_FRAMES | SR_CONF_GET | SR_CONF_SET,
36 SR_CONF_SAMPLERATE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
37 SR_CONF_TRIGGER_SOURCE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
38 SR_CONF_TRIGGER_SLOPE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
39 SR_CONF_BUFFERSIZE | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
42 static const uint32_t devopts_cg[] = {
43 SR_CONF_VDIV | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
44 SR_CONF_COUPLING | SR_CONF_GET | SR_CONF_SET | SR_CONF_LIST,
45 SR_CONF_PROBE_FACTOR | SR_CONF_GET | SR_CONF_SET,
48 static const uint64_t samplerates[] = {
49 SR_MHZ(100), SR_MHZ(50), SR_MHZ(25), SR_MHZ(20),
50 SR_MHZ(10), SR_MHZ(5), SR_KHZ(2500), SR_MHZ(2),
51 SR_MHZ(1), SR_KHZ(500), SR_KHZ(250), SR_KHZ(200),
52 SR_KHZ(100), SR_KHZ(50), SR_KHZ(25), SR_KHZ(20),
53 SR_KHZ(10), SR_KHZ(5), SR_HZ(2500), SR_KHZ(2),
54 SR_KHZ(1), SR_HZ(500), SR_HZ(250), SR_HZ(200),
55 SR_HZ(100), SR_HZ(50), SR_HZ(25), SR_HZ(20)
58 /* must be in sync with readout_steps[] in protocol.c */
59 static const uint64_t buffersizes[] = {
60 2 * 500, 3 * 500, 4 * 500, 5 * 500,
61 6 * 500, 7 * 500, 8 * 500, 9 * 500, 10 * 500,
62 12 * 500 - 2, 14 * 500 - 2, 16 * 500 - 2,
63 18 * 500 - 2, 20 * 500 - 2, 10240 - 2
66 static const uint64_t vdivs[][2] = {
78 /* Bits 4 and 5 enable relays that add /10 filters to the chain
79 * Bits 0 and 1 select an output from a resistor array */
80 static const uint8_t vdivs_map[] = {
81 0x01, 0x02, 0x03, 0x21, 0x22, 0x23, 0x31, 0x32, 0x33
85 static const char *trigger_sources[] = {
89 static const uint8_t trigger_sources_map[] = {
93 static const char *trigger_slopes[] = {
97 static const char *coupling[] = {
101 static const uint8_t coupling_map[] = {
105 static GSList *scan_port(GSList *devices, struct parport *port)
107 struct sr_dev_inst *sdi;
108 struct sr_channel *ch;
109 struct sr_channel_group *cg;
110 struct dev_context *devc;
113 if (ieee1284_open(port, 0, &i) != E1284_OK) {
114 sr_err("Can't open parallel port %s", port->name);
118 if ((i & (CAP1284_RAW | CAP1284_BYTE)) != (CAP1284_RAW | CAP1284_BYTE)) {
119 sr_err("Parallel port %s does not provide low-level bidirection access",
124 if (ieee1284_claim(port) != E1284_OK) {
125 sr_err("Parallel port %s already in use", port->name);
129 if (!hung_chang_dso_2100_check_id(port))
132 sdi = g_malloc0(sizeof(struct sr_dev_inst));
133 sdi->status = SR_ST_INACTIVE;
134 sdi->vendor = g_strdup("Hung-Chang");
135 sdi->model = g_strdup("DSO-2100");
136 sdi->inst_type = 0; /* FIXME */
140 for (i = 0; i < NUM_CHANNELS; i++) {
141 cg = sr_channel_group_new(sdi, trigger_sources[i], NULL);
142 ch = sr_channel_new(sdi, i, SR_CHANNEL_ANALOG, FALSE, trigger_sources[i]);
143 cg->channels = g_slist_append(cg->channels, ch);
146 devc = g_malloc0(sizeof(struct dev_context));
147 devc->enabled_channel = g_slist_append(NULL, NULL);
152 devc->cctl[0] = 0x31; /* 1V/div, DC coupling, trigger on channel A*/
153 devc->cctl[1] = 0x31; /* 1V/div, DC coupling, no tv sync trigger */
158 devc->offset[0] = 0x80;
159 devc->offset[1] = 0x80;
160 devc->gain[0] = 0x80;
161 devc->gain[1] = 0x80;
162 devc->frame_limit = 0;
163 devc->last_step = 0; /* buffersize = 1000 */
166 devices = g_slist_append(devices, sdi);
169 ieee1284_release(port);
171 ieee1284_close(port);
176 static GSList *scan(struct sr_dev_driver *di, GSList *options)
178 struct parport_list ports;
179 struct sr_config *src;
180 const char *conn = NULL;
181 GSList *devices, *option;
186 for (option = options; option; option = option->next) {
188 if (src->key == SR_CONF_CONN) {
189 conn = g_variant_get_string(src->data, NULL);
197 if (ieee1284_find_ports(&ports, 0) != E1284_OK)
202 for (i = 0; i < ports.portc; i++)
203 if (!strcmp(ports.portv[i]->name, conn)) {
205 devices = scan_port(devices, ports.portv[i]);
209 sr_err("Parallel port %s not found. Valid names are:", conn);
210 for (i = 0; i < ports.portc; i++)
211 sr_err("\t%s", ports.portv[i]->name);
214 ieee1284_free_ports(&ports);
216 return std_scan_complete(di, devices);
219 static void clear_helper(struct dev_context *devc)
221 g_slist_free(devc->enabled_channel);
224 static int dev_clear(const struct sr_dev_driver *di)
226 struct drv_context *drvc = di->context;
227 struct sr_dev_inst *sdi;
231 for (l = drvc->instances; l; l = l->next) {
233 ieee1284_unref(sdi->conn);
237 return std_dev_clear_with_callback(di, (std_dev_clear_callback)clear_helper);
240 static int dev_open(struct sr_dev_inst *sdi)
242 struct dev_context *devc = sdi->priv;
245 if (ieee1284_open(sdi->conn, 0, &i) != E1284_OK)
248 if (ieee1284_claim(sdi->conn) != E1284_OK)
251 if (ieee1284_data_dir(sdi->conn, 1) != E1284_OK)
254 if (hung_chang_dso_2100_move_to(sdi, 1))
257 devc->samples = g_try_malloc(1000 * sizeof(*devc->samples));
264 hung_chang_dso_2100_reset_port(sdi->conn);
265 ieee1284_release(sdi->conn);
267 ieee1284_close(sdi->conn);
272 static int dev_close(struct sr_dev_inst *sdi)
274 struct dev_context *devc = sdi->priv;
276 g_free(devc->samples);
277 hung_chang_dso_2100_reset_port(sdi->conn);
278 ieee1284_release(sdi->conn);
279 ieee1284_close(sdi->conn);
284 static int config_get(uint32_t key, GVariant **data,
285 const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
287 struct dev_context *devc = sdi->priv;
288 struct parport *port;
291 if (cg) /* sr_config_get will validate cg using config_list */
292 ch = ((struct sr_channel *)cg->channels->data)->index;
297 *data = g_variant_new_string(port->name);
299 case SR_CONF_LIMIT_FRAMES:
300 *data = g_variant_new_uint64(devc->frame_limit);
302 case SR_CONF_SAMPLERATE:
303 *data = g_variant_new_uint64(samplerates[devc->rate]);
305 case SR_CONF_TRIGGER_SOURCE:
306 if ((idx = std_u8_idx_s(devc->cctl[0] & 0xC0, ARRAY_AND_SIZE(trigger_sources_map))) < 0)
308 *data = g_variant_new_string(trigger_sources[idx]);
310 case SR_CONF_TRIGGER_SLOPE:
311 if (devc->edge >= ARRAY_SIZE(trigger_slopes))
313 *data = g_variant_new_string(trigger_slopes[devc->edge]);
315 case SR_CONF_BUFFERSIZE:
316 *data = g_variant_new_uint64(buffersizes[devc->last_step]);
320 return SR_ERR_CHANNEL_GROUP;
321 if ((idx = std_u8_idx_s(devc->cctl[ch] & 0x33, ARRAY_AND_SIZE(vdivs_map))) < 0)
323 *data = g_variant_new("(tt)", vdivs[idx][0], vdivs[idx][1]);
325 case SR_CONF_COUPLING:
327 return SR_ERR_CHANNEL_GROUP;
328 if ((idx = std_u8_idx_s(devc->cctl[ch] & 0x0C, ARRAY_AND_SIZE(coupling_map))) < 0)
330 *data = g_variant_new_string(coupling[idx]);
332 case SR_CONF_PROBE_FACTOR:
334 return SR_ERR_CHANNEL_GROUP;
335 *data = g_variant_new_uint64(devc->probe[ch]);
344 static int config_set(uint32_t key, GVariant *data,
345 const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
347 struct dev_context *devc = sdi->priv;
351 if (cg) /* sr_config_set will validate cg using config_list */
352 ch = ((struct sr_channel *)cg->channels->data)->index;
355 case SR_CONF_LIMIT_FRAMES:
356 devc->frame_limit = g_variant_get_uint64(data);
358 case SR_CONF_SAMPLERATE:
359 if ((idx = std_u64_idx(data, ARRAY_AND_SIZE(samplerates))) < 0)
363 case SR_CONF_TRIGGER_SOURCE:
364 if ((idx = std_str_idx(data, ARRAY_AND_SIZE(trigger_sources))) < 0)
366 devc->cctl[0] = (devc->cctl[0] & 0x3F) | trigger_sources_map[idx];
368 case SR_CONF_TRIGGER_SLOPE:
369 if ((idx = std_str_idx(data, ARRAY_AND_SIZE(trigger_slopes))) < 0)
373 case SR_CONF_BUFFERSIZE:
374 if ((idx = std_u64_idx(data, ARRAY_AND_SIZE(buffersizes))) < 0)
376 devc->last_step = idx;
380 return SR_ERR_CHANNEL_GROUP;
381 if (!g_variant_is_of_type(data, G_VARIANT_TYPE("(tt)")))
383 if ((idx = std_u64_tuple_idx(data, ARRAY_AND_SIZE(vdivs))) < 0)
385 devc->cctl[ch] = (devc->cctl[ch] & 0xCC) | vdivs_map[idx];
387 case SR_CONF_COUPLING:
389 return SR_ERR_CHANNEL_GROUP;
390 if ((idx = std_str_idx(data, ARRAY_AND_SIZE(coupling))) < 0)
392 devc->cctl[ch] = (devc->cctl[ch] & 0xF3) | coupling_map[idx];
394 case SR_CONF_PROBE_FACTOR:
396 return SR_ERR_CHANNEL_GROUP;
397 u = g_variant_get_uint64(data);
409 static int config_channel_set(const struct sr_dev_inst *sdi,
410 struct sr_channel *ch, unsigned int changes)
412 struct dev_context *devc = sdi->priv;
415 if (!(changes & SR_CHANNEL_SET_ENABLED))
419 v = devc->channel | (1 << ch->index);
423 devc->enabled_channel->data = ch;
425 devc->channel &= ~(1 << ch->index);
431 static int config_commit(const struct sr_dev_inst *sdi)
433 uint8_t state = hung_chang_dso_2100_read_mbox(sdi->conn, 0.02);
440 /* we will travel the complete config path on our way to state 1 */
446 ret = hung_chang_dso_2100_move_to(sdi, 1);
451 hung_chang_dso_2100_write_mbox(sdi->conn, 4);
453 ret = hung_chang_dso_2100_move_to(sdi, 1);
456 return hung_chang_dso_2100_move_to(sdi, state);
459 static int config_list(uint32_t key, GVariant **data,
460 const struct sr_dev_inst *sdi, const struct sr_channel_group *cg)
465 case SR_CONF_SCAN_OPTIONS:
466 case SR_CONF_DEVICE_OPTIONS:
468 case SR_CONF_SAMPLERATE:
469 case SR_CONF_TRIGGER_SOURCE:
470 case SR_CONF_TRIGGER_SLOPE:
471 case SR_CONF_BUFFERSIZE:
476 case SR_CONF_COUPLING:
480 return SR_ERR_CHANNEL_GROUP;
481 l = g_slist_find(sdi->channel_groups, cg);
490 case SR_CONF_SCAN_OPTIONS:
491 return STD_CONFIG_LIST(key, data, sdi, cg, scanopts, NO_OPTS, NO_OPTS);
492 case SR_CONF_DEVICE_OPTIONS:
494 return STD_CONFIG_LIST(key, data, sdi, cg, NO_OPTS, drvopts, devopts);
495 *data = std_gvar_array_u32(ARRAY_AND_SIZE(devopts_cg));
497 case SR_CONF_SAMPLERATE:
498 *data = std_gvar_samplerates(ARRAY_AND_SIZE(samplerates));
500 case SR_CONF_TRIGGER_SOURCE:
501 *data = g_variant_new_strv(ARRAY_AND_SIZE(trigger_sources));
503 case SR_CONF_TRIGGER_SLOPE:
504 *data = g_variant_new_strv(ARRAY_AND_SIZE(trigger_slopes));
506 case SR_CONF_BUFFERSIZE:
507 *data = std_gvar_array_u64(ARRAY_AND_SIZE(buffersizes));
510 *data = std_gvar_tuple_array(ARRAY_AND_SIZE(vdivs));
512 case SR_CONF_COUPLING:
513 *data = g_variant_new_strv(ARRAY_AND_SIZE(coupling));
520 static int dev_acquisition_start(const struct sr_dev_inst *sdi)
522 struct dev_context *devc = sdi->priv;
526 static const float res_array[] = {0.5, 1, 2, 5};
527 static const uint8_t relays[] = {100, 10, 10, 1};
528 devc->factor = devc->probe[devc->channel - 1] / 32.0;
529 devc->factor *= res_array[devc->cctl[devc->channel - 1] & 0x03];
530 devc->factor /= relays[(devc->cctl[devc->channel - 1] >> 4) & 0x03];
533 devc->state_known = TRUE;
536 devc->retries = MAX_RETRIES;
538 ret = hung_chang_dso_2100_move_to(sdi, 0x21);
542 std_session_send_df_header(sdi);
544 sr_session_source_add(sdi->session, -1, 0, 8,
545 hung_chang_dso_2100_poll, (void *)sdi);
550 static int dev_acquisition_stop(struct sr_dev_inst *sdi)
552 std_session_send_df_end(sdi);
553 sr_session_source_remove(sdi->session, -1);
554 hung_chang_dso_2100_move_to(sdi, 1);
559 static struct sr_dev_driver hung_chang_dso_2100_driver_info = {
560 .name = "hung-chang-dso-2100",
561 .longname = "Hung-Chang DSO-2100",
564 .cleanup = std_cleanup,
566 .dev_list = std_dev_list,
567 .dev_clear = dev_clear,
568 .config_get = config_get,
569 .config_set = config_set,
570 .config_channel_set = config_channel_set,
571 .config_commit = config_commit,
572 .config_list = config_list,
573 .dev_open = dev_open,
574 .dev_close = dev_close,
575 .dev_acquisition_start = dev_acquisition_start,
576 .dev_acquisition_stop = dev_acquisition_stop,
579 SR_REGISTER_DEV_DRIVER(hung_chang_dso_2100_driver_info);