README_EN.md · h3l/GPRS_C_SDK

[Ai-Thinker GPRS C SDK](https://github.com/Ai-Thinker-Open/GPRS-C-SDK)
=====

Ai-Thinker GPRS SoC development SDK written by C.

[中文版本](./README.md)

[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/ai-thinker-open/gprs_c_sdk.svg)](http://isitmaintained.com/project/ai-thinker-open/gprs_c_sdk "Average time to resolve an issue") [![Percentage of issues still open](http://isitmaintained.com/badge/open/ai-thinker-open/gprs_c_sdk.svg)](http://isitmaintained.com/project/ai-thinker-open/gprs_c_sdk "Percentage of issues still open")

## ( A ) Hardware

### 1. A9: GPRS Module

![](./doc/assets/A9.png) 
**Features**:
 * RDA 32 bit RISC core, frequency up to 312MHz, with 4k instruction cache, 4k data cache
 * Up to 29 GPIOs (with two download pins)
 * Calendar (Real Time Clock) with alarm
 * 1 USB1.1 device interface
 * 2 UART interface with flow control (+1 download/debug serial port)
 * 2 SPI interface
 * 3 I 2 C interface
 * 1 SDMMC controller (interface)
 * 2 ADC interface, 10 bits
 * 32Mb (4MB) SPI NOR Flash
 * 32Mb (4MB) DDR PSRAM
 * 8kHz, 13Bits/sample ADC mic
 * 48kHz, 16bits/sample DAC Audio
 * Power Management Unit: Lithium battery charge management, integrated DC-DC and LDOs, variable IO voltage
 * 18.8 x 19.2 mm SMD package
 * Quad-band GSM/GPRS (800/900/1800 / 1900MHz)
 * calls
 * SMS service

### 2. A9G: GPRS + GPS + BDS Module

![](./doc/assets/A9G.png) 
**Features**:
 * All the features of A9 above
 * Integrated GPS+BDS (connected to UART2 internal of module)

### 3. A9/A9G GPRS (+GPS+BDS) Development Board( pudding)

![](./doc/assets/A9G_dev.png) 
A9/A9G development board for easy development and debugging
**Features**:
 * 1 A9G module (the board be the same that with A9 and A9G, for the A9 and A9G in the same package, the same pin )
 * 29 GPIOs with 2.45mm spacing (with 2 download debug pins (`HST_TX`,` HST_RX`)
 * One SIM card slot (Nano Card <Micro Card <Standard Card)
 * 1 TF card slot
 * 1 GPRS interface with IPEX 1 generation package
 * 1 GPS interface with IPEX 1 generation package
 * 1 micro USB interface
 * 5v-4.2V DC-DC, it can be 5v power supply or 3.8 ~ 4.2V power supply
 * ~~1 accelerometer chip(LIS3DHx)~~(not soldered by default)
 * 1 power key, and a reset button
 * 2 LED
 * 1 microphone 
![](./doc/assets/pudding_pin.png)

> Or you can use other RDA8955 chip related module or board

### 4. USB to Serial Module

![](./doc/assets/USB-UART.png) 
It should be noted that the USB interface on the development board is not a USB serial port function, but USB1.1 function,
Therefore, in order to download or debug, you need at least one USB to serial port module to connect board's `HST_TX` and` HST_RX` pin

### 5. Power Supply
* board can be light up with 5V(with DC-DC on dev-board) or 4.2V(`VBAT`) power, and ensure supply enough current(Peak current 2A)
* if use lithium battery connected to `VBAT`, you must press <kbd>power-key</kbd> for a while to power up the module, or just pull down the `power-key` pin.
* if `VUSB` connected with 5V(`VBAT` must supply with power ), the module will automaticly power up no matter `power-key` poll down or not.

## ( B ) SDK

### SDK Features

* Provide easy-to-use API, as long as you have `C` language knowledge. 
Integrates a wide range of features including basic GPIO, UART, SPI, IIC, ADC, RTC, OS, FS, SMS, CALL and GPRS, socket, DNS, MQTT, SSL/TLS, LBS, Audio play, Gizwits cloud, aliyun, libs cJson、NMEA etc.

### Get the SDK

**Attention**: Please **DO NOT** Download using the green <kbd> Clone or download </kbd> button in the top right corner of the page will result in tarballs without `SDK-LIB`

there's two way to download SDK:

* Download the latest released archive from [github release page](https://github.com/Ai-Thinker-Open/GPRS_C_SDK/releases).
  > This release gets the released version of the code

* Or clone directly(need to install `git`), and **must with parameter` --recursive`**, or get incomplete SDK files
```
git clone https://github.com/Ai-Thinker-Open/GPRS_C_SDK.git --recursive
```

### Develop applications using the SDK

Examples refer to the [demo](https://github.com/Ai-Thinker-Open/GPRS_C_SDK/tree/master/demo) folder

**Doumentation** here:  [GPRS C SDK DOC](https://ai-thinker-open.github.io/GPRS_C_SDK_DOC/en)

Including environment installation, burn & debug, api docs etc.

## ( E ) Feedback

* [creat issue on github](https://github.com/Ai-Thinker-Open/GPRS-C-SDK/issues/new)

* Or [discuss on forum ](http://bbs.ai-thinker.com/forum.php?mod=forumdisplay&fid=37)

* Click ★ <kbd> Star </kbd> on the right conner of this page if this repo helps you

## ( F ) Participate in the development

fork -> modify -> submit PR

h3l/GPRS_C_SDK

简介

发行版

贡献者

近期动态

h3l/GPRS_C_SDK .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

h3l/GPRS_C_SDK