The frequency band used by the cell as a 3GPP band identifier
(e.g. B20, n78). See {{bibref|3GPP-TS.38.104|Section 5.2}} for
5G NR bands and {{bibref|3GPP-TS.36.101|Section 5.5}} for LTE bands.
The channel bandwidth for uplink on this cell, measured in
{{units}}. For FDD bands this may differ from
{{param|DownlinkBandwidth}}.
The channel bandwidth for downlink on this cell, measured in
{{units}}. For FDD bands this may differ from
{{param|UplinkBandwidth}}.
The uplink channel number (ARFCN) for this cell, as defined in
{{bibref|3GPP-TS.38.104|Section 5.4.2.1}} for 5G NR and
{{bibref|3GPP-TS.36.101|Section 5.7.3}} for LTE. For TDD bands
the uplink and downlink share the same channel number.
The downlink channel number (ARFCN) for this cell, as defined in
{{bibref|3GPP-TS.38.104|Section 5.4.2.1}} for 5G NR and
{{bibref|3GPP-TS.36.101|Section 5.7.3}} for LTE. For TDD bands
the uplink and downlink share the same channel number.
The Physical Cell Identifier (PCI) of this cell.
Set to {{maxval}} if the PCI is not known or not discoverable.
The number of Physical Resource Blocks currently allocated for
uplink on this cell, as reported by the modem at the time of
read. This is an instantaneous value reflecting the current
scheduling grant, not a time-averaged figure.
The number of Physical Resource Blocks currently allocated for
downlink on this cell, as reported by the modem at the time of
read. This is an instantaneous value reflecting the current
scheduling grant, not a time-averaged figure.
The actual number of MIMO (Multiple-Input Multiple-Output)
spatial layers currently scheduled for uplink on this cell,
i.e. the effective Rank Indicator (RI) as negotiated with the
network at the time of read. This does not represent the maximum
number of layers supported by the device hardware.
The actual number of MIMO (Multiple-Input Multiple-Output)
spatial layers currently scheduled for downlink on this cell,
i.e. the effective Rank Indicator (RI) as negotiated with the
network at the time of read. This does not represent the maximum
number of layers supported by the device hardware.
The Reference Signal Received Power measured in {{units}}.
The Signal-to-Interference-plus-Noise Ratio measured in
{{units}}.
The Received Signal Strength Indicator measured in {{units}}.
The Reference Signal Received Quality measured in {{units}}.
The transmit power of the device on this cell measured in
{{units}}.
This object models cellular interfaces and access points.
Enables or disables roaming.
Current roaming status.
{{numentries}}
Cellular interface table (a stackable interface object as described in
{{bibref|TR-181i2|Section 4.2}}). Each instance of this object models a
cellular modem with a single radio and can reference multiple {{object|.TrustedElements.SIM.}}.
Corresponds to {{enum|GPRS|CurrentAccessTechnology}},
{{enum|UMTS|CurrentAccessTechnology}},
{{enum|LTE|CurrentAccessTechnology}} etc ''ATTACHED'' status
Corresponds to {{enum|GPRS|CurrentAccessTechnology}},
{{enum|UMTS|CurrentAccessTechnology}},
{{enum|LTE|CurrentAccessTechnology}} etc ''DETACHED'' status
International Mobile Station Equipment Identity number, represented
as a 15 digit string (digits 0-9).
Access technologies supported by the interface.
GSM with GPRS
GSM with EDGE
UMTS with High Speed Packet Access (HSPA {{bibref|3GPP-HSPA}})
5G New Radio
Preferred access technology.
Access technology that is currently in use.
Note: The ''Unknown'' value was added in Device:2.20.
List of available networks.
Name of the network which will be used, or {{empty}} if the network
is selected automatically.
The value is {{empty}} if no network is found, or if the network
specified in {{param|NetworkRequested}} is not found.
The received signal strength in {{units}}. The allowed values depend
on {{param|CurrentAccessTechnology}}:
* For {{enum|GPRS|SupportedAccessTechnologies}},
{{enum|EDGE|SupportedAccessTechnologies}} the range is -111
{{units}} to -49 {{units}}
* For {{enum|UMTS|SupportedAccessTechnologies}},
{{enum|UMTSHSPA|SupportedAccessTechnologies}} the range is -117
{{units}} to -54 {{units}}
* For {{enum|LTE|SupportedAccessTechnologies}},
{{enum|NR|SupportedAccessTechnologies}} the range is -117 {{units}}
to -25 {{units}}
Note: An undetectable signal is indicated by the appropriate lower
limit, e.g. -117 {{units}} for LTE.
The Reference Signal Received Power in {{units}} for
{{enum|LTE|SupportedAccessTechnologies}},
{{enum|NR|SupportedAccessTechnologies}} values of
{{param|CurrentAccessTechnology}}:
* The valid range of RSRP values from worst to best is -140 {{units}}
to -44 {{units}}
* Set to {{maxval}} if RSRP is not supported by the current access technology
The Reference Signal Received Quality in {{units}} for
{{enum|LTE|SupportedAccessTechnologies}},
{{enum|NR|SupportedAccessTechnologies}} values of
{{param|CurrentAccessTechnology}}:
* RSRQ is calculated using RSSI and RSRP values using RSRQ =
(N*RSRP)/RSSI where N is the number of resource blocks (bandwidth).
* The valid range of RSRQ values from worst to best is -20 {{units}}
to -3 {{units}}.
* Set to {{maxval}} if RSRQ is not supported by the current access technology.
The current NR mode being used.
NR mode is unknown
NR is operating in standalone mode.
This mode is only valid when the
{{param|SupportedAccessTechnologies}} is equal to
{{enum|NR|SupportedAccessTechnologies}}.
NR is operating in non-standalone mode.
This mode is only valid when the
{{param|SupportedAccessTechnologies}} is equal to
{{enum|NR|SupportedAccessTechnologies}}.
The current maximum attainable data rate upstream (expressed in
{{units}}).
The current maximum attainable data rate downstream (expressed in
{{units}}).
Each list item references a SIM with which the interface is associated.
USIM (Universal Subscriber Identity Module or SIM card) parameters for
the interface.
{{deprecated|2.19|because moved to {{object|.TrustedElements.SIM}}}}
{{obsoleted|2.21}}
{{deleted|2.22}}
The current status of the USIM card.
No card available
Card is available but not verified
Card can be used; either valid PIN was entered, or PIN check is
deactivated
USIM is blocked because the maximum number of invalid PIN
entries was exceeded
An error was detected with the card
International Mobile Subscriber Identity represented as a string with
either 14 or 15 digits (digits 0-9). The first 3 digits are the
mobile country code (MCC), which are followed by the mobile network
code (MNC), either 2 digits (European standard) or 3 digits (North
American standard), followed by the mobile subscription
identification number (MSIN).
Integrated Circuit Card Identifier represented as a string of up to
20 digits (digits 0-9). The number is composed of the following
parts:
* Major industry identifier (MII), 2 fixed digits, 89 for
telecommunication purposes.
* Country code, 1–3 digits, as defined by ITU-T recommendation
{{bibref|ITU-E.164}}.
* identifier, 1–4 digits.
* Individual account identification number. Its length is variable,
but every number under one IIN will have the same length.
* Single check digit calculated from the other digits using the Luhn
algorithm.
For cards using an ICCID according to {{bibref|ITU-E.118}} the
maximum length is 19 Digits, for GSM cards 20 digits.
Mobile Subscriber Integrated Service Digital Network Number, a number
uniquely identifying a subscription in a GSM, UMTS, or LTE mobile
network. {{bibref|ITU-E.164}}
Controls the PIN verification of the USIM card.
Check the PIN with each access to a new network
Check the PIN with first access after (re)boot
Disable the PIN check
Allows the Controller to change the USIM PIN used for SIM card
activation.
The object models SMS (Short Message Service) features.
{{numentries}}
{{numentries}}
Represents a SMS storage location.
Each instance of this object corresponds to a distinct SMS storage area.
Multiple instances of this object may exist,
each representing a different storage type (e.g., SM SIM card, ME device memory).
Specifies the storage location e.g. SM SIM card, ME device memory.
Note: The access type was changed to ''readOnly'' in Device:2.20.1
The maximum number of SMS messages in {{object|Device.Cellular.Interface.{i}.SMS.Message}} that can be stored in Storage.
Indicates whether the SMS Storage is available to receive new messages. {{true}} means that there is storage still available; {{false}} means that the storage is full.
The number of SMS messages in {{object|Device.Cellular.Interface.{i}.SMS.Message}} that the Storage entity has room to store, which can not exceed {{param|Capacity}}.
This object models incoming SMS configuration.
Specifies the memory path where the messages are stored.
Maximum number of incoming SMS messages to be stored.
If the number of incoming messages in {{object|Device.Cellular.Interface.{i}.SMS.Message}}
exceeds CapacityLimit, the oldest incoming messages will be removed automatically to prevent
storage overfilling.
-1 disables automatic messages removal.
This object models outgoing SMS configuration.
Specifies the memory path where the messages are stored.
Maximum number of outgoing SMS messages to be stored.
If the number of outgoing messages in {{object|Device.Cellular.Interface.{i}.SMS.Message}}
exceeds CapacityLimit, the oldest outgoing messages will be removed automatically to prevent
storage overfilling.
-1 disables automatic messages removal.
This object models individual SMS messages, including both received and sent entries.
Phone number of the SMS sender.
Phone number of the SMS receiver.
Indicates the time an incoming SMS was received (when {{param|Status}} is {{enum|Received|Status}})
or when an outgoing SMS was sent (when {{param|Status}} is {{enum|Sent|Status}}).
Text of the SMS message.
Specifies the memory path where the messages are stored.
Indicates the status of the message.
The incoming message has been received, stored successfully, and has been marked as read.
The incoming message has been received and stored successfully.
The outgoing message has been stored and sent successfully.
The outgoing message has been created, but has not been sent yet.
Message status processing error.
Indicates the type of the message.
SMS message with a single receiver.
SMS message with multiple receivers.
Receipt of a SMS message.
Cellular Access Point table. Each entry is identified by an
{{param|APN}} (Access Point Name) that identifies a gateway between the
mobile network and another computer network.
Note: Device 2.19 grouped the APN and Interface keys into one combined key.
Enables or disables the Access Point.
Access Point Name. In 5G, this is conceptually equivalent to the Data Network Name (DNN)
{{bibref|3GPP-TS.23.003|Clause 9A}}.
Note: The description and maximum string length requirements were updated in Device:2.20.1 to be compliant with DNN.
Username used to authenticate the device when making a connection to the
Access Point.
Password used to authenticate the device when making a connection to the
Access Point.
Proxy server IP address.
Proxy server port.
Reference to the interface with which the access point is associated.
This parameter specifies the type of APN being used.
Common values are "default", "mms", "ims", "hipri", ...
The specific values supported may vary depending on the network operator.
If the APN type is not applicable, this parameter may be {{empty}}.
This object models the Carrier Aggregation configuration of the
cellular interface. The current configuration is represented in
{{object|MasterCellGroup}} and {{object|SecondaryCellGroup}}.
Historical configurations are retained in
{{object|MasterCellGroup.History}} and
{{object|SecondaryCellGroup.History}} instances respectively.
When 5G dual connectivity is not active,
{{param|SecondaryCellGroup.CurrentAccessTechnology}} reports
{{enum|NotApplicable|SecondaryCellGroup.CurrentAccessTechnology}}
and the SCG cell counts are 0.
Defines the maximum number of History instances that can be
stored per CellGroup on the device. History retention is
entry-based, not time-based. To determine the time span covered,
inspect the {{param|MasterCellGroup.History.{i}.StartTime}} and
{{param|MasterCellGroup.History.{i}.Duration}} of the oldest
retained entry.
When the maximum is reached, the next History entry will replace
the instance with the oldest {{param|MasterCellGroup.History.{i}.StartTime}}.
Reducing this parameter will cause the implementation to delete
the oldest History instances.
The Master Cell Group (MCG) represents the primary radio connection
for the cellular interface. The MCG is always present and contains
exactly one Primary Cell (PCell) and zero or more Secondary Cells
(SCells). In LTE-only and 5G SA configurations the MCG is the sole
cell group. In dual connectivity configurations such as EN-DC or
NR-DC a Secondary Cell Group is also present.
The radio access technology currently in use by this Master Cell
Group. Allows a controller to determine which radio technology is
carrying traffic on this cell group and to correctly interpret the
band and channel values in the associated cell objects.
Long Term Evolution (4G).
New Radio (5G).
{{numentries}}
{{numentries}}
The Primary Cell (PCell) of the Master Cell Group. The PCell is
always present and handles both control signaling and data traffic.
A Secondary Cell (SCell) of the Master Cell Group. SCells carry
additional data traffic on top of the PCell. Zero or more SCells
may be active at any time.
When {{true}}, this Secondary Cell carries downlink traffic only
and has no uplink component. When {{false}}, the cell carries
both uplink and downlink traffic.
A historical record of a past MCG Carrier Aggregation configuration.
Each instance represents a period during which the MCG configuration
remained unchanged, defined by {{param|StartTime}} and
{{param|Duration}}.
A new History entry is created only when the set of Component
Carriers changes in the UE's RRC Connected state, for example
when the network issues an RRC Reconfiguration that adds or removes
a cell from the configured set. Transient MAC-layer SCell
activations and deactivations do not create new History entries.
The time at which this MCG configuration became active.
The length of time in {{units}} for which this MCG configuration
was active and unchanged.
The radio access technology that was in use by this Master Cell
Group during this historical record. Allows a controller to
correctly interpret the band and channel values in the associated
historical cell objects.
Long Term Evolution (4G).
New Radio (5G).
{{numentries}}
The Primary Cell (PCell) configuration snapshot for this MCG
history record.
A Secondary Cell (SCell) configuration snapshot for this MCG
history record.
When {{true}}, this Secondary Cell carried downlink traffic only
during this historical period.
The Secondary Cell Group (SCG) represents the secondary radio
connection in 5G dual connectivity configurations such as EN-DC
(E-UTRA NR Dual Connectivity) or NR-DC (NR Dual Connectivity).
When dual connectivity is active, the SCG contains exactly one
Primary Secondary Cell (PSCell) and zero or more Secondary Cells.
When dual connectivity is not active,
{{param|CurrentAccessTechnology}} reports
{{enum|NotApplicable|CurrentAccessTechnology}} and
{{param|SecondaryCellNumberOfEntries}} is 0.
The radio access technology currently in use by this Secondary
Cell Group. Allows a controller to determine which radio
technology is carrying traffic on this cell group and to correctly
interpret the band and channel values in the associated cell
objects. Reports {{enum|NotApplicable}} when 5G dual connectivity
is not active.
Long Term Evolution (4G).
New Radio (5G).
5G dual connectivity is not active. The Secondary Cell
Group is not in use and {{param|SecondaryCellNumberOfEntries}}
is 0.
{{numentries}}
{{numentries}}
The Primary Secondary Cell (PSCell) of the Secondary Cell Group.
The PSCell handles data traffic for the SCG.
A Secondary Cell (SCell) of the Secondary Cell Group. Zero or more
SCells may be active at any time.
When {{true}}, this Secondary Cell carries downlink traffic only
and has no uplink component. When {{false}}, the cell carries
both uplink and downlink traffic.
A historical record of a past SCG Carrier Aggregation configuration.
Each instance represents a period during which the SCG configuration
remained unchanged, defined by {{param|StartTime}} and
{{param|Duration}}.
A new History entry is created only when the set of Component
Carriers changes in the UE's RRC Connected state, for example
when the network issues an RRC Reconfiguration that adds or removes
a cell from the configured set. Transient MAC-layer SCell
activations and deactivations do not create new History entries.
The time at which this SCG configuration became active.
The length of time in {{units}} for which this SCG configuration
was active and unchanged.
The radio access technology that was in use by this Secondary
Cell Group during this historical record. Allows a controller to
correctly interpret the band and channel values in the associated
historical cell objects.
Long Term Evolution (4G).
New Radio (5G).
{{numentries}}
The Primary Secondary Cell (PSCell) configuration snapshot for
this SCG history record.
A Secondary Cell (SCell) configuration snapshot for this SCG
history record.
When {{true}}, this Secondary Cell carried downlink traffic only
during this historical period.