mirror of
https://github.com/jam422470459/EPD-nRF52-hema213.git
synced 2025-12-06 16:42:49 +08:00
155 lines
6.5 KiB
C
155 lines
6.5 KiB
C
/* 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 <inttypes.h>
|
|
#include <stdbool.h>
|
|
#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 0x16
|
|
|
|
#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__
|
|
|
|
/** @} */
|