Configuring the Reader
Resetting to Factory Defaults
The Config class contains all the method related to reader configuration. The ResetFactoryDefaults method informs the reader to set all configurable values to factory defaults.
// Reset to Factory defaults
rfidApi.Config.ResetFactoryDefaults();
GPIO (General Purpose Input and Output)
The set of functions are available for controlling the GPIO ports of the Reader. The number of GPIs and GPOs supported by the reader can be queried from the reader capabilities. In general sensors will be connected to input ports and indicator or lights will be connected to output ports.
GPI (General Purpose Input) Port
The property GPI is the indexer to the GPI ports available in the reader. The specified port can be accessed by passing the index.
IsEnabled property can be used to get the current configuration and state of the specified port number.
The Enable property enables the specified port number. It is possible to register for GPI Port state change notification. Before registering, the interested port must be enabled
// Enable GPI port 1
rfidApi.Config.GPI[1].Enable = true;
GPO (General Purpose Output) Port
The GPO property is the indexer and allows to get or set the current state of the specified output port number.
// Set the state of GPO port 1
rfidApi.Config.GPO[1].PortState = GPOs.GPO_PORT_STATE.TRUE;
Radio Power State Configuration
The property rfidApi.Config.RadioPowerState gets/sets the current power state of the RFID Radio Module whether it is turned ON or OFF.
// gets Radio Power state
RADIO_POWER_STATE radioPowerState = rfidApi.Config.RadioPowerState;
Save LLRP Configuration
The method GetSaveLlrpConfigStatus gets the LLRP configuration saved status from the reader. SaveLlrpConfig method shall be used to save the LLRP configurations in the reader.
Antenna specific configuration
The config class contains the Antennas indexer property (Config.Antennas property). The individual antenna can be accessed and configured using the index.
Configuration
The AntennaProperties is used to set the antenna configuration to individual antenna or all the antennas.
Antenna Configuration
The antenna configuration (SetConfg method) comprises of Receive Sensitivity Index, Transmit Power index, Transmit Frequency Index. These indices refers to the Receive Sensitivity table, Transmit Power table, Frequency Hop table or Fixed Frequency table respectively. These tables are available in Reader capabilities. GetConfig method gets the antenna configuration for the given antenna ID indexer.
RF Configuration
The method SetRfConfig is added to configure antenna RF configuration to individual antenna or all the antennas. This method is similar like SetConfig but includes additional parameters specific pertaining to antenna.
The configuration includes Receive Sensitivity Index, Transmit Power index, Transmit Frequency Index, RF Mode Table index. These indices refer to the Receive Sensitivity table, Transmit Power table, Frequency Hop table or Fixed Frequency table, RF Mode table respectively. These tables are available in Reader capabilities. Also, includes tari, transmit port, receive port and Antenna Stop trigger condition. The stop condition can be ‘n’ number of attempts, duration based. The following code snippet shows configuring the antenna 1’s stop trigger condition to a duration of 400 ms.
Antennas.AntennaRfConfig antRfConfig = rfidApi.Config.Antennas[1].GetRfConfig();
antRfConfig.AntennaStopTriggerConfig.StopTriggerType =
ANTENNA_STOP_TRIGGER_TYPE.ANTENNA_STOP_TRIGGER_TYPE_DURATION_MILLISECS;
antRfConfig.AntennaStopTriggerConfig.AntennaStopConditionValue = 400;
rfidApi.Config.Antennas[1].SetRfConfig(antRfConfig);
Singulation Control
The method GetSingulationControl retrieves the current settings of the singulation control from the reader for the given Antenna ID.
To set the singulation control settings, the SetSingulationControl method will be used. The following settings can be configured:
- Session: Session number to use for inventory operation
- Tag Population: An estimate of the tag population in view of the RF field of the antenna
- Tag Transit Time: An estimate of the time a tag will typically remain in the RF field
- State Aware singulation Action: The action includes the Inventory state and SL flag. The action can be used if only reader supports this capability. The ReaderCapabilities class helps to determine whether state-aware singulation is supported or not.
// Get Singulation Control for the antenna 2
Antennas.SingulationControl singulationControl;
singulationControl = rfidApi.Config.Antennas[2].GetSingulationControl();
// Set Singulation Control for the antenna 1
singulationControl.Session = SESSION.SESSION_S0;
singulationControl.TagPopulation = 30;
singulationControl.Action.PerformStateAwareSingulationAction = true;
singulationControl.Action.SLFlag = SL_FLAG.SL_ALL;
singulationControl.Action.InventoryState = INVENTORY_STATE.INVENTORY_STATE_A;
rfidApi.Config.Antennas[1].SetSingulationControl(
singulationControl);
RF Mode
The reader has one or more set of C1G2 RF mode that the reader is capable of operating. The supported RF mode can be retrieved from RF Mode table using ReaderCapabilities class. The method GetRFMode gets the current index to RF Mode table and the Tari from the reader. SetRFMode method shall be used to change the RF Mode settings in the reader. Properties
The physical antenna properties of the individual antenna can be known by using PhysicalProperties. The property gets the gain and the connectivity status of the specified antenna. GetPhysicalProperties method gets the physical antenna configuration for the given antenna ID indexer