新增telephony相关的ndk接口，获取默认主卡ID和网络制式

Signed-off-by: SJH <282229496@qq.com>
Change-Id: I094500f3d3201fd199676a7bcc277973e9693b39

telephony/cellular_data/BUILD.gn

@@ -0,0 +1,29 @@
+# Copyright (c) 2024 Huawei Device Co., Ltd.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import("//build/ohos.gni")
+
+ohos_ndk_library("libtelephony_data") {
+  output_name = "telephony_data"
+  output_extension = "so"
+  ndk_description_file = "./libtelephony_data.json"
+  min_compact_version = "1"
+  system_capability = "SystemCapability.Telephony.CellularData"
+
+  system_capability_headers = [ "telephony/cellular_data/telephony_data.h" ]
+}
+
+ohos_ndk_headers("telephony_data_header") {
+  dest_dir = "$ndk_headers_out_dir/telephony/cellular_data"
+  sources = [ "include/telephony_data.h" ]
+}

telephony/cellular_data/include/telephony_data.h

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2024 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef NATIVE_TELEPHONY_DATA_API_H
+#define NATIVE_TELEPHONY_DATA_API_H
+
+/**
+ * @file telephony_data.h
+ *
+ * @brief Provides C interface for the telephony cellular data.
+ *
+ * @kit TelephonyKit
+ * @syscap SystemCapability.Telephony.CellularData
+ * @library libtelephony_data.so
+ * @since 13
+ */
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+ * @brief Obtains the default cellular data slot id.
+ *
+ * @return the default cellular data slot id (0 for slot 1, 1 for slot 2).
+ * @syscap SystemCapability.Telephony.CellularData
+ * @since 13
+ */
+int32_t OH_Telephony_GetDefaultCellularDataSlotId(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NATIVE_TELEPHONY_DATA_API_H

telephony/cellular_data/libtelephony_data.json

@@ -0,0 +1,6 @@
+[
+    {
+        "first_introduced":"13",
+        "name": "OH_Telephony_GetDefaultCellularDataSlotId"
+    }
+]

telephony/core_service/BUILD.gn

@@ -0,0 +1,35 @@
+# Copyright (c) 2024 Huawei Device Co., Ltd.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import("//build/ohos.gni")
+
+ohos_ndk_library("libtelephony_radio") {
+  output_name = "telephony_radio"
+  output_extension = "so"
+  ndk_description_file = "./libtelephony_radio.json"
+  min_compact_version = "1"
+  system_capability = "SystemCapability.Telephony.CoreService"
+
+  system_capability_headers = [
+    "telephony/core_service/telephony_radio.h",
+    "telephony/core_service/telephony_radio_type.h",
+  ]
+}
+
+ohos_ndk_headers("telephony_radio_header") {
+  dest_dir = "$ndk_headers_out_dir/telephony/core_service"
+  sources = [
+    "include/telephony_radio.h",
+    "include/telephony_radio_type.h",
+  ]
+}

telephony/core_service/include/telephony_radio.h

@@ -0,0 +1,74 @@
+/*
+ * Copyright (c) 2024 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef NATIVE_TELEPHONY_RADIO_API_H
+#define NATIVE_TELEPHONY_RADIO_API_H
+
+/**
+ * @file telephony_radio.h
+ *
+ * @brief Provides C interface for the telephony radio.
+ *
+ * @kit TelephonyKit
+ * @syscap SystemCapability.Telephony.CoreService
+ * @library libtelephony_radio.so
+ * @since 13
+ */
+
+#include "telephony_radio_type.h"
+#include "stdint.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+/**
+ * @brief Obtains the radio network state.
+ *
+ * @param state Pointer to the network state.
+ * @return the result defines in {@link Telephony_RadioResult}.
+ *         {@link TEL_RADIO_SUCCESS} Success.
+ *         {@link TEL_RADIO_PERMISSION_DENIED} Permission denied.
+ *         {@link TEL_RADIO_ERR_MARSHALLING_FAILED} Low probability Marshalling failed, try again later.
+ *         {@link TEL_RADIO_ERR_SERVICE_CONNECTION_FAILED} Unable to connect to telephony service, try again later.
+ *         {@link TEL_RADIO_ERR_OPERATION_FAILED} Operation failed in telephony service, try again later.
+ *         {@link TEL_RADIO_ERR_INVALID_PARAM} Invalid parameter.
+ * @permission ohos.permission.GET_NETWORK_INFO
+ * @syscap SystemCapability.Telephony.CoreService
+ * @since 13
+ */
+Telephony_RadioResult OH_Telephony_GetNetworkState(Telephony_NetworkState *state);
+
+/**
+ * @brief Obtains the radio network state for given slot id.
+ *
+ * @param slotId the number of slot, 0 for card slot 1, 1 for card slot 2.
+ * @param state Pointer to the network state.
+ * @return the result defines in {@link Telephony_RadioResult}.
+ *         {@link TEL_RADIO_SUCCESS} Success.
+ *         {@link TEL_RADIO_PERMISSION_DENIED} Permission denied.
+ *         {@link TEL_RADIO_ERR_MARSHALLING_FAILED} Low probability Marshalling failed, try again later.
+ *         {@link TEL_RADIO_ERR_SERVICE_CONNECTION_FAILED} Unable to connect to telephony service, try again later.
+ *         {@link TEL_RADIO_ERR_OPERATION_FAILED} Operation failed in telephony service, try again later.
+ *         {@link TEL_RADIO_ERR_INVALID_PARAM} Invalid parameter.
+ * @permission ohos.permission.GET_NETWORK_INFO
+ * @syscap SystemCapability.Telephony.CoreService
+ * @since 13
+ */
+Telephony_RadioResult OH_Telephony_GetNetworkStateForSlot(int32_t slotId, Telephony_NetworkState *state);
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NATIVE_TELEPHONY_RADIO_API_H

telephony/core_service/include/telephony_radio_type.h

@@ -0,0 +1,157 @@
+/*
+ * Copyright (c) 2024 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#ifndef NATIVE_TELEPHONY_RADIO_TYPE_H
+#define NATIVE_TELEPHONY_RADIO_TYPE_H
+
+/**
+ * @file telephony_radio_type.h
+ *
+ * @brief Provides the data structures for the C APIs of the the telephony radio.
+ *
+ * @kit TelephonyKit
+ * @syscap SystemCapability.Telephony.CoreService
+ * @library libtelephony_radio.so
+ * @since 13
+ */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#define TELEPHONY_MAX_OPERATOR_LEN 64
+#define TELEPHONY_MAX_PLMN_NUMERIC_LEN 6
+
+/**
+ * @brief Result code.
+ *
+ * @since 13
+ */
+typedef enum {
+    /* @error success */
+    TEL_RADIO_SUCCESS = 0,
+    /* @error permission denied */
+    TEL_RADIO_PERMISSION_DENIED = 201,
+    /* @error invalid parameter */
+    TEL_RADIO_ERR_INVALID_PARAM = 401,
+    /* @error marshalling failed, this is a low probability error, try again later when get this error */
+    TEL_RADIO_ERR_MARSHALLING_FAILED = 8300001,
+    /* @error unable to connect to telephony service, try again later when get this error */
+    TEL_RADIO_ERR_SERVICE_CONNECTION_FAILED = 8300002,
+    /* @error operation failed in telephony service, try again later when get this error */
+    TEL_RADIO_ERR_OPERATION_FAILED = 8300003,
+} Telephony_RadioResult;
+
+/**
+ * @brief network registration status.
+ *
+ * @since 13
+ */
+typedef enum {
+    /* can not use any services */
+    TEL_REG_STATE_NO_SERVICE = 0,
+    /* can use services properly */
+    TEL_REG_STATE_IN_SERVICE = 1,
+    /* can use emergency call only */
+    TEL_REG_STATE_EMERGENCY_CALL_ONLY = 2,
+    /* radio power off */
+    TEL_REG_STATE_POWER_OFF = 3,
+} Telephony_RegState;
+
+/**
+ * @brief radio access technologies.
+ *
+ * @since 13
+ */
+typedef enum {
+    /* Unknown radio technology */
+    TEL_RADIO_TECHNOLOGY_UNKNOWN = 0,
+    /* Global System for Mobile Communication (GSM) */
+    TEL_RADIO_TECHNOLOGY_GSM = 1,
+    /* Single-Carrier Radio Transmission Technology (1XRTT) */
+    TEL_RADIO_TECHNOLOGY_1XRTT = 2,
+    /* Wideband Code Division Multiple Access (WCDMA) */
+    TEL_RADIO_TECHNOLOGY_WCDMA = 3,
+    /* High Speed Packet Access (HSPA) */
+    TEL_RADIO_TECHNOLOGY_HSPA = 4,
+    /* Evolved High Speed Packet Access (HSPA+) */
+    TEL_RADIO_TECHNOLOGY_HSPAP = 5,
+    /* Time Division-Synchronous Code Division Multiple Access(TD-SCDMA) */
+    TEL_RADIO_TECHNOLOGY_TD_SCDMA = 6,
+    /* Evolution-Data Optimized (EVDO) */
+    TEL_RADIO_TECHNOLOGY_EVDO = 7,
+    /* Evolved High Rate Package Data (EHRPD) */
+    TEL_RADIO_TECHNOLOGY_EHRPD = 8,
+    /* Long Term Evolution (LTE) */
+    TEL_RADIO_TECHNOLOGY_LTE = 9,
+    /* Long Term Evolution_Carrier Aggregation (LTE_CA) */
+    TEL_RADIO_TECHNOLOGY_LTE_CA = 10,
+    /* Industrial Wireless LAN (IWLAN) */
+    TEL_RADIO_TECHNOLOGY_IWLAN = 11,
+    /* New Radio (NR) */
+    TEL_RADIO_TECHNOLOGY_NR = 12,
+} Telephony_RadioTechnology;
+
+/**
+ * @brief NSA network state.
+ *
+ * @since 13
+ */
+typedef enum {
+    /* The device is in idle or connected state in an LTE cell that does not support NSA */
+    TEL_NSA_STATE_NOT_SUPPORTED = 1,
+    /* The device is in the idle state in an LTE cell that supports NSA but not NR coverage detection */
+    TEL_NSA_STATE_NO_DETECTED = 2,
+    /* The device is connected to the LTE network in an LTE cell that supports NSA and NR coverage detection */
+    TEL_NSA_STATE_CONNECTED_DETECTED = 3,
+    /* The device is in the idle state in an LTE cell that supports NSA and NR coverage detection */
+    TEL_NSA_STATE_IDLE_DETECTED = 4,
+    /* The device is connected to the LTE/NR network in an LTE cell that supports NSA */
+    TEL_NSA_STATE_DUAL_CONNECTED = 5,
+    /* The device is idle or connected to the NG-RAN cell when being attached to the 5G Core */
+    TEL_NSA_STATE_SA_ATTACHED = 6,
+} Telephony_NsaState;
+
+/**
+ * @brief Network status.
+ *
+ * @since 13
+ */
+typedef struct {
+    /* Long carrier name of the registered network */
+    char longOperatorName_[TELEPHONY_MAX_OPERATOR_LEN];
+    /* Short carrier name of the registered network */
+    char shortOperatorName_[TELEPHONY_MAX_OPERATOR_LEN];
+    /* PLMN code of the registered network */
+    char plmnNumeric_[TELEPHONY_MAX_PLMN_NUMERIC_LEN];
+    /* Whether in roaming */
+    bool isRoaming_;
+    /* Network registration status */
+    Telephony_RegState regState_;
+    /* Radio technology. */
+    Telephony_RadioTechnology cfgTech_;
+    /* NSA state */
+    Telephony_NsaState nsaState_;
+    /* Whether Carrier Aggregation(CA) is active */
+    bool isCaActive_;
+    /* Whether in emergency call only */
+    bool isEmergency_;
+} Telephony_NetworkState;
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // NATIVE_TELEPHONY_RADIO_TYPE_H

telephony/core_service/libtelephony_radio.json

@@ -0,0 +1,10 @@
+[
+    {
+        "first_introduced":"13",
+        "name": "OH_Telephony_GetNetworkState"
+    },
+    {
+        "first_introduced":"13",
+        "name": "OH_Telephony_GetNetworkStateForSlot"
+    }
+]