BLEHIDKeyboard Class

BLEHIDKeyboard Class

Description

A class used for creating and managing a BLE HID Keyboard.

Syntax
class BLEHIDKeyboard

Members

Public Constructors 
BLEHIDKeyboard::BLEHIDKeyboardConstructs a BLEHIDKeyboard object.
Public Methods 
BLEHIDKeyboard::setReportIDSet HID report ID for the HID Keyboard and HID consumer control.
BLEHIDKeyboard::consumerReportSend a HID Consumer report.
BLEHIDKeyboard::keyboardReportSend a HID Keyboard report.
BLEHIDKeyboard::consumerPressSend a HID Consumer report indicating button pressed.
BLEHIDKeyboard::consumerReleaseSend a HID Consumer report indicating button released.
BLEHIDKeyboard::keypressSend a HID Keyboard report indicating keys pressed.
BLEHIDKeyboard::keyReleaseSend a HID Keyboard report indicating keys released.
BLEHIDKeyboard::keyReleaseAllSend a HID Keyboard report indicating no keys pressed.
BLEHIDKeyboard::keyCharPressSend a HID Keyboard report indicating keys pressed to output an ASCII character.
BLEHIDKeyboard::keySequenceSend a HID Keyboard report indicating keys pressed to output an ASCII string.

BLEHIDKeyboard::BLEHIDKeyboard

Description
Constructs a BLEHIDKeyboard object.

Syntax
BLEHIDKeyboard(void);

Parameters
NA

Returns
NA

Example Code
Example: BLEHIDKeyboard
(https://github.com/ambiot/ambd_arduino/blob/dev/Arduino_package/hardware/libraries/BLE/examples/BLEHIDKeyboard/BLEHIDKeyboard.ino)

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::setReportID

Description
Set HID report ID for the HID Keyboard and HID consumer control.

Syntax
void setReportID(uint8_t reportIDKeyboard, uint8_t reportIDConsumer);

Parameters
reportIDKeyboard: The report ID for the HID keyboard device, corresponding to the HID report descriptor.
reportIDConsumer: The report ID for the HID consumer control device, corresponding to the HID report descriptor.

Returns
NA

Example Code
NA

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::consumerReport

Description
Send a HID Consumer report.

Syntax
void consumerReport(uint16_t usage_code);

Parameters
usage_code: HID consumer control usage code for the button pressed.

Returns
NA

Example Code
Example: BLEHIDKeyboard
(https://github.com/ambiot/ambd_arduino/blob/dev/Arduino_package/hardware/libraries/BLE/examples/BLEHIDKeyboard/BLEHIDKeyboard.ino)

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::keyboardReport

Description
Send a HID Keyboard report.

Syntax
void keyboardReport(void);
void keyboardReport(uint8_t modifiers, uint8_t keycode[6]);

Parameters
modifiers: bitmap indicating key modifiers pressed (CTRL, ALT, SHIFT).
keycode: byte array indicating keys pressed.

Returns
NA

Example Code
NA

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::consumerPress

Description
Send a HID Consumer report indicating button pressed.

Syntax
void consumerPress(uint16_t usage_code);

Parameters
usage_code: HID consumer control usage code for the button pressed.

Returns
NA

Example Code
NA

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::consumerRelease

Description
Send a HID Consumer report indicating button released.

Syntax
void consumerRelease(void);

Parameters
NA

Returns
NA

Example Code
Example: BLEHIDKeyboard
(https://github.com/ambiot/ambd_arduino/blob/dev/Arduino_package/hardware/libraries/BLE/examples/BLEHIDKeyboard/BLEHIDKeyboard.ino)

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::keypress

Description
Send a HID Keyboard report indicating keys pressed.

Syntax
void keyPress(uint16_t key);

Parameters
key: HID keycode for key pressed, value ranges from 0x00 to 0xE7.

Returns
NA

Example Code
Example: BLEHIDKeyboard
(https://github.com/ambiot/ambd_arduino/blob/dev/Arduino_package/hardware/libraries/BLE/examples/BLEHIDKeyboard/BLEHIDKeyboard.ino)

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::keyRelease

Description
Send a HID Keyboard report indicating keys released.

Syntax
void keyRelease(uint16_t key);

Parameters
key: HID keycode for key pressed, value ranges from 0x00 to 0xE7.

Returns
NA

Example Code
NA

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::keyReleaseAll

Description
Send a HID Keyboard report indicating no keys pressed.

Syntax
void keyReleaseAll(void);

Parameters
NA

Returns
NA

Example Code
Example: BLEHIDKeyboard
(https://github.com/ambiot/ambd_arduino/blob/dev/Arduino_package/hardware/libraries/BLE/examples/BLEHIDKeyboard/BLEHIDKeyboard.ino)

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::keyCharPress

Description
Send a HID Keyboard report indicating keys pressed to output a specific ASCII character.

Syntax
void keyCharPress(char ch);

Parameters
str: character string to output, expressed as a pointer to a character array or a String class object
delayTime: time delay between key press and release, in milliseconds. Default value of 5.

Returns
NA

Example Code
NA

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

BLEHIDKeyboard::keySequence

Description
Send a HID Keyboard report indicating keys pressed to output an ASCII string.

Syntax
void keySequence(const char* str, uint16_t delayTime);
void keySequence(String str, uint16_t delayTime);

Parameters
str: pointer to character string to output
str: String object containing character string to output
delayTime: time delay between key press and release, in milliseconds. Default value of 5.

Returns
NA

Example Code
Example: BLEHIDKeyboard
(https://github.com/ambiot/ambd_arduino/blob/dev/Arduino_package/hardware/libraries/BLE/examples/BLEHIDKeyboard/BLEHIDKeyboard.ino)

Notes and Warnings
“BLEHIDKeyboard.h” must be included to use the class function.

請先確認已安裝QQ通訊軟體