Change APN Config¶
The CHANGE_APN_CONFIG function allows the user to change the APN (Access Point Name) configuration on an MCM device. This function is essential for configuring data connection settings when switching between different mobile network operators or data plans.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| APN_NAME | The name of the APN to configure. | internet, wap, data.operator.com | Yes | |
| PROTOCOL | The IP protocol type for the APN connection. | IP, IPV6, IPV4V6 | Yes | |
| USERNAME | The username for APN authentication. Leave empty if not required. | user123 | No | |
| PASSWORD | The password for APN authentication. Leave empty if not required. | pass456 | No | |
| AUTHENTICATION | The authentication method for the APN. | NONE, PAP, CHAP, PAP_OR_CHAP | Yes | |
| TIMEOUT | Maximum time in seconds to wait for network re-registration after APN change. | 30, 60, 120 | Yes | |
| EXPECT | The expected result of the APN configuration change. If the change is successful and device re-registers, it returns SUCCESS. If the change fails or registration times out, it returns FAILURE. | SUCCESS, FAILURE | Yes | SUCCESS |
Explanation of Fields¶
- APN_NAME: The access point name provided by your mobile network operator for data connectivity.
- PROTOCOL: Specifies whether to use IPv4, IPv6, or dual-stack (both) connectivity.
- USERNAME: Username for APN authentication if required by the operator (optional).
- PASSWORD: Password for APN authentication if required by the operator (optional).
- AUTHENTICATION: The authentication protocol to use (NONE for no auth, PAP/CHAP for secure auth).
- TIMEOUT: How long to wait for the device to re-register on the network after applying APN changes.
- EXPECT: Defines the expected outcome.
SUCCESSmeans APN was changed and device re-registered successfully.