Use case ON(1)

Use case ON(1) is introduced here.

Syntax:

AT%XMIPIRFFECTRL=<dev_id>,1,n,<act_addr_0><act_data_0><act_addr_n-1><act_data_n-1><k>,
<addr_0>,<addr_1>,<data_0_0><data_1_0>,<freq_0>,...,<data_0_k-1><data_1_k-1><freq_k-1>

The parameters and their defined values are the following:

<n>
The number of activation register address-data pairs. Valid values are 0, 1, 2. If n = 0, act_addr_0/1 and act_data_0/1 must be omitted.
<act_addr_x>
Optional 8-bit address of the first register whose value is set to e.g. activate device. This is written each time RF starts.
<act_data_x>
Optional 8-bit data for the register in <act_addr_x>.
<k>
The number of frequencies in the configuration. Valid values are 0−64. If k = 0, all the following fields must be omitted.
<addr_0>
The 8-bit address of the first register, whose value is changed on the basis of RF frequency.
<addr_1>
The 8-bit address of the other register, whose value is changed on the basis of RF frequency. If addr_1 == addr_0, then only <data_0_x> is written.
<data_0_y>
The 8-bit data for the register in <addr_0>, if frequency is smaller than or equal to <freq_y>.
<data_1_y>
The 8-bit data for the register in <addr_1>, if frequency is smaller than or equal to <freq_y>. Note that data_1_y must be given (e.g. as 0) even if addr_1 == addr_0.
<freq_y>
The frequency in MHz (integer), to which the current RF frequency is compared. If current RF frequency is smaller than or equal to <freq_y>, then <data_0_y> is written to <addr_0> and <data_1_y> is written to <addr_1>. Note that if the RF frequency is greater than <freq_k−1> (the last given frequency), then neither <addr_0> nor <addr_1> is written.

The command below configures the ON use case of <dev_id> = 1 to write activation value 56 to register 28 (<n> = 1):

AT%XMIPIRFFECTRL=1,1,1,28,56,6,1,2,2,3,750,3,8,850,18,9,1000,20,12,1700,35,19,1900,37,25,2200

The command also configures the following frequency table (<k> = 6):

Table 1. Example frequency dependency table for the values for registers <addr_0> and <addr_1>
freq (addr) data_0 (addr_0 = 1) data_1 (addr_1 = 2) Note
750 2 3 Used when RF frequency ≤ 750
850 3 8 Used when RF frequency > 750 and ≤ 850
1000 18 9 Used when RF frequency > 850 and ≤ 1000
1700 20 12 Used when RF frequency > 1000 and ≤ 1700
1900 35 19 Used when RF frequency > 1700 and ≤ 1900
2200 37 25 Used when RF frequency > 1900 and ≤ 2200