Hexiwear library for communicating with the on-board KW40Z BLE device. KW40Z handles also the touch buttons.
Dependents: Hexi_BLE_Example_Modified Hexi_BLE_Example_ModifiedPOTATO
Fork of Hexi_KW40Z by
Hexi_KW40Z.h
- Committer:
- cotigac
- Date:
- 2016-09-19
- Revision:
- 0:c2d52562f36b
- Child:
- 1:f6f9b24aea57
File content as of revision 0:c2d52562f36b:
/** BLE KW40Z Driver for Hexiwear * This file contains BLE and Touch Buttons driver functionality for Hexiwear * * Redistribution and use in source and binary forms, with or without modification, * are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright notice, this list * of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright notice, this * list of conditions and the following disclaimer in the documentation and/or * other materials provided with the distribution. * * Neither the name of NXP, nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * visit: http://www.mikroe.com and http://www.nxp.com * * get support at: http://www.mikroe.com/forum and https://community.nxp.com * * Project HEXIWEAR, 2015 */ #ifndef HG_HEXI_KW40Z #define HG_HEXI_KW40Z #include "mbed.h" #include "rtos.h" //#define LIB_DEBUG 1 #define START_THREAD 1 #define gHostInterface_startByte1 0x55 #define gHostInterface_startByte2 0xAA #define gHostInterface_trailerByte 0x45 #define gHostInterface_dataSize 23 #define gHostInterface_headerSize 4 #define gHostInterface_retransmitCount 3 #define gHostInterface_retransmitTimeout 100 #define gHostInterface_TxConfirmationEnable 1 // send confirmation when receive packet #define gHostInterface_RxConfirmationEnable 1 // wait on confirmation from remote side (do retransmit) /** HEXIWEAR firmware version */ #define HEXIWEAR_VERSION_PATCH ( 2 ) #define HEXIWEAR_VERSION_MINOR ( 0 ) #define HEXIWEAR_VERSION_MAJOR ( 1 ) /** packet types */ typedef enum { packetType_pressUp = 0, /**< touch press up */ packetType_pressDown = 1, /**< touch press down */ packetType_pressLeft = 2, /**< touch press left */ packetType_pressRight = 3, /**< touch press right */ packetType_slide = 4, /**< touch slide */ packetType_batteryLevel = 5, /**< battery Service */ packetType_accel = 6, /**< motion service */ packetType_ambiLight = 7, /**< weather service */ packetType_pressure = 8, /**< weather service */ packetType_gyro = 9, /**< motion service */ packetType_temperature = 10, /**< weather service */ packetType_humidity = 11, /**< weather service */ packetType_magnet = 12, /**< motion service */ packetType_heartRate = 13, /**< health service */ packetType_steps = 14, /**< health service */ packetType_calories = 15, /**< health service */ /* Alert Service */ packetType_alertIn = 16, /**< incoming alerts */ packetType_alertOut = 17, /**< outcoming alerts */ packetType_passDisplay = 18, /**< key display type */ /* OTAP procedure types */ packetType_otapKW40Started = 19, packetType_otapMK64Started = 20, packetType_otapCompleted = 21, packetType_otapFailed = 22, /* active buttons types */ packetType_buttonsGroupToggleActive = 23, packetType_buttonsGroupGetActive = 24, packetType_buttonsGroupSendActive = 25, /* Turn off/on bluetooth advertising */ packetType_advModeGet = 26, packetType_advModeSend = 27, packetType_advModeToggle = 28, packetType_appMode = 29, /**< app mode service */ /* Link State */ packetType_linkStateGet = 30, /**< connected */ packetType_linkStateSend = 31, /**< disconnected */ packetType_notification = 32, /**< notifications */ packetType_buildVersion = 33, /**< build version */ packetType_sleepON = 34, /**< sleep ON */ packetType_sleepOFF = 35, /**< sleep OFF */ packetType_OK = 255 /**< OK packet */ } hostInterface_packetType_t; /** data-packet structure */ typedef struct { /* NOTE: Size of struct must be multiplier of 4! */ uint8_t start1; uint8_t start2; hostInterface_packetType_t type; uint8_t length; uint8_t data[gHostInterface_dataSize + 1]; } hostInterface_packet_t; /** incoming alert types */ typedef enum { alertIn_type_notification = 1, alertIn_type_settings = 2, alertIn_type_timeUpdate = 3, } hostInterface_alertIn_type_t; typedef enum { pressUp = 0, /**< touch press up */ pressDown = 1, /**< touch press down */ pressLeft = 2, /**< touch press left */ pressRight = 3, /**< touch press right */ slide = 4, /**< touch slide */ } hexi_buttons_t; typedef struct { void (*buttons)(hexi_buttons_t button); void (*alert)(uint8_t *data, uint8_t length); void (*passkey)(uint8_t *data); void (*notifications)(uint8_t eventId, uint8_t categoryId); } kw40z_callbacks_t; typedef struct name { uint8_t ver_patchNumber; uint8_t ver_minorNumber; uint8_t ver_majorNumber; } hexiwear_version_t; class KW40Z{ public: /** * Create a Hexiwear BLE KW40Z Driver connected to the UART pins * * @param txPin UART TX pin * @param rxPin UART RX pin */ KW40Z(PinName txPin,PinName rxPin); /** * Destroy the Hexiwear instance */ ~KW40Z(); void attach(kw40z_callbacks_t * callbacks); void GetVersion(); private: RawSerial device; Thread mainThread; Thread rxThread; hostInterface_packet_t hostInterface_rxPacket; hostInterface_packet_t hostInterface_txPacket; kw40z_callbacks_t * kw40z_Cbs; uint8_t * rxBuff; bool confirmReceived; MemoryPool<hostInterface_packet_t, 16> mpool; Queue<hostInterface_packet_t, 16> queue; void mainTask(void); void rxTask(void); void ProcessBuffer(); void ProcessReceivedPacket(hostInterface_packet_t * rxPacket); void SendPacket(hostInterface_packet_t * txPacket, bool confirmRequested); void SearchStartByte(); void SendPacketOK(); void ConfirmPacketOK(); #if defined (LIB_DEBUG) void DebugPrintRxPacket(); void DebugPrintTxPacket(hostInterface_packet_t * txPacket); #endif static void rxStarter(void const *p); static void mainStarter(void const *p); }; #endif