app.h

/*
 * Copyright 2016-2023, Cypress Semiconductor Corporation (an Infineon company) or
 * an affiliate of Cypress Semiconductor Corporation.  All rights reserved.
 *
 * This software, including source code, documentation and related
 * materials ("Software") is owned by Cypress Semiconductor Corporation
 * or one of its affiliates ("Cypress") and is protected by and subject to
 * worldwide patent protection (United States and foreign),
 * United States copyright laws and international treaty provisions.
 * Therefore, you may use this Software only as provided in the license
 * agreement accompanying the software package from which you
 * obtained this Software ("EULA").
 * If no EULA applies, Cypress hereby grants you a personal, non-exclusive,
 * non-transferable license to copy, modify, and compile the Software
 * source code solely for use in connection with Cypress's
 * integrated circuit products.  Any reproduction, modification, translation,
 * compilation, or representation of this Software except as specified
 * above is prohibited without the express written permission of Cypress.
 *
 * Disclaimer: THIS SOFTWARE IS PROVIDED AS-IS, WITH NO WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, NONINFRINGEMENT, IMPLIED
 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Cypress
 * reserves the right to make changes to the Software without notice. Cypress
 * does not assume any liability arising out of the application or use of the
 * Software or any product or circuit described in the Software. Cypress does
 * not authorize its products for use in any products where a malfunction or
 * failure of the Cypress product may reasonably be expected to result in
 * significant property damage, injury or death ("High Risk Product"). By
 * including Cypress's product in a High Risk Product, the manufacturer
 * of such system or application assumes all risk of such use and in doing
 * so agrees to indemnify Cypress against all liability.
 */

/** @file
 *
 * Bluetooth LE RCU control
 *
 * This file provides definitions and function prototypes for LE remote control
 * device
 *
 */

#ifndef __APP_H__
#define __APP_H__
#include "wiced.h"
#include "wiced_hidd_lib.h"
#include "wiced_platform.h"
#include "wiced_bt_trace.h"
#include "hidd_lib.h"
#include "btstack.h"


/*******************************************************************************
* Types and Defines
*******************************************************************************/
#define BT_LOCAL_NAME "LE RCU"
#define NUM_KEYSCAN_ROWS   3  // Num of Rows in keyscan matrix
#define NUM_KEYSCAN_COLS   7  // Num of Cols in keyscan matrix
#define NUM_MAX_KEY (NUM_KEYSCAN_ROWS*NUM_KEYSCAN_COLS)
#define CONNECT_KEY_INDEX  0  // Use none exist key as a virtual connect key
#define AUDIO_KEY_INDEX    1
#define HOME_KEY_INDEX     13
#define BACK_KEY_INDEX     14
#define MUTE_KEY_INDEX     20

#define CONNECT_INDEX       13 // HOME button hold for 10 sec to enter pairing
#define CONNECT_COMBO       (1<<CONNECT_INDEX)   // CONNECT COMBO BITS
#define CONNECT_COMBO_HOLD_TIME 10               // Hold for 10 sec.

#define LED_RED_IDX         WICED_PLATFORM_LED_1
#define LED_GREEN_IDX       WICED_PLATFORM_LED_2

#define LED_ERROR           LED_RED_IDX
#define LED_LE_LINK         LED_GREEN_IDX

#define LED_DEBUG(n)        hidd_led_blink(LED_RED_IDX, n, 100)
#define LED_AUDIO_ON()      hidd_led_on(LED_RED_IDX)
#define LED_AUDIO_OFF()     hidd_led_off(LED_RED_IDX)
/*******************************************************************************
 * Report ID defines
 ********************************************************************************/
// Input report id
typedef enum {
    RPT_ID_IN_STD_KEY      =0x01,
    RPT_ID_IN_BIT_MAPPED   =0x02,
    RPT_ID_IN_BATTERY      =0x03,
    RPT_ID_IN_MEDIA_KEY    =0x0a,
    RPT_ID_IN_CNT_CTL      =0xcc,
    RPT_ID_IN_AUDIO_DATA   =HIDD_VOICE_REPORT_ID,
    RPT_ID_IN_AUDIO_CTL    =HIDD_VOICE_CTL_REPORT_ID,
    RPT_ID_IN_NOT_USED     =0xff,
    RPT_ID_CLIENT_CHAR_CONF=0xff,
} rpt_id_in_e;

// Output report id
typedef enum {
    RPT_ID_OUT_KB_LED      =0x01,
    RPT_ID_OUT_AUDIO_DATA=HIDD_VOICE_REPORT_ID,
    RPT_ID_OUT_AUDIO_CTL =HIDD_VOICE_CTL_REPORT_ID,
} rpt_id_out_e;

// Feature report id
typedef enum {
    RPT_ID_FEATURE_CNT_CTL =0xcc,
    RPT_ID_FEATURE_AUDIO_DATA=HIDD_VOICE_REPORT_ID,
    RPT_ID_FEATURE_AUDIO_CTL =HIDD_VOICE_CTL_REPORT_ID,
} rpt_id_feature_e;

/*******************************************************************************
 * App queue defines
 ********************************************************************************/
typedef union {
    uint8_t                     type;
    HidEvent                    info;
    HidEventButtonStateChange   button;
    HidEventKey                 key;
    HidEventAny                 any;
    HidEventUserDefine          user;
} app_queue_t;

#define APP_QUEUE_SIZE sizeof(app_queue_t)
#define APP_QUEUE_MAX  44                         // max number of event in queue

/*******************************************************************************
 * Include all components
*******************************************************************************/

#include "battery.h"
#include "ota.h"
#include "bt.h"
#include "key.h"
#include "audio.h"

/*******************************************************************************
 * Function Name: app_setReport
 ********************************************************************************
 * Summary:
 *  This function implements the rxSetReport function defined by
 *  the HID application to handle "Set Report" messages.
 *  This function looks at the report ID and passes the message to the
 *  appropriate handler.
 *
 * Parameters:
 *  reportType -- type of incoming report,  WICED_HID_REPORT_TYPE_INPUT, WICED_HID_REPORT_TYPE_OUTPUT, or WICED_HID_REPORT_TYPE_FEATURE
 *  reportId -- report id
 *  payload -- pointer to data that came along with the set report request after the report ID
 *  payloadSize -- size of the payload excluding the report ID
 *
 * Return:
 *  none
 *
 *******************************************************************************/
void app_setReport(wiced_hidd_report_type_t reportType,
                     uint8_t reportId,
                     void *payload,
                     uint16_t payloadSize);

/*******************************************************************************
 * Function Name: app_queueEvent
 ********************************************************************************
 * Summary:
 *  Queue an event to event queue
 *
 * Parameters:
 *  event -- event to queue
 *
 * Return:
 *  none
 *
 *******************************************************************************/
void app_queueEvent(app_queue_t * event);

/*******************************************************************************
 * Function Name: app_transportStateChangeNotification
 ********************************************************************************
 * Summary:
 *  This function is called when the state of a link is changed.
 *
 * Parameters:
 *  newState new state of the link
 *
 * Return:
 *  none
 *
 *******************************************************************************/
void app_transportStateChangeNotification(uint32_t newState);

/*******************************************************************************
 * Function Name: app_start
 ********************************************************************************
 * Summary: This is application start function. After system initialization is done, when the
 *          Bluetooth management calls with BTM_ENABLED_EVT, this function is called to
 *          start application
 *
 * Parameters:
 *  none
 *
 * Return:
 *  WICED_BT_SUCCESS -- if application initialization is okay and ready to start;
 *                      otherwise, should return the error code defined in wiced_result_t
 *
 *******************************************************************************/
wiced_result_t app_start();

#endif