tmr_serial_reader.h

Go to the documentation of this file.

/* ex: set tabstop=2 shiftwidth=2 expandtab cindent: */
#ifndef _TMR_SERIAL_READER_H
#define _TMR_SERIAL_READER_H

/*
 * Copyright (c) 2009 ThingMagic, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

#include "tmr_region.h"
#include "tmr_tag_protocol.h"
#include "tmr_serial_transport.h"

#define TMR_SR_MAX_PACKET_SIZE 256

#ifdef  __cplusplus
extern "C" {
#endif

typedef enum TMR_SR_PowerMode
{
  TMR_SR_POWER_MODE_MIN     = 0,
  TMR_SR_POWER_MODE_FULL    = 0,
  TMR_SR_POWER_MODE_MINSAVE = 1,
  TMR_SR_POWER_MODE_MEDSAVE = 2,
  TMR_SR_POWER_MODE_MAXSAVE = 3,
  TMR_SR_POWER_MODE_SLEEP   = 4,
  TMR_SR_POWER_MODE_MAX     = TMR_SR_POWER_MODE_SLEEP,
  TMR_SR_POWER_MODE_INVALID = TMR_SR_POWER_MODE_MAX + 1,
} TMR_SR_PowerMode;

typedef enum TMR_SR_SetProtocolLicenseOption
{
TMR_SR_SET_LICENSE_KEY = 0x01,     
TMR_SR_ERASE_LICENSE_KEY = 0x02, 
}TMR_SR_SetProtocolLicenseOption;

typedef enum TMR_SR_UserConfigOperation
{          
TMR_USERCONFIG_SAVE = 0x01,     
TMR_USERCONFIG_RESTORE = 0x02, 
TMR_USERCONFIG_VERIFY = 0x03,  
TMR_USERCONFIG_CLEAR = 0x04,
TMR_USERCONFIG_SAVE_WITH_READPLAN = 0x05,
}TMR_SR_UserConfigOperation; 

typedef enum TMR_SR_UserConfigCategory
{
TMR_SR_ALL=0x01,   
}TMR_SR_UserConfigCategory;

typedef enum TMR_SR_UserConfigType
{
TMR_SR_FIRMWARE_DEFAULT=0x00,
TMR_SR_CUSTOM_CONFIGURATION=0x01,      
}TMR_SR_UserConfigType;

typedef struct TMR_SR_UserConfigOp
{
  TMR_SR_UserConfigCategory category;
  TMR_SR_UserConfigOperation op;
}TMR_SR_UserConfigOp;

typedef enum TMR_SR_UserMode
{
  TMR_SR_USER_MODE_MIN      = 0,
  TMR_SR_USER_MODE_UNSPEC   = 0,
  TMR_SR_USER_MODE_PRINTER  = 1,
  TMR_SR_USER_MODE_CONVEYOR = 2,
  TMR_SR_USER_MODE_PORTAL   = 3,
  TMR_SR_USER_MODE_HANDHELD = 4,
  TMR_SR_USER_MODE_MAX      = TMR_SR_USER_MODE_HANDHELD,
  TMR_SR_USER_MODE_INVALID  = TMR_SR_USER_MODE_MAX + 1,
}TMR_SR_UserMode;

typedef enum TMR_SR_GEN2_QType
{
  TMR_SR_GEN2_Q_MIN     = 0,
  TMR_SR_GEN2_Q_DYNAMIC = 0,
  TMR_SR_GEN2_Q_STATIC  = 1,
  TMR_SR_GEN2_Q_MAX     = TMR_SR_GEN2_Q_STATIC,
  TMR_SR_GEN2_Q_INVALID = TMR_SR_GEN2_Q_MAX + 1,
} TMR_SR_GEN2_QType;

typedef struct TMR_SR_GEN2_QStatic
{
  uint8_t initialQ;
} TMR_SR_GEN2_QStatic;

typedef struct TMR_SR_GEN2_Q
{
  TMR_SR_GEN2_QType type;
  union
  {
    TMR_SR_GEN2_QStatic staticQ;
  }u;
} TMR_SR_GEN2_Q;


typedef struct TMR_PortValue
{
  uint8_t port;
  int32_t value;
} TMR_PortValue;

typedef struct TMR_PortValueList
{
  TMR_PortValue *list;
  uint8_t max;
  uint8_t len;
} TMR_PortValueList;


typedef struct TMR_AntennaMap
{
  uint8_t antenna;
  uint8_t txPort;
  uint8_t rxPort;
} TMR_AntennaMap;

typedef struct TMR_AntennaMapList
{
  TMR_AntennaMap *list;
  uint8_t max;
  uint8_t len;
} TMR_AntennaMapList;

typedef struct TMR_SR_VersionInfo
{
  uint8_t bootloader[4];
  uint8_t hardware[4];
  uint8_t fwDate[4];
  uint8_t fwVersion[4];
  uint32_t protocols;
} TMR_SR_VersionInfo;

typedef enum TMR_TransportType
{
  /* Serial */
  TMR_SR_MSG_SOURCE_SERIAL = 0x0000,
  /* USB */
  TMR_SR_MSG_SOURCE_USB = 0x0003,
  /* Unknown */
  TMR_SR_MSG_SOURCE_UNKNOWN = 0x0004,
}TMR_TransportType;

typedef struct TM_SR_SerialReader
{
  /* Serial transport information */
  TMR_SR_SerialTransport transport;
  union
  {
#ifdef TMR_ENABLE_SERIAL_TRANSPORT_NATIVE
    TMR_SR_SerialPortNativeContext nativeContext;
#endif
  } transportContext;

  /* User-configurable values */
  uint32_t baudRate;
  TMR_AntennaMapList *txRxMap;
  TMR_GEN2_Password gen2AccessPassword;
  uint32_t transportTimeout;
  uint32_t commandTimeout;
  TMR_Region regionId;

  /* Static storage for the default map */
  TMR_AntennaMap staticTxRxMapData[TMR_SR_MAX_ANTENNA_PORTS];
  TMR_AntennaMapList staticTxRxMap;

  /* Mostly-fixed information about the connected reader */
  TMR_SR_VersionInfo versionInfo;
  uint32_t portMask;

  /* Option to enable or disable the pre-amble */
  bool supportsPreamble;

  /* Cache extendedEPC setting */
  bool extendedEPC;

  /* Cached values */
  TMR_SR_PowerMode powerMode;
  TMR_TagProtocol currentProtocol;
  int8_t gpioDirections;

  /* Large bitmask that stores whether each parameter's presence
   * is known or not.
   */
  uint32_t paramConfirmed[TMR_PARAMWORDS];
  /* Large bitmask that, if the corresponding bit in paramConfirmed is set,
   * stores whether each parameter is present or not.
   */
  uint32_t paramPresent[TMR_PARAMWORDS];

  /* Temporary storage during a read and subsequent fetch of tags */
  uint32_t readTimeLow, readTimeHigh;
  uint32_t lastSentTagTimestampHigh, lastSentTagTimestampLow;
  uint32_t searchTimeoutMs;
  
  /* Number of tags reported by module read command.
   * In streaming mode, exact quantity is unknown, so use
   * 0 if stream has ended, non-zero if end-of-stream has
   * not yet been detected. */
  int tagsRemaining;
  /* Buffer tag records fetched from module but not yet passed to caller. */
  uint8_t bufResponse[TMR_SR_MAX_PACKET_SIZE];
  /* bufResopnse read index */
  uint8_t bufPointer;
  /* Number of tag records in buffer but not yet passed to caller */
  uint8_t tagsRemainingInBuffer;
  /*TMR opCode*/
  uint8_t opCode;
  /*Gen2 Q Value from previous tagop */
  TMR_SR_GEN2_Q oldQ;
  /*Gen2 WriteMode*/
  TMR_GEN2_WriteMode writeMode;
  /* Buffer to store additional error message */
  char errMsg[TMR_SR_MAX_PACKET_SIZE];
  /* Product group id */
  uint16_t productId;
  /* Tag operation success count */
  uint16_t tagopSuccessCount;
  /* Tag operation failure count */
  uint16_t tagopFailureCount;
  /* Enable read filtering */
  bool enableReadFiltering;
  /* Read filter timeout */
  int32_t readFilterTimeout;
  /* Option to use the user specified transportTimeout */
  bool usrTimeoutEnable;
  /* Enable CRC calculation */
  bool crcEnabled;
  /* TransportType */
  TMR_TransportType transportType;
  /* Option for Gen2 all memory bank read */
  bool gen2AllMemoryBankEnabled;
  /* option for Gen2 Bap parameter */
  bool isBapEnabled;
  /* baud rates to be used for serial communication */
  TMR_uint32List probeBaudRates;
  /* storage for the probe baud rates */
  uint32_t baudRates[TMR_MAX_PROBE_BAUDRATE_LENGTH];
  /* Flag to be raised when Autonomous read is requested */
  bool enableAutonomousRead;
  /* The flag to be used in case of tag reading */
  bool isBasetimeUpdated;
} TMR_SR_SerialReader;

typedef struct TMR_SR_ReaderStatistics
{
  uint8_t numPorts;
  uint32_t rfOnTime[TMR_SR_MAX_ANTENNA_PORTS];
  uint32_t noiseFloor[TMR_SR_MAX_ANTENNA_PORTS];
  uint32_t noiseFloorTxOn[TMR_SR_MAX_ANTENNA_PORTS];
}TMR_SR_ReaderStatistics;

typedef struct TMR_SR_AntennaStatusReport
{
  uint8_t ant;
}TMR_SR_AntennaStatusReport;

typedef struct TMR_SR_FrequencyStatusReport
{
  uint32_t freq;
}TMR_SR_FrequencyStatusReport;

typedef struct TMR_SR_TemperatureStatusReport
{
  int8_t temp;
}TMR_SR_TemperatureStatusReport;

typedef enum TMR_SR_StatusType
{
  /* None */
  TMR_SR_STATUS_NONE = 0x0000,
  /* Frequency */
  TMR_SR_STATUS_FREQUENCY = 0x0002,
  /* Temperature */
  TMR_SR_STATUS_TEMPERATURE = 0x0004,
  /* Current Antenna Ports */
  TMR_SR_STATUS_ANTENNA = 0x0008,
  /* All */
  TMR_SR_STATUS_ALL = 0x000E,
  TMR_SR_STATUS_MAX = 4,
}TMR_SR_StatusType;

typedef struct TMR_SR_StatusReport
{
  TMR_SR_StatusType type;
  union
  {
    TMR_SR_AntennaStatusReport asr;
    TMR_SR_FrequencyStatusReport fsr;
    TMR_SR_TemperatureStatusReport tsr;
  } u;
}TMR_SR_StatusReport;


TMR_Status TMR_SR_connect(struct TMR_Reader *reader);
TMR_Status TMR_SR_destroy(struct TMR_Reader *reader);
TMR_Status TMR_SR_read(struct TMR_Reader *reader, uint32_t timeoutMs, int32_t *tagCount);
TMR_Status TMR_SR_hasMoreTags(struct TMR_Reader *reader);
TMR_Status TMR_SR_getNextTag(struct TMR_Reader *reader, TMR_TagReadData *read);
TMR_Status TMR_SR_executeTagOp(struct TMR_Reader *reader, TMR_TagOp *tagop, TMR_TagFilter *filter, TMR_uint8List *data);
TMR_Status TMR_SR_writeTag(struct TMR_Reader *reader, const TMR_TagFilter *filter, const TMR_TagData *data);
TMR_Status TMR_SR_killTag(struct TMR_Reader *reader, const TMR_TagFilter *filter, const TMR_TagAuthentication *auth);
TMR_Status TMR_SR_lockTag(struct TMR_Reader *reader, const TMR_TagFilter *filter, TMR_TagLockAction *action);
TMR_Status TMR_SR_readTagMemBytes(struct TMR_Reader *reader, const TMR_TagFilter *filter,
                              uint32_t bank, uint32_t address,
                              uint16_t count, uint8_t data[]);
TMR_Status TMR_SR_readTagMemWords(struct TMR_Reader *reader, const TMR_TagFilter *filter,
                              uint32_t bank, uint32_t address,
                              uint16_t count, uint16_t *data);
TMR_Status TMR_SR_writeTagMemBytes(struct TMR_Reader *reader, const TMR_TagFilter *filter,
                               uint32_t bank, uint32_t address,
                               uint16_t count, const uint8_t data[]);
TMR_Status TMR_SR_writeTagMemWords(struct TMR_Reader *reader, const TMR_TagFilter *filter,
                               uint32_t bank, uint32_t address,
                               uint16_t count, const uint16_t data[]);
TMR_Status TMR_SR_gpoSet(struct TMR_Reader *reader, uint8_t count, const TMR_GpioPin state[]);
TMR_Status TMR_SR_gpiGet(struct TMR_Reader *reader, uint8_t *count, TMR_GpioPin state[]);
TMR_Status TMR_SR_firmwareLoad(TMR_Reader *reader, void *cookie,
                               TMR_FirmwareDataProvider provider);
TMR_Status TMR_SR_modifyFlash(TMR_Reader *reader, uint8_t sector, uint32_t address,uint32_t password,
                              uint8_t length, const uint8_t data[], uint32_t offset);
TMR_Status TMR_init_UserConfigOp(TMR_SR_UserConfigOp *config, TMR_SR_UserConfigOperation op);
TMR_Status TMR_SR_reboot(struct TMR_Reader *reader);

TMR_Status TMR_SR_SerialReader_init(TMR_Reader *reader);

#ifdef __cplusplus
}
#endif

#endif /* _TMR_SERIAL_READER_H */