125 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
			
		
		
	
	
			125 lines
		
	
	
		
			4.8 KiB
		
	
	
	
		
			C
		
	
	
	
| /* 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)
 | |
| 
 | |
| #define USBTMC_IOCTL_GET_STB            _IOR(USBTMC_IOC_NR, 26, __u8)
 | |
| #define USBTMC_IOCTL_GET_SRQ_STB        _IOR(USBTMC_IOC_NR, 27, __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
 |