.. module:: g350

***********
G350 Module
***********

This module implements the Zerynth driver for the Ublox G350 (or U260) gsm/gprs chip (`System Integration Manual <https://www.u-blox.com/sites/default/files/SARA-G3-U2_SysIntegrManual_(UBX-13000995).pdf>`_).

The driver must be used together with the standard library :ref:`GSM Module <stdlib_gsm>`.

The following functionalities are implemented:

    * attach/detach from gprs network
    * retrieve and set available operators
    * retrieve signal strength
    * retrieve network and device info
    * socket abstraction (and secure socket if available on the model). Listening sockets for TCP and UDP protocols are not implemented due to the nature of GSM networks.

The communication with G350 is performed via UART without hardware flow control.

This module provides the :samp:`g350Exception` to signal errors related to the hardware initialization and management.

   
.. function::auto_init()

    Tries to initialize the G350 device with auto parameters if possible.
    Raise :samp:`UnsupportedError` otherwise.
    
.. function::init(serial,dtr,rts,poweron,reset)

    Initialize the G350 device given the following parameters:

    * *serial*, the serial port connected to the G350 (:samp;`SERIAL1`,:samp:`SERIAL2`, etc..)
    * *dtr*, the DTR pin of G350
    * *rts*, the RTS pin of G350
    * *poweron*, the power up pin of G350
    * *reset*, the reset pin of G350

    
.. function::last_error()

    Return the textual description of the last AT command error (refer to +CME ERRORS in the `AT command manual <www.u-blox.com/sites/default/files/u-blox-ATCommands_Manual_(UBX-13002752).pdf>`_

    
    
.. function:: rtc()

    Return a tuple of seven elements:

        * current year
        * current month (1-12)
        * current day (1-31)
        * current hour (0-23)
        * current minute (0-59)
        * current second (0-59)
        * current timezone in minutes away from GMT 0

    The returned time is always UTC time with a timezone indication.