GPRS API

更新时间:2022-11-24 09:20:24

API 列表

函数名称 功能描述
tuya_gprs_service_start_with_apn 启动移动模组的数据拨号
tuya_gprs_service_pending 暂停移动模组的数据服务线程
tuya_gprs_service_resume 恢复移动模组的数据服务线程
tuya_gprs_get_imsi 查询国际移动用户识别码
tuya_gprs_get_status 查询移动模组的数据服务状态
tuya_gprs_get_work_mode 查询移动通信的工作模式
tuya_gprs_set_work_mode 设置移动通信的工作模式
tuya_gprs_reset_net 复位移动通信的工作模式
tuya_gprs_get_simid 查询当前使用的 SIM 卡 ID
tuya_gprs_get_cid 查询当前使用的模组的数据通信的 channel
tuya_gprs_service_start_autoretry 启动移动通信 PDP(Packet Data Protocol)失败后,自动重新连接
tuya_gprs_service_stop_autoretry 停止移动通信 PDP 失败后,自动重新连接

API 说明

tuya_gprs_service_start_with_apn

定义 说明
函数原型 int tuya_gprs_service_start_with_apn(char *apn, unsigned char *usr, unsigned char *pwd)
功能说明 启动移动模组的数据拨号
参数
  • apn:APN名称,字符串格式,如果为空,系统自动设置 APN
  • usr:APN 认证用户名(默认为空)
  • pwd:APN 认证密码(默认为空)
返回值
  • 0:成功
  • 其它:失败

tuya_gprs_service_pending

定义 说明
函数原型 int tuya_gprs_service_pending(void)
功能说明 暂停移动模组的数据服务线程
参数
返回值
  • 0:成功
  • 其它:失败

tuya_gprs_service_resume

定义 说明
函数原型 int tuya_gprs_service_resume(void)
功能说明 恢复移动模组的数据服务线程
参数
返回值
  • 0:成功
  • 其它:失败

tuya_gprs_get_imsi

定义 说明
函数原型 int tuya_gprs_get_imsi(char imsi[16])
功能说明 查询国际移动用户识别码
参数 imsi:存储移动用户识别码的缓冲
返回值
  • 0:成功
  • 其它:失败

tuya_gprs_get_status

定义 说明
函数原型 int tuya_gprs_get_status(void)
功能说明 查询移动模组的数据服务状态
参数
返回值
  • GPRS_STATUS_IDLE:空闲
  • GPRS_STATUS_REG:注册
  • GPRS_STATUS_CAMPED:拒绝注册
  • GPRS_STATUS_ACTIVE:激活

tuya_gprs_get_work_mode

定义 说明
函数原型 int tuya_gprs_get_work_mode(int *work_mode)
功能说明 查询移动通信的工作模式
参数 work_mode:存储工作模式的内存地址
返回值
  • 0:成功
  • 其它:失败

tuya_gprs_set_work_mode

定义 说明
函数原型 int tuya_gprs_set_work_mode(int work_mode)
功能说明 设置移动通信的工作模式
参数 work_mode:工作模式
返回值
  • 返回值:0:成功
  • 其它:失败

tuya_gprs_reset_net

定义 说明
函数原型 int tuya_gprs_reset_net(void)
功能说明 复位移动通信的工作模式
参数
返回值
  • 0:成功
  • 其他:失败

tuya_gprs_get_simid

定义 说明
函数原型 uint8_t tuya_gprs_get_simid(void)
功能说明 查询当前使用的 SIM 卡 ID
参数
返回值 SIM 卡 ID:0 或 1

tuya_gprs_get_cid

定义 说明
函数原型 uint8_t tuya_gprs_get_cid(void)
功能说明 查询当前使用的模组的数据通信的通道(channel)
参数
返回值 通道 ID

tuya_gprs_service_start_autoretry

定义 说明
函数原型 int tuya_gprs_service_start_autoretry(void)
功能说明 启动移动通信 PDP 失败后,自动重新连接
参数
返回值
  • 0:成功
  • 其它:失败

tuya_gprs_service_stop_autoretry

定义 说明
函数原型 int tuya_gprs_service_stop_autoretry(void)
功能说明 停止移动通信 PDP 失败后,自动重新连接
参数
返回值
  • 0:成功
  • 其它:失败