RFID Scanner

OMD Mobile supports UHF Scanner APIs for the "iDTronic C4 Red" device and several Nordic Id scanning devices, as the "EXA51". The app tries to determine the device, but also offers selection of the "RFID Scan Device" in the app-settings, under "RFID-Settings". Another setting, with the label "RFID Scan Duration", controls the duration of a scan cycle, in milliseconds.

showRFIDIcon
Type Default Value Example Android HTML 5
Boolean false true + +

Enable the RFID scanning icon in the task screen by setting the showRFIDIcon flow preference to true.

For manufacturer- and device-specific settings, profiles can be defined in configuration-wide or resource-specific flow-preferences. The two default profile names for "iDTronic C4 Red" and the supported Nordic devices scanProfileIdTronicC4Red and scanProfileNordicId. The profiles must be defined in XML-format, usually with two levels of elements: Profile and Setting. Examples follow below. Every Setting-element has two mandatory attributes: name and value. Generally, all names and values correspond to related definitions of the manufacturers. See product and API documentations for details, while exceptions are explained below.

scanProfileNordicId
Type Default Value Example Android HTML 5
String (XML) Undefined (see below) + -

<?xml version="1.0" encoding="UTF-8"?>
<Profile name="scanProfileNordicId">
         <Setting name="regionId" value="0" />
         <Setting name="txPower" value="300" />
         <Setting name="linkFreq" value="160000" />
         <Setting name="rxDecoding" value="0" />
         <Setting name="txModulation" value="0" />
         <Setting name="inventoryQ" value="0" />
         <Setting name="inventoryRounds" value="0" />
         <Setting name="inventorySession" value="0" />
         <Setting name="inventoryTarget" value="0" />
         <Setting name="antennaMask" value="3" />
         <Setting name="autotune" value="true" />
</Profile>

Exceptions to Nordic's setting-definitions are:

  • autotune, which here can only be true or false for switching autotune on or off during inventory. In detail, switching it "on" is equal to defining "AutotuneSetup.ATMODE_EN | AutotuneSetup.ATMODE_THEN", while "off" means "AutotuneSetup".ATMODE_OFF".
  • txPower, which here is an integer value of maximum transmission power in [mW]. This is an absolute value, that corresponds to Nordic's steps of the txLevel, which varies from product to product. If the given power value is not supported by the device, the next smaller step will be used instead.

Defaults for Nordic's devices are:

name value API relation
autotune true AutotuneSetup#mode=AutotuneSetup.ATMODE_EN | AutotuneSetup.ATMODE_THEN; AutotuneSetup#thresholddBm = -10
antennaMask 3 2 ^ NurApi.ANTENNAID_1 | 2 ^ NurApi.ANTENNAID_2
inventoryTarget 0 NurApi.INVTARGET_A
inventorySession 0 NurApi.SESSION_S0
inventoryRounds 0 0 ("Automatic")
inventoryQ 0 0 ("Automatic")
txModulation 0 NurApi.TXMODULATION_ASK
rxDecoding 0 NurApi.RXDECODING_FM0
linkFreq 160000 NurApi.LINK_FREQUENCY_160000
regionId 0 NurApi.REGIONID_EU
txLevel 0 0 ("Maximum power for device")
scanProfileIdTronicC4Red
Type Default Value Example Android HTML 5
String (XML) Undefined (see below) + -
<?xml version="1.0" encoding="UTF-8"?>
<Profile name="scanProfileIdTronicC4Red">
         <Setting name="sensitivity" value="3" />
         <Setting name="outputPower" value="26" />
         <Setting name="workArea" value="3" />
</Profile>

Defaults for the iDTronic C4 Red are:

name value API relation
sensitivity 3 UhfManager.SENSITIVE_HIHG
outputPower 26 26 ("26 dBm")
workArea 3 UhfManager.WorkArea_Europe

Apart from these profiles in standard flow-preferences, diverging profiles can be prepared in parallel by a deliberate name. It's strongly recommended to use profile-names derived from the standard names, e.g.:

  • scanProfileNordicId-lowPower
  • scanProfileIdTronicC4Red-mediumSensitivity

The active profile is selected by the flow-preference scanProfileName.

scanProfileName
Type Default Value Example Android HTML 5
String Undefined scanProfileNordicId-lowPower + -

results matching ""

    No results matching ""