sfe-chris / uno-hidkeyboard-library Goto Github PK
View Code? Open in Web Editor NEWAn Arduino library that implements functions to use the UNO as an HID keyboard.
An Arduino library that implements functions to use the UNO as an HID keyboard.
Written by Chris Taylor for SparkFun Electronics, 10/15/12 This is an Arduino library written to simpify the use of the Arduino UNO as an HID device. It can NOT be used on its own. It must be used in conjunction with the arduino-keyboard firmware written by Darran, found here: http://hunt.net.nz/users/darran/weblog/b3029/Arduino_UNO_Keyboard_HID_version_03.html This firmware is meant to be installed on the ATMega8U2 on the UNO. I would attempt to write full installation instructions in this README, but Michael did a much more thorough and colorful job here: http://mitchtech.net/arduino-usb-hid-keyboard/ NOTE that the ATMega328 cannot be programmed over USB when the arduino-keyboard firmware is installed on the ATMega8U2, you must flash the arduino-serial firmware again using FLIP, as explained in the above link. ON TO THE LIBRARY: The library defines a series of functions that make sending HID codes intuitive. Rather than having to look up and send HID codes for every character, the library takes care of it for you. Here's the jist: Each HID report is sent as a key plus a modifier. The modifiers are CTRL, ALT, SHIFT, and GUI. By default each key is sent with a modifier of zero. The modifiers can be masked together to send more complex commands. The function pressKey() is overloaded to do this. For example: To send the keypress 'k', use pressKey('k'); To send the keypress CTRL+ALT+k, use pressKey((CTRL | ALT), 'k'); There are similar functions for "Special Keys" like F1 that do not appear in the ASCII table. The values for these keys are defined in HIDKeyboard.h and are sent using the pressSpecialKey() function. For example: To send the keypress TAB, use pressSpecialKey(TAB); To send the keypress CTRL+ALT+TAB, use pressSpecialKey((CTRL | ALT), TAB); There are also functions for printing ASCII strings, similar to the Serial.print() and println() functions. All of the functions are listed below: begin() Initializes the HIDKeyboard object by ending any Serial communication and resetting it to 9600 baud pressKey(modifier, key) pressKey(key) pressSpecialKey(modifier, key) pressSpecialKey(key) releaseKey() Releases any keys and modifiers that are currently down. NOTE: the pressKey and pressSpecialKey functions DO NOT release the key. releaseKey must be used to release the key. print() Sends keypresses for a full string. For example print("Hello World!"); println() Sends keypresses for a full string, followed by a carriage return. EXAMPLE: HIDKeyboard Keyboard; void setup() { Keyboard.begin(); // Initializes keyboard } void loop() { Keyboard.println("Hello World!"); // Types "Hello World!" followed by a carriage return Keyboard.pressSpecialKey(ENTER); // Sends an "Enter" keypress Keyboard.releaseKey(); // Releases "Enter" Keyboard.pressKey('a'); // Types 'a' Keyboard.releaseKey(); // Releases the 'a' key Keyboard.pressKey(SHIFT, 'a'); // Types 'A' Keyboard.releaseKey(); // Releases 'a' and SHIFT while(1); // Hold forever } OUTPUT: Hello World! aA For more examples, please see the included examples folder.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.