nrf9160

Packet domain event notification +CGEV

Unsolicited packet domain notifications are sent when the device is detached from the network or when a packet data connection is activated, deactivated, or modified.v1.0.xv1.1.xv1.2.xv1.3.x

For reference, see 3GPP 27.007 Ch. 10.1.19.

These notifications are subscribed using the +CGEREP command.

Syntax descriptions are as follows:

Network detach. All active contexts are deactivated. The deactivation of individual contexts is not reported separately:

+CGEV: NW DETACH

Mobile Equipment (ME) detach:

+CGEV: ME DETACH

ME overheated and flight mode enabled:

+CGEV: ME OVERHEATED

Battery voltage is low:

+CGEV: ME BATTERY LOW

The ME has activated a default bearer:

+CGEV: ME PDN ACT <cid>[,<reason>]

The network has activated a dedicated bearer:

+CGEV: NW ACT <p_cid>,<cid>,<event_type>

The network has deactivated a default bearer:

+CGEV: NW PDN DEACT <cid>

The User Equipment (UE) has deactivated a default bearer:

+CGEV: ME PDN DEACT <cid>

The network has deactivated a dedicated bearer:

+CGEV: NW DEACT <p_cid>,<cid>,<event_type>

The UE has deactivated a dedicated bearer:

+CGEV: ME DEACT <p_cid>,<cid>,<event_type>

The network has modified a bearer:

+CGEV: NW MODIFY <cid>,<change_reason>,<event_type>

The UE has modified a bearer:

+CGEV: ME MODIFY <cid>,<change_reason>,<event_type>

IPv6 link is up for the default bearer:

+CGEV: IPV6 <cid>

IPv6 address resolution or refresh failure:

+CGEV: IPV6 FAIL <cid>

Requested procedure restricted:v1.1.xv1.2.x

+CGEV: RESTR <cause>,<validity>

Configuration of Access Point Name (APN) rate control:v1.3.x≥1

+CGEV: APNRATECTRL CFG <cid>,<number_of_packets>,<time_window>

Status of APN rate control:v1.3.x≥1

+CGEV: APNRATECTRL STAT <cid>,<status>[,<remaining_time>]
<cid>
Integer, 0–10.
<reason>
0 – Only IPv4 allowed
1 – Only IPv6 allowed
2 – Only single access bearers allowed
3 – Only single access bearers allowed and context activation for a second address type bearer was not successful.
<change_reason>
Integer. A bitmap that indicates what kind of change has occurred. The <change_reason> value is determined by adding together all the applicable bits.
Bit 1 – TFT changed
Bit 2 – Quality of Service (QoS) changed
Bit 3 – WLAN offload changed
<cid_other>
Integer, 0–10. Indicates the context identifier allocated for an Mobile Termination (MT)-initiated context of a second address type. This parameter is included only if the <reason> parameter indicates that only single address bearers are allowed.
<p_cid>
Integer, 0–10. Context identifier for an associated default context.
<event_type>
0 – Informational event
1 – Information request. Acknowledgement is required, and it can be either accept or reject.
<cause>
Restriction cause
1 – Radio Policy Manager (RPM). Procedure restricted by RPM.
2 – Throttling. Procedure restricted by 3GPP or operator-specific throttling.
3 – Invalid configuration. Procedure restricted by invalid context configuration.
<validity>
Validity of restriction
1 – Permanent restriction. Enabling requires a power-off, Universal Integrated Circuit Card (UICC) change, or a configuration change.
2 – Temporary restriction. Enabling requires, for example, back-off timer expiry.
<number_of_packets>v1.3.x≥1
0–16 777 215 – Number of data packets that the UE is allowed to send during the time period indicated in <time_window>.
Values 0,0 of <number_of_packets>,<time_window> indicate that APN rate control is not configured.
<time_window>v1.3.x≥1
60–604 800 – Time window in seconds (1 minute to 1 week).
<status>v1.3.x≥1
0 – OFF. APN rate control does not block uplink data.
1 – ON. APN rate control blocks uplink data.
<remaining_time>v1.3.x≥1
0–604 800 – Remaining uplink data blocking time in seconds when status is 1. Can be 0 if less than a full second remains.

The following notification example shows that an initial Packet Data Network (PDN) connection is activated:

+CGEV: ME PDN ACT 0

The following notification example shows that the device is detached from network:

+CGEV: ME DETACH

The following notification example shows a restriction caused by throttling with temporary validity.

+CGEV: RESTR 2,2