Parameter |
Type |
Description |
Example |
API-Version |
Number |
Active Version of the API. Currently ""1"" |
1 |
Type |
Text |
The Model of the Device. Like MDH860, MDH862 etc. |
MDH862 |
Serialnumber |
Number |
The Serialnumber of the Device |
33178620128920 |
Name |
Text |
The Name of the Device, given at your Account |
MyDevice1 |
Firmware |
Text |
The current Firmwareversion on the Device |
2.2.10 |
Date-Time |
Text |
The current Date and Time on the Device |
Fri Apr 1 21:09:34 CEST 2022 |
Modem.xxxx |
|
This item is only available on Device with a Momdem, like 3G or 4G |
|
Modem.State |
Number |
Modem Statemachine
0 = idle state
1 = Turn OFF Modem
2 = Turn ON Modem
4 = Switch SIM Socket if available
5 = Check AT Command
6 = Initialize Modem
7 = Set SIM Pin on the Modem
8 = check for switch sim socket in case of error
9 = Initialize Modem after SIM Pin
10 = Set APN
11 = Wait for registering into network
12 = check for switch sim socket in case of roaming
From 100 to 120 there is Loop
100 = Check network registration
101 = check for switch sim socket in case of roaming
105 = Check GSM level
106 = Check Networktype
110 = Check SMS Receiving Queue
120 = Check SMS Sending Queue
253 = Error State while waiting for SIM card, wait 10 seconds till start at state 1
254 = Error State from any other issue, wait 10 seconds till start at state 1
255 = Error State remaining till Power Reset
|
100 |
Modem.State-Text |
Text |
This will show the corresponding Text to the state number.
1 = "Turn off modem"
2 = "Turn on modem"
6 = "Initialize Modem"
5 = "Check modem response with AT"
7 = "SIM Pin", "SIM Pin required? [Response from the Modem]", "Sending SIM Pin to GSM Modem", "SIM Pin is correct", "The GSM Modem does not require a SIM Pin", "Check SIM Pin counter", "SIM Pin counter is [Count from the modem]"
9 = "Initialize Modem after SIM"
11 = "Check Network"
10 = "Set APN" or "CDMA, no APN needed"
100 = "Check Network"
105 = "Check gsm level"
106 = "Check Network type"
110 = "check SMS memory for pending SMS"
|
""Check Network"" |
Modem.Error |
Text |
Here are the possible Error Textes:
Error Text |
Explanation |
""Set APN to [APN Text]"" |
The APN Name could not be set to the Modem. Check if the APN has some incorrect Characters in its Name |
""1|GSM modem does not powered on!"" |
The internal Modem does not respond to be turned on |
""2:HW shutdown the modem!"" |
The internal Modem could not be turned off |
""Initialize Modem, at+cmee=1"" |
Error while AT Command ""AT+CMEE=1"" |
""Check Pincounter, at#PCT"" |
Error while AT Command ""AT#PCT"" |
""The GSM Modem does not response after a reset."" |
The GSM Modem does not response after a reset |
""There is only one try for the SIM PIN left. The SIM Pin will not be sended."" |
There is only one try for the SIM PIN left. The SIM Pin will not be sended. |
""The SIM Pin was not correct. Please check your SIM Pin on [Network-Modem]"" |
The SIM Pin was not correct. Please check your SIM Pin on [Network-Modem] |
""The GSM Modem requires the SIM PUK. Please enter once the PUK and PIN on [Network-Modem] in this format =[PUK,PIN]"" |
The GSM Modem requires the SIM PUK. Please enter once the PUK and PIN on [Network-Modem] in this format =[PUK,PIN] |
""Error response from sending SIM Pin to GSM Modem: xxxx"" |
Error response from sending SIM Pin to GSM Modem. The response is represented by the xxxx |
""The GSM Modem required a SIM Pin, please configure a SIM Pin on [Modem]"" |
The GSM Modem required a SIM Pin, please configure a SIM Pin on [Modem] |
""The SIM Card is locked by Phone security locks set by client or factory. Response: xxxx""! |
The SIM Card is locked by Phone security locks set by client or factory. Response. The response is represented by the xxxx |
""There is no SIM Card inserted. Please insert a SIM Card"" |
There is no SIM Card inserted. Please insert a SIM Card |
""There is a SIM Card Error occurred. Errornumber [sim_error]"" |
There is a SIM Card Error occurred. The Errornumber is represented by sim_error. |
""Initialize Modem, ats0=0"" |
Error while AT Command ""ats0=0"" |
""Initialize Modem, at+creg=0"" |
Error while AT Command ""at+creg=0"" |
""Initialize Modem, at+cmgf=1"" |
Error while AT Command ""at+cmgf=1"" |
""Initialize Modem, at+cpms=\""ME\"",\""ME\"""" |
Error while AT Command ""at+cpms=\""ME\"",\""ME\"""" |
""Initialize Modem, at+cpms=\""SM\"",\""SM\"",\""SM\"""" |
Error while AT Command ""at+cpms=\""SM\"",\""SM\"",\""SM\"""" |
""Initialize Modem, at+ws46=12"" |
Error while AT Command ""at+ws46=12"" |
""Initialize Modem, AT+CGATT=1"" |
Error while AT Command ""AT+CGATT=1"" |
""Checking network, no response to at+creg?"" |
Error while AT Command ""at+creg?"" |
""Checking GSM level, no response to AT+CSQ"" |
Error while AT Command ""AT+CSQ"" |
""A SMS to $_phonenumlist could not be sent. [$_error]"" |
Error while sending a SMS. The $_phonenumlist represents the Phonenumber and $_error the Errormessage from the Modem |
""Timeout while checking Network in state 100 after $_loop_count tries"" |
Timeout while checking Network in state 100 after 6 or 12 tries, depending on if Mobilconnection is running or not. The Statemashine while be reseted and start from 1. |
|
|
Modem.GSM-Level |
Number |
Received signal strength indication
- 0 - (-113) dBm or less
- 1 - (-111) dBm
- 2..30 - (-109)dBm..(-53)dBm / 2 dBm per step
- 31 - (-51)dBm or greater
- 99 - not known or not detectable
|
24 |
Modem.ID0 |
Text |
Modem response on ATI0 |
332 |
Modem.ID3 |
Text |
Modem response on ATI3 |
Telit |
Modem.IMEI |
Text |
IMEI Number of the Modem |
1234 |
Modem.Provider |
Text |
Provider Information of the registered Network |
Telekom.de |
Modem.Network |
Number |
- 0 = The GSM Modem is not registered. It is NOT searching for a network.
- 1 = The GSM Modem is logged in
- 2 = The GSM Modem is not registered. It is searching for a network
- 3 = The GSM Modem registration was denied
- 4 = Unknown Response from CREG.
- 5 = The GSM Modem is logged in, Roaming
|
|
Modem.Networktype |
Number |
- 0 = GSM
- 1 = GPRS
- 2 = EDGE
- 3 = UMTS
- 4 = HSDPA
- 5 = HSUPA
- 6 = HSDPA/HSUPA
- 7 = HSPA+
- 8 = LTE
|
8 |
Modem.SIM-Error |
Text |
These are the possible Text:
- No Sim card inserted...
- Sim card error: Errortext
- No PIN inserted...
- PUK needed...
- The SIM card is locked by a phone security setting.
- OK
- There is only one try for the SIM PIN left. The SIM Pin will not be sended.
- The SIM Pin was not correct.
- The GSM Modem required a SIM Pin, please configure a SIM Pin.
|
OK |
Modem-SIM-Socket |
|
n.a. |
|
WAN.xxx |
|
This item is only available on Device with a WAN Ethernet Port |
|
WAN.State |
Number |
- 0 = No WAN Cable plugged in or no Link on WAN
- 1 = There is a Link on WAN, but no IP-Address yet
- 2 = There is a Link and IP-Address. All OK
|
2 |
WAN.MAC |
Text |
This is the MAC Address of the WAN Interface |
70:83:D5:16:16:89 |
WAN.IP |
Text |
This is the IP Address of the WAN Interface |
172.25.201.252 |
WAN.Mask |
Text |
This is the Subnet-Mask of the WAN Interface |
255.255.0.0 |
WAN.Gateway |
Text |
This is the Gateway Address of the WAN Interface |
172.25.255.253 |
WAN.DNS |
Text |
This is the DNS Address of the WAN Interface |
172.16.100.1; |
WAN.Proxy |
Text |
This indicates if Proxy is enabled. |
0 |
WAN.Proxy-Addr |
Text |
This is the IP Address and Port of the Proxy-Server |
:8080 |
WLAN.xxx |
|
This item is only available on Device with a WLAN Modem |
|
WLAN.State |
Number |
- 0 = WLAN is disabled
- 1 = WLAN enabled, but not Ready
- 2 = WLAN enabled and Ready
|
2 |
WLAN.MAC |
Text |
This is the MAC Address of the WLAN Interface |
7C:DD:90:6A:ED:40 |
WLAN.IP |
Text |
This is the IP Address of the WLAN Interface |
192.168.3.167 |
WLAN.Mask |
Text |
This is the Subnet-Mask of the WLAN Interface |
255.255.255.0 |
WLAN.Gateway |
Text |
This is the Gateway Address of the WLAN Interface |
192.168.3.1 |
WLAN.DNS |
Text |
This is the DNS Address of the WLAN Interface |
192.168.3.1; |
WLAN.SSID |
Text |
This is the SSID Name of the WLAN Interface (Service Set Identifier. This is the unique name that identifies a wireless network) |
MBCL Hidden |
WLAN.SSID-MAC |
Text |
This is the MAC-Address of the SSID of the WLAN Interface |
80:2A:A8:F7:7E:3E |
WLAN.Bit-Rate |
Number |
This is the Bit-Rate of the WLAN Connection in MBit/s. |
26 |
WLAN.Link-Quality |
Number |
This is the Link-Quality of the WLAN Connection in %. So 0-100% |
64 |
WLAN.Signal-Level |
Number |
This is the Signal-Level of the WLAN Connection in dBm.
Signal Strength |
Quality to Expect |
-30 dBm |
Maximum signal strength, you are probably standing right next to the access point / router. |
-50 dBm |
Anything down to this level can be regarded as excellent signal strength. |
-60 dBm |
This is still good, reliable signal strength. |
-67 dBm |
This is the minimum value for all services that require smooth and reliable data traffic. |
-70 dBm |
The signal is not very strong, but mostly sufficient. |
-80 dBm |
Minimum value required to make a connection. You cannot count on a reliable connection or sufficient signal strength to use services at this level. |
-90 dBm |
It is very unlikely that you will be able to connect or make use of any services with this signal strength. |
|
-75 |
WLAN.Noise-Level |
Number |
This is the Noise-Level of the WLAN Connection in dBm.
The noise level indicates the amount of background noise in your environment.
- If the noise level is too high, it can result in degraded strength and performance for your wireless signal strength.
- Noise level is measured in -dBm format (0 to -100). This is the power ratio in decibels (dB) of the measured power referenced to one milliwatt.
- The closer the value to 0, the greater the noise level.
- Negative values indicate less background noise. For example, -96dBm is a lower noise level than
-20dBm.
|
-79 |
WLAN.Frequency |
Text |
This shows the Frequency of the WLAN Connection. Frequency and used Channel. |
2.462 GHz (Channel 11) |
WLAN.LAN-Network |
Text |
This show the Network-Address of the LAN-Network. |
192.168.0.0 |
WLAN.WLAN-Network |
Text |
This show the Network-Address of the WLAN-Network. This is to check if there are overlapps with LAN and WLAN Networks which can affect issues. |
192.168.3.0 |
IO.xxx |
|
This group shows the configuration and state of the Onboard IO's |
|
IO.Input1-State |
Number |
This is the State of the Input or Output.
|
2 |
IO.Input1-Type |
Text |
This indicates for what function the Input is configured. Here are the possible configurations:
- "Configured for connection" = The Input is configured to Trigger a connection
- "not configured" = The Input is not configured
|
not configured |
IO.Input2-State |
Number |
This is the State of the Input or Output.
|
0 |
IO.Input2-Type |
Text |
This indicates for what function the Input is configured. Here are the possible configurations:
- "Configured for signallevel Low" = The Input is configured to Trigger a Event when LOW
- "Configured for signallevel High" = The Input is configured to Trigger a Event when HIGH
- "not configured" = The Input is not configured
|
not configured |
IO.Input2-Configuration |
Text |
This indicates for what Event the Input is configured. Here are the possible configurations:
- "E-Mail (email), Text: (text)" = Send an Email to (email) with the Text of (text)
- "Reboot" = Reboot the Device
- "SMS (smsnum), Text: (text)" = Send an SMS to (smsnum) with the Text of (text)
- "Portal-SMS (smsnum), Text: (text)" = Send an Portal-SMS to (smsnum) with the Text of (text)
|
|
Internet.xxx |
|
|
|
Internet.State |
Number |
Internet Statemachine
0 = idle state
1 = Initialize
2 = Initiate Internet/WAN/WLAN Connection
3 = Wait for Internet established or WAN plugged in
4 = Internet established and remain in this State and Check Connection (Test-Address!)
5 = Internet established but no Check was configured (no Test-Address or Interval)
50 = No Internet via Cellular and no Check was configured (no Test-Address or Interval)
100 = Reboot Device
110 = Reset Modem
112 = Reset WLAN
250 = Connect Error
251 = Check connection Error
254 = Failover initiate
255 = Switch Device while Failover
|
2 |
Internet.State-Text |
Text |
This will show the corresponding Text to the state number.
- 0 = "not started yet"
- 1 = "will be initialized"
- 2 = "is initializied" or "wait for modem to become ready" depending on the Device
- 3 = "will be established" or "waiting..., Connect when input 1 has High-signal" or "waiting..., Connect when input 1 has High-signal, disconnect at Low-Signal" or "waiting..., Connect when SMS received" or "waiting..., Connect when function key pressed"
- 4 = "is established"
- 5, 50 = "is established, Monitoring is OFF!"
- all other states = "resetting"
|
is established |
Internet.Device |
Text |
This indicates what Interface is active to establish the connection to the Internet.
- "ether" = WAN Interface
- "modem" = 3G/4G Modem
- wlan" = WLAN Interface
|
ether |
Internet.PPP-IP-Local |
Text |
This is the local IP Address of the Modem-Internet Connection the Provider |
|
Internet.PPP-IP-Remote |
Text |
This is the remote IP Address of the Modem-Internet Connection the Provider |
|
Internet.DNS |
Text |
This is the used DNS Server IP Address of the Modem-Internet Connection the Provider |
172.16.100.1; |
Internet.Ping-Test |
Number |
This is the Result of the Test-Address (Monitoring) of the Internet-Connection
- 0 = not started
- 2 = Check passed
- 3 = Check failed
|
2 |
Internet.Ping-Test-Text |
Text |
This is the Test-Address (Monitoring) which is used
|
8.8.8.8 |
Connection.xxx |
|
This group shows the overall state of the connection checks |
|
State |
Number |
This is the state of the Connection Statemachine when checking DNS-Server, NTP-Server and available Ports
- 0 = not started
- 1 = Checks are in progress
- 2 = Checks passed
- 3 = Checks failed or at least one has failed
|
2 |
DNS |
Text |
This is the state of the DNS Server check.
- 0 = not started
- 2 = Check passed
- 3 = Checks failed
- or "Status ignored, Proxy in use"
|
2 |
NTP |
Text |
This is the state of the NTP Server check.
- 0 = not started
- 2 = Check passed
- 3 = Checks failed
- or "Status ignored, Proxy in use"
|
2 |
Port-80 |
Number |
This is the state of the TCP-Port 80 check.
- 0 = not started
- 2 = Check passed
- 3 = Checks failed
|
2 |
Port-443 |
Number |
This is the state of the TCP-Port 443 check.
- 0 = not started
- 2 = Check passed
- 3 = Checks failed
|
2 |
Port-1194 |
Number |
This is the state of the TCP-Port 1194 check.
- 0 = not started
- 2 = Check passed
- 3 = Checks failed
|
2 |
Cloud.xxx |
|
This group shows the overall state of the Cloud Connection |
|
State |
Number |
This is the state of the Cloud Connection.
- 0 = not started
- 1 = Connection in progress
- 2 = Connection established
|
2 |
State-Text |
Text |
This will show the corresponding Text to the state number.
- 0 = "waiting..., Connect when input 1 has High-signal" or "waiting..., Connect when input 1 has High-signal, disconnect at Low-Signal" or "waiting..., Connect when function key pressed" or "waiting..., Connect when SMS received" or "waiting for Internet connection" or "the service is not running" or "not configured"
- 1 = "will be established"
- 2 = "is established"
|
is established |
Cloudserver |
Text |
This ist the DNS Name of the configured Cloud-Server |
rsp-vpn.mbconnect24.net |
CTM-State |
Number |
This is the state of the CTM (Config Transfer Manager)
- 0 = not started
- 1 = CTM in progress
- 2 = CTM passed
- 3 = CTM failed
|
2 |
CTM-State-Text |
Text |
This will show the corresponding Text to the state number.
- 0 = "waiting for Internet connection" or "there is no configuration on the unit and CTM is disabled. Please run setup again!" or "there is no configuration on the unit. Please run CTM again!"
- 1 = "CTM cycle started", "check DNS", "check connectivity", "find host, requesting config", "getting to download config", "config is downloaded", "config is taken over, restarting all services now!", "configuration is valid", "downloading config failed!", "email confirmation from administrator is pending, wait 60seconds for next try"
- 2 = "no config available", CTM is disabled, no configuration download.", "host is not prepared for CTM. It is a old version!"
- 3 = "no connection to host, certificate error", "no connection to host", "a session code is needed!"
|
no config available |
CTM-Error |
Text |
This will show any Error Text coming from the SSL Certification check |
- |
Last-Config |
Text |
This show the Date/Time when the last config update was made. |
08/09/21,14:13:12 |