100 lines
2.9 KiB
C
100 lines
2.9 KiB
C
|
/**
|
|||
|
|
* @file cm_modem_info.h
|
|||
|
|
* @brief Modem_info接口
|
|||
|
|
* @copyright Copyright © 2021 China Mobile IOT. All rights reserved.
|
|||
|
|
* @author By ZH
|
|||
|
|
* @date 2022/11/18
|
|||
|
|
*
|
|||
|
|
* @defgroup modem modem
|
|||
|
|
* @ingroup DS
|
|||
|
|
* @{
|
|||
|
|
*/
|
|||
|
|
#ifndef __CM_MODEM_INFO_H__
|
|||
|
|
#define __CM_MODEM_INFO_H__
|
|||
|
|
|
|||
|
|
/****************************************************************************
|
|||
|
|
* Included Files
|
|||
|
|
****************************************************************************/
|
|||
|
|
|
|||
|
|
#include <stdint.h>
|
|||
|
|
#include<stdbool.h>
|
|||
|
|
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
#define EXTERN extern "C"
|
|||
|
|
extern "C"
|
|||
|
|
{
|
|||
|
|
#else
|
|||
|
|
#define EXTERN extern
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
/** 无线信息 */
|
|||
|
|
typedef struct
|
|||
|
|
{
|
|||
|
|
uint8_t rat; /**无线接入模式*/
|
|||
|
|
uint16_t rsrp; /**信号接收功率 */
|
|||
|
|
uint16_t rsrq; /**信号接收质量 */
|
|||
|
|
uint16_t rssi; /**信号强度指示 */
|
|||
|
|
uint16_t rxlev; /**信号接收电平 */
|
|||
|
|
uint16_t tx_power; /**最近一次发射功率 */
|
|||
|
|
uint32_t tx_time; /**上行累计发送时长 */
|
|||
|
|
uint32_t rx_time; /**下行累计接收时长 */
|
|||
|
|
uint32_t last_cellid; /**上一次SB1服务小区ID */
|
|||
|
|
uint8_t last_ecl; /**上一次ECL值 */
|
|||
|
|
uint16_t last_snr; /**上一次信噪比 */
|
|||
|
|
uint32_t last_earfcn; /**上一次绝对射频频道编号 */
|
|||
|
|
uint16_t last_pci; /**上一次小区物理ID */
|
|||
|
|
} cm_radio_info_t;
|
|||
|
|
|
|||
|
|
|
|||
|
|
/** 小区信息 */
|
|||
|
|
typedef struct
|
|||
|
|
{
|
|||
|
|
bool primary_cell; /**是否为当前驻留小区 */
|
|||
|
|
uint8_t mcc[8]; /**移动国家代码 */
|
|||
|
|
uint8_t mnc[8]; /**移动网络代码 */
|
|||
|
|
uint32_t earfcn; /**绝对射频频道编号 */
|
|||
|
|
uint8_t earfcn_offset; /**绝对射频频偏 */
|
|||
|
|
uint16_t tac; /**类型分配码 */
|
|||
|
|
uint16_t pci; /**小区物理ID */
|
|||
|
|
uint16_t rsrp; /**信号接收功率 */
|
|||
|
|
uint16_t rsrq; /**信号接收质量 */
|
|||
|
|
uint16_t rssi; /**信号强度指示 */
|
|||
|
|
uint16_t snr; /**信噪比 */
|
|||
|
|
uint32_t bandwidth; /**带宽 */
|
|||
|
|
uint32_t cid; /**小区识别码 */
|
|||
|
|
} cm_cell_info_t;
|
|||
|
|
/**
|
|||
|
|
* @brief 获取模组小区信息
|
|||
|
|
*
|
|||
|
|
* @param [out] cell_info[] 小区信息数组
|
|||
|
|
* @param [in] cell_info_num 欲获取小区信息个数（暂时只支持当前小区信息，该参数无效）
|
|||
|
|
*
|
|||
|
|
* @return
|
|||
|
|
* >= 0 - 实际获取到的小区信息个数 \n
|
|||
|
|
* < 0 - 失败, 返回值为错误码
|
|||
|
|
*
|
|||
|
|
* @details More details
|
|||
|
|
*/
|
|||
|
|
int32_t cm_modem_info_cell(cm_cell_info_t cell_info[], uint16_t cell_info_num);
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @brief 获取模组无线信息
|
|||
|
|
*
|
|||
|
|
* @param [out] radio_info 无线信息
|
|||
|
|
*
|
|||
|
|
* @return
|
|||
|
|
* = 0 - 成功 \n
|
|||
|
|
* < 0 - 失败, 返回值为错误码
|
|||
|
|
*
|
|||
|
|
* @details 该函数无法获取rat，需通过虚拟AT+COPS？获取
|
|||
|
|
*/
|
|||
|
|
int32_t cm_modem_info_radio(cm_radio_info_t *radio_info);
|
|||
|
|
|
|||
|
|
#undef EXTERN
|
|||
|
|
#ifdef __cplusplus
|
|||
|
|
}
|
|||
|
|
#endif
|
|||
|
|
|
|||
|
|
#endif /* __CM_MODEM_H__ */
|
|||
|
|
|
|||
|
|
/** @}*/
|