Updated comments - especially in BTHID.h

This commit is contained in:
Kristian Lauszus 2013-12-30 16:05:50 +01:00
parent 14fda1372c
commit 8ae6f8bb1d
4 changed files with 22 additions and 15 deletions

2
BTD.h
View file

@ -286,7 +286,7 @@ public:
*/ */
virtual boolean DEVCLASSOK(uint8_t klass) { virtual boolean DEVCLASSOK(uint8_t klass) {
return (klass == USB_CLASS_WIRELESS_CTRL); return (klass == USB_CLASS_WIRELESS_CTRL);
} };
/** /**
* Used by the USB core to check what this driver support. * Used by the USB core to check what this driver support.

25
BTHID.h
View file

@ -42,11 +42,11 @@ public:
* @param ACLData Incoming acldata. * @param ACLData Incoming acldata.
*/ */
virtual void ACLData(uint8_t* ACLData); virtual void ACLData(uint8_t* ACLData);
/** Used to run part of the state maschine. */ /** Used to run part of the state machine. */
virtual void Run(); virtual void Run();
/** Use this to reset the service. */ /** Use this to reset the service. */
virtual void Reset(); virtual void Reset();
/** Used this to disconnect any of the controllers. */ /** Used this to disconnect the devices. */
virtual void disconnect(); virtual void disconnect();
/**@}*/ /**@}*/
@ -60,24 +60,31 @@ public:
return true; return true;
}; };
/**
* Set HID protocol mode.
* @param mode HID protocol to use. Either HID_BOOT_PROTOCOL or HID_RPT_PROTOCOL.
*/
void setProtocolMode(uint8_t mode) { void setProtocolMode(uint8_t mode) {
protocolMode = mode; protocolMode = mode;
}; };
/** Used to set the leds on a keyboard */ /**
* Used to set the leds on a keyboard.
* @param data See KBDLEDS in hidboot.h
*/
void setLeds(uint8_t data); void setLeds(uint8_t data);
/** True if a device is connected */ /** True if a device is connected */
bool connected; bool connected;
/** Call this to start the paring sequence with a controller */ /** Call this to start the paring sequence with a device */
void pair(void) { void pair(void) {
if(pBtd) if(pBtd)
pBtd->pairWithHID(); pBtd->pairWithHID();
}; };
/** /**
* Used to call your own function when the controller is successfully initialized. * Used to call your own function when the device is successfully initialized.
* @param funcOnInit Function to call. * @param funcOnInit Function to call.
*/ */
void attachOnInit(void (*funcOnInit)(void)) { void attachOnInit(void (*funcOnInit)(void)) {
@ -87,28 +94,28 @@ public:
private: private:
BTD *pBtd; // Pointer to BTD instance BTD *pBtd; // Pointer to BTD instance
HIDReportParser *pRptParser[NUM_PARSERS]; HIDReportParser *pRptParser[NUM_PARSERS]; // Pointer to HIDReportParsers.
/** Set report protocol. */ /** Set report protocol. */
void setProtocol(); void setProtocol();
uint8_t protocolMode; uint8_t protocolMode;
/** /**
* Called when the controller is successfully initialized. * Called when a device is successfully initialized.
* Use attachOnInit(void (*funcOnInit)(void)) to call your own function. * Use attachOnInit(void (*funcOnInit)(void)) to call your own function.
* This is useful for instance if you want to set the LEDs in a specific way. * This is useful for instance if you want to set the LEDs in a specific way.
*/ */
void onInit() { void onInit() {
if(pFuncOnInit) if(pFuncOnInit)
pFuncOnInit(); // Call the user function pFuncOnInit(); // Call the user function
} };
void (*pFuncOnInit)(void); // Pointer to function called in onInit() void (*pFuncOnInit)(void); // Pointer to function called in onInit()
void L2CAP_task(); // L2CAP state machine void L2CAP_task(); // L2CAP state machine
/* Variables filled from HCI event management */ /* Variables filled from HCI event management */
uint16_t hci_handle; uint16_t hci_handle;
bool activeConnection; // Used to indicate if it's already has established a connection bool activeConnection; // Used to indicate if it already has established a connection
/* Variables used by high level L2CAP task */ /* Variables used by high level L2CAP task */
uint8_t l2cap_state; uint8_t l2cap_state;

View file

@ -46,7 +46,7 @@ public:
* @param ACLData Incoming acldata. * @param ACLData Incoming acldata.
*/ */
virtual void ACLData(uint8_t* ACLData); virtual void ACLData(uint8_t* ACLData);
/** Used to run part of the state maschine. */ /** Used to run part of the state machine. */
virtual void Run(); virtual void Run();
/** Use this to reset the service. */ /** Use this to reset the service. */
virtual void Reset(); virtual void Reset();
@ -147,7 +147,7 @@ public:
/** Turn all LEDs off. */ /** Turn all LEDs off. */
void setLedOff() { void setLedOff() {
setLedRaw(0); setLedRaw(0);
} };
/** /**
* Turn the specific ::LED off. * Turn the specific ::LED off.
* @param a The ::LED to turn off. * @param a The ::LED to turn off.

6
Wii.h
View file

@ -63,7 +63,7 @@ public:
* @param ACLData Incoming acldata. * @param ACLData Incoming acldata.
*/ */
virtual void ACLData(uint8_t* ACLData); virtual void ACLData(uint8_t* ACLData);
/** Used to run part of the state maschine. */ /** Used to run part of the state machine. */
virtual void Run(); virtual void Run();
/** Use this to reset the service. */ /** Use this to reset the service. */
virtual void Reset(); virtual void Reset();
@ -90,7 +90,7 @@ public:
void pair(void) { void pair(void) {
if(pBtd) if(pBtd)
pBtd->pairWithWiimote(); pBtd->pairWithWiimote();
} };
/** /**
* Used to read the joystick of the Nunchuck. * Used to read the joystick of the Nunchuck.
* @param a Either ::HatX or ::HatY. * @param a Either ::HatX or ::HatY.
@ -152,7 +152,7 @@ public:
/** Turn all LEDs off. */ /** Turn all LEDs off. */
void setLedOff() { void setLedOff() {
setLedRaw(0); setLedRaw(0);
} };
/** /**
* Turn the specific ::LED off. * Turn the specific ::LED off.
* @param a The ::LED to turn off. * @param a The ::LED to turn off.