API
Obtain the result of discovered cellular network.
The API will always return fail when the WAN connection is not support carrier scan.
Available in 8.0.1 or later
Input Parameters
| Type | Notation | Mandatory | Description | |
| connId | Number | <conn_id> | require | Specify which WAN connection ID is wanted to scan cellular network |
| reference | String | <yes,no> | require | The cellular network which is wanted to select |
Return Parameters
Return JSON
| Type | Notation | Description | |
| scanStatus | String | { scanning, done } | Report the scanning status |
| timestamp | Number | <integer> | Timestamp of the carrier list |
| list | Array | list of <Scan_Carrier_Obj> | List of discovered carrier |
| reference | Object | <Reference_Obj> | Current configuration |
<Scan_Carrier_Obj>
| Type | Notation | Description | |
| name | String | <string> | Name of the carrier |
| mobileType | String | { 2G, 3G, LTE } | – |
| mcc | String | 3 digits <string> | Mobile Country Code |
| mnc | String | 2-3 digits <string> | Mobile Network Code |
| pcs | Number | [ 0, 1 ] | – |
<Reference_Obj>
| Type | Notation | Description | |
| activeSim | Object NULL | <In_Use_SIM_Obj> NULL | Active SIM information. If there is no active SIM, this value is JSON NULL |
<In_Use_SIM_Obj>
| Type | Notation | Description | |
| simId | Number | {1,2} | SIM ID of the active SIM |
| selectedCarrier | Object NULL | <Carrier_Obj> NULL | The selected network If is it auto, this value is JSON NULL. |
<Carrier_Obj>
| Type | Notation | Description | |
| name | String | <string> | Name of the carrier |
| mcc | String | 3 digits <string> | – |
| mnc | String | 2-3 digits <string> | – |
| pcs | Number | [ 0, 1 ] | – |
cURL Example
curl -b cookies.txt http://192.168.1.1/api/cmd.carrier.scan?connId=4&reference=yes
{
"stat": "ok",
"response": {
"scanStatus": "scanning",
"list": [
{
"name": ".csl",
"mobileType": "LTE",
"mcc": "454",
"mnc": "0",
"pcs": 0
},
{
"name": "SMT HK",
"mobileType": "LTE",
"mcc": "454",
"mnc": "6",
"pcs": 0
}
],
"reference": {
"activeSim": {
"simId": 1,
"cellularNetwork": null
}
}
}
}