The set command requests the configuration or status information of the Access Point Name (APN) rate control.
The APN rate control configuration and status changes are available also as +CGEV notifications.
APN rate control is active only when the context is active. An indication of context deactivation, such as +CGEV ME PDN DEACT <cid>, received by a client also indicates that the APN rate control configuration is removed for the context identified by <cid>. If the context is activated again, a new APN rate control configuration is indicated to the client if it is configured by the network.
The network can assign a separate APN rate control for exceptional data called additional APN rate control.
Syntax:
%APNRATECTRL=<mode>[,<cid>]
Response syntax for status query:
%APNRATECTRL: <mode>,<cid>,<status>,<remaining_time>,<exceptional_data_allowed>,<additional_rc_status>,
<additional_rc_remaining_time>
Response syntax for configuration query:
%APNRATECTRL: <mode>,<cid>,<rate>,<time_window>,<exceptional_data_allowed>,<additional_rc_rate>,
<additional_rc_time_window>
The set command parameters and their defined values are the following:
The following command example requests the status of CID 1. APN rate control is configured and blocking uplink data with one minute remaining. Additional APN rate control is not configured for CID 1:
AT%APNRATECTRL=0,1
%APNRATECTRL: 0,1,1,60,0,2,0
OK
The following command example requests the status of CID 1. APN rate control is configured and blocking uplink data with one minute remaining. Additional APN rate control is blocking with two minutes remaining:
AT%APNRATECTRL=0,1
%APNRATECTRL: 0,1,1,60,0,1,120
OK
The following command example requests the status of CID 1. APN rate control is configured and blocking uplink data with one minute remaining. Exceptional data is allowed:
AT%APNRATECTRL=0,1
%APNRATECTRL: 0,1,1,60,1,2,0
OK
The following command example requests the status of CID 1. APN rate control is configured and not blocking uplink data, but if <rate> is exceeded before <additional_remaining_time> is elapsed, also exceptional data is blocked immediately:
AT%APNRATECTRL=0,1
%APNRATECTRL: 0,1,0,0,0,1,180
OK
The following command example requests the status of CID 2. APN rate control is configured and not blocking uplink data. Additional APN rate control is not configured for CID 2:
AT%APNRATECTRL=0,2
%APNRATECTRL: 0,2,0,0,0,2,0
OK
The following command example requests the status of CID 2. APN rate control and additional APN rate control are not configured:
AT%APNRATECTRL=0,2
%APNRATECTRL: 0,2,2,0,0,2,0
OK
The following command example requests APN rate control configurations. APN rate control is configured for CID 1 and 2. Additional APN rate control is not configured:
AT%APNRATECTRL=1
%APNRATECTRL: 1,1,10,180,0,0,0
%APNRATECTRL: 1,2,100,60,0,0,0
OK
The following command example requests APN rate control configurations. APN rate control is configured for CID 1 and 2. Exceptional data is allowed for CID1. Additional configuration for CID2:
AT%APNRATECTRL=1
%APNRATECTRL: 1,1,10,180,1,0,0
%APNRATECTRL: 1,2,100,60,0,400,120
OK
The following command example requests APN rate control configurations. No configurations are active:
AT%APNRATECTRL=1
%APNRATECTRL: 1,0,0,0,0,0,0
OK