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 | + | - |