unleashed-firmware/lib/ST25RFAL002/source/st25r3916/st25r3916_aat.h

/******************************************************************************
  * \attention
  *
  * <h2><center>&copy; COPYRIGHT 2020 STMicroelectronics</center></h2>
  *
  * Licensed under ST MYLIBERTY SOFTWARE LICENSE AGREEMENT (the "License");
  * You may not use this file except in compliance with the License.
  * You may obtain a copy of the License at:
  *
  *        www.st.com/myliberty
  *
  * 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,
  * AND SPECIFICALLY DISCLAIMING THE IMPLIED WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  *
******************************************************************************/

/*
 *      PROJECT:   ST25R3916 firmware
 *      Revision: 
 *      LANGUAGE:  ISO C99
 */

/*! \file st25r3916_aat.h
 *
 *  \author
 *
 *  \brief ST25R3916 Antenna Tuning 
 *
 * The antenna tuning algorithm tries to find the optimal settings for 
 * the AAT_A and AAT_B registers, which are connected to variable capacitors 
 * to tune the antenna matching.
 *
 */

#ifndef ST25R3916_AAT_H
#define ST25R3916_AAT_H

#include "platform.h"
#include "st_errno.h"

/*
******************************************************************************
* GLOBAL DATATYPES
******************************************************************************
*/

/*!
 * struct representing input parameters for the antenna tuning
 */
struct st25r3916AatTuneParams {
    uint8_t aat_a_min; /*!< min value of A cap */
    uint8_t aat_a_max; /*!< max value of A cap */
    uint8_t aat_a_start; /*!< start value of A cap */
    uint8_t aat_a_stepWidth; /*!< increment stepWidth for A cap */
    uint8_t aat_b_min; /*!< min value of B cap */
    uint8_t aat_b_max; /*!< max value of B cap */
    uint8_t aat_b_start; /*!< start value of B cap */
    uint8_t aat_b_stepWidth; /*!< increment stepWidth for B cap */

    uint8_t phaTarget; /*!< target phase */
    uint8_t phaWeight; /*!< weight of target phase */
    uint8_t ampTarget; /*!< target amplitude */
    uint8_t ampWeight; /*!< weight of target amplitude */

    bool doDynamicSteps; /*!< dynamically reduce step size in algo */
    uint8_t measureLimit; /*!< max number of allowed steps/measurements */
};

/*!
 * struct representing out parameters for the antenna tuning
 */
struct st25r3916AatTuneResult {
    uint8_t aat_a; /*!< serial cap after tuning */
    uint8_t aat_b; /*!< parallel cap after tuning */
    uint8_t pha; /*!< phase after tuning */
    uint8_t amp; /*!< amplitude after tuning */
    uint16_t measureCnt; /*!< number of measures performed */
};

/*! 
 *****************************************************************************
 *  \brief  Perform antenna tuning
 *
 *  This function starts an antenna tuning procedure by modifying the serial 
 *  and parallel capacitors of the antenna matching circuit via the AAT_A
 *  and AAT_B registers. 
 *   
 *  \param[in] tuningParams : Input parameters for the tuning algorithm. If NULL
 *                            default values will be used.
 *  \param[out] tuningStatus : Result information of performed tuning. If NULL
 *                             no further information is returned, only registers
 *                             ST25R3916 (AAT_A,B) will be adapted.
 *
 *  \return ERR_IO    : Error during communication.
 *  \return ERR_PARAM : Invalid input parameters
 *  \return ERR_NONE  : No error.
 *
 *****************************************************************************
 */
extern ReturnCode st25r3916AatTune(
    const struct st25r3916AatTuneParams* tuningParams,
    struct st25r3916AatTuneResult* tuningStatus);

#endif /* ST25R3916_AAT_H */