Understanding Wireless Connectivity States (Telnyx API)
When using the Telnyx Wireless Connectivity Logs API, you might encounter different state values representing the status of your wireless SIM sessions. Below is a detailed explanation of each state, including their definitions and trigger points.
Possible State Values & Definitions:
1. Open
Definition: This state occurs when a SIM initiates a new session to connect to a wireless network.
Trigger Points: Occurs immediately after an attached event when a device starts transmitting or receiving data.
2. Attached
Definition: Represents a SIM successfully connecting to the local carrier network. Once attached, the SIM receives an IP address, enabling data sessions.
Trigger Points: Occurs when the SIM successfully registers with the cellular network and can start exchanging data.
3. Closed
Definition: Indicates the data session has ended.
Trigger Points: Can occur due to:
Loss of network coverage.
Device intentionally stopping the session (e.g., IoT device scheduled sessions).
Device switching off or entering airplane mode.
Device disconnecting from the cellular network upon connecting to Wi-Fi.
4. Provisioned
Definition: A newly provisioned SIM remains in this state until it first attaches to a cellular network. It may also appear if the SIM has been transferred from a regular SIM group to a private wireless gateway SIM group.
Trigger Points: Occurs upon initial provisioning or after specific account/SIM group changes.
Frequently Asked Questions (FAQs)
Q1. What triggers the state 'Closed'?
The state 'Closed' triggers when:
Network connectivity is lost.
Device intentionally terminates a data session.
Device is switched off, placed in airplane mode, or moves to Wi-Fi connectivity.
Q2. How can I identify if a device is out of network coverage?
Currently, the API does not explicitly identify devices that lose coverage. However, a lack of "Attached" events indicates the device has not connected to the network. A standard successful connection cycle should be:
Attached → Open → Closed
Q3. What does 'our API' refer to?
"Our API" refers specifically to the Telnyx Wireless Connectivity Logs API that you initially mentioned:
For more detailed technical information, please visit the Telnyx API documentation.