155 lines
5.1 KiB
C++
155 lines
5.1 KiB
C++
/* Copyright (C) 2013 Kristian Lauszus, TKJ Electronics. All rights reserved.
|
|
|
|
This software may be distributed and modified under the terms of the GNU
|
|
General Public License version 2 (GPL2) as published by the Free Software
|
|
Foundation and appearing in the file GPL2.TXT included in the packaging of
|
|
this file. Please note that GPL2 Section 2[b] requires that all works based
|
|
on this software must also be made publicly available under the terms of
|
|
the GPL2 ("Copyleft").
|
|
|
|
Contact information
|
|
-------------------
|
|
|
|
Kristian Lauszus, TKJ Electronics
|
|
Web : http://www.tkjelectronics.com
|
|
e-mail : kristianl@tkjelectronics.com
|
|
*/
|
|
|
|
#ifndef _bthid_h_
|
|
#define _bthid_h_
|
|
|
|
#include "BTD.h"
|
|
#include "hidboot.h"
|
|
|
|
#define KEYBOARD_PARSER_ID 0
|
|
#define MOUSE_PARSER_ID 1
|
|
#define NUM_PARSERS 2
|
|
|
|
/** This BluetoothService class implements support for Bluetooth HID devices. */
|
|
class BTHID : public BluetoothService {
|
|
public:
|
|
/**
|
|
* Constructor for the BTHID class.
|
|
* @param p Pointer to the BTD class instance.
|
|
* @param pair Set this to true in order to pair with the device. If the argument is omitted then it will not pair with it. One can use ::PAIR to set it to true.
|
|
* @param pin Write the pin to BTD#btdPin. If argument is omitted, then "0000" will be used.
|
|
*/
|
|
BTHID(BTD *p, bool pair = false, const char *pin = "0000");
|
|
|
|
/** @name BluetoothService implementation */
|
|
/** Used this to disconnect the devices. */
|
|
void disconnect();
|
|
/**@}*/
|
|
|
|
/**
|
|
* Get HIDReportParser.
|
|
* @param id ID of parser.
|
|
* @return Returns the corresponding HIDReportParser. Returns NULL if id is not valid.
|
|
*/
|
|
HIDReportParser *GetReportParser(uint8_t id) {
|
|
if (id >= NUM_PARSERS)
|
|
return NULL;
|
|
return pRptParser[id];
|
|
};
|
|
|
|
/**
|
|
* Set HIDReportParser to be used.
|
|
* @param id Id of parser.
|
|
* @param prs Pointer to HIDReportParser.
|
|
* @return Returns true if the HIDReportParser is set. False otherwise.
|
|
*/
|
|
bool SetReportParser(uint8_t id, HIDReportParser *prs) {
|
|
if (id >= NUM_PARSERS)
|
|
return false;
|
|
pRptParser[id] = prs;
|
|
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) {
|
|
protocolMode = mode;
|
|
};
|
|
|
|
/**
|
|
* Used to set the leds on a keyboard.
|
|
* @param data See KBDLEDS in hidboot.h
|
|
*/
|
|
void setLeds(uint8_t data);
|
|
|
|
/** True if a device is connected */
|
|
bool connected;
|
|
|
|
/** Call this to start the paring sequence with a device */
|
|
void pair(void) {
|
|
if(pBtd)
|
|
pBtd->pairWithHID();
|
|
};
|
|
|
|
protected:
|
|
/** @name BluetoothService implementation */
|
|
/**
|
|
* Used to pass acldata to the services.
|
|
* @param ACLData Incoming acldata.
|
|
*/
|
|
void ACLData(uint8_t* ACLData);
|
|
/** Used to run part of the state machine. */
|
|
void Run();
|
|
/** Use this to reset the service. */
|
|
void Reset();
|
|
/**
|
|
* Called when a device is successfully initialized.
|
|
* 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.
|
|
*/
|
|
void onInit() {
|
|
if(pFuncOnInit)
|
|
pFuncOnInit(); // Call the user function
|
|
OnInitBTHID();
|
|
};
|
|
/**@}*/
|
|
|
|
/** @name Overridable functions */
|
|
/**
|
|
* Used to parse Bluetooth HID data to any class that inherits this class.
|
|
* @param len The length of the incoming data.
|
|
* @param buf Pointer to the data buffer.
|
|
*/
|
|
virtual void ParseBTHIDData(uint8_t len, uint8_t *buf) {
|
|
return;
|
|
};
|
|
/** Called when a device is connected */
|
|
virtual void OnInitBTHID() {
|
|
return;
|
|
};
|
|
/** Used to reset any buffers in the class that inherits this */
|
|
virtual void ResetBTHID() {
|
|
return;
|
|
}
|
|
/**@}*/
|
|
|
|
/** L2CAP source CID for HID_Control */
|
|
uint8_t control_scid[2];
|
|
|
|
/** L2CAP source CID for HID_Interrupt */
|
|
uint8_t interrupt_scid[2];
|
|
|
|
private:
|
|
HIDReportParser *pRptParser[NUM_PARSERS]; // Pointer to HIDReportParsers.
|
|
|
|
/** Set report protocol. */
|
|
void setProtocol();
|
|
uint8_t protocolMode;
|
|
|
|
void L2CAP_task(); // L2CAP state machine
|
|
|
|
bool activeConnection; // Used to indicate if it already has established a connection
|
|
|
|
/* Variables used for L2CAP communication */
|
|
uint8_t control_dcid[2]; // L2CAP device CID for HID_Control - Always 0x0070
|
|
uint8_t interrupt_dcid[2]; // L2CAP device CID for HID_Interrupt - Always 0x0071
|
|
uint8_t l2cap_state;
|
|
};
|
|
#endif
|