Change APN Config¶
Function: 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.
The step writes the new settings to PDP context 1, then cycles airplane mode for about 3 seconds so that the modem registers again. It passes as soon as the APN is written; whether the modem registers again is only reported in the log. To verify the connection, add an IS_ATTACHED, PING or SPEED_TEST step afterwards.
Supported on: MCM only.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
| APN_NAME | The name of the APN to configure. | internet, wap, data.operator.com | No | |
| PROTOCOL | The IP protocol type for the APN connection. | IPv4, IPv6, IPv4v6 |
No | IPv4 |
| 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 |
No | NONE |
| TIMEOUT | Maximum time in seconds to wait for network re-registration after the APN change before the result is written to the log. It does not decide pass or fail. Whole seconds, 0-3700. | 30, 60, 120 | Yes | |
| EXPECT | The expected result of the APN configuration change. SUCCESS when the new APN settings are written, FAIL when writing them should fail. |
SUCCESS, FAIL |
Yes | SUCCESS |
API payloads
Send every key, with an empty string for a value you do not use (for example "USERNAME": ""). The step editor does this for you.
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. The outcome is logged; it does not fail the step.
- EXPECT: Defines the expected outcome.
SUCCESSmeans the new APN settings were written to the modem.