1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Hidraw Userspace Example
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Copyright (c) 2010 Alan Ott <alan@signal11.us>
6*4882a593Smuzhiyun * Copyright (c) 2010 Signal 11 Software
7*4882a593Smuzhiyun *
8*4882a593Smuzhiyun * The code may be used by anyone for any purpose,
9*4882a593Smuzhiyun * and can serve as a starting point for developing
10*4882a593Smuzhiyun * applications using hidraw.
11*4882a593Smuzhiyun */
12*4882a593Smuzhiyun
13*4882a593Smuzhiyun /* Linux */
14*4882a593Smuzhiyun #include <linux/types.h>
15*4882a593Smuzhiyun #include <linux/input.h>
16*4882a593Smuzhiyun #include <linux/hidraw.h>
17*4882a593Smuzhiyun
18*4882a593Smuzhiyun /*
19*4882a593Smuzhiyun * Ugly hack to work around failing compilation on systems that don't
20*4882a593Smuzhiyun * yet populate new version of hidraw.h to userspace.
21*4882a593Smuzhiyun */
22*4882a593Smuzhiyun #ifndef HIDIOCSFEATURE
23*4882a593Smuzhiyun #warning Please have your distro update the userspace kernel headers
24*4882a593Smuzhiyun #define HIDIOCSFEATURE(len) _IOC(_IOC_WRITE|_IOC_READ, 'H', 0x06, len)
25*4882a593Smuzhiyun #define HIDIOCGFEATURE(len) _IOC(_IOC_WRITE|_IOC_READ, 'H', 0x07, len)
26*4882a593Smuzhiyun #endif
27*4882a593Smuzhiyun
28*4882a593Smuzhiyun /* Unix */
29*4882a593Smuzhiyun #include <sys/ioctl.h>
30*4882a593Smuzhiyun #include <sys/types.h>
31*4882a593Smuzhiyun #include <sys/stat.h>
32*4882a593Smuzhiyun #include <fcntl.h>
33*4882a593Smuzhiyun #include <unistd.h>
34*4882a593Smuzhiyun
35*4882a593Smuzhiyun /* C */
36*4882a593Smuzhiyun #include <stdio.h>
37*4882a593Smuzhiyun #include <string.h>
38*4882a593Smuzhiyun #include <stdlib.h>
39*4882a593Smuzhiyun #include <errno.h>
40*4882a593Smuzhiyun
41*4882a593Smuzhiyun const char *bus_str(int bus);
42*4882a593Smuzhiyun
main(int argc,char ** argv)43*4882a593Smuzhiyun int main(int argc, char **argv)
44*4882a593Smuzhiyun {
45*4882a593Smuzhiyun int fd;
46*4882a593Smuzhiyun int i, res, desc_size = 0;
47*4882a593Smuzhiyun char buf[256];
48*4882a593Smuzhiyun struct hidraw_report_descriptor rpt_desc;
49*4882a593Smuzhiyun struct hidraw_devinfo info;
50*4882a593Smuzhiyun char *device = "/dev/hidraw0";
51*4882a593Smuzhiyun
52*4882a593Smuzhiyun if (argc > 1)
53*4882a593Smuzhiyun device = argv[1];
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun /* Open the Device with non-blocking reads. In real life,
56*4882a593Smuzhiyun don't use a hard coded path; use libudev instead. */
57*4882a593Smuzhiyun fd = open(device, O_RDWR|O_NONBLOCK);
58*4882a593Smuzhiyun
59*4882a593Smuzhiyun if (fd < 0) {
60*4882a593Smuzhiyun perror("Unable to open device");
61*4882a593Smuzhiyun return 1;
62*4882a593Smuzhiyun }
63*4882a593Smuzhiyun
64*4882a593Smuzhiyun memset(&rpt_desc, 0x0, sizeof(rpt_desc));
65*4882a593Smuzhiyun memset(&info, 0x0, sizeof(info));
66*4882a593Smuzhiyun memset(buf, 0x0, sizeof(buf));
67*4882a593Smuzhiyun
68*4882a593Smuzhiyun /* Get Report Descriptor Size */
69*4882a593Smuzhiyun res = ioctl(fd, HIDIOCGRDESCSIZE, &desc_size);
70*4882a593Smuzhiyun if (res < 0)
71*4882a593Smuzhiyun perror("HIDIOCGRDESCSIZE");
72*4882a593Smuzhiyun else
73*4882a593Smuzhiyun printf("Report Descriptor Size: %d\n", desc_size);
74*4882a593Smuzhiyun
75*4882a593Smuzhiyun /* Get Report Descriptor */
76*4882a593Smuzhiyun rpt_desc.size = desc_size;
77*4882a593Smuzhiyun res = ioctl(fd, HIDIOCGRDESC, &rpt_desc);
78*4882a593Smuzhiyun if (res < 0) {
79*4882a593Smuzhiyun perror("HIDIOCGRDESC");
80*4882a593Smuzhiyun } else {
81*4882a593Smuzhiyun printf("Report Descriptor:\n");
82*4882a593Smuzhiyun for (i = 0; i < rpt_desc.size; i++)
83*4882a593Smuzhiyun printf("%hhx ", rpt_desc.value[i]);
84*4882a593Smuzhiyun puts("\n");
85*4882a593Smuzhiyun }
86*4882a593Smuzhiyun
87*4882a593Smuzhiyun /* Get Raw Name */
88*4882a593Smuzhiyun res = ioctl(fd, HIDIOCGRAWNAME(256), buf);
89*4882a593Smuzhiyun if (res < 0)
90*4882a593Smuzhiyun perror("HIDIOCGRAWNAME");
91*4882a593Smuzhiyun else
92*4882a593Smuzhiyun printf("Raw Name: %s\n", buf);
93*4882a593Smuzhiyun
94*4882a593Smuzhiyun /* Get Physical Location */
95*4882a593Smuzhiyun res = ioctl(fd, HIDIOCGRAWPHYS(256), buf);
96*4882a593Smuzhiyun if (res < 0)
97*4882a593Smuzhiyun perror("HIDIOCGRAWPHYS");
98*4882a593Smuzhiyun else
99*4882a593Smuzhiyun printf("Raw Phys: %s\n", buf);
100*4882a593Smuzhiyun
101*4882a593Smuzhiyun /* Get Raw Info */
102*4882a593Smuzhiyun res = ioctl(fd, HIDIOCGRAWINFO, &info);
103*4882a593Smuzhiyun if (res < 0) {
104*4882a593Smuzhiyun perror("HIDIOCGRAWINFO");
105*4882a593Smuzhiyun } else {
106*4882a593Smuzhiyun printf("Raw Info:\n");
107*4882a593Smuzhiyun printf("\tbustype: %d (%s)\n",
108*4882a593Smuzhiyun info.bustype, bus_str(info.bustype));
109*4882a593Smuzhiyun printf("\tvendor: 0x%04hx\n", info.vendor);
110*4882a593Smuzhiyun printf("\tproduct: 0x%04hx\n", info.product);
111*4882a593Smuzhiyun }
112*4882a593Smuzhiyun
113*4882a593Smuzhiyun /* Set Feature */
114*4882a593Smuzhiyun buf[0] = 0x9; /* Report Number */
115*4882a593Smuzhiyun buf[1] = 0xff;
116*4882a593Smuzhiyun buf[2] = 0xff;
117*4882a593Smuzhiyun buf[3] = 0xff;
118*4882a593Smuzhiyun res = ioctl(fd, HIDIOCSFEATURE(4), buf);
119*4882a593Smuzhiyun if (res < 0)
120*4882a593Smuzhiyun perror("HIDIOCSFEATURE");
121*4882a593Smuzhiyun else
122*4882a593Smuzhiyun printf("ioctl HIDIOCSFEATURE returned: %d\n", res);
123*4882a593Smuzhiyun
124*4882a593Smuzhiyun /* Get Feature */
125*4882a593Smuzhiyun buf[0] = 0x9; /* Report Number */
126*4882a593Smuzhiyun res = ioctl(fd, HIDIOCGFEATURE(256), buf);
127*4882a593Smuzhiyun if (res < 0) {
128*4882a593Smuzhiyun perror("HIDIOCGFEATURE");
129*4882a593Smuzhiyun } else {
130*4882a593Smuzhiyun printf("ioctl HIDIOCGFEATURE returned: %d\n", res);
131*4882a593Smuzhiyun printf("Report data (not containing the report number):\n\t");
132*4882a593Smuzhiyun for (i = 0; i < res; i++)
133*4882a593Smuzhiyun printf("%hhx ", buf[i]);
134*4882a593Smuzhiyun puts("\n");
135*4882a593Smuzhiyun }
136*4882a593Smuzhiyun
137*4882a593Smuzhiyun /* Send a Report to the Device */
138*4882a593Smuzhiyun buf[0] = 0x1; /* Report Number */
139*4882a593Smuzhiyun buf[1] = 0x77;
140*4882a593Smuzhiyun res = write(fd, buf, 2);
141*4882a593Smuzhiyun if (res < 0) {
142*4882a593Smuzhiyun printf("Error: %d\n", errno);
143*4882a593Smuzhiyun perror("write");
144*4882a593Smuzhiyun } else {
145*4882a593Smuzhiyun printf("write() wrote %d bytes\n", res);
146*4882a593Smuzhiyun }
147*4882a593Smuzhiyun
148*4882a593Smuzhiyun /* Get a report from the device */
149*4882a593Smuzhiyun res = read(fd, buf, 16);
150*4882a593Smuzhiyun if (res < 0) {
151*4882a593Smuzhiyun perror("read");
152*4882a593Smuzhiyun } else {
153*4882a593Smuzhiyun printf("read() read %d bytes:\n\t", res);
154*4882a593Smuzhiyun for (i = 0; i < res; i++)
155*4882a593Smuzhiyun printf("%hhx ", buf[i]);
156*4882a593Smuzhiyun puts("\n");
157*4882a593Smuzhiyun }
158*4882a593Smuzhiyun close(fd);
159*4882a593Smuzhiyun return 0;
160*4882a593Smuzhiyun }
161*4882a593Smuzhiyun
162*4882a593Smuzhiyun const char *
bus_str(int bus)163*4882a593Smuzhiyun bus_str(int bus)
164*4882a593Smuzhiyun {
165*4882a593Smuzhiyun switch (bus) {
166*4882a593Smuzhiyun case BUS_USB:
167*4882a593Smuzhiyun return "USB";
168*4882a593Smuzhiyun break;
169*4882a593Smuzhiyun case BUS_HIL:
170*4882a593Smuzhiyun return "HIL";
171*4882a593Smuzhiyun break;
172*4882a593Smuzhiyun case BUS_BLUETOOTH:
173*4882a593Smuzhiyun return "Bluetooth";
174*4882a593Smuzhiyun break;
175*4882a593Smuzhiyun case BUS_VIRTUAL:
176*4882a593Smuzhiyun return "Virtual";
177*4882a593Smuzhiyun break;
178*4882a593Smuzhiyun default:
179*4882a593Smuzhiyun return "Other";
180*4882a593Smuzhiyun break;
181*4882a593Smuzhiyun }
182*4882a593Smuzhiyun }
183