1# Telephony Radio
2
3
4## 概述
5
6为网络搜索模块提供C接口。
7
8**起始版本：** 13
9
10
11## 汇总
12
13
14### 文件
15
16| 名称 | 描述 |
17| -------- | -------- |
18| [telephony_radio.h](telephony__radio_8h.md) | 为SSL/TLS证书链校验模块定义C接口。<br>**引用文件：** \<telephony\/core_service\/telephony_radio.h\> |
19| [telephony_radio_type.h](telephony__radio__type_8h.md) | 定义SSL/TLS证书链校验模块的C接口需要的数据结构。<br>**引用文件：** \<telephony\/core_service\/telephony_radio_type.h\> |
20
21
22### 结构体
23
24| 名称 | 描述 |
25| -------- | -------- |
26| [Telephony_NetworkState](_telephony__network_state.md) | 网络状态结构体。 |
27
28### 宏定义
29
30| 名称                               | 描述 |
31| ---------------------------------- | ---- |
32| **TELEPHONY_MAX_OPERATOR_LEN**     | 64   |
33| **TELEPHONY_MAX_PLMN_NUMERIC_LEN** | 6    |
34
35### 枚举
36
37| 名称 | 描述 |
38| -------- | -------- |
39| [Telephony_RadioResult](#telephony_radioresult) { <br/>TEL_RADIO_SUCCESS = 0,<br />TEL_RADIO_PERMISSION_DENIED = 201,<br />TEL_RADIO_ERR_INVALID_PARAM = 401,<br />TEL_RADIO_ERR_MARSHALLING_FAILED = 8300001,<br />TEL_RADIO_ERR_SERVICE_CONNECTION_FAILED = 8300002,<br />TEL_RADIO_ERR_OPERATION_FAILED = 8300003,<br />} | 错误码类型枚举。 |
40| [Telephony_RegState](#telephony_regstate) {<br />TEL_REG_STATE_NO_SERVICE = 0,<br />TEL_REG_STATE_IN_SERVICE = 1,<br />TEL_REG_STATE_EMERGENCY_CALL_ONLY = 2,<br />TEL_REG_STATE_POWER_OFF = 3,<br />} | 设备的网络注册状态类型。  |
41| [Telephony_RadioTechnology](#telephony_radiotechnology) {<br />TEL_RADIO_TECHNOLOGY_UNKNOWN = 0,<br />TEL_RADIO_TECHNOLOGY_GSM = 1,<br />TEL_RADIO_TECHNOLOGY_1XRTT = 2,<br />TEL_RADIO_TECHNOLOGY_WCDMA = 3,<br />TEL_RADIO_TECHNOLOGY_HSPA = 4,<br />TEL_RADIO_TECHNOLOGY_HSPAP = 5,<br />TEL_RADIO_TECHNOLOGY_TD_SCDMA = 6,<br />TEL_RADIO_TECHNOLOGY_EVDO = 7,<br />TEL_RADIO_TECHNOLOGY_EHRPD = 8,<br />TEL_RADIO_TECHNOLOGY_LTE = 9,<br />TEL_RADIO_TECHNOLOGY_LTE_CA = 10,<br />TEL_RADIO_TECHNOLOGY_IWLAN = 11,<br />TEL_RADIO_TECHNOLOGY_NR = 12,<br />} | 设备的无线接入技术类型。   |
42| [Telephony_NsaState](#telephony_nsastate) {<br />TEL_NSA_STATE_NOT_SUPPORTED = 1,<br />TEL_NSA_STATE_NO_DETECTED = 2,<br />TEL_NSA_STATE_CONNECTED_DETECTED = 3,<br />TEL_NSA_STATE_IDLE_DETECTED = 4,<br />TEL_NSA_STATE_DUAL_CONNECTED = 5,<br />TEL_NSA_STATE_SA_ATTACHED = 6,<br />} | 设备的NSA网络注册状态类型。 |
43
44### 函数
45
46| 名称 | 描述 |
47| -------- | -------- |
48| [OH_Telephony_GetNetworkState](#oh_telephony_getnetworkstate) | 获取网络状态。             |
49| [OH_Telephony_GetNetworkStateForSlot](#oh_telephony_getnetworkstateforslot) | 获取给定卡槽ID的网络状态。 |
50
51## 枚举类型说明
52
53
54### Telephony_RadioResult
55
56```
57enum Telephony_RadioResult
58```
59
60**描述**
61
62错误码类型枚举。
63
64**起始版本：** 13
65
66| 枚举值 | 描述 |
67| -------- | -------- |
68| TEL_RADIO_SUCCESS | 成功。 |
69| TEL_RADIO_PERMISSION_DENIED | 权限错误。 |
70| TEL_RADIO_ERR_INVALID_PARAM | 参数错误。 |
71| TEL_RADIO_ERR_MARSHALLING_FAILED | 编组错误。 |
72| TEL_RADIO_ERR_SERVICE_CONNECTION_FAILED | 连接电话服务错误。 |
73| TEL_RADIO_ERR_OPERATION_FAILED | 操作电话服务错误。 |
74
75
76### Telephony_RegState
77
78```
79enum Telephony_RegState
80```
81**描述**
82 设备的网络注册状态类型。
83
84**起始版本：** 13
85
86| 枚举值 | 描述 |
87| -------- | -------- |
88| TEL_REG_STATE_NO_SERVICE | 设备不能使用任何服务，包括数据业务、短信、通话等。 |
89| TEL_REG_STATE_IN_SERVICE | 设备可以正常使用服务，包括数据业务、短信、通话等。 |
90| TEL_REG_STATE_EMERGENCY_CALL_ONLY | 设备只能使用紧急呼叫业务。 |
91| TEL_REG_STATE_POWER_OFF | 蜂窝无线电已关闭，modem下电，无法和网侧进行通信。 |
92
93### Telephony_RadioTechnology
94
95```
96enum Telephony_RadioTechnology
97```
98
99**描述**
100
101  设备的无线接入技术类型。
102
103**起始版本：** 13
104
105| 枚举值                        | 描述                                                         |
106| ----------------------------- | ------------------------------------------------------------ |
107| TEL_RADIO_TECHNOLOGY_UNKNOWN  | 未知无线接入技术（RAT）。                                    |
108| TEL_RADIO_TECHNOLOGY_GSM      | 无线接入技术GSM（Global System For Mobile Communication）。  |
109| TEL_RADIO_TECHNOLOGY_1XRTT    | 无线接入技术1XRTT（Single-Carrier Radio Transmission Technology）。 |
110| TEL_RADIO_TECHNOLOGY_WCDMA    | 无线接入技术WCDMA（Wideband Code Division Multiple Access）。 |
111| TEL_RADIO_TECHNOLOGY_HSPA     | 无线接入技术HSPA（High Speed Packet Access）。               |
112| TEL_RADIO_TECHNOLOGY_HSPAP    | 无线接入技术HSPAP（High Speed packet access (HSPA+) ）。     |
113| TEL_RADIO_TECHNOLOGY_TD_SCDMA | 无线接入技术TDSCDMA（TimeDivision-Synchronous Code Division Multiple Access）。 |
114| TEL_RADIO_TECHNOLOGY_EVDO     | 无线接入技术EVDO（Evolution Data Only）。                    |
115| TEL_RADIO_TECHNOLOGY_EHRPD    | 无线接入技术EHRPD（Evolved High Rate Package Data）。        |
116| TEL_RADIO_TECHNOLOGY_LTE      | 无线接入技术LTE（Long Term Evolution）。                     |
117| TEL_RADIO_TECHNOLOGY_LTE_CA   | 无线接入技术LTE_CA（Long Term Evolution_Carrier Aggregation）。 |
118| TEL_RADIO_TECHNOLOGY_IWLAN    | 无线接入技术IWLAN（Industrial Wireless LAN）。               |
119| TEL_RADIO_TECHNOLOGY_NR       | 无线接入技术NR（New Radio）。                                |
120
121### Telephony_NsaState
122
123```
124enum Telephony_NsaState
125```
126
127**描述**
128
129设备的NSA网络注册状态类型。
130
131**起始版本：** 13
132
133| 枚举值                           | 描述                                                       |
134| -------------------------------- | ---------------------------------------------------------- |
135| TEL_NSA_STATE_NOT_SUPPORTED      | 设备在不支持NSA的LTE小区下处于空闲状态或连接状态。         |
136| TEL_NSA_STATE_NO_DETECTED        | 在支持NSA但不支持NR覆盖检测的LTE小区下，设备处于空闲状态。 |
137| TEL_NSA_STATE_CONNECTED_DETECTED | 设备在LTE小区下连接到LTE网络支持NSA和NR覆盖检测。          |
138| TEL_NSA_STATE_IDLE_DETECTED      | 支持NSA和NR覆盖检测的LTE小区下设备处于空闲状态。           |
139| TEL_NSA_STATE_DUAL_CONNECTED     | 设备在支持NSA的LTE小区下连接到LTE + NR网络。               |
140| TEL_NSA_STATE_SA_ATTACHED        | 设备在5GC附着时在NG-RAN小区下空闲或连接到NG-RAN小区。      |
141
142## 函数说明
143
144
145### OH_Telephony_GetNetworkState()
146
147```
148Telephony_RadioResult OH_Telephony_GetNetworkState(Telephony_NetworkState * state)
149```
150
151**描述**
152
153获取网络状态。
154
155**系统能力：** SystemCapability.Telephony.CoreService
156
157**起始版本：** 13
158
159**参数:**
160
161| 名称 | 描述 |
162| -------- | -------- |
163| state | 用户接收网络状态信息的结构体。 |
164
165**返回：**
166
1670 - 成功.
168
169201 - 权限错误.
170
171401 - 参数错误.
172
1738300001 -   编组错误.
174
1758300002 -  连接电话服务错误.
176
1778300003 -  操作电话服务错误.
178
179**Permission：**
180
181ohos.permission.GET_NETWORK_INFO
182
183### OH_Telephony_GetNetworkStateForSlot()
184
185```
186Telephony_RadioResult OH_Telephony_GetNetworkStateForSlot(int32_t slotId, Telephony_NetworkState *state)
187```
188
189**描述**
190
191获取给定卡槽ID的网络状态。
192
193**系统能力：** SystemCapability.Telephony.CoreService
194
195**起始版本：** 13
196
197**参数:**
198
199| 名称   | 描述                           |
200| ------ | ------------------------------ |
201| slotId | 卡槽ID                         |
202| state  | 用户接收网络状态信息的结构体。 |
203
204**返回：**
205
2060 - 成功.
207
208201 - 权限错误.
209
210401 - 参数错误.
211
2128300001 -   编组错误.
213
2148300002 -  连接电话服务错误.
215
2168300003 -  操作电话服务错误.
217
218**Permission：**
219
220ohos.permission.GET_NETWORK_INFO