hc
2024-08-16 a24a44ff9ca902811b99aa9663d697cf452e08ef
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
/*
 * Copyright (C) 2007 Stefan Kopp, Gechingen, Germany
 * Copyright (C) 2008 Novell, Inc.
 * Copyright (C) 2008 Greg Kroah-Hartman <gregkh@suse.de>
 * Copyright (C) 2015 Dave Penkler <dpenkler@gmail.com>
 * Copyright (C) 2018 IVI Foundation, Inc.
 *
 * This file holds USB constants defined by the USB Device Class
 * and USB488 Subclass Definitions for Test and Measurement devices
 * published by the USB-IF.
 *
 * It also has the ioctl and capability definitions for the
 * usbtmc kernel driver that userspace needs to know about.
 */
 
#ifndef __LINUX_USB_TMC_H
#define __LINUX_USB_TMC_H
 
#include <linux/types.h>   /* __u8 etc */
 
/* USB TMC status values */
#define USBTMC_STATUS_SUCCESS                0x01
#define USBTMC_STATUS_PENDING                0x02
#define USBTMC_STATUS_FAILED                0x80
#define USBTMC_STATUS_TRANSFER_NOT_IN_PROGRESS        0x81
#define USBTMC_STATUS_SPLIT_NOT_IN_PROGRESS        0x82
#define USBTMC_STATUS_SPLIT_IN_PROGRESS            0x83
 
/* USB TMC requests values */
#define USBTMC_REQUEST_INITIATE_ABORT_BULK_OUT        1
#define USBTMC_REQUEST_CHECK_ABORT_BULK_OUT_STATUS    2
#define USBTMC_REQUEST_INITIATE_ABORT_BULK_IN        3
#define USBTMC_REQUEST_CHECK_ABORT_BULK_IN_STATUS    4
#define USBTMC_REQUEST_INITIATE_CLEAR            5
#define USBTMC_REQUEST_CHECK_CLEAR_STATUS        6
#define USBTMC_REQUEST_GET_CAPABILITIES            7
#define USBTMC_REQUEST_INDICATOR_PULSE            64
#define USBTMC488_REQUEST_READ_STATUS_BYTE        128
#define USBTMC488_REQUEST_REN_CONTROL            160
#define USBTMC488_REQUEST_GOTO_LOCAL            161
#define USBTMC488_REQUEST_LOCAL_LOCKOUT            162
 
struct usbtmc_request {
   __u8 bRequestType;
   __u8 bRequest;
   __u16 wValue;
   __u16 wIndex;
   __u16 wLength;
} __attribute__ ((packed));
 
struct usbtmc_ctrlrequest {
   struct usbtmc_request req;
   void __user *data; /* pointer to user space */
} __attribute__ ((packed));
 
struct usbtmc_termchar {
   __u8 term_char;
   __u8 term_char_enabled;
} __attribute__ ((packed));
 
/*
 * usbtmc_message->flags:
 */
#define USBTMC_FLAG_ASYNC        0x0001
#define USBTMC_FLAG_APPEND        0x0002
#define USBTMC_FLAG_IGNORE_TRAILER    0x0004
 
struct usbtmc_message {
   __u32 transfer_size; /* size of bytes to transfer */
   __u32 transferred; /* size of received/written bytes */
   __u32 flags; /* bit 0: 0 = synchronous; 1 = asynchronous */
   void __user *message; /* pointer to header and data in user space */
} __attribute__ ((packed));
 
/* Request values for USBTMC driver's ioctl entry point */
#define USBTMC_IOC_NR            91
#define USBTMC_IOCTL_INDICATOR_PULSE    _IO(USBTMC_IOC_NR, 1)
#define USBTMC_IOCTL_CLEAR        _IO(USBTMC_IOC_NR, 2)
#define USBTMC_IOCTL_ABORT_BULK_OUT    _IO(USBTMC_IOC_NR, 3)
#define USBTMC_IOCTL_ABORT_BULK_IN    _IO(USBTMC_IOC_NR, 4)
#define USBTMC_IOCTL_CLEAR_OUT_HALT    _IO(USBTMC_IOC_NR, 6)
#define USBTMC_IOCTL_CLEAR_IN_HALT    _IO(USBTMC_IOC_NR, 7)
#define USBTMC_IOCTL_CTRL_REQUEST    _IOWR(USBTMC_IOC_NR, 8, struct usbtmc_ctrlrequest)
#define USBTMC_IOCTL_GET_TIMEOUT    _IOR(USBTMC_IOC_NR, 9, __u32)
#define USBTMC_IOCTL_SET_TIMEOUT    _IOW(USBTMC_IOC_NR, 10, __u32)
#define USBTMC_IOCTL_EOM_ENABLE            _IOW(USBTMC_IOC_NR, 11, __u8)
#define USBTMC_IOCTL_CONFIG_TERMCHAR    _IOW(USBTMC_IOC_NR, 12, struct usbtmc_termchar)
#define USBTMC_IOCTL_WRITE        _IOWR(USBTMC_IOC_NR, 13, struct usbtmc_message)
#define USBTMC_IOCTL_READ        _IOWR(USBTMC_IOC_NR, 14, struct usbtmc_message)
#define USBTMC_IOCTL_WRITE_RESULT    _IOWR(USBTMC_IOC_NR, 15, __u32)
#define USBTMC_IOCTL_API_VERSION    _IOR(USBTMC_IOC_NR, 16, __u32)
 
#define USBTMC488_IOCTL_GET_CAPS    _IOR(USBTMC_IOC_NR, 17, unsigned char)
#define USBTMC488_IOCTL_READ_STB    _IOR(USBTMC_IOC_NR, 18, unsigned char)
#define USBTMC488_IOCTL_REN_CONTROL    _IOW(USBTMC_IOC_NR, 19, unsigned char)
#define USBTMC488_IOCTL_GOTO_LOCAL    _IO(USBTMC_IOC_NR, 20)
#define USBTMC488_IOCTL_LOCAL_LOCKOUT    _IO(USBTMC_IOC_NR, 21)
#define USBTMC488_IOCTL_TRIGGER        _IO(USBTMC_IOC_NR, 22)
#define USBTMC488_IOCTL_WAIT_SRQ    _IOW(USBTMC_IOC_NR, 23, __u32)
 
#define USBTMC_IOCTL_MSG_IN_ATTR    _IOR(USBTMC_IOC_NR, 24, __u8)
#define USBTMC_IOCTL_AUTO_ABORT        _IOW(USBTMC_IOC_NR, 25, __u8)
 
/* Cancel and cleanup asynchronous calls */
#define USBTMC_IOCTL_CANCEL_IO        _IO(USBTMC_IOC_NR, 35)
#define USBTMC_IOCTL_CLEANUP_IO        _IO(USBTMC_IOC_NR, 36)
 
/* Driver encoded usb488 capabilities */
#define USBTMC488_CAPABILITY_TRIGGER         1
#define USBTMC488_CAPABILITY_SIMPLE          2
#define USBTMC488_CAPABILITY_REN_CONTROL     2
#define USBTMC488_CAPABILITY_GOTO_LOCAL      2
#define USBTMC488_CAPABILITY_LOCAL_LOCKOUT   2
#define USBTMC488_CAPABILITY_488_DOT_2       4
#define USBTMC488_CAPABILITY_DT1             16
#define USBTMC488_CAPABILITY_RL1             32
#define USBTMC488_CAPABILITY_SR1             64
#define USBTMC488_CAPABILITY_FULL_SCPI       128
 
#endif