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

(一) 硬件

1. A9: GPRS 模块

特征

32位内核，主频高达312MHz，4k指令缓存，4k数据缓存
多达29个GPIO（两个GPIO作为下载口）
实时时钟、闹钟
1个USB1.1接口
2个带流控的UART接口（+1个下载调试串口）
2个SPI接口
3个I²C接口
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_TX和HST_RX引脚

5. 电源

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

(二) SDK特征

提供易用的API，只要有C语言开发基础就可以快速使用，并提供详细的例程和文档
集成大量功能，包括：
- 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. 下载代码

方法一：从github发布页面下载最新发布的压缩包（推荐）。

这种方式获取的代码的发布的版本

方法二：使用如下命令克隆工程到本地（需先安装git）。
这种方式可以得到最新的还未发布的代码
```
git clone https://github.com/Ai-Thinker-Open/GPRS_C_SDK.git
```
2. 检查代码完整性

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

(三) 开发文档及例程

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

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

例程在本项目的demo目录下

(四) 反馈

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

反馈方式：

方式一：github 添加issue
方式二：安信可论坛讨论
右上角★Star一个不会迷路哦,下次方便找到哦~

(五) 参与开发

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

Ai-Thinker-Open / GPRS_C_SDK

readme