结构体
struct	luat_mobile_gsm_service_cell_info

struct	luat_mobile_gsm_cell_info

struct	luat_mobile_lte_service_cell_info

struct	luat_mobile_lte_cell_info

struct	luat_mobile_cell_info

struct	luat_mobile_gw_signal_strength_info

struct	luat_mobile_lte_signal_strength_info

struct	luat_mobile_signal_strength_info

宏定义
#define	LUAT_MOBILE_CELL_MAX_NUM 21

类型定义
typedef enum LUAT_MOBILE_SIM_PIN_OP	LUAT_MOBILE_SIM_PIN_OP_E

typedef struct luat_mobile_gsm_service_cell_info	luat_mobile_gsm_service_cell_info_t

typedef struct luat_mobile_gsm_cell_info	luat_mobile_gsm_cell_info_t

typedef struct luat_mobile_lte_service_cell_info	luat_mobile_lte_service_cell_info_t

typedef struct luat_mobile_lte_cell_info	luat_mobile_lte_cell_info_t

typedef struct luat_mobile_cell_info	luat_mobile_cell_info_t

typedef struct luat_mobile_gw_signal_strength_info	luat_mobile_gw_signal_strength_info_t

typedef struct luat_mobile_lte_signal_strength_info	luat_mobile_lte_signal_strength_info_t

typedef struct luat_mobile_signal_strength_info	luat_mobile_signal_strength_info_t

typedef enum LUAT_MOBILE_EVENT	LUAT_MOBILE_EVENT_E
	网络状态及相关功能状态发生更换的消息

typedef enum LUAT_MOBILE_CFUN_STATUS	LUAT_MOBILE_CFUN_STATUS_E

typedef enum LUAT_MOBILE_SIM_STATUS	LUAT_MOBILE_SIM_STATUS_E

typedef enum LUAT_MOBILE_REGISTER_STATUS	LUAT_MOBILE_REGISTER_STATUS_E

typedef enum LUAT_MOBILE_CELL_INFO_STATUS	LUAT_MOBILE_CELL_INFO_STATUS_E

typedef enum LUAT_MOBILE_PDP_STATUS	LUAT_MOBILE_PDP_STATUS_E

typedef enum LUAT_MOBILE_NETIF_STATUS	LUAT_MOBILE_NETIF_STATUS_E

typedef enum LUAT_MOBILE_BEARER_STATUS	LUAT_MOBILE_BEARER_STATUS_E

typedef enum LUAT_MOBILE_SMS_STATUS	LUAT_MOBILE_SMS_STATUS_E

typedef enum LUAT_MOBILE_IMS_REGISTER_STATUS	LUAT_MOBILE_IMS_REGISTER_STATUS_E

typedef enum LUAT_MOBILE_CC_STATUS	LUAT_MOBILE_CC_STATUS_E

typedef enum LUAT_MOBILE_CC_MAKE_CALL_RESULT	LUAT_MOBILE_CC_MAKE_CALL_RESULT_E

typedef enum LUAT_MOBILE_CC_PLAY_IND	LUAT_MOBILE_CC_PLAY_IND_E

typedef void(*	luat_mobile_event_callback_t) (LUAT_MOBILE_EVENT_E event, uint8_t index, uint8_t status)
	网络状态及相关功能状态发生更换时的回调函数，event是消息，index是CID，SIM卡号之类的序号，status是变更后的状态或者更具体的ENUM

typedef void(*	luat_mobile_sms_event_callback_t) (uint32_t event, void *param)
	底层短信消息回调函数，event是消息，param是具体数据指针，暂时不同的平台需要独自处理

枚举
enum	LUAT_MOBILE_SIM_PIN_OP { LUAT_SIM_PIN_VERIFY = 0 , LUAT_SIM_PIN_CHANGE , LUAT_SIM_PIN_ENABLE , LUAT_SIM_PIN_DISABLE , LUAT_SIM_PIN_UNBLOCK }

enum	LUAT_MOBILE_EVENT { LUAT_MOBILE_EVENT_CFUN = 0 , LUAT_MOBILE_EVENT_SIM , LUAT_MOBILE_EVENT_REGISTER_STATUS , LUAT_MOBILE_EVENT_CELL_INFO , LUAT_MOBILE_EVENT_PDP , LUAT_MOBILE_EVENT_NETIF , LUAT_MOBILE_EVENT_TIME_SYNC , LUAT_MOBILE_EVENT_CSCON , LUAT_MOBILE_EVENT_BEARER , LUAT_MOBILE_EVENT_SMS , LUAT_MOBILE_EVENT_NAS_ERROR , LUAT_MOBILE_EVENT_IMS_REGISTER_STATUS , LUAT_MOBILE_EVENT_CC , LUAT_MOBILE_EVENT_FATAL_ERROR = 0xff }
	网络状态及相关功能状态发生更换的消息更多...

enum	LUAT_MOBILE_CFUN_STATUS { LUAT_MOBILE_CFUN_OFF = 0 , LUAT_MOBILE_CFUN_ON , LUAT_MOBILE_CFUN_NO_RF = 4 }

enum	LUAT_MOBILE_SIM_STATUS { LUAT_MOBILE_SIM_READY = 0 , LUAT_MOBILE_NO_SIM , LUAT_MOBILE_SIM_NEED_PIN , LUAT_MOBILE_SIM_ENTER_PIN_RESULT , LUAT_MOBILE_SIM_NUMBER , LUAT_MOBILE_SIM_WC }

enum	LUAT_MOBILE_REGISTER_STATUS { LUAT_MOBILE_STATUS_UNREGISTER , LUAT_MOBILE_STATUS_REGISTERED , LUAT_MOBILE_STATUS_SEARCHING , LUAT_MOBILE_STATUS_DENIED , LUAT_MOBILE_STATUS_UNKNOW , LUAT_MOBILE_STATUS_REGISTERED_ROAMING , LUAT_MOBILE_STATUS_SMS_ONLY_REGISTERED , LUAT_MOBILE_STATUS_SMS_ONLY_REGISTERED_ROAMING , LUAT_MOBILE_STATUS_EMERGENCY_REGISTERED , LUAT_MOBILE_STATUS_CSFB_NOT_PREFERRED_REGISTERED , LUAT_MOBILE_STATUS_CSFB_NOT_PREFERRED_REGISTERED_ROAMING }

enum	LUAT_MOBILE_CELL_INFO_STATUS { LUAT_MOBILE_CELL_INFO_UPDATE = 0 , LUAT_MOBILE_SIGNAL_UPDATE }

enum	LUAT_MOBILE_PDP_STATUS { LUAT_MOBILE_PDP_ACTIVED = 0 , LUAT_MOBILE_PDP_DEACTIVING , LUAT_MOBILE_PDP_DEACTIVED }

enum	LUAT_MOBILE_NETIF_STATUS { LUAT_MOBILE_NETIF_LINK_ON = 0 , LUAT_MOBILE_NETIF_LINK_OFF , LUAT_MOBILE_NETIF_LINK_OOS }

enum	LUAT_MOBILE_BEARER_STATUS { LUAT_MOBILE_BEARER_GET_DEFAULT_APN = 0 , LUAT_MOBILE_BEARER_APN_SET_DONE , LUAT_MOBILE_BEARER_AUTH_SET_DONE , LUAT_MOBILE_BEARER_DEL_DONE , LUAT_MOBILE_BEARER_SET_ACT_STATE_DONE }

enum	LUAT_MOBILE_SMS_STATUS { LUAT_MOBILE_SMS_READY = 0 , LUAT_MOBILE_NEW_SMS , LUAT_MOBILE_SMS_SEND_DONE , LUAT_MOBILE_SMS_ACK }

enum	LUAT_MOBILE_IMS_REGISTER_STATUS { LUAT_MOBILE_IMS_READY = 0 }

enum	LUAT_MOBILE_CC_STATUS { LUAT_MOBILE_CC_READY = 0 , LUAT_MOBILE_CC_INCOMINGCALL , LUAT_MOBILE_CC_CALL_NUMBER , LUAT_MOBILE_CC_CONNECTED_NUMBER , LUAT_MOBILE_CC_CONNECTED , LUAT_MOBILE_CC_DISCONNECTED , LUAT_MOBILE_CC_SPEECH_START , LUAT_MOBILE_CC_MAKE_CALL_OK , LUAT_MOBILE_CC_MAKE_CALL_FAILED , LUAT_MOBILE_CC_ANSWER_CALL_DONE , LUAT_MOBILE_CC_HANGUP_CALL_DONE , LUAT_MOBILE_CC_LIST_CALL_RESULT , LUAT_MOBILE_CC_PLAY }

enum	LUAT_MOBILE_CC_MAKE_CALL_RESULT { LUAT_MOBILE_CC_MAKE_CALL_RESULT_OK = 0 , LUAT_MOBILE_CC_MAKE_CALL_RESULT_NO_CARRIER , LUAT_MOBILE_CC_MAKE_CALL_RESULT_BUSY , LUAT_MOBILE_CC_MAKE_CALL_RESULT_ERROR }

enum	LUAT_MOBILE_CC_PLAY_IND { LUAT_MOBILE_CC_PLAY_STOP , LUAT_MOBILE_CC_PLAY_DIAL_TONE , LUAT_MOBILE_CC_PLAY_RINGING_TONE , LUAT_MOBILE_CC_PLAY_CONGESTION_TONE , LUAT_MOBILE_CC_PLAY_BUSY_TONE , LUAT_MOBILE_CC_PLAY_CALL_WAITING_TONE , LUAT_MOBILE_CC_PLAY_MULTI_CALL_PROMPT_TONE , LUAT_MOBILE_CC_PLAY_CALL_INCOMINGCALL_RINGING }

enum	{ MOBILE_CONF_RESELTOWEAKNCELL = 1 , MOBILE_CONF_STATICCONFIG , MOBILE_CONF_QUALITYFIRST , MOBILE_CONF_USERDRXCYCLE , MOBILE_CONF_T3324MAXVALUE , MOBILE_CONF_PSM_MODE , MOBILE_CONF_CE_MODE , MOBILE_CONF_SIM_WC_MODE , MOBILE_CONF_FAKE_CELL_BARTIME , MOBILE_CONF_RESET_TO_FACTORY }

enum	{ LUAT_MOBILE_ISP_UNKNOW , LUAT_MOBILE_ISP_CMCC , LUAT_MOBILE_ISP_CTCC , LUAT_MOBILE_ISP_CUCC , LUAT_MOBILE_ISP_CRCC }

函数
int	luat_mobile_get_imei (int sim_id, char *buff, size_t buf_len)
	获取IMEI

int	luat_mobile_get_sn (char *buff, size_t buf_len)
	获取SN，如果用户没有调用luat_mobile_set_sn接口写过SN，默认值为空

int	luat_mobile_set_sn (char *buff, uint8_t buf_len)
	设置SN

int	luat_mobile_get_muid (char *buff, size_t buf_len)
	获取MUID，并不一定存在

int	luat_mobile_get_iccid (int sim_id, char *buff, size_t buf_len)
	获取SIM卡的ICCID

int	luat_mobile_get_imsi (int sim_id, char *buff, size_t buf_len)
	获取SIM卡的IMSI

int	luat_mobile_get_sim_number (int sim_id, char *buff, size_t buf_len)
	当前使用的SIM卡的手机号，注意，只有写入了手机号才能读出，因此有可能读出来是空的

int	luat_mobile_get_sim_id (int *id)
	当前使用的SIM卡的位置，并不一定支持

int	luat_mobile_set_sim_id (int id)
	改变使用的SIM卡的位置，并不一定支持

int	luat_mobile_set_sim_pin (int id, uint8_t operation, char pin1[9], char pin2[9])
	对SIM卡的pin码做操作

uint8_t	luat_mobile_get_sim_ready (int id)
	检查SIM卡是否准备好

void	luat_mobile_set_sim_detect_sim0_first (void)
	在自动选择模式时，开机后优先用sim0

void	luat_mobile_set_default_pdn_ipv6 (uint8_t onoff)
	设置默认PDN激活时是否要IPV6网络，现在默认情况下不开

uint8_t	luat_mobile_get_default_pdn_ipv6 (void)
	返回默认PDN激活时是否要IPV6网络

int	luat_mobile_get_apn (int sim_id, int cid, char *buff, size_t buf_len)
	获取配置的apn name，并不一定支持

void	luat_mobile_user_ctrl_apn (void)
	用户控制APN激活过程。只有使用了本函数后，才能通过手动激活用户的APN并加装网卡。只有EC618/EC7XX支持

void	luat_mobile_user_ctrl_apn_stop (void)
	解除用户控制APN激活过程

int	luat_mobile_set_apn_base_info (int sim_id, int cid, uint8_t type, uint8_t *apn_name, uint8_t name_len)
	手动设置APN激活所需的最小信息，如果需要更详细的设置，可以自行修改本函数。，只有EC618/EC7XX支持

int	luat_mobile_set_apn_auth_info (int sim_id, int cid, uint8_t protocol, uint8_t user_name, uint8_t user_name_len, uint8_t password, uint8_t password_len)
	手动设置APN激活所需的加密信息，如果需要更详细的设置，可以自行修改本函数。大部分情况下不需要加密信息，定向卡可能需要。只有EC618/EC7XX支持

int	luat_mobile_active_apn (int sim_id, int cid, uint8_t state)
	手动激活/去激活APN。只有EC618/EC7XX支持

int	luat_mobile_active_netif (int sim_id, int cid)
	手动激活网卡。只有EC618支持

void	luat_mobile_user_apn_auto_active (int sim_id, uint8_t cid, uint8_t ip_type, uint8_t protocol_type, uint8_t apn_name, uint8_t apn_name_len, uint8_t user, uint8_t user_len, uint8_t *password, uint8_t password_len)
	用户设置APN的基本信息，并且自动激活，注意不能和上述手动操作APN的API共用，专网卡如果不能用公网apn激活默认承载的必须用这个

int	luat_mobile_get_default_apn (int sim_id, char *buff, size_t buf_len)
	获取默认CID的apn name，并不一定支持

int	luat_mobile_del_apn (int sim_id, uint8_t cid, uint8_t is_dedicated)
	删除定义好的apn

int	luat_mobile_set_flymode (int index, int mode)
	进出飞行模式

int	luat_mobile_get_flymode (int index)
	飞行模式当前状态

int	luat_mobile_get_local_ip (int sim_id, int cid, ip_addr_t ip_v4, ip_addr_t ip_v6)
	获取已激活承载分配的本地ip地址

int	luat_mobile_get_cell_info (luat_mobile_cell_info_t *info)
	立刻搜索一次周围小区基站信息，并同步返回结果

int	luat_mobile_get_cell_info_async (uint8_t max_time)
	立刻搜索一次周围小区基站信息，通过LUAT_MOBILE_CELL_INFO_UPDATE返回搜索完成消息，luat_mobile_get_last_notify_cell_info获取详细信息

int	luat_mobile_get_cell_info_async_with_sim_id (uint8_t sim_id)
	双卡双待设备，立刻搜索一次周围小区基站信息，通过LUAT_MOBILE_CELL_INFO_UPDATE返回搜索完成消息，luat_mobile_get_last_notify_cell_info获取详细信息

int	luat_mobile_get_last_notify_cell_info (luat_mobile_cell_info_t *info)
	获取上一次异步搜索周围小区基站信息，包括周期性搜索和异步搜索，在LUAT_MOBILE_CELL_INFO_UPDATE到来后用本函数获取信息

int	luat_mobile_get_last_notify_cell_info_with_sim_id (uint8_t sim_id, luat_mobile_cell_info_t *info)
	双卡双待设备，获取上一次异步搜索周围小区基站信息，包括周期性搜索和异步搜索，在LUAT_MOBILE_CELL_INFO_UPDATE到来后用本函数获取信息

void	luat_mobile_print_last_notify_cell_info_with_sim_id (uint8_t sim_id)
	打印指定sim卡槽搜索到的详细基站信息，与平台有关

uint8_t	luat_mobile_rssi_to_csq (int8_t rssi)
	从RSSI转换到CSQ，RSSI只能作为天线口状态的一个参考，而不能作为LTE网络信号状态的参考

int	luat_mobile_get_signal_strength_info (luat_mobile_signal_strength_info_t *info)
	获取当前移动网络信号状态详细信息

int	luat_mobile_get_signal_strength (uint8_t *csq)
	获取CSQ值 CSQ从RSSI转换而来，只能作为天线口状态的一个参考，而不能作为LTE网络信号状态的参考

int	luat_mobile_get_last_notify_signal_strength_info (luat_mobile_signal_strength_info_t *info)
	获取最近一次网络信号状态更新通知后的网络信号状态详细信息

int	luat_mobile_get_last_notify_signal_strength (uint8_t *csq)
	获取最近一次网络信号状态更新通知后的CSQ值

int	luat_mobile_get_service_cell_identifier (uint32_t *eci)
	获取当前服务小区的ECI

int	luat_mobile_get_service_tac_or_lac (uint16_t *tac)
	获取当前服务小区的TAC或LAC

LUAT_MOBILE_SIM_STATUS_E	luat_mobile_get_sim_status (void)

LUAT_MOBILE_REGISTER_STATUS_E	luat_mobile_get_register_status (void)

int	luat_mobile_event_register_handler (luat_mobile_event_callback_t callback_fun)
	注册网络状态及相关功能状态发生更换时的回调函数

int	luat_mobile_event_deregister_handler (void)
	注销网络状态及相关功能状态发生更换时的回调函数

int	luat_mobile_sms_sdk_event_register_handler (luat_mobile_sms_event_callback_t callback_fun)
	注册底层短信消息回调函数，后续改为统一消息处理

int	luat_mobile_sms_event_register_handler (luat_mobile_sms_event_callback_t callback_fun)
	注册底层短信消息回调函数，后续改为统一消息处理(和luat_mobile_sms_sdk_event_register_handler一样，只是为了兼容老的BSP)

void	luat_mobile_set_rrc_auto_release_time (uint8_t s)
	设置RRC自动释放时间，在RRC active（见LUAT_MOBILE_EVENT_CSCON）后经过一段时间在适当的时机释放RRC

void	luat_mobile_rrc_auto_release_pause (uint8_t onoff)
	RRC自动释放暂停/恢复

void	luat_mobile_rrc_release_once (void)
	RRC立刻释放一次，不能在luat_mobile_event_callback里使用

int	luat_mobile_reset_stack (void)
	重新底层网络协议栈，本质是快速的进出飞行模式，注意和设置飞行模式是冲突的，一定时间内只能用一个。

void	luat_mobile_fatal_error_auto_reset_stack (uint8_t onoff)
	遇到网络严重错误时允许自动重启协议栈

int	luat_mobile_set_period_work (uint32_t get_cell_period, uint32_t check_sim_period, uint8_t search_cell_time)
	设置周期性辅助工作，包括周期性搜索小区基站，SIM卡短时间脱离卡槽后周期性尝试恢复，这个功能和luat_mobile_reset_stack是有可能冲突的。所有功能默认都是关闭的

int	luat_mobile_set_check_sim (uint32_t check_sim_period)
	设置SIM卡短时间脱离卡槽后周期性尝试恢复，luat_mobile_set_period_work的简化版本

void	luat_mobile_set_check_network_period (uint32_t period)
	设置定时检测网络是否正常并且在检测到长时间无网时通过重启协议栈来恢复，但是不能保证一定成功，这个功能和luat_mobile_reset_stack是有可能冲突的。所有功能默认都是关闭的

void	luat_mobile_get_ip_data_traffic (uint64_t uplink, uint64_t downlink)
	获取累计的IP流量数据

void	luat_mobile_clear_ip_data_traffic (uint8_t clear_uplink, uint8_t clear_downlink)
	清除IP流量数据

int	luat_mobile_get_support_band (uint8_t band, uint8_t total_num)
	获取模块能支持的频段

int	luat_mobile_get_band (uint8_t band, uint8_t total_num)
	获取模块当前设置使用的频段

int	luat_mobile_set_band (uint8_t *band, uint8_t total_num)
	设置模块使用的频段

int	luat_mobile_config (uint8_t item, uint32_t value)
	LTE协议栈功能特殊配置

void	luat_mobile_rf_test_mode (uint8_t uart_id, uint8_t on_off)
	RF测试模式

void	luat_mobile_rf_test_input (char *data, uint32_t data_len)
	RF测试的指令或者数据输入

uint32_t	luat_mobile_sim_write_counter (void)

int	luat_mobile_get_isp_from_plmn (uint16_t mcc, uint8_t mnc)
	通过PLMN判断运营商，目前只支持国内三大运营商及广电

int	luat_mobile_get_plmn_from_imsi (char imsi, uint16_t mcc, uint8_t *mnc)
	通过IMSI提取PLMN

void	luat_mobile_get_last_call_num (char *buf, uint8_t buf_len)
	获取最近一次来电号码

int	luat_mobile_make_call (uint8_t sim_id, char *number, uint8_t len)
	主动拨打打电话

void	luat_mobile_hangup_call (uint8_t sim_id)
	主动挂断电话

int	luat_mobile_answer_call (uint8_t sim_id)
	接听电话

int	luat_mobile_speech_init (uint8_t multimedia_id, void *callback)
	初始化电话功能

int	luat_mobile_speech_upload (uint8_t *data, uint32_t len)
	上行通话数据

void	luat_mobile_set_sync_time (uint8_t on_off)
	是否允许基站时间同步给本地时间

uint8_t	luat_mobile_get_sync_time (void)
	查看当前是否允许基站时间同步给本地时间

int	luat_mobile_softsim_onoff (uint8_t on_off)

int	luat_mobile_sim_detect_onoff (uint8_t on_off)

详细描述

宏定义说明

◆ LUAT_MOBILE_CELL_MAX_NUM

#define LUAT_MOBILE_CELL_MAX_NUM 21

在文件 luat_mobile.h 第 303 行定义.

类型定义说明

◆ LUAT_MOBILE_BEARER_STATUS_E

typedef enum LUAT_MOBILE_BEARER_STATUS LUAT_MOBILE_BEARER_STATUS_E

◆ LUAT_MOBILE_CC_MAKE_CALL_RESULT_E

typedef enum LUAT_MOBILE_CC_MAKE_CALL_RESULT LUAT_MOBILE_CC_MAKE_CALL_RESULT_E

◆ LUAT_MOBILE_CC_PLAY_IND_E

typedef enum LUAT_MOBILE_CC_PLAY_IND LUAT_MOBILE_CC_PLAY_IND_E

◆ LUAT_MOBILE_CC_STATUS_E

typedef enum LUAT_MOBILE_CC_STATUS LUAT_MOBILE_CC_STATUS_E

◆ LUAT_MOBILE_CELL_INFO_STATUS_E

typedef enum LUAT_MOBILE_CELL_INFO_STATUS LUAT_MOBILE_CELL_INFO_STATUS_E

◆ luat_mobile_cell_info_t

typedef struct luat_mobile_cell_info luat_mobile_cell_info_t

◆ LUAT_MOBILE_CFUN_STATUS_E

typedef enum LUAT_MOBILE_CFUN_STATUS LUAT_MOBILE_CFUN_STATUS_E

◆ luat_mobile_event_callback_t

typedef void(* luat_mobile_event_callback_t) (LUAT_MOBILE_EVENT_E event, uint8_t index, uint8_t status)

网络状态及相关功能状态发生更换时的回调函数，event是消息，index是CID，SIM卡号之类的序号，status是变更后的状态或者更具体的ENUM

在文件 luat_mobile.h 第 661 行定义.

◆ LUAT_MOBILE_EVENT_E

typedef enum LUAT_MOBILE_EVENT LUAT_MOBILE_EVENT_E

网络状态及相关功能状态发生更换的消息

◆ luat_mobile_gsm_cell_info_t

typedef struct luat_mobile_gsm_cell_info luat_mobile_gsm_cell_info_t

◆ luat_mobile_gsm_service_cell_info_t

typedef struct luat_mobile_gsm_service_cell_info luat_mobile_gsm_service_cell_info_t

◆ luat_mobile_gw_signal_strength_info_t

typedef struct luat_mobile_gw_signal_strength_info luat_mobile_gw_signal_strength_info_t

◆ LUAT_MOBILE_IMS_REGISTER_STATUS_E

typedef enum LUAT_MOBILE_IMS_REGISTER_STATUS LUAT_MOBILE_IMS_REGISTER_STATUS_E

◆ luat_mobile_lte_cell_info_t

typedef struct luat_mobile_lte_cell_info luat_mobile_lte_cell_info_t

◆ luat_mobile_lte_service_cell_info_t

typedef struct luat_mobile_lte_service_cell_info luat_mobile_lte_service_cell_info_t

◆ luat_mobile_lte_signal_strength_info_t

typedef struct luat_mobile_lte_signal_strength_info luat_mobile_lte_signal_strength_info_t

◆ LUAT_MOBILE_NETIF_STATUS_E

typedef enum LUAT_MOBILE_NETIF_STATUS LUAT_MOBILE_NETIF_STATUS_E

◆ LUAT_MOBILE_PDP_STATUS_E

typedef enum LUAT_MOBILE_PDP_STATUS LUAT_MOBILE_PDP_STATUS_E

◆ LUAT_MOBILE_REGISTER_STATUS_E

typedef enum LUAT_MOBILE_REGISTER_STATUS LUAT_MOBILE_REGISTER_STATUS_E

◆ luat_mobile_signal_strength_info_t

typedef struct luat_mobile_signal_strength_info luat_mobile_signal_strength_info_t

◆ LUAT_MOBILE_SIM_PIN_OP_E

typedef enum LUAT_MOBILE_SIM_PIN_OP LUAT_MOBILE_SIM_PIN_OP_E

◆ LUAT_MOBILE_SIM_STATUS_E

typedef enum LUAT_MOBILE_SIM_STATUS LUAT_MOBILE_SIM_STATUS_E

◆ luat_mobile_sms_event_callback_t

typedef void(* luat_mobile_sms_event_callback_t) (uint32_t event, void *param)

底层短信消息回调函数，event是消息，param是具体数据指针，暂时不同的平台需要独自处理

在文件 luat_mobile.h 第 668 行定义.

◆ LUAT_MOBILE_SMS_STATUS_E

typedef enum LUAT_MOBILE_SMS_STATUS LUAT_MOBILE_SMS_STATUS_E

枚举类型说明

◆ anonymous enum

anonymous enum

枚举值
MOBILE_CONF_RESELTOWEAKNCELL
MOBILE_CONF_STATICCONFIG
MOBILE_CONF_QUALITYFIRST
MOBILE_CONF_USERDRXCYCLE
MOBILE_CONF_T3324MAXVALUE
MOBILE_CONF_PSM_MODE
MOBILE_CONF_CE_MODE
MOBILE_CONF_SIM_WC_MODE
MOBILE_CONF_FAKE_CELL_BARTIME
MOBILE_CONF_RESET_TO_FACTORY

在文件 luat_mobile.h 第 823 行定义.

◆ anonymous enum

anonymous enum

枚举值
LUAT_MOBILE_ISP_UNKNOW
LUAT_MOBILE_ISP_CMCC
LUAT_MOBILE_ISP_CTCC
LUAT_MOBILE_ISP_CUCC
LUAT_MOBILE_ISP_CRCC

在文件 luat_mobile.h 第 839 行定义.

◆ LUAT_MOBILE_BEARER_STATUS

enum LUAT_MOBILE_BEARER_STATUS

枚举值
LUAT_MOBILE_BEARER_GET_DEFAULT_APN	获取到默认APN
LUAT_MOBILE_BEARER_APN_SET_DONE	设置APN信息完成
LUAT_MOBILE_BEARER_AUTH_SET_DONE	设置APN加密状态完成
LUAT_MOBILE_BEARER_DEL_DONE	删除APN信息完成
LUAT_MOBILE_BEARER_SET_ACT_STATE_DONE	APN激活/去激活完成

在文件 luat_mobile.h 第 584 行定义.

◆ LUAT_MOBILE_CC_MAKE_CALL_RESULT

enum LUAT_MOBILE_CC_MAKE_CALL_RESULT

枚举值
LUAT_MOBILE_CC_MAKE_CALL_RESULT_OK	电话相关请求成功
LUAT_MOBILE_CC_MAKE_CALL_RESULT_NO_CARRIER	拨打电话无人接听或者已挂断
LUAT_MOBILE_CC_MAKE_CALL_RESULT_BUSY	拨打电话对方正忙
LUAT_MOBILE_CC_MAKE_CALL_RESULT_ERROR	拨打电话请求发生未知错误

在文件 luat_mobile.h 第 623 行定义.

◆ LUAT_MOBILE_CC_PLAY_IND

enum LUAT_MOBILE_CC_PLAY_IND

枚举值
LUAT_MOBILE_CC_PLAY_STOP	音频关闭
LUAT_MOBILE_CC_PLAY_DIAL_TONE	播放dial音
LUAT_MOBILE_CC_PLAY_RINGING_TONE	播放振铃
LUAT_MOBILE_CC_PLAY_CONGESTION_TONE	播放振铃
LUAT_MOBILE_CC_PLAY_BUSY_TONE	播放振铃
LUAT_MOBILE_CC_PLAY_CALL_WAITING_TONE	播放振铃
LUAT_MOBILE_CC_PLAY_MULTI_CALL_PROMPT_TONE	播放振铃
LUAT_MOBILE_CC_PLAY_CALL_INCOMINGCALL_RINGING	播放来电铃声

在文件 luat_mobile.h 第 631 行定义.

◆ LUAT_MOBILE_CC_STATUS

enum LUAT_MOBILE_CC_STATUS

枚举值
LUAT_MOBILE_CC_READY	通话准备完成，可以拨打电话了
LUAT_MOBILE_CC_INCOMINGCALL	有来电
LUAT_MOBILE_CC_CALL_NUMBER	有来电号码
LUAT_MOBILE_CC_CONNECTED_NUMBER	已接通电话号码
LUAT_MOBILE_CC_CONNECTED	电话已经接通
LUAT_MOBILE_CC_DISCONNECTED	电话被对方挂断
LUAT_MOBILE_CC_SPEECH_START	通话开始
LUAT_MOBILE_CC_MAKE_CALL_OK	拨打电话请求成功
LUAT_MOBILE_CC_MAKE_CALL_FAILED	拨打电话请求失败
LUAT_MOBILE_CC_ANSWER_CALL_DONE	接听电话请求完成
LUAT_MOBILE_CC_HANGUP_CALL_DONE	挂断电话请求完成
LUAT_MOBILE_CC_LIST_CALL_RESULT	电话列表，未实现
LUAT_MOBILE_CC_PLAY	电话功能相关音频控制

在文件 luat_mobile.h 第 606 行定义.

◆ LUAT_MOBILE_CELL_INFO_STATUS

enum LUAT_MOBILE_CELL_INFO_STATUS

枚举值
LUAT_MOBILE_CELL_INFO_UPDATE	小区基站信息变更，只有设置了周期性搜索小区基站时才会有
LUAT_MOBILE_SIGNAL_UPDATE	网络信号状态变更，但是不一定是有变化

在文件 luat_mobile.h 第 564 行定义.

◆ LUAT_MOBILE_CFUN_STATUS

enum LUAT_MOBILE_CFUN_STATUS

枚举值
LUAT_MOBILE_CFUN_OFF
LUAT_MOBILE_CFUN_ON
LUAT_MOBILE_CFUN_NO_RF

在文件 luat_mobile.h 第 532 行定义.

◆ LUAT_MOBILE_EVENT

enum LUAT_MOBILE_EVENT

网络状态及相关功能状态发生更换的消息

枚举值
LUAT_MOBILE_EVENT_CFUN	CFUN消息
LUAT_MOBILE_EVENT_SIM	SIM卡消息
LUAT_MOBILE_EVENT_REGISTER_STATUS	移动网络注册消息
LUAT_MOBILE_EVENT_CELL_INFO	小区基站信息和网络信号变更消息
LUAT_MOBILE_EVENT_PDP	PDP状态消息
LUAT_MOBILE_EVENT_NETIF	internet状态
LUAT_MOBILE_EVENT_TIME_SYNC	通过基站同步时间完成
LUAT_MOBILE_EVENT_CSCON	RRC状态，0 idle 1 active
LUAT_MOBILE_EVENT_BEARER	PDP承载状态
LUAT_MOBILE_EVENT_SMS	SMS短信 >
LUAT_MOBILE_EVENT_NAS_ERROR	NAS异常消息，air780e, air780ep有效
LUAT_MOBILE_EVENT_IMS_REGISTER_STATUS	IMS注册状态，volte必须在注册成功情况下使用
LUAT_MOBILE_EVENT_CC	通话相关消息
LUAT_MOBILE_EVENT_FATAL_ERROR	网络遇到严重故障

在文件 luat_mobile.h 第 514 行定义.

◆ LUAT_MOBILE_IMS_REGISTER_STATUS

enum LUAT_MOBILE_IMS_REGISTER_STATUS

枚举值
LUAT_MOBILE_IMS_READY	IMS网络已注册

在文件 luat_mobile.h 第 601 行定义.

◆ LUAT_MOBILE_NETIF_STATUS

enum LUAT_MOBILE_NETIF_STATUS

枚举值
LUAT_MOBILE_NETIF_LINK_ON	已联网
LUAT_MOBILE_NETIF_LINK_OFF	断网
LUAT_MOBILE_NETIF_LINK_OOS	失去网络连接，尝试恢复中，等同于LUAT_MOBILE_NETIF_LINK_OFF

在文件 luat_mobile.h 第 577 行定义.

◆ LUAT_MOBILE_PDP_STATUS

enum LUAT_MOBILE_PDP_STATUS

枚举值
LUAT_MOBILE_PDP_ACTIVED
LUAT_MOBILE_PDP_DEACTIVING
LUAT_MOBILE_PDP_DEACTIVED

在文件 luat_mobile.h 第 570 行定义.

◆ LUAT_MOBILE_REGISTER_STATUS

enum LUAT_MOBILE_REGISTER_STATUS

枚举值
LUAT_MOBILE_STATUS_UNREGISTER	网络未注册
LUAT_MOBILE_STATUS_REGISTERED	网络已注册
LUAT_MOBILE_STATUS_SEARCHING	网络搜索中
LUAT_MOBILE_STATUS_DENIED	网络注册被拒绝
LUAT_MOBILE_STATUS_UNKNOW	网络状态未知
LUAT_MOBILE_STATUS_REGISTERED_ROAMING	网络已注册，漫游
LUAT_MOBILE_STATUS_SMS_ONLY_REGISTERED
LUAT_MOBILE_STATUS_SMS_ONLY_REGISTERED_ROAMING
LUAT_MOBILE_STATUS_EMERGENCY_REGISTERED
LUAT_MOBILE_STATUS_CSFB_NOT_PREFERRED_REGISTERED
LUAT_MOBILE_STATUS_CSFB_NOT_PREFERRED_REGISTERED_ROAMING

在文件 luat_mobile.h 第 549 行定义.

◆ LUAT_MOBILE_SIM_PIN_OP

enum LUAT_MOBILE_SIM_PIN_OP

枚举值
LUAT_SIM_PIN_VERIFY
LUAT_SIM_PIN_CHANGE
LUAT_SIM_PIN_ENABLE
LUAT_SIM_PIN_DISABLE
LUAT_SIM_PIN_UNBLOCK

在文件 luat_mobile.h 第 113 行定义.

◆ LUAT_MOBILE_SIM_STATUS

enum LUAT_MOBILE_SIM_STATUS

枚举值
LUAT_MOBILE_SIM_READY	SIM卡已准备好
LUAT_MOBILE_NO_SIM	无SIM卡
LUAT_MOBILE_SIM_NEED_PIN	需要输入PIN码
LUAT_MOBILE_SIM_ENTER_PIN_RESULT	PIN码输入结果
LUAT_MOBILE_SIM_NUMBER	获取到电话号码(不一定有值)
LUAT_MOBILE_SIM_WC	SIM卡的写入次数统计,掉电归0

在文件 luat_mobile.h 第 539 行定义.

◆ LUAT_MOBILE_SMS_STATUS

enum LUAT_MOBILE_SMS_STATUS

枚举值
LUAT_MOBILE_SMS_READY	短信功能初始化完成
LUAT_MOBILE_NEW_SMS	接收到新的短信
LUAT_MOBILE_SMS_SEND_DONE	短信发送到运营商
LUAT_MOBILE_SMS_ACK	短信已经被接收

在文件 luat_mobile.h 第 593 行定义.

函数说明

◆ luat_mobile_active_apn()

int luat_mobile_active_apn	(	int	sim_id,
		int	cid,
		uint8_t	state )

手动激活/去激活APN。只有EC618/EC7XX支持

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 2~6
state	1激活 0去激活

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_active_netif()

int luat_mobile_active_netif	(	int	sim_id,
		int	cid )

手动激活网卡。只有EC618支持

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 2~6

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_answer_call()

int luat_mobile_answer_call ( uint8_t sim_id )

接听电话

参数

sim_id sim卡槽

返回: =0成功，其他错误

◆ luat_mobile_clear_ip_data_traffic()

void luat_mobile_clear_ip_data_traffic	(	uint8_t	clear_uplink,
		uint8_t	clear_downlink )

清除IP流量数据

参数

clear_uplink	清除上行流量
clear_downlink	清除下行流量

返回: 无

◆ luat_mobile_config()

int luat_mobile_config	(	uint8_t	item,
		uint32_t	value )

LTE协议栈功能特殊配置

参数

item	见MOBILE_CONF_XXX
value	配置值

返回: 成功返回0，其他失败

◆ luat_mobile_del_apn()

int luat_mobile_del_apn	(	int	sim_id,
		uint8_t	cid,
		uint8_t	is_dedicated )

删除定义好的apn

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 1~6
is_dedicated	是否是专用的,不清楚的写0

返回: int =0成功，其他失败

◆ luat_mobile_event_deregister_handler()

int luat_mobile_event_deregister_handler ( void )

注销网络状态及相关功能状态发生更换时的回调函数

返回: int =0成功，其他失败

◆ luat_mobile_event_register_handler()

int luat_mobile_event_register_handler ( luat_mobile_event_callback_t callback_fun )

注册网络状态及相关功能状态发生更换时的回调函数

参数

callback_fun 网络状态及相关功能状态发生更换时的回调函数

返回: int =0成功，其他失败

◆ luat_mobile_fatal_error_auto_reset_stack()

void luat_mobile_fatal_error_auto_reset_stack ( uint8_t onoff )

遇到网络严重错误时允许自动重启协议栈

参数

onoff 0关闭其他开启

返回: void

◆ luat_mobile_get_apn()

int luat_mobile_get_apn	(	int	sim_id,
		int	cid,
		char *	buff,
		size_t	buf_len )

获取配置的apn name，并不一定支持

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 1~6
buff[OUT]	apn name
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_band()

int luat_mobile_get_band	(	uint8_t *	band,
		uint8_t *	total_num )

获取模块当前设置使用的频段

参数

band	存放输出频段值的缓存，至少需要CMI_DEV_SUPPORT_MAX_BAND_NUM字节的空间
total_num	频段数量

返回: 成功返回0，其他失败

◆ luat_mobile_get_cell_info()

int luat_mobile_get_cell_info ( luat_mobile_cell_info_t * info )

立刻搜索一次周围小区基站信息，并同步返回结果

参数

info	当前移动网络信号状态详细信息

返回: int =0成功，其他失败

◆ luat_mobile_get_cell_info_async()

int luat_mobile_get_cell_info_async ( uint8_t max_time )

立刻搜索一次周围小区基站信息，通过LUAT_MOBILE_CELL_INFO_UPDATE返回搜索完成消息，luat_mobile_get_last_notify_cell_info获取详细信息

参数

max_time 搜索的最大时间，单位秒

返回: int =0成功，其他失败

◆ luat_mobile_get_cell_info_async_with_sim_id()

int luat_mobile_get_cell_info_async_with_sim_id ( uint8_t sim_id )

双卡双待设备，立刻搜索一次周围小区基站信息，通过LUAT_MOBILE_CELL_INFO_UPDATE返回搜索完成消息，luat_mobile_get_last_notify_cell_info获取详细信息

参数

sim_id sim卡槽

返回: int =0成功，其他失败

◆ luat_mobile_get_default_apn()

int luat_mobile_get_default_apn	(	int	sim_id,
		char *	buff,
		size_t	buf_len )

获取默认CID的apn name，并不一定支持

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
buff[OUT]	apn name
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_default_pdn_ipv6()

uint8_t luat_mobile_get_default_pdn_ipv6 ( void )

返回默认PDN激活时是否要IPV6网络

返回: uint8_t 1开 0关

◆ luat_mobile_get_flymode()

int luat_mobile_get_flymode ( int index )

飞行模式当前状态

参数

index sim位置，对于双卡双待的设备，选0或者1，其他设备随意

返回: int <0 异常 =0飞行模式 =1正常工作 =4射频关闭

◆ luat_mobile_get_iccid()

int luat_mobile_get_iccid	(	int	sim_id,
		char *	buff,
		size_t	buf_len )

获取SIM卡的ICCID

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
buff[OUT]	ICCID数据
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_imei()

int luat_mobile_get_imei	(	int	sim_id,
		char *	buff,
		size_t	buf_len )

获取IMEI

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
buff[OUT]	IMEI数据
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_imsi()

int luat_mobile_get_imsi	(	int	sim_id,
		char *	buff,
		size_t	buf_len )

获取SIM卡的IMSI

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
buff[OUT]	IMSI数据
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_ip_data_traffic()

void luat_mobile_get_ip_data_traffic	(	uint64_t *	uplink,
		uint64_t *	downlink )

获取累计的IP流量数据

参数

uplink	上行流量
downlink	下行流量

返回: 无

◆ luat_mobile_get_isp_from_plmn()

int luat_mobile_get_isp_from_plmn	(	uint16_t	mcc,
		uint8_t	mnc )

通过PLMN判断运营商，目前只支持国内三大运营商及广电

参数

mcc	MCC码，3位10进制数字，目前只有中国460是支持的
mnc	MNC码，2位10进制数字

返回: < 0 发生错误，其他见LUAT_MOBILE_ISP_XXX

◆ luat_mobile_get_last_call_num()

void luat_mobile_get_last_call_num	(	char *	buf,
		uint8_t	buf_len )

获取最近一次来电号码

参数

buf	存放号码的缓存
buf_len	存放号码的缓存长度，推荐80

返回: 无

◆ luat_mobile_get_last_notify_cell_info()

int luat_mobile_get_last_notify_cell_info ( luat_mobile_cell_info_t * info )

获取上一次异步搜索周围小区基站信息，包括周期性搜索和异步搜索，在LUAT_MOBILE_CELL_INFO_UPDATE到来后用本函数获取信息

参数

info	当前移动网络信号状态详细信息

返回: int =0成功，其他失败

◆ luat_mobile_get_last_notify_cell_info_with_sim_id()

int luat_mobile_get_last_notify_cell_info_with_sim_id	(	uint8_t	sim_id,
		luat_mobile_cell_info_t *	info )

双卡双待设备，获取上一次异步搜索周围小区基站信息，包括周期性搜索和异步搜索，在LUAT_MOBILE_CELL_INFO_UPDATE到来后用本函数获取信息

参数

sim_id	sim卡槽
info	当前移动网络信号状态详细信息
max_time	搜索的最大时间

返回: int =0成功，其他失败

◆ luat_mobile_get_last_notify_signal_strength()

int luat_mobile_get_last_notify_signal_strength ( uint8_t * csq )

获取最近一次网络信号状态更新通知后的CSQ值

参数

info CSQ值

返回: int =0成功，其他失败

◆ luat_mobile_get_last_notify_signal_strength_info()

int luat_mobile_get_last_notify_signal_strength_info ( luat_mobile_signal_strength_info_t * info )

获取最近一次网络信号状态更新通知后的网络信号状态详细信息

参数

info	网络信号状态详细信息

返回: int =0成功，其他失败

◆ luat_mobile_get_local_ip()

int luat_mobile_get_local_ip	(	int	sim_id,
		int	cid,
		ip_addr_t *	ip_v4,
		ip_addr_t *	ip_v6 )

获取已激活承载分配的本地ip地址

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 1~6，没有使用专网APN的话，就是用1
ip_v4,ipv4的IP地址
ip_v6,ipv6的IP地址

返回: int =0成功，其他失败

◆ luat_mobile_get_muid()

int luat_mobile_get_muid	(	char *	buff,
		size_t	buf_len )

获取MUID，并不一定存在

参数

buff[OUT]	MUID数据
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_plmn_from_imsi()

int luat_mobile_get_plmn_from_imsi	(	char *	imsi,
		uint16_t *	mcc,
		uint8_t *	mnc )

通过IMSI提取PLMN

参数

imsi	IMSI号码
mcc	MCC码，3位10进制数字
mnc	MNC码，2位10进制数字

返回: =0成功，其他错误

◆ luat_mobile_get_register_status()

LUAT_MOBILE_REGISTER_STATUS_E luat_mobile_get_register_status ( void )

◆ luat_mobile_get_service_cell_identifier()

int luat_mobile_get_service_cell_identifier ( uint32_t * eci )

获取当前服务小区的ECI

参数

eci

返回: int =0成功，其他失败

◆ luat_mobile_get_service_tac_or_lac()

int luat_mobile_get_service_tac_or_lac ( uint16_t * tac )

获取当前服务小区的TAC或LAC

参数

tac

返回: int =0成功，其他失败

◆ luat_mobile_get_signal_strength()

int luat_mobile_get_signal_strength ( uint8_t * csq )

获取CSQ值 CSQ从RSSI转换而来，只能作为天线口状态的一个参考，而不能作为LTE网络信号状态的参考

参数

csq CSQ值

返回: int =0成功，其他失败

◆ luat_mobile_get_signal_strength_info()

int luat_mobile_get_signal_strength_info ( luat_mobile_signal_strength_info_t * info )

获取当前移动网络信号状态详细信息

参数

info	当前移动网络信号状态详细信息

返回: int =0成功，其他失败

◆ luat_mobile_get_sim_id()

int luat_mobile_get_sim_id ( int * id )

当前使用的SIM卡的位置，并不一定支持

参数

id[OUT] sim位置，对于双卡双待的设备，输出0或者1，其他设备输出0

返回: int =0成功，其他失败

◆ luat_mobile_get_sim_number()

int luat_mobile_get_sim_number	(	int	sim_id,
		char *	buff,
		size_t	buf_len )

当前使用的SIM卡的手机号，注意，只有写入了手机号才能读出，因此有可能读出来是空的

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
buff[OUT]	sim_number数据
buf_len	用户传入缓存的大小，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_sim_ready()

uint8_t luat_mobile_get_sim_ready ( int id )

检查SIM卡是否准备好

参数

id	sim位置，对于双卡的设备，选0或者1，其他为自动选择模式，但是0和1的优先级是一致的。非双卡的设备不支持

返回: =1准备好，其他未准备好，或者SIM卡不在位

◆ luat_mobile_get_sim_status()

LUAT_MOBILE_SIM_STATUS_E luat_mobile_get_sim_status ( void )

◆ luat_mobile_get_sn()

int luat_mobile_get_sn	(	char *	buff,
		size_t	buf_len )

获取SN，如果用户没有调用luat_mobile_set_sn接口写过SN，默认值为空

参数

buff[OUT]	SN数据
buf_len	用户传入缓存的大小，EC618平台底层支持的最大长度为32字节，如果底层数据量大于buf_len，只会传出buf_len大小的数据

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_get_support_band()

int luat_mobile_get_support_band	(	uint8_t *	band,
		uint8_t *	total_num )

获取模块能支持的频段

参数

band	存放输出频段值的缓存，至少需要CMI_DEV_SUPPORT_MAX_BAND_NUM字节的空间
total_num	频段数量

返回: 成功返回0，其他失败

◆ luat_mobile_get_sync_time()

uint8_t luat_mobile_get_sync_time ( void )

查看当前是否允许基站时间同步给本地时间

返回: =0不允许，其他允许

◆ luat_mobile_hangup_call()

void luat_mobile_hangup_call ( uint8_t sim_id )

主动挂断电话

参数

sim_id sim卡槽

返回: 无

◆ luat_mobile_make_call()

int luat_mobile_make_call	(	uint8_t	sim_id,
		char *	number,
		uint8_t	len )

主动拨打打电话

参数

sim_id	sim卡槽
number	字符串形式的电话号码
len	电话号码长度

返回: =0成功，其他错误

◆ luat_mobile_print_last_notify_cell_info_with_sim_id()

void luat_mobile_print_last_notify_cell_info_with_sim_id ( uint8_t sim_id )

打印指定sim卡槽搜索到的详细基站信息，与平台有关

参数

sim_id sim卡槽

返回

◆ luat_mobile_reset_stack()

int luat_mobile_reset_stack ( void )

重新底层网络协议栈，本质是快速的进出飞行模式，注意和设置飞行模式是冲突的，一定时间内只能用一个。

返回: int =0成功，其他失败

◆ luat_mobile_rf_test_input()

void luat_mobile_rf_test_input	(	char *	data,
		uint32_t	data_len )

RF测试的指令或者数据输入

参数

data	数据，可以为空，只有为空的时候才会真正开始处理指令
data_len	数据长度，可以为0，只有为0的时候才会真正开始处理指令

返回: 无

◆ luat_mobile_rf_test_mode()

void luat_mobile_rf_test_mode	(	uint8_t	uart_id,
		uint8_t	on_off )

RF测试模式

参数

uart_id	测试结果输出的串口ID
on_off	进出测试模式，0退出其他进入

返回: 无

◆ luat_mobile_rrc_auto_release_pause()

void luat_mobile_rrc_auto_release_pause ( uint8_t onoff )

RRC自动释放暂停/恢复

参数

onoff 1暂停 0恢复

注解: 没有在Air724上使用过AT*RTIME的，或者不明白RRC的含义，请不要使用RRC相关API

◆ luat_mobile_rrc_release_once()

void luat_mobile_rrc_release_once ( void )

RRC立刻释放一次，不能在luat_mobile_event_callback里使用

注解: 没有在Air724上使用过AT*RTIME的，或者不明白RRC的含义，请不要使用RRC相关API

◆ luat_mobile_rssi_to_csq()

uint8_t luat_mobile_rssi_to_csq ( int8_t rssi )

从RSSI转换到CSQ，RSSI只能作为天线口状态的一个参考，而不能作为LTE网络信号状态的参考

参数

rssi RSSI值

返回: uint8_t CSQ值

◆ luat_mobile_set_apn_auth_info()

int luat_mobile_set_apn_auth_info	(	int	sim_id,
		int	cid,
		uint8_t	protocol,
		uint8_t *	user_name,
		uint8_t	user_name_len,
		uint8_t *	password,
		uint8_t	password_len )

手动设置APN激活所需的加密信息，如果需要更详细的设置，可以自行修改本函数。大部分情况下不需要加密信息，定向卡可能需要。只有EC618/EC7XX支持

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 2~6
protocol	加密协议 1~3，0和0xff表示不需要
user_name	用户名
user_name_len	用户名长度
password	密码
password_len	密码长度

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_set_apn_base_info()

int luat_mobile_set_apn_base_info	(	int	sim_id,
		int	cid,
		uint8_t	type,
		uint8_t *	apn_name,
		uint8_t	name_len )

手动设置APN激活所需的最小信息，如果需要更详细的设置，可以自行修改本函数。，只有EC618/EC7XX支持

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 2~6
type	激活类型 1 IPV4 2 IPV6 3 IPV4V6
apn_name	apn name
name_len	apn name 长度

返回: int <= 0错误 >0实际传出的大小

◆ luat_mobile_set_band()

int luat_mobile_set_band	(	uint8_t *	band,
		uint8_t	total_num )

设置模块使用的频段

参数

band	设置的频段，需要至少total_num数量的空间
total_num	频段数量

返回: 成功返回0，其他失败

◆ luat_mobile_set_check_network_period()

void luat_mobile_set_check_network_period ( uint32_t period )

设置定时检测网络是否正常并且在检测到长时间无网时通过重启协议栈来恢复，但是不能保证一定成功，这个功能和luat_mobile_reset_stack是有可能冲突的。所有功能默认都是关闭的

参数

period 无网时长，单位ms，不可以太短，建议60000以上，为网络搜索网络保留足够的时间

返回: void

◆ luat_mobile_set_check_sim()

int luat_mobile_set_check_sim ( uint32_t check_sim_period )

设置SIM卡短时间脱离卡槽后周期性尝试恢复，luat_mobile_set_period_work的简化版本

参数

check_sim_period SIM卡短时间脱离卡槽后尝试恢复的时间间隔，单位ms，建议在5000~10000，或者写0，当SIM卡移除的消息上来后手动重启协议栈

返回: int

◆ luat_mobile_set_default_pdn_ipv6()

void luat_mobile_set_default_pdn_ipv6 ( uint8_t onoff )

设置默认PDN激活时是否要IPV6网络，现在默认情况下不开

参数

onoff 1开 0关

返回: uint8_t 1开 0关

◆ luat_mobile_set_flymode()

int luat_mobile_set_flymode	(	int	index,
		int	mode )

进出飞行模式

参数

index	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
mode	飞行模式，1进入，0退出

返回: int =0成功，其他失败

◆ luat_mobile_set_period_work()

int luat_mobile_set_period_work	(	uint32_t	get_cell_period,
		uint32_t	check_sim_period,
		uint8_t	search_cell_time )

设置周期性辅助工作，包括周期性搜索小区基站，SIM卡短时间脱离卡槽后周期性尝试恢复，这个功能和luat_mobile_reset_stack是有可能冲突的。所有功能默认都是关闭的

参数

get_cell_period	周期性搜索小区基站的时间间隔，单位ms，这个会增加低功耗，尽量的长，或者写0关闭这个功能，用上面的手段搜索
check_sim_period	SIM卡短时间脱离卡槽后尝试恢复的时间间隔，单位ms，建议在5000~10000，或者写0，当SIM卡移除的消息上来后手动重启协议栈
search_cell_time	启动周期性搜索小区基站后，每次搜索的最大时间，单位s，1~8

返回: int

◆ luat_mobile_set_rrc_auto_release_time()

void luat_mobile_set_rrc_auto_release_time ( uint8_t s )

设置RRC自动释放时间，在RRC active（见LUAT_MOBILE_EVENT_CSCON）后经过一段时间在适当的时机释放RRC

参数

s	超时时间，单位秒，如果为0则是关闭功能

注解: 没有在Air724上使用过AT*RTIME的，或者不明白RRC的含义，请不要使用RRC相关API

◆ luat_mobile_set_sim_detect_sim0_first()

void luat_mobile_set_sim_detect_sim0_first ( void )

在自动选择模式时，开机后优先用sim0

◆ luat_mobile_set_sim_id()

int luat_mobile_set_sim_id ( int id )

改变使用的SIM卡的位置，并不一定支持

参数

id	sim位置，对于双卡的设备，选0或者1，其他为自动选择模式。非双卡的设备不支持

返回: int =0成功，其他失败

◆ luat_mobile_set_sim_pin()

int luat_mobile_set_sim_pin	(	int	id,
		uint8_t	operation,
		char	pin1[9],
		char	pin2[9] )

对SIM卡的pin码做操作

参数

id	sim位置，对于双卡的设备，选0或者1，其他为自动选择模式，但是0和1的优先级是一致的。非双卡的设备不支持
operation	操作码，见LUAT_MOBILE_SIM_PIN_OP_E
pin1	旧的pin码，或者验证的pin码，解锁pin码时的PUK，参考手机操作
pin2	更换pin码操作时的新的pin码，解锁pin码时的新PIN，参考手机操作

返回: int =0成功，其他失败

◆ luat_mobile_set_sn()

int luat_mobile_set_sn	(	char *	buff,
		uint8_t	buf_len )

设置SN

参数

buff	SN数据，必须是ascii值大于等于0x21小于等于0x7e的可见ascii字符
buf_len	SN数据长度；EC618平台底层支持的最大长度为32字节，如果buf_len大于32，只会保存前32字节的数据

返回: int = 0成功， = -1失败

◆ luat_mobile_set_sync_time()

void luat_mobile_set_sync_time ( uint8_t on_off )

是否允许基站时间同步给本地时间

参数

on_off 0不允许，其他允许

◆ luat_mobile_sim_detect_onoff()

int luat_mobile_sim_detect_onoff ( uint8_t on_off )

◆ luat_mobile_sim_write_counter()

uint32_t luat_mobile_sim_write_counter ( void )

◆ luat_mobile_sms_event_register_handler()

int luat_mobile_sms_event_register_handler ( luat_mobile_sms_event_callback_t callback_fun )

注册底层短信消息回调函数，后续改为统一消息处理(和luat_mobile_sms_sdk_event_register_handler一样，只是为了兼容老的BSP)

参数

callback_fun 短信消息回调函数，如果为NULL，则是注销

返回: int =0成功，其他失败

◆ luat_mobile_sms_sdk_event_register_handler()

int luat_mobile_sms_sdk_event_register_handler ( luat_mobile_sms_event_callback_t callback_fun )

注册底层短信消息回调函数，后续改为统一消息处理

参数

callback_fun 短信消息回调函数，如果为NULL，则是注销

返回: int =0成功，其他失败

◆ luat_mobile_softsim_onoff()

int luat_mobile_softsim_onoff ( uint8_t on_off )

◆ luat_mobile_speech_init()

int luat_mobile_speech_init	(	uint8_t	multimedia_id,
		void *	callback )

初始化电话功能

参数

multimedia_id	multimedia_id 多媒体通道，目前只有0
callback	下行通话数据回调函数

返回: =0成功，其他错误

◆ luat_mobile_speech_upload()

int luat_mobile_speech_upload	(	uint8_t *	data,
		uint32_t	len )

上行通话数据

参数

data	录音数据
len	录音数据长度

返回: =0成功，其他错误

◆ luat_mobile_user_apn_auto_active()

void luat_mobile_user_apn_auto_active	(	int	sim_id,
		uint8_t	cid,
		uint8_t	ip_type,
		uint8_t	protocol_type,
		uint8_t *	apn_name,
		uint8_t	apn_name_len,
		uint8_t *	user,
		uint8_t	user_len,
		uint8_t *	password,
		uint8_t	password_len )

用户设置APN的基本信息，并且自动激活，注意不能和上述手动操作APN的API共用，专网卡如果不能用公网apn激活默认承载的必须用这个

参数

sim_id	sim位置，对于双卡双待的设备，选0或者1，其他设备随意
cid	cid位置 1~6
ip_type	激活类型 1 IPV4 2 IPV6 3 IPV4V6
protocol_type	加密协议 0~2，0xff表示不需要
apn_name	apn name，如果留空则使用默认APN
apn_name_len	apn name 长度
user_name	用户名
user_name_len	用户名长度
password	密码
password_len	密码长度

返回: 无

◆ luat_mobile_user_ctrl_apn()

void luat_mobile_user_ctrl_apn ( void )

用户控制APN激活过程。只有使用了本函数后，才能通过手动激活用户的APN并加装网卡。只有EC618/EC7XX支持

◆ luat_mobile_user_ctrl_apn_stop()

void luat_mobile_user_ctrl_apn_stop ( void )

解除用户控制APN激活过程

结构体

宏定义

类型定义

枚举

函数

详细描述

宏定义说明

◆ LUAT_MOBILE_CELL_MAX_NUM

类型定义说明

◆ LUAT_MOBILE_BEARER_STATUS_E

◆ LUAT_MOBILE_CC_MAKE_CALL_RESULT_E

◆ LUAT_MOBILE_CC_PLAY_IND_E

◆ LUAT_MOBILE_CC_STATUS_E

◆ LUAT_MOBILE_CELL_INFO_STATUS_E

◆ luat_mobile_cell_info_t

◆ LUAT_MOBILE_CFUN_STATUS_E

◆ luat_mobile_event_callback_t

◆ LUAT_MOBILE_EVENT_E

◆ luat_mobile_gsm_cell_info_t

◆ luat_mobile_gsm_service_cell_info_t

◆ luat_mobile_gw_signal_strength_info_t

◆ LUAT_MOBILE_IMS_REGISTER_STATUS_E

◆ luat_mobile_lte_cell_info_t

◆ luat_mobile_lte_service_cell_info_t

◆ luat_mobile_lte_signal_strength_info_t

◆ LUAT_MOBILE_NETIF_STATUS_E

◆ LUAT_MOBILE_PDP_STATUS_E

◆ LUAT_MOBILE_REGISTER_STATUS_E

◆ luat_mobile_signal_strength_info_t

◆ LUAT_MOBILE_SIM_PIN_OP_E

◆ LUAT_MOBILE_SIM_STATUS_E

◆ luat_mobile_sms_event_callback_t

◆ LUAT_MOBILE_SMS_STATUS_E

枚举类型说明

◆ anonymous enum

◆ anonymous enum

◆ LUAT_MOBILE_BEARER_STATUS

◆ LUAT_MOBILE_CC_MAKE_CALL_RESULT

◆ LUAT_MOBILE_CC_PLAY_IND

◆ LUAT_MOBILE_CC_STATUS

◆ LUAT_MOBILE_CELL_INFO_STATUS

◆ LUAT_MOBILE_CFUN_STATUS

◆ LUAT_MOBILE_EVENT

◆ LUAT_MOBILE_IMS_REGISTER_STATUS

◆ LUAT_MOBILE_NETIF_STATUS

◆ LUAT_MOBILE_PDP_STATUS

◆ LUAT_MOBILE_REGISTER_STATUS

◆ LUAT_MOBILE_SIM_PIN_OP

◆ LUAT_MOBILE_SIM_STATUS

◆ LUAT_MOBILE_SMS_STATUS

函数说明

◆ luat_mobile_active_apn()

◆ luat_mobile_active_netif()

◆ luat_mobile_answer_call()

◆ luat_mobile_clear_ip_data_traffic()

◆ luat_mobile_config()

◆ luat_mobile_del_apn()

◆ luat_mobile_event_deregister_handler()

◆ luat_mobile_event_register_handler()

◆ luat_mobile_fatal_error_auto_reset_stack()

◆ luat_mobile_get_apn()

◆ luat_mobile_get_band()

◆ luat_mobile_get_cell_info()

◆ luat_mobile_get_cell_info_async()

◆ luat_mobile_get_cell_info_async_with_sim_id()

◆ luat_mobile_get_default_apn()

◆ luat_mobile_get_default_pdn_ipv6()

◆ luat_mobile_get_flymode()

◆ luat_mobile_get_iccid()

◆ luat_mobile_get_imei()

◆ luat_mobile_get_imsi()

◆ luat_mobile_get_ip_data_traffic()

◆ luat_mobile_get_isp_from_plmn()

◆ luat_mobile_get_last_call_num()

◆ luat_mobile_get_last_notify_cell_info()

◆ luat_mobile_get_last_notify_cell_info_with_sim_id()

◆ luat_mobile_get_last_notify_signal_strength()

◆ luat_mobile_get_last_notify_signal_strength_info()

◆ luat_mobile_get_local_ip()

◆ luat_mobile_get_muid()