2 * This file is part of the sigrok project.
4 * Copyright (C) 2010 Bert Vermeulen <bert@biot.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 #include <sys/types.h>
38 #include <arpa/inet.h>
42 #include <sigrok-internal.h>
46 #define O_NONBLOCK FIONBIO
49 static int capabilities[] = {
50 SR_HWCAP_LOGIC_ANALYZER,
52 SR_HWCAP_CAPTURE_RATIO,
53 SR_HWCAP_LIMIT_SAMPLES,
57 /* default supported samplerates, can be overridden by device metadata */
58 static struct sr_samplerates samplerates = {
65 /* List of struct sr_serial_device_instance */
66 static GSList *device_instances = NULL;
68 static int send_shortcommand(int fd, uint8_t command)
72 sr_dbg("ols: sending cmd 0x%.2x", command);
74 if (serial_write(fd, buf, 1) != 1)
80 static int send_longcommand(int fd, uint8_t command, uint32_t data)
84 sr_dbg("ols: sending cmd 0x%.2x data 0x%.8x", command, data);
86 buf[1] = (data & 0xff000000) >> 24;
87 buf[2] = (data & 0xff0000) >> 16;
88 buf[3] = (data & 0xff00) >> 8;
90 if (serial_write(fd, buf, 5) != 5)
96 static int configure_probes(struct ols_device *ols, GSList *probes)
98 struct sr_probe *probe;
100 int probe_bit, stage, i;
104 for (i = 0; i < NUM_TRIGGER_STAGES; i++) {
105 ols->trigger_mask[i] = 0;
106 ols->trigger_value[i] = 0;
110 for (l = probes; l; l = l->next) {
111 probe = (struct sr_probe *)l->data;
116 * Set up the probe mask for later configuration into the
119 probe_bit = 1 << (probe->index - 1);
120 ols->probe_mask |= probe_bit;
125 /* Configure trigger mask and value. */
127 for (tc = probe->trigger; tc && *tc; tc++) {
128 ols->trigger_mask[stage] |= probe_bit;
130 ols->trigger_value[stage] |= probe_bit;
134 * TODO: Only supporting parallel mode, with
139 if (stage > ols->num_stages)
140 ols->num_stages = stage;
146 static uint32_t reverse16(uint32_t in)
150 out = (in & 0xff) << 8;
151 out |= (in & 0xff00) >> 8;
152 out |= (in & 0xff0000) << 8;
153 out |= (in & 0xff000000) >> 8;
158 static uint32_t reverse32(uint32_t in)
162 out = (in & 0xff) << 24;
163 out |= (in & 0xff00) << 8;
164 out |= (in & 0xff0000) >> 8;
165 out |= (in & 0xff000000) >> 24;
170 static struct ols_device *ols_device_new(void)
172 struct ols_device *ols;
174 /* TODO: Is 'ols' ever g_free()'d? */
175 if (!(ols = g_try_malloc0(sizeof(struct ols_device)))) {
176 sr_err("ols: %s: ols malloc failed", __func__);
180 ols->trigger_at = -1;
181 ols->probe_mask = 0xffffffff;
182 ols->cur_samplerate = SR_KHZ(200);
187 static struct sr_device_instance *get_metadata(int fd)
189 struct sr_device_instance *sdi;
190 struct ols_device *ols;
192 uint8_t key, type, token;
193 GString *tmp_str, *devicename, *version;
196 sdi = sr_device_instance_new(0, SR_ST_INACTIVE, NULL, NULL, NULL);
197 ols = ols_device_new();
200 devicename = g_string_new("");
201 version = g_string_new("");
205 if (serial_read(fd, &key, 1) != 1 || key == 0x00)
211 /* NULL-terminated string */
212 tmp_str = g_string_new("");
213 while (serial_read(fd, &tmp_c, 1) == 1 && tmp_c != '\0')
214 g_string_append_c(tmp_str, tmp_c);
215 sr_dbg("ols: got metadata key 0x%.2x value '%s'",
220 devicename = g_string_append(devicename, tmp_str->str);
223 /* FPGA firmware version */
225 g_string_append(version, ", ");
226 g_string_append(version, "FPGA version ");
227 g_string_append(version, tmp_str->str);
230 /* Ancillary version */
232 g_string_append(version, ", ");
233 g_string_append(version, "Ancillary version ");
234 g_string_append(version, tmp_str->str);
237 sr_info("ols: unknown token 0x%.2x: '%s'",
238 token, tmp_str->str);
241 g_string_free(tmp_str, TRUE);
244 /* 32-bit unsigned integer */
245 if (serial_read(fd, &tmp_int, 4) != 4)
247 tmp_int = reverse32(tmp_int);
248 sr_dbg("ols: got metadata key 0x%.2x value 0x%.8x",
252 /* Number of usable probes */
253 ols->num_probes = tmp_int;
256 /* Amount of sample memory available (bytes) */
257 ols->max_samples = tmp_int;
260 /* Amount of dynamic memory available (bytes) */
261 /* what is this for? */
264 /* Maximum sample rate (hz) */
265 ols->max_samplerate = tmp_int;
268 /* protocol version */
269 ols->protocol_version = tmp_int;
272 sr_info("ols: unknown token 0x%.2x: 0x%.8x",
278 /* 8-bit unsigned integer */
279 if (serial_read(fd, &tmp_c, 1) != 1)
281 sr_dbg("ols: got metadata key 0x%.2x value 0x%.2x",
285 /* Number of usable probes */
286 ols->num_probes = tmp_c;
289 /* protocol version */
290 ols->protocol_version = tmp_c;
293 sr_info("ols: unknown token 0x%.2x: 0x%.2x",
304 sdi->model = devicename->str;
305 sdi->version = version->str;
306 g_string_free(devicename, FALSE);
307 g_string_free(version, FALSE);
312 static int hw_init(const char *deviceinfo)
314 struct sr_device_instance *sdi;
315 struct ols_device *ols;
317 GPollFD *fds, probefd;
318 int devcnt, final_devcnt, num_ports, fd, ret, i;
319 char buf[8], **device_names, **serial_params;
324 ports = g_slist_append(NULL, strdup(deviceinfo));
326 /* No specific device given, so scan all serial ports. */
327 ports = list_serial_ports();
329 num_ports = g_slist_length(ports);
331 if (!(fds = g_try_malloc0(num_ports * sizeof(GPollFD)))) {
332 sr_err("ols: %s: fds malloc failed", __func__);
333 goto hw_init_free_ports; /* TODO: SR_ERR_MALLOC. */
336 if (!(device_names = g_try_malloc(num_ports * sizeof(char *)))) {
337 sr_err("ols: %s: device_names malloc failed", __func__);
338 goto hw_init_free_fds; /* TODO: SR_ERR_MALLOC. */
341 if (!(serial_params = g_try_malloc(num_ports * sizeof(char *)))) {
342 sr_err("ols: %s: serial_params malloc failed", __func__);
343 goto hw_init_free_device_names; /* TODO: SR_ERR_MALLOC. */
347 for (l = ports; l; l = l->next) {
348 /* The discovery procedure is like this: first send the Reset
349 * command (0x00) 5 times, since the device could be anywhere
350 * in a 5-byte command. Then send the ID command (0x02).
351 * If the device responds with 4 bytes ("OLS1" or "SLA1"), we
354 * Since it may take the device a while to respond at 115Kb/s,
355 * we do all the sending first, then wait for all of them to
356 * respond with g_poll().
358 sr_info("ols: probing %s...", (char *)l->data);
359 fd = serial_open(l->data, O_RDWR | O_NONBLOCK);
361 serial_params[devcnt] = serial_backup_params(fd);
362 serial_set_params(fd, 115200, 8, 0, 1, 2);
364 for (i = 0; i < 5; i++) {
365 if ((ret = send_shortcommand(fd,
366 CMD_RESET)) != SR_OK) {
367 /* Serial port is not writable. */
372 serial_restore_params(fd,
373 serial_params[devcnt]);
377 send_shortcommand(fd, CMD_ID);
379 fds[devcnt].events = G_IO_IN;
380 device_names[devcnt] = strdup(l->data);
386 /* 2ms isn't enough for reliable transfer with pl2303, let's try 10 */
389 g_poll(fds, devcnt, 1);
391 for (i = 0; i < devcnt; i++) {
392 if (fds[i].revents != G_IO_IN)
394 if (serial_read(fds[i].fd, buf, 4) != 4)
396 if (strncmp(buf, "1SLO", 4) && strncmp(buf, "1ALS", 4))
399 /* definitely using the OLS protocol, check if it supports
400 * the metadata command
402 send_shortcommand(fds[i].fd, CMD_METADATA);
403 probefd.fd = fds[i].fd;
404 probefd.events = G_IO_IN;
405 if (g_poll(&probefd, 1, 10) > 0) {
407 sdi = get_metadata(fds[i].fd);
408 sdi->index = final_devcnt;
410 /* not an OLS -- some other board that uses the sump protocol */
411 sdi = sr_device_instance_new(final_devcnt, SR_ST_INACTIVE,
412 "Sump", "Logic Analyzer", "v1.0");
413 ols = ols_device_new();
414 ols->num_probes = 32;
417 sdi->serial = sr_serial_device_instance_new(device_names[i], -1);
418 device_instances = g_slist_append(device_instances, sdi);
420 serial_close(fds[i].fd);
424 /* clean up after all the probing */
425 for (i = 0; i < devcnt; i++) {
426 if (fds[i].fd != 0) {
427 serial_restore_params(fds[i].fd, serial_params[i]);
428 serial_close(fds[i].fd);
430 free(serial_params[i]);
431 free(device_names[i]);
434 hw_init_free_serial_params:
435 g_free(serial_params);
436 hw_init_free_device_names:
437 g_free(device_names);
446 static int hw_opendev(int device_index)
448 struct sr_device_instance *sdi;
450 if (!(sdi = sr_get_device_instance(device_instances, device_index)))
453 sdi->serial->fd = serial_open(sdi->serial->port, O_RDWR);
454 if (sdi->serial->fd == -1)
457 sdi->status = SR_ST_ACTIVE;
462 static void hw_closedev(int device_index)
464 struct sr_device_instance *sdi;
466 if (!(sdi = sr_get_device_instance(device_instances, device_index)))
469 if (sdi->serial->fd != -1) {
470 serial_close(sdi->serial->fd);
471 sdi->serial->fd = -1;
472 sdi->status = SR_ST_INACTIVE;
476 static void hw_cleanup(void)
479 struct sr_device_instance *sdi;
481 /* Properly close all devices. */
482 for (l = device_instances; l; l = l->next) {
484 if (sdi->serial->fd != -1)
485 serial_close(sdi->serial->fd);
486 sr_device_instance_free(sdi);
488 g_slist_free(device_instances);
489 device_instances = NULL;
492 static void *hw_get_device_info(int device_index, int device_info_id)
494 struct sr_device_instance *sdi;
495 struct ols_device *ols;
498 if (!(sdi = sr_get_device_instance(device_instances, device_index)))
503 switch (device_info_id) {
507 case SR_DI_NUM_PROBES:
508 info = GINT_TO_POINTER(NUM_PROBES);
510 case SR_DI_SAMPLERATES:
513 case SR_DI_TRIGGER_TYPES:
514 info = (char *)TRIGGER_TYPES;
516 case SR_DI_CUR_SAMPLERATE:
517 info = &ols->cur_samplerate;
524 static int hw_get_status(int device_index)
526 struct sr_device_instance *sdi;
528 if (!(sdi = sr_get_device_instance(device_instances, device_index)))
529 return SR_ST_NOT_FOUND;
534 static int *hw_get_capabilities(void)
539 static int set_configuration_samplerate(struct sr_device_instance *sdi,
542 struct ols_device *ols;
545 if (ols->max_samplerate) {
546 if (samplerate > ols->max_samplerate)
547 return SR_ERR_SAMPLERATE;
548 } else if (samplerate < samplerates.low || samplerate > samplerates.high)
549 return SR_ERR_SAMPLERATE;
551 ols->cur_samplerate = samplerate;
552 if (samplerate > CLOCK_RATE) {
553 ols->flag_reg |= FLAG_DEMUX;
554 ols->cur_samplerate_divider = (CLOCK_RATE * 2 / samplerate) - 1;
556 ols->flag_reg &= ~FLAG_DEMUX;
557 ols->cur_samplerate_divider = (CLOCK_RATE / samplerate) - 1;
563 static int hw_set_configuration(int device_index, int capability, void *value)
565 struct sr_device_instance *sdi;
566 struct ols_device *ols;
570 if (!(sdi = sr_get_device_instance(device_instances, device_index)))
574 if (sdi->status != SR_ST_ACTIVE)
577 switch (capability) {
578 case SR_HWCAP_SAMPLERATE:
580 ret = set_configuration_samplerate(sdi, *tmp_u64);
582 case SR_HWCAP_PROBECONFIG:
583 ret = configure_probes(ols, (GSList *) value);
585 case SR_HWCAP_LIMIT_SAMPLES:
587 if (*tmp_u64 < MIN_NUM_SAMPLES)
589 ols->limit_samples = *tmp_u64;
590 sr_info("ols: sample limit %" PRIu64, ols->limit_samples);
593 case SR_HWCAP_CAPTURE_RATIO:
595 ols->capture_ratio = *tmp_u64;
596 if (ols->capture_ratio < 0 || ols->capture_ratio > 100) {
597 ols->capture_ratio = 0;
609 static int receive_data(int fd, int revents, void *user_data)
611 struct sr_datafeed_packet packet;
612 struct sr_device_instance *sdi;
613 struct ols_device *ols;
615 int count, buflen, num_channels, offset, i, j;
616 unsigned char byte, *buffer;
618 /* find this device's ols_device struct by its fd */
620 for (l = device_instances; l; l = l->next) {
622 if (sdi->serial->fd == fd) {
628 /* shouldn't happen */
631 if (ols->num_transfers++ == 0) {
633 * First time round, means the device started sending data,
634 * and will not stop until done. If it stops sending for
635 * longer than it takes to send a byte, that means it's
636 * finished. We'll double that to 30ms to be sure...
638 sr_source_remove(fd);
639 sr_source_add(fd, G_IO_IN, 30, receive_data, user_data);
640 ols->raw_sample_buf = g_try_malloc(ols->limit_samples * 4);
641 if (!ols->raw_sample_buf) {
642 sr_err("ols: %s: ols->raw_sample_buf malloc failed",
646 /* fill with 1010... for debugging */
647 memset(ols->raw_sample_buf, 0x82, ols->limit_samples * 4);
651 for (i = 0x20; i > 0x02; i /= 2) {
652 if ((ols->flag_reg & i) == 0)
656 if (revents == G_IO_IN
657 && ols->num_transfers / num_channels <= ols->limit_samples) {
658 if (serial_read(fd, &byte, 1) != 1)
661 ols->sample[ols->num_bytes++] = byte;
662 sr_dbg("ols: received byte 0x%.2x", byte);
663 if (ols->num_bytes == num_channels) {
664 /* Got a full sample. */
665 sr_dbg("ols: received sample 0x%.*x",
666 ols->num_bytes * 2, (int) *ols->sample);
667 if (ols->flag_reg & FLAG_RLE) {
669 * In RLE mode -1 should never come in as a
670 * sample, because bit 31 is the "count" flag.
671 * TODO: Endianness may be wrong here, could be
674 if (ols->sample[0] & 0x80
675 && !(ols->last_sample[0] & 0x80)) {
676 count = (int)(*ols->sample) & 0x7fffffff;
677 if (!(buffer = g_try_malloc(count))) {
678 sr_err("ols: %s: buffer malloc "
684 for (i = 0; i < count; i++) {
685 memcpy(buffer + buflen, ols->last_sample, 4);
690 * Just a single sample, next sample
691 * will probably be a count referring
692 * to this -- but this one is still a
693 * part of the stream.
695 buffer = ols->sample;
699 /* No compression. */
700 buffer = ols->sample;
704 if (num_channels < 4) {
706 * Some channel groups may have been turned
707 * off, to speed up transfer between the
708 * hardware and the PC. Expand that here before
709 * submitting it over the session bus --
710 * whatever is listening on the bus will be
711 * expecting a full 32-bit sample, based on
712 * the number of probes.
715 memset(ols->tmp_sample, 0, 4);
716 for (i = 0; i < 4; i++) {
717 if (((ols->flag_reg >> 2) & (1 << i)) == 0) {
719 * This channel group was
720 * enabled, copy from received
723 ols->tmp_sample[i] = ols->sample[j++];
726 memcpy(ols->sample, ols->tmp_sample, 4);
727 sr_dbg("ols: full sample 0x%.8x", (int) *ols->sample);
730 /* the OLS sends its sample buffer backwards.
731 * store it in reverse order here, so we can dump
732 * this on the session bus later.
734 offset = (ols->limit_samples - ols->num_transfers / num_channels) * 4;
735 memcpy(ols->raw_sample_buf + offset, ols->sample, 4);
737 if (buffer == ols->sample)
738 memcpy(ols->last_sample, buffer, num_channels);
742 memset(ols->sample, 0, 4);
747 * This is the main loop telling us a timeout was reached, or
748 * we've acquired all the samples we asked for -- we're done.
749 * Send the (properly-ordered) buffer to the frontend.
751 if (ols->trigger_at != -1) {
752 /* a trigger was set up, so we need to tell the frontend
755 if (ols->trigger_at > 0) {
756 /* there are pre-trigger samples, send those first */
757 packet.type = SR_DF_LOGIC;
758 packet.length = ols->trigger_at * 4;
760 packet.payload = ols->raw_sample_buf;
761 sr_session_bus(user_data, &packet);
764 packet.type = SR_DF_TRIGGER;
766 sr_session_bus(user_data, &packet);
768 packet.type = SR_DF_LOGIC;
769 packet.length = (ols->limit_samples * 4) - (ols->trigger_at * 4);
771 packet.payload = ols->raw_sample_buf + ols->trigger_at * 4;
772 sr_session_bus(user_data, &packet);
774 packet.type = SR_DF_LOGIC;
775 packet.length = ols->limit_samples * 4;
777 packet.payload = ols->raw_sample_buf;
778 sr_session_bus(user_data, &packet);
780 g_free(ols->raw_sample_buf);
784 packet.type = SR_DF_END;
786 sr_session_bus(user_data, &packet);
792 static int hw_start_acquisition(int device_index, gpointer session_device_id)
794 struct sr_datafeed_packet *packet;
795 struct sr_datafeed_header *header;
796 struct sr_device_instance *sdi;
797 struct ols_device *ols;
798 uint32_t trigger_config[4];
800 uint16_t readcount, delaycount;
801 uint8_t changrp_mask;
804 if (!(sdi = sr_get_device_instance(device_instances, device_index)))
809 if (sdi->status != SR_ST_ACTIVE)
812 readcount = ols->limit_samples / 4;
814 memset(trigger_config, 0, 16);
815 trigger_config[ols->num_stages - 1] |= 0x08;
816 if (ols->trigger_mask[0]) {
817 delaycount = readcount * (1 - ols->capture_ratio / 100.0);
818 ols->trigger_at = (readcount - delaycount) * 4 - ols->num_stages;
820 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_MASK_0,
821 reverse32(ols->trigger_mask[0])) != SR_OK)
823 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_VALUE_0,
824 reverse32(ols->trigger_value[0])) != SR_OK)
826 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_CONFIG_0,
827 trigger_config[0]) != SR_OK)
830 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_MASK_1,
831 reverse32(ols->trigger_mask[1])) != SR_OK)
833 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_VALUE_1,
834 reverse32(ols->trigger_value[1])) != SR_OK)
836 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_CONFIG_1,
837 trigger_config[1]) != SR_OK)
840 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_MASK_2,
841 reverse32(ols->trigger_mask[2])) != SR_OK)
843 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_VALUE_2,
844 reverse32(ols->trigger_value[2])) != SR_OK)
846 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_CONFIG_2,
847 trigger_config[2]) != SR_OK)
850 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_MASK_3,
851 reverse32(ols->trigger_mask[3])) != SR_OK)
853 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_VALUE_3,
854 reverse32(ols->trigger_value[3])) != SR_OK)
856 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_CONFIG_3,
857 trigger_config[3]) != SR_OK)
860 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_MASK_0,
861 ols->trigger_mask[0]) != SR_OK)
863 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_VALUE_0,
864 ols->trigger_value[0]) != SR_OK)
866 if (send_longcommand(sdi->serial->fd, CMD_SET_TRIGGER_CONFIG_0,
867 0x00000008) != SR_OK)
869 delaycount = readcount;
872 sr_info("ols: setting samplerate to %" PRIu64 " Hz (divider %u, "
873 "demux %s)", ols->cur_samplerate, ols->cur_samplerate_divider,
874 ols->flag_reg & FLAG_DEMUX ? "on" : "off");
875 if (send_longcommand(sdi->serial->fd, CMD_SET_DIVIDER,
876 reverse32(ols->cur_samplerate_divider)) != SR_OK)
879 /* Send sample limit and pre/post-trigger capture ratio. */
880 data = ((readcount - 1) & 0xffff) << 16;
881 data |= (delaycount - 1) & 0xffff;
882 if (send_longcommand(sdi->serial->fd, CMD_CAPTURE_SIZE, reverse16(data)) != SR_OK)
886 * Enable/disable channel groups in the flag register according to the
890 for (i = 0; i < 4; i++) {
891 if (ols->probe_mask & (0xff << (i * 8)))
892 changrp_mask |= (1 << i);
895 /* The flag register wants them here, and 1 means "disable channel". */
896 ols->flag_reg |= ~(changrp_mask << 2) & 0x3c;
897 ols->flag_reg |= FLAG_FILTER;
898 data = ols->flag_reg << 24;
899 if (send_longcommand(sdi->serial->fd, CMD_SET_FLAGS, data) != SR_OK)
902 /* Start acquisition on the device. */
903 if (send_shortcommand(sdi->serial->fd, CMD_RUN) != SR_OK)
906 sr_source_add(sdi->serial->fd, G_IO_IN, -1, receive_data,
909 if (!(packet = g_try_malloc(sizeof(struct sr_datafeed_packet)))) {
910 sr_err("ols: %s: packet malloc failed", __func__);
911 return SR_ERR_MALLOC;
914 if (!(header = g_try_malloc(sizeof(struct sr_datafeed_header)))) {
915 sr_err("ols: %s: header malloc failed", __func__);
917 return SR_ERR_MALLOC;
920 /* Send header packet to the session bus. */
921 packet->type = SR_DF_HEADER;
922 packet->length = sizeof(struct sr_datafeed_header);
923 packet->payload = (unsigned char *)header;
924 header->feed_version = 1;
925 gettimeofday(&header->starttime, NULL);
926 header->samplerate = ols->cur_samplerate;
927 header->protocol_id = SR_PROTO_RAW;
928 header->num_logic_probes = NUM_PROBES;
929 header->num_analog_probes = 0;
930 sr_session_bus(session_device_id, packet);
938 static void hw_stop_acquisition(int device_index, gpointer session_device_id)
940 struct sr_datafeed_packet packet;
942 /* Avoid compiler warnings. */
943 device_index = device_index;
945 packet.type = SR_DF_END;
947 sr_session_bus(session_device_id, &packet);
950 struct sr_device_plugin ols_plugin_info = {
952 .longname = "Openbench Logic Sniffer",
955 .cleanup = hw_cleanup,
957 .close = hw_closedev,
958 .get_device_info = hw_get_device_info,
959 .get_status = hw_get_status,
960 .get_capabilities = hw_get_capabilities,
961 .set_configuration = hw_set_configuration,
962 .start_acquisition = hw_start_acquisition,
963 .stop_acquisition = hw_stop_acquisition,