10.1.3 Traffic flow template +CGTFT

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Tools: ARFCN - Frequency Conversion for 5G NR/LTE/UMTS/GSM

Table 113: +CGTFT parameter command syntax

Command	Possible Response(s)
+CGTFT=<cid>[,<packet filter identifier>,<evaluation precedence index>[,<remote address and subnet mask>[,<protocol number (ipv4) / next header (ipv6)>[,<local port range>[,<remote port range>[,<ipsec security parameter index (spi)>[,<type of service (tos) (ipv4) and mask / traffic class (ipv6) and mask>[,<flow label (ipv6)>[,<direction>[,<local address and subnet mask>[,<QRI>[,<traffic_segregation>[,<destination MAC address>[,<source MAC address>[,<802.1Q C-TAG VID>[,<802.1Q S-TAG VID>[,<802.1Q C-TAG PCP/DEI>[,<802.1Q S-TAG PCP/DEI>[,<ethertype>]]]]]]]]]]]]]]]]]]]	+CME ERROR: <err>
+CGTFT?	[+CGTFT: <cid>,<packet filter identifier>,<evaluation precedence index>,<remote address and subnet mask>,<protocol number (ipv4) / next header (ipv6)>,<local port range>,<remote port range>,<ipsec security parameter index (spi)>,<type of service (tos) (ipv4) and mask / traffic class (ipv6) and mask>,<flow label (ipv6)>,<direction>,<local address and subnet mask>,<QRI>,<traffic_segregation>,<destination MAC address>,<source MAC address>,<802.1Q C-TAG VID>,<802.1Q S-TAG VID>,<802.1Q C-TAG PCP/DEI>,<802.1Q S-TAG PCP/DEI>,<ethertype>] [<CR><LF>+CGTFT: <cid>,<packet filter identifier>,<evaluation precedence index>,<remote address and subnet mask>,<protocol number (ipv4) / next header (ipv6)>,<local port range>, <remote port range>,<ipsec security parameter index (spi)>,<type of service (tos) (ipv4) and mask / traffic class (ipv6) and mask>,<flow label (ipv6)>,<direction>,<local address and subnet mask>,<QRI>,<traffic_segregation>,<destination MAC address>,<source MAC address>,<802.1Q C-TAG VID>,<802.1Q S-TAG VID>,<802.1Q C-TAG PCP/DEI>,<802.1Q S-TAG PCP/DEI>,<ethertype> […]]
+CGTFT=?	+CGTFT: <PDP_type>,(list of supported <packet filter identifier>s),(list of supported <evaluation precedence index>s),(list of supported <remote address and subnet mask>s),(list of supported <protocol number (ipv4) / next header (ipv6)>s),(list of supported <local port range>s),(list of supported <remote port range>s),(list of supported <ipsec security parameter index (spi)>s),(list of supported <type of service (tos) (ipv4) and mask / traffic class (ipv6) and mask>s),(list of supported <flow label (ipv6)>s),(list of supported <direction>s),(list of supported <local address and subnet mask>s),(range of supported <QRI>s),(list of supported <traffic_segregation>s),(range of supported <destination MAC address>s),(range of supported <source MAC address>s),(range of supported <802.1Q C-TAG VID>s),(range of supported <802.1Q S-TAG VID>s),(range of supported <802.1Q C-TAG PCP/DEI>s),(range of supported <802.1Q S-TAG PCP/DEI>s),(range of supported <ethertype>s) [<CR><LF>+CGTFT: <PDP_type>,(list of supported <packet filter identifier>s),(list of supported <evaluation precedence index>s),(list of supported <remote address and subnet mask>s),(list of supported <protocol number (ipv4) / next header (ipv6)>s),(list of supported <local port range>s),(list of supported <remote port range>s),(list of supported <ipsec security parameter index (spi)>s),(list of supported <type of service (tos) (ipv4) and mask / traffic class (ipv6) and mask>s),(list of supported <flow label (ipv6)>s),(list of supported <direction>s),(list of supported <local address and subnet mask>s),(range of supported <QRI>s),(list of supported <traffic_segregation>s),(range of supported <destination MAC address>s),(range of supported <source MAC address>s),(range of supported <802.1Q C-TAG VID>s),(range of supported <802.1Q S-TAG VID>s),(range of supported <802.1Q C-TAG PCP/DEI>s),(range of supported <802.1Q S-TAG PCP/DEI>s),(range of supported <ethertype>s) […]]
NOTE: The syntax of the AT Set Command is corrected to make the parameter <cid> mandatory. Older versions of the specification had defined the parameter <cid> optional, however the UE behaviour was not defined.

Description

This command allows the TE to specify a Packet Filter – PF for a Traffic Flow Template – TFT that is used in the GGSN and in the Packet GW for routing of packets onto different QoS flows towards the TE. The concept is further described in the 3GPP TS 23.060 [47], 3GPP TS 23.501 [165] and 3GPP TS 24.501 [161]. A TFT consists of from one and up to 16 Packet Filters, each identified by a unique <packet filter identifier>. A Packet Filter also has an <evaluation precedence index> that is unique within all TFTs associated with all PDP contexts that are associated with the same PDP address.

The set command specifies a Packet Filter that is to be added to the TFT stored in the MT and used for the context identified by the (local) context identification parameter, <cid>. The specified TFT will be stored in the GGSN, the Packet GW and UPF only at activation or MS-initiated modification of the related context. Since this is the same parameter that is used in the +CGDCONT and +CGDSCONT commands, the +CGTFT command is effectively an extension to these commands. The Packet Filters consist of a number of parameters, each of which may be set to a separate value.

A special form of the set command, +CGTFT=<cid> causes all of the Packet Filters in the TFT for context number <cid> to become undefined. At any time there may exist only one PDP context with no associated TFT amongst all PDP contexts associated to one PDP address. At an attempt to delete a TFT, which would violate this rule, an ERROR or +CME ERROR response is returned. Extended error responses are enabled by the +CMEE command. Refer clause 9.2 for possible <err> values.

The read command returns the current settings for all Packet Filters for each defined context.

The test command returns values supported as compound values. If the MT supports several PDP types, the parameter value ranges for each PDP type are returned on a separate line. TFTs shall be used for PDP-type IP and PPP only. For PDP-type PPP a TFT is applicable only when IP traffic is carried over PPP. If PPP carries header-compressed IP packets, then a TFT cannot be used.

Defined values

<cid>: integer type. Specifies a particular PDP context definition (see the +CGDCONT and +CGDSCONT commands).

<PDP_type>: string type. Specifies the type of packet data protocol (see the +CGDCONT command).

For the following parameters, see also 3GPP TS 23.060 [47], 3GPP TS 23.501 [165] and 3GPP TS 24.501 [161]:

<packet filter identifier>: integer type. Value range is from 1 to 16.

NOTE: While the numbering of packet filter identifier in this specification ranges from 1 to 16, the numbering of packet filter identifier in 3GPP TS 24.008 [8] ranges from 0 to 15. It is up to MT implementation to perform a mapping between the two value ranges.

<evaluation precedence index>: integer type. The value range is from 0 to 255.

<remote address and subnet mask>: string type. The string is given as dot-separated numeric (0-255) parameters on the form:
"a1.a2.a3.a4.m1.m2.m3.m4" for IPv4 or
"a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16", for IPv6.

When +CGPIAF is supported, its settings can influence the format of this parameter returned with the read form of +CGTFT.

<protocol number (ipv4) / next header (ipv6)>: integer type. Value range is from 0 to 255.

<local port range>: string type. The string is given as dot-separated numeric (0-65535) parameters on the form "f.t".

<remote port range>: string type. The string is given as dot-separated numeric (0-65535) parameters on the form "f.t".

<ipsec security parameter index (spi)>: numeric value in hexadecimal format. The value range is from 00000000 to FFFFFFFF.

<type of service (tos) (ipv4) and mask / traffic class (ipv6) and mask>:
string type. The string is given as dot-separated numeric (0-255) parameters on the form "t.m".

<flow label (ipv6)>: numeric value in hexadecimal format. The value range is from 00000 to FFFFF. Valid for IPv6 only.

<direction>: integer type. Specifies the transmission direction in which the packet filter shall be applied.

0 Pre-Release 7 TFT filter (see 3GPP TS 24.008 [8], table 10.5.162)

Reserved (see 3GPP TS 24.501 [161], table 9.11.4.13.1)

1 Uplink

2 Downlink

3 Bidirectional (Up & Downlink)

<local address and subnet mask>: string type. The string is given as dot-separated numeric (0-255) parameters on the form:
"a1.a2.a3.a4.m1.m2.m3.m4" for IPv4 or
"a1.a2.a3.a4.a5.a6.a7.a8.a9.a10.a11.a12.a13.a14.a15.a16.m1.m2.m3.m4.m5.m6.m7.m8.m9.m10.m11.m12.m13.m14.m15.m16", for IPv6.

When +CGPIAF is supported, its settings can influence the format of this parameter returned with the read form of +CGTFT.

<QRI>: integer type. Identifies the QoS rule, see 3GPP TS 23.501 [165] and 3GPP TS 24.501 [161].

<traffic_segregation>: integer type; indicates to the network whether traffic segregation is requested or not, see 3GPP TS 24.501 [161].

0 traffic segregation is not requested

1 traffic segregation is requested

<destination MAC address>: string type. The string is given as dot-separated numeric (0-255) parameters on the form: "a1.a2.a3.a4.a5.a6".

<source MAC address>: string type. The string is given as dot-separated numeric (0-255) parameters on the form: "a1.a2.a3.a4.a5.a6".

<802.1Q C-TAG VID>: numeric value in hexadecimal format. The value range is from 000 to FFF.

<802.1Q S-TAG VID>: numeric value in hexadecimal format. The value range is from 000 to FFF.

<802.1Q C-TAG PCP/DEI>: numeric value in hexadecimal format. The value range is from 0 to F.

<802.1Q S-TAG PCP/DEI>: numeric value in hexadecimal format. The value range is from 0 to F.

<ethertype>: numeric value in hexadecimal format. The value range is from 0000 to FFFF.

Some of the above listed attributes may coexist in a Packet Filter while others mutually exclude each other, the possible combinations are shown in 3GPP TS 23.060 [47], 3GPP TS 23.501 [165] and 3GPP TS 24.501 [161].

Implementation

Optional.