View source for MakaPython A9G

== Introduction ==

MakePython A9G is an IOT for GPRS / GSM + GPS module, users can use MicroPython to program it, which is very easy, especially for non-programmers. There is also a user guide to learn how to use the board to create the first IOT project, which allows beginners to quickly learn hardware and programming skills.<br>

With this board, you will easy to add text, SMS and data to your project. It is good for your smart home project or GPS tracker and so on.<br>

'''Model: [https://www.makerfabs.com/maduino-zero-a9g.html OAC010A9G]'''<br>
[[File:MakePython_0_A9G.jpg|500px]]<br>

== Features ==
*Micro SIM connector
*Support AT Command
*Quad-band: 850/900/1800/1900Mz
*Support GPS
*Support GPRS data traffic, the maximum data rate, download 85.6Kbps, upload 42.8Kbps
*Support SMS text messaging
*Support Micro SD Card
*Working Temperature: -40 – 85℃
*Size: 70*32.6mm

== Interface Function ==
[[File:MakePython_A9G_2.JPG|700px]]<br>
①BAT: 3.7V Lipo battery connector<br>
②CHRG: 5V power input<br>
③Micro SD Card Holder<br>
④Micro SIM Card Holder<br>
⑤A9G Module<br>
⑥GSM: GSM Antenna IPX Interface<br>
⑦GPS: GPS Antenna IPX Interface<br>

==Usage==
Warning: Don't operate when in power supply on (That is, don’t plug or unplug the Antenna ,SIM Cars, SD Card , in case of short-circuit that may burn the IC down.)<br>

===Related instructions===
<pre>
AT+GPS=1   #1:Turn the GPS on, 0:Turn the GPS off
AT+CCID	   #Query SIM, unique serial number, can be used to judge whether the card is normal
AT+CREG?   #Check the registration status of the network
AT+CSQ	   #Query signal strength, the first parameter is the signal strength value
AT+CGATT=1  #Attach to the network, if you need to access the Internet, this command is mandatory
AT+CGDCONT=1,”IP”,”CMNET”	#Set PDP parameters
AT+CGACT=1,1	  #Activate PDP, you can go online after activation
AT+GPSRD=N	  #N is a number indicating that a NEMA message is read every N seconds
AT+GPSRD=0	  #Stop reporting
AT+LOCATION=2   #Get the address information of GPS, as long as the GPS can see the satellite before returning, otherwise it will return GPS NOT FIX NOW
AT+CPMS="SM","SM","SM"   #Set up SMS storage unit
AT+CMGF=0/1		 #Set the SMS format, 1 for text format reading, 0 for pud format reading
AT+CMGR=x		 #Read SMS content, x is the number of SMS
AT+CMGL=4/"ALL"	  #View the SMS list. The reading parameter in PUD format is 4, and the reading parameter in txt format is "ALL"
AT+CMGD=1		#Delete the text message. If you use AT + CMGD = 1,4 then delete all SMS
</pre>

===Project_1: Shows the GPS location on OLED display===
Attention: To get GPS location, please ensure you are outdoor, and plug the GPS Antenna. Indoor may get the incorrect location or no location information.<br>
<br>
The example uses MicroPython programming, very simple and easy to understand.<br>
This MakePython A9G can do nothing. It needs a microcontroller like ESP32 to drive it. The following two routines are implemented by A9G with MakePython ESP32, they can be directly combined to achieve various functions.<br>
[[File:MakePython_A9G_3.JPG|700px]]<br>
You can get MakePython ESP32 from here: 
https://www.makerfabs.com/makepython-esp32.html<br>
Step:<br>
1. Plug in the GPS antenna<br>
2. Plug to MakePython ESP32, connect the USB to the PC.<br>
[[File:MakePython_A9G_4.JPG|700px]]<br>
3. Sample code, or you can get it from here: [https://github.com/Makerfabs/MakePython-A9G A9G_GPS.py]<br>
<pre>
from machine import UART,Pin,I2C
import machine
import ssd1306	
import utime

uart = UART(2, baudrate=115200, rx=21, tx=22,timeout=10)
i2c = I2C(scl=Pin(5), sda=Pin(4), freq=100000)      #Init i2c
lcd=ssd1306.SSD1306_I2C(128,64,i2c)           
lcd.text('Hello, Makerfabs',0,0)
lcd.text('waiting...',0,8)
lcd.show() 

A9G_RESET_PIN = Pin(33, Pin.OUT) 
A9G_RESET_PIN.value(0)             #set pin to low

utime.sleep_ms(2000)
A9G_PWR_KEY = Pin(27, Pin.OUT) 
A9G_PWR_KEY.value(0)
utime.sleep_ms(2000)
A9G_PWR_KEY.value(1)
utime.sleep_ms(20000)

#Display line wrap
p=0 
def text(string,c=0,r=0): 
    global p 
    if p>80: 
        p=0
        lcd.fill(0) 
    colum=int(len(string)/15)+2 
    i=0
    for a in range(0,colum):
        lcd.text(string[i:i+15],c,a*8)
        i=i+15 
    lcd.show() 

if True:
  lcd.fill(0)
  uart.write('AT+GPS=1\r\n')#1: turn on GPS  0:Turn off GPS
  utime.sleep_ms(1000)
  uart.write('AT+GPSRD=10\r\n')
  utime.sleep_ms(1000)
  uart.write('AT+LOCATION=2\r\n')
  utime.sleep_ms(1000)
  while True:      
    if uart.any():
      uart.write('AT+LOCATION=2\r\n') #Get GPS address
      bin_data = uart.readline()
      msg = len(bin_data)
      print(bin_data)
      mystr = str(bin_data[0:msg-2],'utf-8')
      lcd.fill(0)
      text(mystr,0,0)  
      lcd.show() 
    utime.sleep_ms(2000)
</pre>
4. The screen displays NEMA message.<br>
[[File:MakePython_A9G_5.JPG|700px]]<br>
<br>
5. The screen displays GPS address.<br>
[[File:MakePython_A9G_20.JPG|700px]]<br>
*Location information may not be received indoors, and GPS NOT FIX NOW will be displayed on the screen if reception fails.<br>
<br>
6. We can show our location where we are in https://www.gps-coordinates.org/.<br>
[[File:MakePython_A9G_21.JPG|900px]]<br>

===Project_2: Display SMS message on OLED display===
Please note that each text message may require some fees depending on your local GSM operator, make sure the SIM card is active, and leave enough money for this application.<br>
<br>
This example also uses MakePython ESP32 for MicroPython programming.<br>
Step:<br>
1. Plug in the GSM antenna<br>
2. Insert a mini SIM card(GPS does work without a SIM)<br>
[[File:MakePython_A9G_6.JPG|700px]]<br>
3. Plug to MakePython ESP32, connect the USB to the PC.<br>
4. Sample code, or you can get it from here: [https://github.com/Makerfabs/MakePython-A9G A9G_GSM.py]<br>
<pre>
from machine import UART,Pin,I2C
import machine
import ssd1306
import utime
uart = UART(2, baudrate=115200, rx=21, tx=22,timeout=10)
i2c = I2C(scl=Pin(5), sda=Pin(4), freq=100000)      #Init i2c
lcd=ssd1306.SSD1306_I2C(128,64,i2c)           
A9G_RESET_PIN = Pin(33, Pin.OUT) 
A9G_RESET_PIN.value(0)             
utime.sleep_ms(2000)
A9G_PWR_KEY = Pin(27, Pin.OUT) 
A9G_PWR_KEY.value(0)
utime.sleep_ms(2000)
A9G_PWR_KEY.value(1)
utime.sleep_ms(20000)
p=0 
def text(string,c=0,r=0): 
    global p 
    if p>80: 
        p=0
        lcd.fill(0) 
    colum=int(len(string)/15)+2 
    i=0
    for a in range(0,colum):
        lcd.text(string[i:i+15],c,a*8)
        i=i+15 
    lcd.show() 
if True:
    uart.write('AT+GPS=0\r\n')#1: turn on GPS  0:Turn off GPS
    utime.sleep_ms(1000)
    uart.write('AT+CCID\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CREG?\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CGATT=1\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CGACT=1,1\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CGDCONT=1,\"IP\",\"CMNET\"\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CSQ\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CPMS="SM","SM","SM"\r\n')
    utime.sleep_ms(1000)
    uart.write('AT+CMGF=1\r\n')
    utime.sleep_ms(1000)
    #uart.write('AT+CMGL="ALL"\r\n')
    #utime.sleep_ms(1000)
    while True:      
      if uart.any():
        lcd.fill(0)
        uart.write('AT+CMGR=1\r\n')
        utime.sleep_ms(1000)
        bin_data = uart.readline()
        print(bin_data)
        text(bin_data,0,0)
        lcd.show() 
      utime.sleep_ms(2000)
</pre>
4. The screen displays the phone number, time and information for sending SMS.<br>
[[File:MakePython_A9G_7.JPG|500px]]<br>
*Mobile phone to send SMS.<br>
[[File:MakePython_A9G_8.JPG|700px]]<br>
*Display the phone number and time of sending SMS<br>
[[File:MakePython_A9G_10.JPG|700px]]<br>
*Show received content

== FAQ  ==
You can list your questions here or contact with '''support@makerfabs.com''' for technology support.

== Resources ==
*[https://www.makerfabs.com/wiki/images/a/a0/Gprs_series_module_at_instruction_set_v1.0%28A9_A9G%29.pdf AT Command Set]
*[https://www.makerfabs.com/wiki/images/2/22/MakePython_A9G_GPS_Tracker_V1.0.pdf V1.0 Schematic]