HID调试工具

在做HID相关的产品是，我们经常要看看输出是否正确，这时就需要一些小工具，这些小工具可以自己开发，也可以从网上找些已经做好的，下面介绍几款工具，

1. PassMark KeyboardTest

    这是Windows下的一款测试小工具，小巧简单实用，是Windows下面测试的好助手，有一个月的免费试用期。

2. evtest

Linux下面的测试工具，可以使用 “apt-get install evtest”安装。

需要su权限执行，可以选择监听那个“/dev/input/eventXX”。

（注意：直接使用“cat /dev/input/eventXX”会产生一堆乱码）

3. showkey

Linux下面的测试工具，ubuntu好些不需要安装可以直接使用，命令“showkey -a”显示输入的字符。

4. hcidump

这是一款Linux下的工具，可以使用命令“apt-get install bluez-hcidump”安装，其功能和命令十分丰富，

打开help文档，可以看到有如下功能，

# hcidump --help
Usage: hcidump [OPTION...] [filter]
  -i, --device=hci_dev       HCI device
  -l, --snap-len=len         Snap len (in bytes)
  -p, --psm=psm              Default PSM
  -m, --manufacturer=compid  Default manufacturer
  -w, --save-dump=file       Save dump to a file
  -r, --read-dump=file       Read dump from a file
  -d, --wait-dump=host       Wait on a host and send
  -t, --ts                   Display time stamps
  -a, --ascii                Dump data in ascii
  -x, --hex                  Dump data in hex
  -X, --ext                  Dump data in hex and ascii
  -R, --raw                  Dump raw data
  -C, --cmtp=psm             PSM for CMTP
  -H, --hcrp=psm             PSM for HCRP
  -O, --obex=port            Channel/PSM for OBEX
  -P, --ppp=channel          Channel for PPP
  -S, --sap=channel          Channel for SAP
  -D, --pppdump=file         Extract PPP traffic
  -A, --audio=file           Extract SCO audio data
  -Y, --novendor             No vendor commands or events
  -4, --ipv4                 Use IPv4 as transport
  -6  --ipv6                 Use IPv6 as transport
  -h, --help                 Give this help list
  -v, --version              Give version information
      --usage                Give a short usage message

举例来说其强大的功能，Bluetooth HID输入“12345”，选择既输出ASCII又输出hex，结果如下，

# hcidump -X
HCI sniffer - Bluetooth packet analyzer ver 2.5
device: hci0 snap_len: 1500 filter: 0xffffffffffffffff
> ACL data: handle 21 flags 0x02 dlen 14
    L2CAP(d): cid 0x0041 len 10 [psm 0]
      0000: a1 01 00 00 1e 00 00 00  00 00                    ..........
1> ACL data: handle 21 flags 0x02 dlen 14
    L2CAP(d): cid 0x0041 len 10 [psm 0]
      0000: a1 01 00 00 1f 00 00 00  00 00                    ..........
> ACL data: handle 21 flags 0x02 dlen 14
    L2CAP(d): cid 0x0041 len 10 [psm 0]
      0000: a1 01 00 00 20 00 00 00  00 00                    .... .....
23> ACL data: handle 21 flags 0x02 dlen 14
    L2CAP(d): cid 0x0041 len 10 [psm 0]
      0000: a1 01 00 00 21 00 00 00  00 00                    ....!.....
> ACL data: handle 21 flags 0x02 dlen 14
    L2CAP(d): cid 0x0041 len 10 [psm 0]
      0000: a1 01 00 00 22 00 00 00  00 00                    ....".....
45> ACL data: handle 21 flags 0x02 dlen 14
    L2CAP(d): cid 0x0041 len 10 [psm 0]
      0000: a1 01 00 00 00 00 00 00  00 00                    ..........

Bluetooth HID输入“12345”，选择输出raw data，结果如下，

从结果上看，输出6行，前5行是输出“Press Key”事件（12345），最后一个是“release key”事件。

正常而言，一般是 按下(press)一个Key后，马上松开(release)；不过这会造成传输效率低下，所以这里是只传输按下(press) key的事件，最后才传输一个松开(release) key的事件（我们称之为Fast HID）。不过，这在一些设备上会出现丢失字符的现象。所以需要修改Bluetooth firemare来设置一个选项Enable/Disable "Fast HID"。

# hcidump -R
HCI sniffer - Bluetooth packet analyzer ver 2.5
device: hci0 snap_len: 1500 filter: 0xffffffffffffffff
> 02 15 20 0E 00 0A 00 41 00 A1 01 00 00 1E 00 00 00 00 00 
> 02 15 20 0E 00 0A 00 41 00 A1 01 00 00 1F 00 00 00 00 00 
> 02 15 20 0E 00 0A 00 41 00 A1 01 00 00 20 00 00 00 00 00 
> 02 15 20 0E 00 0A 00 41 00 A1 01 00 00 21 00 00 00 00 00 
> 02 15 20 0E 00 0A 00 41 00 A1 01 00 00 22 00 00 00 00 00 
> 02 15 20 0E 00 0A 00 41 00 A1 01 00 00 00 00 00 00 00 00 

5.  还有其他Linux节点与此有关，如/dev/hidrawX，没有搞懂里面数据的具体含义；

另外，还有节点/dev/input/eventX，但是没有细细研究。

$ sudo hexdump /dev/hidraw0 
0000000 0001 2300 0000 0000 0100 0000 0026 0000
0000010 0000 0001 1f00 0000 0000 0100 0000 001e
0000020 0000 0000 0001 2400 0000 0000 0100 0000
0000030 0020 0000 0000 0001 2100 0000 0000 0100
0000040 0000 0026 0000 0000 0001 2700 0000 0000
0000050 0100 0000 0000 0000 0000 0001 2700 0000
0000060 0000 0100 0000 001e 0000 0000 0001 2500
0000070 0000 0000 0100 0000 0027 0000 0000 0001