Micropython教程實例之USB－HID應用（蘿蔔學科編程）

1.引言

USB－HID是Human Interface Device的縮寫，屬於人機交互操做的設備，如USB鼠標，USB鍵盤，USB遊戲操縱桿，USB觸摸板，USB軌跡球、電話撥號設備、VCR遙控等等設備。 TPYBV101除了具備usb host功能之外，還可做爲USB－HID設備來應用，這裏重點講述若是做爲鼠標和鍵盤使用。（蘿蔔學科編程tpyboard。com）

2.TPYBV101做爲鼠標應用

TPYBV101做爲鼠標的應用能夠參考micropython官方實例中的usb-mouse應用。這裏以官方實例爲例。

1. 編輯 boot.py 文件以更改 USB—mouse 的確認方式。具體以下：

 

<span style="font-family: 宋體, SimSun; font-size: 12px;">

# boot.py -- run on boot-up<br>

# can run arbitrary Python, but best to keep it minimal<br>import pyb<br>

#pyb.main('main.py')<br>

# main script to run after this one

#pyb.usb_mode('CDC+MSC')<br>

# act as a serial and a storage device<br>pyb.usb_mode('CDC+HID')<br>

# act as a serial device and a mouse<br></span>

其實就是去掉了pyb.usb_mode('CDC+HID')前的註釋符。這裏pyb.usb_mode()，

定義了HID的設備，默認爲mouse，也能夠用

 

pyb.usb_mode('CDC+HID',hid=pyb.hid_mouse)

若是是鍵盤，應改成

 

pyb.usb_mode('CDC+HID',hid=pyb.hid_keyboard)

（2）REPL調試鼠標事件

這裏依然用putty進行REPL調試。當進行完（1）再次啓動時，會發現本來會出現的u盤沒有了，此時設備的串口也可能發生了改變，所以在鏈接Putty前要先確認一下串口。在putty中，輸入:（蘿蔔學科編程tpyboard。com）

 

 

pyb.hid((0,10,0,0))  #注意這裏兩層括號

回車後，會發現鼠標向右移動了10個像素。pyb.hid()的具體用法：

pyb.hid((buttons, x, y, z))

這裏buttons取0,1,2,3分別表示0移動，1按下左鍵，2按下中鍵，3按下右鍵。這句也能夠用pyb.USB_HID().send((buttons, x, y, z))，效果是同樣的。

（3）鼠標左右搖晃，代碼以下：

>>> import math

>>> def osc(n, d):

...   for i in range(n):

...     pyb.hid((0, int(20 * math.sin(i / 10)), 0, 0))

...     pyb.delay(d)

...

>>> osc(100, 50)

這段代碼也能夠寫到main.py中，這時你們可能會問，u盤沒了，main.py怎麼編輯啊。這裏須要進入TPYBV101的安全模式。按住usr鍵，按一下reset，此時led2與led3交替亮，當led3亮起，led2沒亮時，鬆開usr，此時led3快閃後，能夠發現u盤掛載出來了，這時能夠修改main.py文件。（蘿蔔學科編程tpyboard。com）

 

#main.py

import math

import pyb

def osc(n, d):

for i in range(n):

    pyb.hid((0, int(20 * math.sin(i / 10)), 0, 0))

    pyb.delay(d)

osc(100, 50)

保存後，按reset重啓後，就能夠看到效果了。

（4）加上加速度傳感器的鼠標（官方例程）

用加速度傳感器製做一個能根據 TPYBoard 板角度移動而移動的鼠標。相關的代碼能夠直接在交互式解釋器裏邊完成，或者放入 main.py 文件中。在這裏咱們選擇放入 main.py 文件。（蘿蔔學科編程tpyboard。com）

 

在 main.py 中代碼：

import pyb

switch = pyb.Switch()

accel = pyb.Accel()

while not switch():

    pyb.hid((0, accel.x(), accel.y(), 0))

    pyb.delay(20）

保存文件，退出或卸載 TPYBoard 設備。經過復位按鍵重置，其將再次成爲鼠標，且根據板的傾斜角度移動鼠標。你應該能注意到 y軸方向是顛倒的。這個問題很容易解決：在上述的 pyb.hid( )行裏，y 軸方向前邊加上負號便可。（蘿蔔學科編程tpyboard。com）

三、TPYBV10x做爲鍵盤應用

（1） 編輯 boot.py 文件，定義usb-keyboard

# boot.py -- run on boot-up

# can run arbitrary Python, but best to keep it minimal

  

import machine

import pyb

#pyb.main('main.py') # main script to run after this one

#pyb.usb_mode('CDC+MSC') # act as a serial and a storage device

pyb.usb_mode('CDC+HID',hid=pyb.hid_keyboard) # act as a serial device and a keyboard

（2）按鍵測試，這裏爲了便於查看，咱們修改main.py文件：

         # main.py -- put your code here!

         hid=pyb.USB_HID()

         def release_key_once():

             buf = bytearray(8) # report is 8 bytes long

             buf[2] = 0

             hid.send(buf) # key released

             pyb.delay(10)

         def press_key_once(key):

             buf = bytearray(8) # report is 8 bytes long

             buf[2] = key

             hid.send(buf) # key released

             pyb.delay(10)

         def press_2key(key1,key2):

             buf = bytearray(8) # report is 8 bytes long

             buf[2] = key1

             buf[3] = key2

             hid.send(buf) # key released

             pyb.delay(10)

         def release_2key():

             buf = bytearray(8) # report is 8 bytes long

             buf[2] = 0

             buf[3] = 0

             hid.send(buf) # key released

             pyb.delay(10)

         pyb.delay(1000)

         press_key_once(0x04)

         release_key_once()

         pyb.delay(1000)

         press_key_once(0x05)

         release_key_once()

         pyb.delay(1000)

         press_key_once(0x2B)

         release_key_once()

         pyb.delay(1000)

         press_key_once(0x28)

         release_key_once()

         pyb.delay(1000)

         press_key_once(0x06)

         release_key_once()

         pyb.delay(1000)

         press_key_once(0x07)

         release_key_once()

         pyb.delay(1000)

         press_2key(0x08,0x09)

         release_2key()

         pyb.delay(1000)

這個程序定義了按下一個鍵press_key_once(key)，擡起一個鍵 release_key_once()，按下兩個鍵press_2key(key1,key2)，擡起兩個鍵release_2key()的方法。具體運行效果，可先打開一個記事本，而後按一下reset鍵，或者插拔一次usb口，最後能夠看到在記事本里，先打入ab，接着是tab，回車，接着cdef，除了ef幾乎同時出現，前面的輸入間都間隔了1秒。（蘿蔔學科編程tpyboard。com）

 

（3）按鍵值的定義

爲何上面的0x04是a，0x05是b呢，這裏的定義具體以下：

         #define KEY_NONE                               0x00

         #define KEY_ERRORROLLOVER                      0x01

         #define KEY_POSTFAIL                           0x02

         #define KEY_ERRORUNDEFINED                     0x03

         #define KEY_A                                  0x04

         #define KEY_B                                  0x05

         #define KEY_C                                  0x06

         #define KEY_D                                  0x07

         #define KEY_E                                  0x08

         #define KEY_F                                  0x09

         #define KEY_G                                  0x0A

         #define KEY_H                                  0x0B

         #define KEY_I                                  0x0C

         #define KEY_J                                  0x0D

         #define KEY_K                                  0x0E

         #define KEY_L                                  0x0F

         #define KEY_M                                  0x10

         #define KEY_N                                  0x11

         #define KEY_O                                  0x12

         #define KEY_P                                  0x13

         #define KEY_Q                                  0x14

         #define KEY_R                                  0x15

         #define KEY_S                                  0x16

         #define KEY_T                                  0x17

         #define KEY_U                                  0x18

         #define KEY_V                                  0x19

         #define KEY_W                                  0x1A

         #define KEY_X                                  0x1B

         #define KEY_Y                                  0x1C

         #define KEY_Z                                  0x1D

         #define KEY_1_EXCLAMATION_MARK                 0x1E

         #define KEY_2_AT                               0x1F

         #define KEY_3_NUMBER_SIGN                      0x20

         #define KEY_4_DOLLAR                           0x21

         #define KEY_5_PERCENT                          0x22

         #define KEY_6_CARET                            0x23

         #define KEY_7_AMPERSAND                        0x24

         #define KEY_8_ASTERISK                         0x25

         #define KEY_9_OPARENTHESIS                     0x26

         #define KEY_0_CPARENTHESIS                     0x27

         #define KEY_ENTER                              0x28

         #define KEY_ESCAPE                             0x29

         #define KEY_BACKSPACE                          0x2A

         #define KEY_TAB                                0x2B

         #define KEY_SPACEBAR                           0x2C

         #define KEY_MINUS_UNDERSCORE                   0x2D

         #define KEY_EQUAL_PLUS                         0x2E

         #define KEY_OBRACKET_AND_OBRACE                0x2F

         #define KEY_CBRACKET_AND_CBRACE                0x30

         #define KEY_BACKSLASH_VERTICAL_BAR             0x31

         #define KEY_NONUS_NUMBER_SIGN_TILDE            0x32

         #define KEY_SEMICOLON_COLON                    0x33

         #define KEY_SINGLE_AND_DOUBLE_QUOTE            0x34

         #define KEY_GRAVE ACCENT AND TILDE             0x35

         #define KEY_COMMA_AND_LESS                     0x36

         #define KEY_DOT_GREATER                        0x37

         #define KEY_SLASH_QUESTION                     0x38

         #define KEY_CAPS LOCK                          0x39

         #define KEY_F1                                 0x3A

         #define KEY_F2                                 0x3B

         #define KEY_F3                                 0x3C

         #define KEY_F4                                 0x3D

         #define KEY_F5                                 0x3E

         #define KEY_F6                                 0x3F

         #define KEY_F7                                 0x40

         #define KEY_F8                                 0x41

         #define KEY_F9                                 0x42

         #define KEY_F10                                0x43

         #define KEY_F11                                0x44

         #define KEY_F12                                0x45

         #define KEY_PRINTSCREEN                        0x46

         #define KEY_SCROLL LOCK                        0x47

         #define KEY_PAUSE                              0x48

         #define KEY_INSERT                             0x49

         #define KEY_HOME                               0x4A

         #define KEY_PAGEUP                             0x4B

         #define KEY_DELETE                             0x4C

         #define KEY_END1                               0x4D

         #define KEY_PAGEDOWN                           0x4E

         #define KEY_RIGHTARROW                         0x4F

         #define KEY_LEFTARROW                          0x50

         #define KEY_DOWNARROW                          0x51

         #define KEY_UPARROW                            0x52

         #define KEY_KEYPAD_NUM_LOCK_AND_CLEAR          0x53

         #define KEY_KEYPAD_SLASH                       0x54

         #define KEY_KEYPAD_ASTERIKS                    0x55

         #define KEY_KEYPAD_MINUS                       0x56

         #define KEY_KEYPAD_PLUS                        0x57

         #define KEY_KEYPAD_ENTER                       0x58

         #define KEY_KEYPAD_1_END                       0x59

         #define KEY_KEYPAD_2_DOWN_ARROW                0x5A

         #define KEY_KEYPAD_3_PAGEDN                    0x5B

         #define KEY_KEYPAD_4_LEFT_ARROW                0x5C

         #define KEY_KEYPAD_5                           0x5D

         #define KEY_KEYPAD_6_RIGHT_ARROW               0x5E

         #define KEY_KEYPAD_7_HOME                      0x5F

         #define KEY_KEYPAD_8_UP_ARROW                  0x60

         #define KEY_KEYPAD_9_PAGEUP                    0x61

         #define KEY_KEYPAD_0_INSERT                    0x62

         #define KEY_KEYPAD_DECIMAL_SEPARATOR_DELETE    0x63

         #define KEY_NONUS_BACK_SLASH_VERTICAL_BAR      0x64

         #define KEY_APPLICATION                        0x65

         #define KEY_POWER                              0x66

         #define KEY_KEYPAD_EQUAL                       0x67

         #define KEY_F13                                0x68

         #define KEY_F14                                0x69

         #define KEY_F15                                0x6A

         #define KEY_F16                                0x6B

         #define KEY_F17                                0x6C

         #define KEY_F18                                0x6D

         #define KEY_F19                                0x6E

         #define KEY_F20                                0x6F

         #define KEY_F21                                0x70

         #define KEY_F22                                0x71

         #define KEY_F23                                0x72

         #define KEY_F24                                0x73

         #define KEY_EXECUTE                            0x74

         #define KEY_HELP                               0x75

         #define KEY_MENU                               0x76

         #define KEY_SELECT                             0x77

         #define KEY_STOP                               0x78

         #define KEY_AGAIN                              0x79

         #define KEY_UNDO                               0x7A

         #define KEY_CUT                                0x7B

         #define KEY_COPY                               0x7C

         #define KEY_PASTE                              0x7D

         #define KEY_FIND                               0x7E

         #define KEY_MUTE                               0x7F

         #define KEY_VOLUME_UP                          0x80

         #define KEY_VOLUME_DOWN                        0x81

         #define KEY_LOCKING_CAPS_LOCK                  0x82

         #define KEY_LOCKING_NUM_LOCK                   0x83

         #define KEY_LOCKING_SCROLL_LOCK                0x84

         #define KEY_KEYPAD_COMMA                       0x85

         #define KEY_KEYPAD_EQUAL_SIGN                  0x86

         #define KEY_INTERNATIONAL1                     0x87

         #define KEY_INTERNATIONAL2                     0x88

         #define KEY_INTERNATIONAL3                     0x89

         #define KEY_INTERNATIONAL4                     0x8A

         #define KEY_INTERNATIONAL5                     0x8B

         #define KEY_INTERNATIONAL6                     0x8C

         #define KEY_INTERNATIONAL7                     0x8D

         #define KEY_INTERNATIONAL8                     0x8E

         #define KEY_INTERNATIONAL9                     0x8F

         #define KEY_LANG1                              0x90

         #define KEY_LANG2                              0x91

         #define KEY_LANG3                              0x92

         #define KEY_LANG4                              0x93

         #define KEY_LANG5                              0x94

         #define KEY_LANG6                              0x95

         #define KEY_LANG7                              0x96

         #define KEY_LANG8                              0x97

         #define KEY_LANG9                              0x98

         #define KEY_ALTERNATE_ERASE                    0x99

         #define KEY_SYSREQ                             0x9A

         #define KEY_CANCEL                             0x9B

         #define KEY_CLEAR                              0x9C

         #define KEY_PRIOR                              0x9D

         #define KEY_RETURN                             0x9E

         #define KEY_SEPARATOR                          0x9F

         #define KEY_OUT                                0xA0

         #define KEY_OPER                               0xA1

         #define KEY_CLEAR_AGAIN                        0xA2

         #define KEY_CRSEL                              0xA3

         #define KEY_EXSEL                              0xA4

         #define KEY_KEYPAD_00                          0xB0

         #define KEY_KEYPAD_000                         0xB1

         #define KEY_THOUSANDS_SEPARATOR                0xB2

         #define KEY_DECIMAL_SEPARATOR                  0xB3

         #define KEY_CURRENCY_UNIT                      0xB4

         #define KEY_CURRENCY_SUB_UNIT                  0xB5

         #define KEY_KEYPAD_OPARENTHESIS                0xB6

         #define KEY_KEYPAD_CPARENTHESIS                0xB7

         #define KEY_KEYPAD_OBRACE                      0xB8

         #define KEY_KEYPAD_CBRACE                      0xB9

         #define KEY_KEYPAD_TAB                         0xBA

         #define KEY_KEYPAD_BACKSPACE                   0xBB

         #define KEY_KEYPAD_A                           0xBC

         #define KEY_KEYPAD_B                           0xBD

         #define KEY_KEYPAD_C                           0xBE

         #define KEY_KEYPAD_D                           0xBF

         #define KEY_KEYPAD_E                           0xC0

         #define KEY_KEYPAD_F                           0xC1

         #define KEY_KEYPAD_XOR                         0xC2

         #define KEY_KEYPAD_CARET                       0xC3

         #define KEY_KEYPAD_PERCENT                     0xC4

         #define KEY_KEYPAD_LESS                        0xC5

         #define KEY_KEYPAD_GREATER                     0xC6

         #define KEY_KEYPAD_AMPERSAND                   0xC7

         #define KEY_KEYPAD_LOGICAL_AND                 0xC8

         #define KEY_KEYPAD_VERTICAL_BAR                0xC9

         #define KEY_KEYPAD_LOGIACL_OR                  0xCA

         #define KEY_KEYPAD_COLON                       0xCB

         #define KEY_KEYPAD_NUMBER_SIGN                 0xCC

         #define KEY_KEYPAD_SPACE                       0xCD

         #define KEY_KEYPAD_AT                          0xCE

         #define KEY_KEYPAD_EXCLAMATION_MARK            0xCF

         #define KEY_KEYPAD_MEMORY_STORE                0xD0

         #define KEY_KEYPAD_MEMORY_RECALL               0xD1

         #define KEY_KEYPAD_MEMORY_CLEAR                0xD2

         #define KEY_KEYPAD_MEMORY_ADD                  0xD3

         #define KEY_KEYPAD_MEMORY_SUBTRACT             0xD4

         #define KEY_KEYPAD_MEMORY_MULTIPLY             0xD5

         #define KEY_KEYPAD_MEMORY_DIVIDE               0xD6

         #define KEY_KEYPAD_PLUSMINUS                   0xD7

         #define KEY_KEYPAD_CLEAR                       0xD8

         #define KEY_KEYPAD_CLEAR_ENTRY                 0xD9

         #define KEY_KEYPAD_BINARY                      0xDA

         #define KEY_KEYPAD_OCTAL                       0xDB

         #define KEY_KEYPAD_DECIMAL                     0xDC

         #define KEY_KEYPAD_HEXADECIMAL                 0xDD

         #define KEY_LEFTCONTROL                        0xE0

         #define KEY_LEFTSHIFT                          0xE1

         #define KEY_LEFTALT                            0xE2

         #define KEY_LEFT_GUI                           0xE3

         #define KEY_RIGHTCONTROL                       0xE4

         #define KEY_RIGHTSHIFT                         0xE5

         #define KEY_RIGHTALT                           0xE6

         #define KEY_RIGHT_GUI                          0xE7

四、恢復正常模式

TPYBoard V10x退出CDC+HID模式的方法有兩個，一個是進入安全模式，將boot.py文件的pyb.usb_mode('CDC+HID'）註釋掉，另外一種是恢復出廠設置，這種方法是按住usr鍵，按一下reset，而後led2和led3交替亮，當兩個燈交替亮到三次，且均亮起時，鬆開usr，兩個燈會快閃屢次，而後TPYBV101恢復到出廠設置，此時main.py裏的內容也都清空了。