/* Copyright (c) 2012 Nordic Semiconductor. All Rights Reserved. * * The information contained herein is property of Nordic Semiconductor ASA. * Terms and conditions of usage are described in detail in NORDIC * SEMICONDUCTOR STANDARD SOFTWARE LICENSE AGREEMENT. * * Licensees are granted free, non-transferable use of the information. NO * WARRANTY of ANY KIND is provided. This heading must NOT be removed from * the file. * */ #ifndef __EPD_SERVICE_H #define __EPD_SERVICE_H #include #include #include "ble.h" #include "ble_srv_common.h" #if defined(S112) #include "nrf_sdh_ble.h" #endif #include "sdk_config.h" #include "EPD_driver.h" #include "EPD_config.h" #include "GUI.h" /**@brief Macro for defining a ble_hts instance. * * @param _name Name of the instance. * @hideinitializer */ #if defined(S112) void ble_epd_evt_handler(ble_evt_t const * p_ble_evt, void * p_context); #define BLE_EPD_BLE_OBSERVER_PRIO 2 #define BLE_EPD_DEF(_name) \ static ble_epd_t _name; \ NRF_SDH_BLE_OBSERVER(_name ## _obs, \ BLE_EPD_BLE_OBSERVER_PRIO, \ ble_epd_evt_handler, &_name) #else #define BLE_EPD_DEF(_name) static ble_epd_t _name; #endif #define APP_VERSION 0x18 #define BLE_UUID_EPD_SVC_BASE {{0XEC, 0X5A, 0X67, 0X1C, 0XC1, 0XB6, 0X46, 0XFB, \ 0X8D, 0X91, 0X28, 0XD8, 0X22, 0X36, 0X75, 0X62}} #define BLE_UUID_EPD_SVC 0x0001 #define BLE_UUID_EPD_CHAR 0x0002 #define BLE_UUID_APP_VER 0x0003 #define EPD_SVC_UUID_TYPE BLE_UUID_TYPE_VENDOR_BEGIN #if defined(S112) #define BLE_EPD_MAX_DATA_LEN (NRF_SDH_BLE_GATT_MAX_MTU_SIZE - 3) #else #define BLE_EPD_MAX_DATA_LEN (GATT_MTU_SIZE_DEFAULT - 3) /**< Maximum length of data (in bytes) that can be transmitted to the peer. */ #endif /**< EPD Service command IDs. */ enum EPD_CMDS { EPD_CMD_SET_PINS = 0x00, /**< set EPD pin mapping. */ EPD_CMD_INIT = 0x01, /**< init EPD display driver */ EPD_CMD_CLEAR = 0x02, /**< clear EPD screen */ EPD_CMD_SEND_COMMAND = 0x03, /**< send command to EPD */ EPD_CMD_SEND_DATA = 0x04, /**< send data to EPD */ EPD_CMD_REFRESH = 0x05, /**< diaplay EPD ram on screen */ EPD_CMD_SLEEP = 0x06, /**< EPD enter sleep mode */ EPD_CMD_SET_TIME = 0x20, /** < set time with unix timestamp */ EPD_CMD_SET_WEEK_START = 0x21, /** < set week start day (0: Sunday, 1: Monday, ...) */ EPD_CMD_WRITE_IMAGE = 0x30, /** < write image data to EPD ram */ EPD_CMD_SET_CONFIG = 0x90, /**< set full EPD config */ EPD_CMD_SYS_RESET = 0x91, /**< MCU reset */ EPD_CMD_SYS_SLEEP = 0x92, /**< MCU enter sleep mode */ EPD_CMD_CFG_ERASE = 0x99, /**< Erase config and reset */ }; /**@brief EPD Service structure. * * @details This structure contains status information related to the service. */ typedef struct { uint16_t service_handle; /**< Handle of EPD Service (as provided by the S110 SoftDevice). */ ble_gatts_char_handles_t char_handles; /**< Handles related to the EPD characteristic (as provided by the SoftDevice). */ ble_gatts_char_handles_t app_ver_handles; /**< Handles related to the APP version characteristic (as provided by the SoftDevice). */ uint16_t conn_handle; /**< Handle of the current connection (as provided by the SoftDevice). BLE_CONN_HANDLE_INVALID if not in a connection. */ uint16_t max_data_len; /**< Maximum length of data (in bytes) that can be transmitted to the peer */ bool is_notification_enabled; /**< Variable to indicate if the peer has enabled notification of the RX characteristic.*/ epd_model_t *epd; /**< current EPD model */ epd_config_t config; /**< EPD config */ } ble_epd_t; typedef struct { ble_epd_t *p_epd; uint32_t timestamp; } epd_gui_update_event_t; #define EPD_GUI_SCHD_EVENT_DATA_SIZE sizeof(epd_gui_update_event_t) /**@brief Function for preparing sleep mode. * * @param[in] p_epd EPD Service structure. */ void ble_epd_sleep_prepare(ble_epd_t * p_epd); /**@brief Function for initializing the EPD Service. * * @param[out] p_epd EPD Service structure. This structure must be supplied * by the application. It is initialized by this function and will * later be used to identify this particular service instance. * * @retval NRF_SUCCESS If the service was successfully initialized. Otherwise, an error code is returned. * @retval NRF_ERROR_NULL If either of the pointers p_epd or p_epd_init is NULL. */ uint32_t ble_epd_init(ble_epd_t * p_epd); /**@brief Function for handling the EPD Service's BLE events. * * @details The EPD Service expects the application to call this function each time an * event is received from the S110 SoftDevice. This function processes the event if it * is relevant and calls the EPD Service event handler of the * application if necessary. * * @param[in] p_epd EPD Service structure. * @param[in] p_ble_evt Event received from the S110 SoftDevice. */ void ble_epd_on_ble_evt(ble_epd_t * p_epd, ble_evt_t * p_ble_evt); /**@brief Function for sending a string to the peer. * * @details This function sends the input string as an RX characteristic notification to the * peer. * * @param[in] p_epd Pointer to the EPD Service structure. * @param[in] p_string String to be sent. * @param[in] length Length of the string. * * @retval NRF_SUCCESS If the string was sent successfully. Otherwise, an error code is returned. */ uint32_t ble_epd_string_send(ble_epd_t * p_epd, uint8_t * p_string, uint16_t length); void ble_epd_on_timer(ble_epd_t * p_epd, uint32_t timestamp, bool force_update); #endif // EPD_BLE_H__ /** @} */