extns/impl/hal_nxpese.h

/******************************************************************************
 *
 *  Copyright (C) 2018 NXP Semiconductors
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *  http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 ******************************************************************************/
#ifndef ANDROID_HARDWARE_HAL_NXPESE_V1_0_H
#define ANDROID_HARDWARE_HAL_NXPESE_V1_0_H

#define ESE_NXPNFC_HARDWARE_MODULE_ID "ese_nxp.pn54x"
#define MAX_IOCTL_TRANSCEIVE_CMD_LEN 256
#define MAX_IOCTL_TRANSCEIVE_RESP_LEN 256
#define MAX_ATR_INFO_LEN 128
enum {
  HAL_ESE_IOCTL_P61_IDLE_MODE = 0,
  HAL_ESE_IOCTL_P61_WIRED_MODE,
  HAL_ESE_IOCTL_P61_PWR_MODE,
  HAL_ESE_IOCTL_P61_DISABLE_MODE,
  HAL_ESE_IOCTL_P61_ENABLE_MODE,
  HAL_ESE_IOCTL_SET_BOOT_MODE,
  HAL_ESE_IOCTL_GET_CONFIG_INFO,
  HAL_ESE_IOCTL_CHECK_FLASH_REQ,
  HAL_ESE_IOCTL_FW_DWNLD,
  HAL_ESE_IOCTL_FW_MW_VER_CHECK,
  HAL_ESE_IOCTL_DISABLE_HAL_LOG,
  HAL_ESE_IOCTL_NXP_TRANSCEIVE,
  HAL_ESE_IOCTL_P61_GET_ACCESS,
  HAL_ESE_IOCTL_P61_REL_ACCESS,
  HAL_ESE_IOCTL_ESE_CHIP_RST,
  HAL_ESE_IOCTL_REL_SVDD_WAIT,
  HAL_ESE_IOCTL_SET_JCP_DWNLD_ENABLE,
  HAL_ESE_IOCTL_SET_JCP_DWNLD_DISABLE,
  HAL_ESE_IOCTL_SET_ESE_SERVICE_PID,
  HAL_ESE_IOCTL_REL_DWP_WAIT,
  HAL_ESE_IOCTL_GET_FEATURE_LIST,
  HAL_ESE_IOCTL_RF_STATUS_UPDATE
};

enum {
  HAL_NFC_IOCTL_P61_IDLE_MODE = 0,
  HAL_NFC_IOCTL_P61_WIRED_MODE,
  HAL_NFC_IOCTL_P61_PWR_MODE,
  HAL_NFC_IOCTL_P61_DISABLE_MODE,
  HAL_NFC_IOCTL_P61_ENABLE_MODE,
  HAL_NFC_IOCTL_SET_BOOT_MODE,
  HAL_NFC_IOCTL_GET_CONFIG_INFO,
  HAL_NFC_IOCTL_CHECK_FLASH_REQ,
  HAL_NFC_IOCTL_FW_DWNLD,
  HAL_NFC_IOCTL_FW_MW_VER_CHECK,
  HAL_NFC_IOCTL_DISABLE_HAL_LOG,
  HAL_NFC_IOCTL_NCI_TRANSCEIVE,
  HAL_NFC_IOCTL_P61_GET_ACCESS,
  HAL_NFC_IOCTL_P61_REL_ACCESS,
  HAL_NFC_IOCTL_ESE_CHIP_RST,
  HAL_NFC_IOCTL_REL_SVDD_WAIT,
  HAL_NFC_IOCTL_SET_JCP_DWNLD_ENABLE,
  HAL_NFC_IOCTL_SET_JCP_DWNLD_DISABLE,
  HAL_NFC_IOCTL_SET_NFC_SERVICE_PID,
  HAL_NFC_IOCTL_REL_DWP_WAIT,
  HAL_NFC_IOCTL_GET_FEATURE_LIST,
  HAL_NFC_IOCTL_SPI_DWP_SYNC, /*21*/
  HAL_NFC_IOCTL_RF_STATUS_UPDATE,
  HAL_NFC_SET_SPM_PWR,
  HAL_NFC_SET_POWER_SCHEME,
  HAL_NFC_GET_SPM_STATUS,
  HAL_NFC_GET_ESE_ACCESS,
  HAL_NFC_SET_DWNLD_STATUS,
  HAL_NFC_INHIBIT_PWR_CNTRL
};
/*
 * Data structures provided below are used of Hal Ioctl calls
 */
/*
 * ese_nxp_ExtnCmd_t shall contain data for commands used for transceive command
 * in ioctl
 */
typedef struct {
  uint16_t cmd_len;
  uint8_t p_cmd[MAX_IOCTL_TRANSCEIVE_CMD_LEN];
} ese_nxp_ExtnCmd_t;

/*
 * ese_nxp_ExtnRsp_t shall contain response for command sent in transceive
 * command
 */
typedef struct {
  uint16_t rsp_len;
  uint8_t p_rsp[MAX_IOCTL_TRANSCEIVE_RESP_LEN];
} ese_nxp_ExtnRsp_t;
/*
 * InputData_t :ioctl has multiple subcommands
 * Each command has corresponding input data which needs to be populated in this
 */
typedef union {
  uint16_t bootMode;
  uint8_t halType;
  ese_nxp_ExtnCmd_t nxpCmd;
  uint32_t timeoutMilliSec;
  long eseServicePid;
} eseInputData_t;
/*
 * ese_nxp_ExtnInputData_t :Apart from InputData_t, there are context data
 * which is required during callback from stub to proxy.
 * To avoid additional copy of data while propagating from libese to Adaptation
 * and Esestub to nxphal, common structure is used. As a sideeffect, context
 * data is exposed to libese (Not encapsulated).
 */
typedef struct {
  /*context to be used/updated only by users of proxy & stub of Ese.hal
   * i.e, EseAdaptation & hardware/interface/Ese.
   */
  void* context;
  eseInputData_t data;
  uint8_t data_source;
  long level;
} ese_nxp_ExtnInputData_t;

/*
 * outputData_t :ioctl has multiple commands/responses
 * This contains the output types for each ioctl.
 */
typedef union {
  uint32_t status;
  ese_nxp_ExtnRsp_t nxpRsp;
  uint8_t nxpNciAtrInfo[MAX_ATR_INFO_LEN];
  uint32_t p61CurrentState;
  uint16_t fwUpdateInf;
  uint16_t fwDwnldStatus;
  uint16_t fwMwVerStatus;
  uint8_t chipType;
} eseOutputData_t;

/*
 * ese_nxp_ExtnOutputData_t :Apart from outputData_t, there are other
 * information which is required during callback from stub to proxy. For ex
 * (context, result of the operation , type of ioctl which was completed). To
 * avoid additional copy of data while propagating from libese to Adaptation and
 * Esestub to nxphal, common structure is used. As a sideeffect, these data is
 * exposed(Not encapsulated).
 */
typedef struct {
  /*ioctlType, result & context to be used/updated only by users of
   * proxy & stub of Ese.hal.
   * i.e, EseAdaptation & hardware/interface/Ese
   * These fields shall not be used by libese or halimplementation*/
  uint64_t ioctlType;
  uint32_t result;
  void* context;
  eseOutputData_t data;
} ese_nxp_ExtnOutputData_t;

/*
 * ese_nxp_IoctlInOutData_t :data structure for input & output
 * to be sent for ioctl command. input is populated by client/proxy side
 * output is provided from server/stub to client/proxy
 */
typedef struct {
  ese_nxp_ExtnInputData_t inp;
  ese_nxp_ExtnOutputData_t out;
} ese_nxp_IoctlInOutData_t;

#endif  // ANDROID_HARDWARE_HAL_NXPESE_V1_0_H