/GPRS_C_SDK

Ai-Thinker A9/A9G GPRS (with GPS(A9G)) module C development SDK

Primary LanguageCMIT LicenseMIT

Ai-Thinker GPRS C SDK

Ai-Thinker GPRS SoC development SDK written by C

安信可GPRS模组片上(SoC)开发SDK C语言版

This SDK can be also applied to RDA8955 raw chip 也可直接在RDA8955芯片上运行

English Readme

Average time to resolve an issue Percentage of issues still open

(一) 硬件

1. A9: GPRS 模块


特征
  • 32位内核,主频高达312MHz,4k指令缓存,4k数据缓存
  • 多达29个GPIO(两个GPIO作为下载口)
  • 实时时钟、闹钟
  • 1个USB1.1接口
  • 2个带流控的UART接口(+1个下载调试串口)
  • 2个SPI接口
  • 3个I2C接口
  • 1个SDMMC控制器(接口)
  • 2个10位ADC接口
  • 32Mb(4MB) SPI NOR Flash
  • 32Mb(4MB) DDR PSRAM
  • 8kHz、13Bits/sample ADC mic
  • 48kHz、16bits/sample DAC Audio
  • 电源管理单元:锂电池充电管理、集成DC-DC及LDOs、可变化的IO电压
  • 18.8 x 19.2 mm SMD封装
  • 四频GSM/GPRS(800/900/1800/1900MHz)
  • 语音通话
  • 短信服务

2. A9G: GPRS+GPS+BDS模块


特征
  • A9所有特征
  • 集成GPS+BDS(内部和GPRS串口2连接)

3. A9/A9G GPRS(+GPS+BDS) 开发板


A9/A9G开发板,方便开发和调试

特征
  • 1个A9G模块(A9和A9G采用相同封装,引脚相同,所以开发板通用)
  • 引出模块29个GPIO(包括2个下载调试引脚(HST_TX,HST_RX
  • 1个SIM卡(Micro卡)卡槽(Nano卡<Micro卡<标准卡)
  • 1个TF卡卡槽
  • 1个GPRS IPEX1代座子
  • 1个GPS IPEX1代座子
  • 一个USB接口
  • 5v-4.2V DC-DC,故可以5v供电或者3.8~4.2V供电
  • 1个加速度计LIS3DHx芯片(购买时请咨询客服开发板有无加速度计,默认没有)
  • 1个开机按键,1个复位按键
  • 2个连接到GPIO的LED灯
  • 1个麦克风
pudding开发板引脚图


RDA8955芯片或者其相关模块理论上也可使用本SDK

4. USB转串口模块

需要注意的是,开发板上的USB接口不是USB转串口功能,而是USB1.1功能, 所以,为了下载和调试,需要一个USB转串口模块接板子上的HST_TXHST_RX引脚

5. 电源

  • 可以用锂电池来给模块供电,接VBAT(3.4~4.2V),VBAT供电需要长按(拉低)power-key开机;
  • 开发板也可使用5V接VUSB经过开发板的DC-DC降压后供电,USB转串口模块直接供电也行(仅调试),要保证有足够的电流供应(峰值2A), 因为VUSB接了电所以模块上电会自动开机

(二) SDK特征

  1. 提供易用的API,只要有C语言开发基础就可以快速使用,并提供详细的例程文档
  2. 集成大量功能,包括:
    • GPIO
    • UART
    • 基础信息获取如ICCID、IMEI、IMSI等
    • SPI
    • I2C
    • ADC
    • OS
    • FS
    • GPRS网络(包括基站信息查询)
    • 基站定位(LBS)
    • socket(TCP/UDP)
    • dns
    • SSL/TLS
    • MQTT
    • 短信
    • 通话
    • 低功耗
    • GPS
    • RTC、基站时间同步
    • FOTA
    • 看门狗
    • 音频播放(如播放MP3)
    • 机智云平台快速接入
    • 阿里云CSDK
    • 其它库如json、NMEA解析库等等,具体可以看demo目录或者libs目录

获得SDK

代码托管在github

1. 下载代码


  • 方法二:使用如下命令克隆工程到本地(需先安装git)。

    这种方式可以得到最新的还未发布的代码

git clone https://github.com/Ai-Thinker-Open/GPRS_C_SDK.git

2. 检查代码完整性

下载完后请检查目录platform/csdk目录写是否包含debugrelease目录。 如果没有,则是下载方式错误,请仔细阅读第一步下载正确的文件

(三) 开发文档及例程

文档地址: GPRS C SDK 在线文档

包括开发环境安装、固件下载、调试以及GPRS基础知识、API说明等

例程在本项目的demo目录下

(四) 反馈

这里(issue)可以查看搜索正在讨论或者已经解决的问题

反馈方式:

(五) 参与开发

bug修复、优化、功能模块增加: fork -> 修改 -> 提交PR