diff options
author | Brian Cully <bjc@kublai.com> | 2019-08-11 13:01:00 -0400 |
---|---|---|
committer | Brian Cully <bjc@kublai.com> | 2019-08-11 13:01:00 -0400 |
commit | a3bcee32b84b92640b4082958ee1e0a6d078ffdd (patch) | |
tree | 73199c33069539a88908019c00bc901166d00d43 | |
parent | d12984e27070d6e44841c1b22c31f235d7c27886 (diff) | |
download | bootkbd-a3bcee32b84b92640b4082958ee1e0a6d078ffdd.tar.gz bootkbd-a3bcee32b84b92640b4082958ee1e0a6d078ffdd.zip |
Documentation.
-rw-r--r-- | README.md | 7 | ||||
-rw-r--r-- | TODO.org | 6 | ||||
-rw-r--r-- | src/lib.rs | 7 |
3 files changed, 12 insertions, 8 deletions
@@ -6,5 +6,8 @@ library. # Hardware -Tested on a Logitech G105 keyboard, but any other low-end keyboard -should probably work. +This has been tested on the following keyboards: + + * Logitech G105 + * Niz Plum 85EC + * Keyboard.io Model 01 @@ -1,9 +1,3 @@ * Documentation - README.md - Literally every trait and method. - -* Parse HID descriptors. -This driver currently assumes a fair amount of behavior on the part of -the keyboard, which, for simple keyboards like the Logitech G105 I'm -testing with, works. More complicated keyboards will probably require -more in-depth probing and feature selection. @@ -26,6 +26,7 @@ const MAX_ENDPOINTS: usize = 2; // The maximum size configuration descriptor we can handle. const CONFIG_BUFFER_LEN: usize = 128; +/// Boot protocol keyboard driver for USB hosts. pub struct BootKeyboard<F> { devices: [Option<Device>; MAX_DEVICES], callback: F, @@ -40,6 +41,12 @@ impl<F> BootKeyboard<F> where F: FnMut(u8, &[u8]), { + /// Create a new driver instance which will call + /// `callback(address: u8, buffer: &[u8])` when a new keyboard + /// report is received. + /// + /// `address` is the address of the USB device which received the + /// report and `buffer` is the contents of the report itself. pub fn new(callback: F) -> Self { Self { devices: [None; MAX_DEVICES], |