[AIOT] Modem Connectivity Manager Information for IMX8P-IM-A

• OS version table for modem connectivity manager tools:

• You can check the file name of release image to get the verion number:

PE100A_YOCTO_1.0.13_202109150127_UTC_RELEASE: PE100A Yocto 2.5 (sumo), ver = 1.0.13

PE100A_YOCTO-3.2_1.0.5_202203180514_UTC_RELEASE: PE100A Yocto 3.2, ver = 1.0.5

PV100A-2G_YOCTO_1.0.3_202203250606_UTC_RELEASE: PV100A Yocto 2.5 (sumo), ver = 1.0.3

• You can also check the current release version number by cat /etc/os-release and make sure that the SOP or document is correct for your OS version:

sh-4.4# cat /etc/os-release
ID="asus-imx-xwayland"
NAME="NXP i.MX Release Distro"
VERSION="4.14-sumo (sumo)"
VERSION_ID="4.14-sumo"
PRETTY_NAME="NXP i.MX Release Distro 4.14-sumo (sumo)"
BUILD_ID="20210914081706"
BUILD_VERSION="1.0.13_202109140813_UTC_DEBUG"

• LTE SOP for Quectel-CM
• Please be noticed that this guide is only for version listed below:

.

We use Quectel-CM to establish cellular data connection, and also provide additional tool to setup connection settings. With AUTO_CONNECT enabled, your device will execute Quectel-CM with the settings located at /etc/lte/lte.conf after device boot up.

Default settings:

APN=internet
PIN=0000
AUTO_CONNECT=y

• Setup APN:

lte.sh set-apn <apn>

• Setup PIN lock:

lte.sh set-pin <pin>

• Setup Auto-Connect:

lte.sh set-auto <y/n>

• Reset settings to default:

• Execute quectel-CM tool individually:

quectel-CM –s <apn> -p <pin>

• LTE SOP for ModemManager
• Please be noticed that this guide is only for version listed below:

We use modem manager to establish cellular data connection, and also provide additional tool to setup and remain data connection. With AUTO_CONNECT enabled, your device will automatically establish data connection once it registered to the mobiles network.

For modem manager usage and details, please visit http://www.freedesktop.org/wiki/Software/ModemManager/

Default settings:

PIN=0000
AUTO_CONNECT=y

• Setup PIN lock:

lte.sh set-pin <pin>

• Setup Auto-Connect:

lte.sh set-auto <y/n>

• Reset settings to default:

lte.sh reset

• ASUS Connectivity Manager Command Line Interface User Manual
• Introduction

ASUS Connectivity manager is a tool on user space that helps user to establish data connection through modem manager and network manager easily. It also provide features for auto reconnect on cellular network and failover with all network interfaces to ensure that device is always online.

Supported functions:

1. Auto generate cellular network settings based on SIM card info
2. Retrive register status, signal, cell locations, SIM card info from modem
3. Power and flight mode control on modem
4. Failover through different network interfaces
5. Auto connect to cellular network when available

• Usage

The basic ASUS Connectivity manager command pattarn is as followed:

    asus_cmcli [COMMAND] [PARAMS]

Which COMMAND means different function and PARAMS are depanded on what command needs. In addition to termainal, logs will also printed at /var/log/syslog while executing asus_cmcli.

    asus_cmcli get_modems

• Description
  Get the information of modems.
• Return

sh-5.0# asus_cmcli get_modems
Index: 0
Path: /org/freedesktop/ModemManager1/Modem/0
Manufacturer: QUALCOMM INCORPORATED
Name: QUECTEL mobiles Broadband Module
Version: EC25JFAR06A05M4G

    asus_cmcli start

• Description
  Start the cellular network connectivity.
• Return

sh-5.0# asus_cmcli start
no previous settings, create new by sim's mcc mnc
modem detected
check profile with mcc=466 and mnc=92
use connection settings with apn=internet, user=, password=
connecting...

    asus_cmcli stop

• Description
  Stop the cellular network connectivity.
• Return

sh-5.0# asus_cmcli stop
disconnecting Cellular...
Connection 'Cellular' successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/4)

    asus_cmcli power_on

• Description
  Power on the modem.
• Return

sh-5.0# asus_cmcli power_on
modem power state is on
power already on

    asus_cmcli power_off

• Description
  Power off the modem.
• Return

sh-5.0# asus_cmcli power_off
modem power state is on
set modem power state off

    asus_cmcli power_cycle

• Description
  Power off and power on the modem.
• Return

sh-5.0# asus_cmcli power_cycle
modem power state is on
set modem power state off
modem power state is off
reset modem to turn on

    asus_cmcli keepalive [PARAMS]

• Description
  Control the keep alive feature for connecting to cellular network automaticly.
• Parameters

• Return

sh-5.0# asus_cmcli keepalive status
Keepalive status: on
sh-5.0# asus_cmcli keepalive stop
Disable keepalive service
sh-5.0# asus_cmcli keepalive start
Enable keepalive service

    asus_cmcli status

• Description
  Get the status of the cellular network connection and the information of IP.
• Return

sh-5.0# asus_cmcli status
Connected: yes
Interface: wwan0
Apn: internet
Roaming: allowed
IPv4 address: 10.44.15.29
IPv4 gateway: 10.44.15.30
IPv4 mtu: 1500
IPv4 dns: 168.95.1.1 / 168.95.192.1
IPv6 address: --
IPv6 gateway: --
IPv6 mtu: --
IPv6 dns: --

    asus_cmcli attach_status

• Description
  Get the attached status of the modem, including the state of the modem and the access technology that the modem use with, or connection status to carrier’s network.
• Return

sh-5.0# asus_cmcli attach_status
Registration state: connected
Flight mode: off
Radio interface: lte

    asus_cmcli switch_sim [PARAMS]

• Description
  Switch the SIM slot, only available on the device with multiple SIM slots.
• Parameters

• Return

sh-5.0# asus_cmcli switch_sim 1
set sim_id as 1
Completion code = 0x00

    asus_cmcli unlock_pin [PARAMS]

• Description
  Unlock the SIM by PIN code.
• Parameters

• Return

sh-5.0# asus_cmcli unlock_pin 0000
successfully sent PIN code to the SIM

    asus_cmcli set_flight_mode [PARAMS]

• Description
  Turm on or turn off the flight mode.
• Parameters

• Return

sh-5.0# asus_cmcli set_flight_mode off
successfully enabled the modem

    asus_cmcli set_apn [PARAMS]

• Description
  Set APN to the profile.
• Parameters

• Return

sh-5.0# asus_cmcli set_apn internet
modify connection settings with apn=internet

    asus_cmcli set_user [PARAMS]

• Description
  Set user name to the profile.
• Parameters

• Return

sh-5.0# asus_cmcli set_user myUser
modify connection settings with user=myUser

    asus_cmcli set_password [PARAMS]

• Description
  Set password to the profile.
• Parameters

• Return

sh-5.0# asus_cmcli set_password myPassword
modify connection settings with password=myPassword

    asus_cmcli set_ip_type [PARAMS]

• Description
  Set allowed IP type to the profile.
• Parameters

• Return

sh-5.0# asus_cmcli set_ip_type ipv6
modify connection settings with ip type=ipv6

    asus_cmcli get_profile

• Description
  Get the information of the profile.
• Return

sh-5.0# asus_cmcli get_profile
Apn: this.is.apn
User: this.is.user
Password: this.is.password
Ipv4: disabled
Ipv6: auto

    asus_cmcli reset_profile

• Description
  Reset the profile to default value, generated based on carrier’s MCCMNC.
• Return

sh-5.0# asus_cmcli reset_profile
modem detected
check profile with mcc=466 and mnc=92
use connection settings with apn=internet, user=, password=

    asus_cmcli switch_carrier [PARAMS]

• Description
  Switch the register network with the input of the carrier’s MCCMNC.
• Parameters

• Return

sh-5.0# asus_cmcli switch_carrier 55123
disconnecting Cellular...
Connection 'Cellular' successfully deactivated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/1)
successfully registered the modem

    asus_cmcli check_carrier

• Description
  Get the information of the carrier including MCC, MNC, and the name of the carrier.
• Return

sh-5.0# asus_cmcli check_carrier
MCC: 466
MNC: 92
Operator name: Chunghwa

    asus_cmcli iccid

• Description
  Get the Integrate Circuit Card Identity.
• Return

sh-5.0# asus_cmcli iccid
Iccid: 89886920042034712146

    asus_cmcli imsi

• Description
  Get the International mobiles Subscriber Identity.
• Return

sh-5.0# asus_cmcli imsi
Imsi: 466924203471214

    asus_cmcli signal

• Description
  Get the percentage of the signal strength.
• Return

sh-5.0# asus_cmcli signal
Signal strength: 71%

    asus_cmcli signal_adv

• Description
  Get the signal strength of the different measurement.
• Return

sh-5.0# asus_cmcli signal_adv
Evdo rssi: -- dBm
Evdo ecio: -- dBm
Evdo sinr: -- dB
Evdo io: -- dBm
Gsm rssi: -- dBm
Umts rssi: -- dBm
Umts rscp: -- dBm
Umts ecio: -- dBm
Lte rssi: -69.00 dBm
Lte rsrq: -9.00 dB
Lte rsrp: -95.00 dBm
Lte snr: 22.20 dB

    asus_cmcli locations_info

• Description
  Get the information of the cell locations.
• Return

sh-5.0# asus_cmcli locations_info
Operator code: 466
Operator name: 92
locations area code: FFFE
Tracking area code: 2C24
Cell id: 03406935

    asus_cmcli failover set [PARAM1] [PARAM2]

• Description
  Set variables of the failover feature.
• Parameters

• Return

sh-5.0# asus_cmcli failover set status on
sh-5.0# asus_cmcli failover set group wwan0 eth0 wlan0
sh-5.0# asus_cmcli failover show group
wwan0, eth0, wlan0
sh-5.0# asus_cmcli failover show status
on

    asus_cmcli failover show [PARAMS]

• Description
  Get variables of the failover feature.
• Parameters

• Return

sh-5.0# asus_cmcli failover show group
wwan0, eth0, wlan0
sh-5.0# asus_cmcli failover show status
on