中级
30 分钟
通过 MC60 和 TM4C1294NCPDT 提供实时 GPS/GLONASS 数据和可靠的 GSM 移动通信
定位和移动通信的未来
已发布 6月 24, 2024
点击板
GSM/GNSS Click
开发板
Fusion for Tiva v8
编译器
NECTO Studio
微控制器单元
TM4C1294NCPDT
我们的解决方案旨在通过将GPS/GLONASS位置跟踪与GSM模块通信能力无缝集成，彻底改变移动运营，为企业提供了一个多功能工具，用于精确跟踪和无缝连接。
A
A
硬件概览
它是如何工作的？
GSM/GNSS Click基于Quectel Wireless Solutions的MC60，这是一款集成了高性能GNSS引擎和四频段GSM/GPRS引擎的多用途模块。四频段GSM/GPRS引擎可以在850、900、1800和1900MHz频率下工作。它还具有GPRS多时隙类别12，并支持GPRS编码方案CS-1、CS-2、CS-3和CS-4。MC60的GSM部分集成了诸如TCP、UDP、PPP、HTTP和FTP等Internet服务协议。出色的定位性能、低功耗和双μSIM卡接口使MC60成为许多M2M应用的最佳选择。它还支持EPO™技术，该技术提供了预测的扩展预测轨道，以加速TTFF，而不需要额外的服务器。还支持EASY™（嵌入式辅助系统）技术，使GNSS引擎在卫星信息不足时能够快速第一次定位。MC60还支持在经过验证的AlwaysLocate™和GLP（GNSS低功耗）模式下工作，确保在超低功耗的同时具有出色的定位精度。内置的LNA为模块提供了改进的
RF灵敏度和在信号较弱区域的出色的获取/跟踪性能。Quectel MC60模块必须由干净稳定的电源供电。模块正常工作所需的电压为4V，通过MCP1826（1A低压降输出（LDO）稳压器）从5V的mikroBUS™电源轨导出。主要的4V电源也是MC60的GSM/GPRS模块的电源，而GNSS模块则由德州仪器的TLV700（低压差线性稳压器）供电，它的输入接收来自MCP1826 LDO（4V）的电压，输出给出固定的3.3V电压。此外，通过与PWRKEY引脚连接的mikroBUS™插座上的RST引脚，还可以激活模块本身，用于打开和关闭模块。MC60使用UART接口与MCU通信，常用的UART RX和TX引脚以及硬件流控制引脚UART CTS、RTS、RI（发送清除、准备发送和振铃指示）用于连接。GSM/GNSS click还具有一个带有卡检测功能的板载MicroSD/MicroSIM卡插座，路由到mikroBUS™插座上的AN引脚，
A5839蓝牙3.0 2.4GHz芯片天线，仅MC60模块版本支持，以及一个额外的标有HD1的标题用于音频接口（用于连接扬声器和麦克风的通道）。除了所有这些功能，此Click板™还具有一个网络状态黄色LED指示灯，标有NET，指示模块是否连接到网络。此外，它还拥有两个SMA天线连接器，阻抗为50Ω，标有GNSS和GSM，用于连接MIKROE提供的适当天线。当连接到GPS天线时，它可以接收来自轨道卫星的GPS坐标、时间和其他信息。此Click板™可用于所有GSM功能：呼叫、消息（SMS、MMS）和移动互联网。此Click板™可以通过板载跳线选择3.3V或5V逻辑电压电平操作。这样，既能够使用3.3V也能够使用5V的MCU可以正确使用通信线路。此外，此Click板™配备了一个包含易于使用的功能和示例代码的库，可用作进一步开发的参考。
功能概述
开发板
Fusion for TIVA v8 是一款专为快速开发嵌入式应用的需求而特别设计的开发板。它支持广泛的微控制器，如不同的32位ARM® Cortex®-M基础MCUs，来自Texas Instruments，无论它们的引脚数量如何，并且具有一系列独特功能，例如首次通过WiFi网络实现的嵌入式调试器/程序员。开发板布局合理，设计周到，使得最终用户可以在一个地方找到所有必要的元素，如开关、按钮、指示灯、连接器等。得益于创新的制造技术，Fusion for TIVA v8 提供了流畅而沉浸式的工作体验，允许在任何情况下、任何地方、任何
时候都能访问。Fusion for TIVA v8开发板的每个部分都包含了使同一板块运行最高效的必要组件。一个先进的集成CODEGRIP程序/调试模块提供许多有价值的编程/调试选项，包括对JTAG、SWD和SWO Trace（单线输出）的支持，并与Mikroe软件环境无缝集成。此外，它还包括一个干净且调节过的开发板电源供应模块。它可以使用广泛的外部电源，包括电池、外部12V电源供应和通过USB Type-C（USB-C）连接器的电源。通信选项如USB-UART、USB HOST/DEVICE、CAN（如果MCU卡支持的话）和以
太网也包括在内。此外，它还拥有广受好评的 mikroBUS™标准，为MCU卡提供了标准化插座（SiBRAIN标准），以及两种显示选项，用于TFT板线产品和基于字符的LCD。Fusion for TIVA v8 是Mikroe快速开发生态系统的一个组成部分。它由Mikroe软件工具原生支持，得益于大量不同的Click板™（超过一千块板），其数量每天都在增长，它涵盖了原型制作和开发的许多方面。
微控制器概述
MCU卡片 / MCU
类型
8th Generation
建筑
ARM Cortex-M4
MCU 内存 (KB)
1024
硅供应商
Texas Instruments
引脚数
128
RAM (字节)
262144
你完善了我！
配件
橡胶天线GSM/GPRS直角型是我们广泛产品线中所有GSM Click板的理想伴侣。这款专用天线旨在通过出色的特性优化您的无线连接。它的频率范围广泛，涵盖824-894/1710-1990MHz或890-960/1710-1890MHz，可以处理各种频段，确保无缝可靠的连接。该天线具有50欧姆的阻抗和2dB的增益，增强了信号的接收和传输。其70/180MHz的带宽为各种应用提供了灵活性。垂直极化进一步增强了其性能。具有50W的最大输入功率容量，即使在苛刻的条件下，该天线也能确保强大的通信。尺寸紧凑，长度为50mm，带有SMA公头连接器，橡胶天线GSM/GPRS直角型是您无线通信需求的多功能紧凑解决方案。
使用的MCU引脚
mikroBUS™映射器
SD Card Detect
PD0
AN
Reset
PK3
RST
UART RTS
PH0
CS
NC
NC
SCK
NC
NC
MISO
NC
NC
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
UART RI
PL4
PWM
UART CTS
PQ4
INT
UART RX
PK1
TX
UART TX
PK0
RX
NC
NC
SCL
NC
NC
SDA
Power Supply
5V
5V
Ground
GND
GND
1
“仔细看看！”
Click board™ 原理图
一步一步来
项目组装
从选择您的开发板和Click板™开始。以Fusion for Tiva v8作为您的开发板开始
实时跟踪您的结果
应用程序输出
1. 应用程序输出 - 在调试模式下，“应用程序输出”窗口支持实时数据监控，直接提供执行结果的可视化。请按照提供的教程正确配置环境，以确保数据正确显示。
2. UART 终端 - 使用UART Terminal通过USB to UART converter监视数据传输，实现Click board™与开发系统之间的直接通信。请根据项目需求配置波特率和其他串行设置，以确保正常运行。有关分步设置说明，请参考提供的教程。
3. Plot 输出 - Plot功能提供了一种强大的方式来可视化实时传感器数据，使趋势分析、调试和多个数据点的对比变得更加直观。要正确设置，请按照提供的教程，其中包含使用Plot功能显示Click board™读数的分步示例。在代码中使用Plot功能时，请使用以下函数：plot(insert_graph_name, variable_name);。这是一个通用格式，用户需要将“insert_graph_name”替换为实际图表名称，并将“variable_name”替换为要显示的参数。
软件支持
库描述
这个库包含GSM/GNSS Click驱动的API。
关键函数：
gsmgnss_send_cmd- 发送命令函数gsmgnss_set_sim_apn- 设置SIM卡APNgsmgnss_send_sms_pdu- 在PDU模式下发送短信
开源
代码示例
完整的应用程序代码和一个现成的项目可以通过NECTO Studio包管理器直接安装到NECTO Studio。 应用程序代码也可以在MIKROE的GitHub账户中找到。
/*!
* \file
* \brief GSMGNSS Click example
*
* # Description
* This example reads and processes data from GSM/GNSS click.
*
* The demo application is composed of two sections :
*
* ## Application Init
* Initializes the driver and powers up the module, then sets default configuration
* for connecting the device to network.
*
* ## Application Task
* Waits for the device to connect to network, then waits for the GNSS position fix. Once it get a fix,
* it sends an SMS with GNSS info to the selected phone number approximately every 40 seconds.
*
* ## Additional Function
* - static void gsmgnss_clear_app_buf ( void )
* - static void gsmgnss_error_check( err_t error_flag )
* - static void gsmgnss_log_app_buf ( void )
* - static void gsmgnss_check_connection( void )
* - static err_t gsmgnss_rsp_check ( void )
* - static err_t gsmgnss_process ( void )
* - static void gnss_parser_application ( void )
*
* @note
* A passive GPS antenna is required for the GNSS to receive the position fix. It may take several minutes
* for the module to receive the fix.
* In order for the example to work, user needs to set the phone number to which he wants
* to send an SMS, and also will need to set an APN and SMSC (required for PDU mode only) of entered SIM card.
* Enter valid data for the following macros: SIM_APN, SIM_SMSC and PHONE_NUMBER_TO_MESSAGE.
* E.g.
SIM_APN "vipmobile"
SIM_SMSC "+381610401"
PHONE_NUMBER_TO_MESSAGE "+381659999999"
*
* @author MikroE Team
*
*/
// ------------------------------------------------------------------- INCLUDES
#include "board.h"
#include "log.h"
#include "gsmgnss.h"
#include "string.h"
#define APP_OK 0
#define APP_ERROR_DRIVER -1
#define APP_ERROR_OVERFLOW -2
#define APP_ERROR_TIMEOUT -3
#define RSP_OK "OK"
#define RSP_ERROR "ERROR"
#define SIM_APN "" // Set valid SIM APN
#define SIM_SMSC "" // Set valid SMS Service Center Address - only in PDU mode
#define PHONE_NUMBER_TO_MESSAGE "" // Set Phone number to message
#define PROCESS_BUFFER_SIZE 256
#define WAIT_FOR_CONNECTION 0
#define CONNECTED_TO_NETWORK 1
static gsmgnss_t gsmgnss;
static log_t logger;
static char app_buf[ PROCESS_BUFFER_SIZE ] = { 0 };
static int32_t app_buf_len = 0;
static int32_t app_buf_cnt = 0;
static uint8_t app_connection_status = WAIT_FOR_CONNECTION;
static err_t app_error_flag;
static uint8_t gnss_parser_flag = 0;
static uint8_t gnss_info_message[ 200 ] = { 0 };
/**
* @brief GSM/GNSS clearing application buffer.
* @details This function clears memory of application buffer and reset its length and counter.
* @note None.
*/
static void gsmgnss_clear_app_buf ( void );
/**
* @brief GSM/GNSS data reading function.
* @details This function reads data from device and concats data to application buffer.
*
* @return @li @c 0 - Read some data.
* @li @c -1 - Nothing is read.
* @li @c -2 - Application buffer overflow.
*
* See #err_t definition for detailed explanation.
* @note None.
*/
static err_t gsmgnss_process ( void );
/**
* @brief GSM/GNSS check for errors.
* @details This function checks for different types of errors and logs them on UART.
* @note None.
*/
static void gsmgnss_error_check( err_t error_flag );
/**
* @brief GSM/GNSS logs application buffer.
* @details This function logs data from application buffer.
* @note None.
*/
static void gsmgnss_log_app_buf ( void );
/**
* @brief GSM/GNSS response check.
* @details This function checks for response and returns the status of response.
*
* @return application status.
* See #err_t definition for detailed explanation.
* @note None.
*/
static err_t gsmgnss_rsp_check ( void );
/**
* @brief GSM/GNSS check connection.
* @details This function checks connection to the network and
* logs that status to UART.
*
* @note None.
*/
static void gsmgnss_check_connection( void );
/**
* @brief GNSS parser application.
* @param rsp Response buffer.
* @details This function logs GNSS data on the USB UART and stores data in gnss_info_message buffer.
*
* @note None.
*/
static void gnss_parser_application ( char *rsp );
// ------------------------------------------------------ APPLICATION FUNCTIONS
void application_init ( void )
{
log_cfg_t log_cfg;
gsmgnss_cfg_t cfg;
/**
* Logger initialization.
* Default baud rate: 115200
* Default log level: LOG_LEVEL_DEBUG
* @note If USB_UART_RX and USB_UART_TX
* are defined as HAL_PIN_NC, you will
* need to define them manually for log to work.
* See @b LOG_MAP_USB_UART macro definition for detailed explanation.
*/
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
gsmgnss_cfg_setup( &cfg );
GSMGNSS_MAP_MIKROBUS( cfg, MIKROBUS_1 );
gsmgnss_init( &gsmgnss, &cfg );
gsmgnss_module_power( &gsmgnss, GSMGNSS_MODULE_POWER_ON );
// dummy read
gsmgnss_process( );
gsmgnss_clear_app_buf( );
// AT
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_AT );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// ATI - product information
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_ATI );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CGMR - firmware version
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_CGMR );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CMEE - Report Mobile Equipment Error
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CMEE, "2" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// COPS - deregister from network
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_COPS, "2" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CGDCONT - set sim apn
gsmgnss_set_sim_apn( &gsmgnss, SIM_APN );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CFUN - full funtionality
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CFUN, "1" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// COPS - automatic mode
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_COPS, "0" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
// CREG - network registration status
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CREG, "1" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// QGNSSC - power ON GNSS
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_QGNSSC, "1" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
app_buf_len = 0;
app_buf_cnt = 0;
app_connection_status = WAIT_FOR_CONNECTION;
log_info( &logger, " Application Task " );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
void application_task ( void )
{
if ( app_connection_status == WAIT_FOR_CONNECTION )
{
// CREG - network registration status
gsmgnss_send_cmd_check( &gsmgnss, GSMGNSS_CMD_CREG );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CSQ - signal quality
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_CSQ );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
else
{
log_info( &logger, "CONNECTED TO NETWORK" );
// SMS message format - PDU mode
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CMGF, "0" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
for( ; ; )
{
// Get GNSS info
gnss_parser_flag = 1;
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_QGNSSRD, "\"NMEA/GGA\"" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
if ( gnss_parser_flag == 0 )
{
log_printf( &logger, "> Sending message to phone number...\r\n" );
gsmgnss_send_sms_pdu ( &gsmgnss, SIM_SMSC, PHONE_NUMBER_TO_MESSAGE, gnss_info_message );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
// 30 seconds delay
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
}
}
}
int main ( void )
{
/* Do not remove this line or clock might not be set correctly. */
#ifdef PREINIT_SUPPORTED
preinit();
#endif
application_init( );
for ( ; ; )
{
application_task( );
}
return 0;
}
static void gsmgnss_clear_app_buf ( void )
{
memset( app_buf, 0, app_buf_len );
app_buf_len = 0;
app_buf_cnt = 0;
}
static err_t gsmgnss_process ( void )
{
err_t return_flag = APP_ERROR_DRIVER;
int32_t rx_size;
char rx_buff[ PROCESS_BUFFER_SIZE ] = { 0 };
rx_size = gsmgnss_generic_read( &gsmgnss, rx_buff, PROCESS_BUFFER_SIZE );
if ( rx_size > 0 )
{
int32_t buf_cnt = 0;
return_flag = APP_OK;
if ( app_buf_len + rx_size >= PROCESS_BUFFER_SIZE )
{
gsmgnss_clear_app_buf( );
return_flag = APP_ERROR_OVERFLOW;
}
else
{
buf_cnt = app_buf_len;
app_buf_len += rx_size;
}
for ( int32_t rx_cnt = 0; rx_cnt < rx_size; rx_cnt++ )
{
if ( rx_buff[ rx_cnt ] != 0 )
{
app_buf[ ( buf_cnt + rx_cnt ) ] = rx_buff[ rx_cnt ];
}
else
{
app_buf_len--;
buf_cnt--;
}
}
}
return return_flag;
}
static err_t gsmgnss_rsp_check ( void )
{
uint32_t timeout_cnt = 0;
uint32_t timeout = 100000;
err_t error_flag = gsmgnss_process( );
if ( ( error_flag != 0 ) && ( error_flag != -1 ) )
{
return error_flag;
}
while ( ( strstr( app_buf, RSP_OK ) == 0 ) && ( strstr( app_buf, RSP_ERROR ) == 0 ) )
{
error_flag = gsmgnss_process( );
if ( ( error_flag != 0 ) && ( error_flag != -1 ) )
{
return error_flag;
}
timeout_cnt++;
if ( timeout_cnt > timeout )
{
while ( ( strstr( app_buf, RSP_OK ) == 0 ) && ( strstr( app_buf, RSP_ERROR ) == 0 ) )
{
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_AT );
gsmgnss_process( );
Delay_ms ( 100 );
}
gsmgnss_clear_app_buf( );
return APP_ERROR_TIMEOUT;
}
Delay_ms ( 1 );
}
gsmgnss_check_connection();
gsmgnss_log_app_buf();
return APP_OK;
}
static void gsmgnss_error_check( err_t error_flag )
{
if ( ( error_flag != 0 ) && ( error_flag != -1 ) )
{
switch ( error_flag )
{
case -2:
log_error( &logger, " Overflow!" );
break;
case -3:
log_error( &logger, " Timeout!" );
break;
default:
break;
}
}
}
static void gsmgnss_log_app_buf ( void )
{
if ( gnss_parser_flag == 1 )
{
gnss_parser_application( app_buf );
}
else
{
for ( int32_t buf_cnt = 0; buf_cnt < app_buf_len; buf_cnt++ )
{
log_printf( &logger, "%c", app_buf[ buf_cnt ] );
}
log_printf( &logger, "\r\n-----------------------------------\r\n" );
}
gsmgnss_clear_app_buf( );
}
static void gsmgnss_check_connection( void )
{
#define CONNECTED "+CREG: 1,1"
if ( strstr( app_buf, CONNECTED ) != 0 )
{
app_connection_status = CONNECTED_TO_NETWORK;
}
}
static void gnss_parser_application ( char *rsp )
{
char element_buf[ 200 ] = { 0 };
memset( gnss_info_message, 0, 200 );
gsmgnss_generic_parser( rsp, GSMGNSS_NMEA_GNGGA, GSMGNSS_GNGGA_LATITUDE, element_buf );
if ( strlen( element_buf ) )
{
strcpy( gnss_info_message, "GNSS info\n" );
strcat( gnss_info_message, "Latitude: " );
strncat( gnss_info_message, element_buf, 2 );
strcat( gnss_info_message, " deg, " );
strcat( gnss_info_message, &element_buf[ 2 ] );
strcat( gnss_info_message, " min" );
gsmgnss_generic_parser( rsp, GSMGNSS_NMEA_GNGGA, GSMGNSS_GNGGA_LONGITUDE, element_buf );
strcat( gnss_info_message, "\nLongitude: " );
strncat( gnss_info_message, element_buf, 3 );
strcat( gnss_info_message, " deg, " );
strcat( gnss_info_message, &element_buf[ 3 ] );
strcat( gnss_info_message, " min" );
memset( element_buf, 0, sizeof( element_buf ) );
gsmgnss_generic_parser( rsp, GSMGNSS_NMEA_GNGGA, GSMGNSS_GNGGA_ALTITUDE, element_buf );
strcat( gnss_info_message, "\nAltitude: " );
strcat( gnss_info_message, element_buf );
strcat( gnss_info_message, " m" );
log_printf( &logger, "%s", gnss_info_message );
gnss_parser_flag = 0;
}
else
{
log_printf( &logger, "Waiting for the position fix..." );
}
log_printf( &logger, "\r\n-----------------------------------\r\n" );
}
// ------------------------------------------------------------------------ END
/*!
* \file
* \brief GSMGNSS Click example
*
* # Description
* This example reads and processes data from GSM/GNSS click.
*
* The demo application is composed of two sections :
*
* ## Application Init
* Initializes the driver and powers up the module, then sets default configuration
* for connecting the device to network.
*
* ## Application Task
* Waits for the device to connect to network, then waits for the GNSS position fix. Once it get a fix,
* it sends an SMS with GNSS info to the selected phone number approximately every 40 seconds.
*
* ## Additional Function
* - static void gsmgnss_clear_app_buf ( void )
* - static void gsmgnss_error_check( err_t error_flag )
* - static void gsmgnss_log_app_buf ( void )
* - static void gsmgnss_check_connection( void )
* - static err_t gsmgnss_rsp_check ( void )
* - static err_t gsmgnss_process ( void )
* - static void gnss_parser_application ( void )
*
* @note
* A passive GPS antenna is required for the GNSS to receive the position fix. It may take several minutes
* for the module to receive the fix.
* In order for the example to work, user needs to set the phone number to which he wants
* to send an SMS, and also will need to set an APN and SMSC (required for PDU mode only) of entered SIM card.
* Enter valid data for the following macros: SIM_APN, SIM_SMSC and PHONE_NUMBER_TO_MESSAGE.
* E.g.
SIM_APN "vipmobile"
SIM_SMSC "+381610401"
PHONE_NUMBER_TO_MESSAGE "+381659999999"
*
* @author MikroE Team
*
*/
// ------------------------------------------------------------------- INCLUDES
#include "board.h"
#include "log.h"
#include "gsmgnss.h"
#include "string.h"
#define APP_OK 0
#define APP_ERROR_DRIVER -1
#define APP_ERROR_OVERFLOW -2
#define APP_ERROR_TIMEOUT -3
#define RSP_OK "OK"
#define RSP_ERROR "ERROR"
#define SIM_APN "" // Set valid SIM APN
#define SIM_SMSC "" // Set valid SMS Service Center Address - only in PDU mode
#define PHONE_NUMBER_TO_MESSAGE "" // Set Phone number to message
#define PROCESS_BUFFER_SIZE 256
#define WAIT_FOR_CONNECTION 0
#define CONNECTED_TO_NETWORK 1
static gsmgnss_t gsmgnss;
static log_t logger;
static char app_buf[ PROCESS_BUFFER_SIZE ] = { 0 };
static int32_t app_buf_len = 0;
static int32_t app_buf_cnt = 0;
static uint8_t app_connection_status = WAIT_FOR_CONNECTION;
static err_t app_error_flag;
static uint8_t gnss_parser_flag = 0;
static uint8_t gnss_info_message[ 200 ] = { 0 };
/**
* @brief GSM/GNSS clearing application buffer.
* @details This function clears memory of application buffer and reset its length and counter.
* @note None.
*/
static void gsmgnss_clear_app_buf ( void );
/**
* @brief GSM/GNSS data reading function.
* @details This function reads data from device and concats data to application buffer.
*
* @return @li @c 0 - Read some data.
* @li @c -1 - Nothing is read.
* @li @c -2 - Application buffer overflow.
*
* See #err_t definition for detailed explanation.
* @note None.
*/
static err_t gsmgnss_process ( void );
/**
* @brief GSM/GNSS check for errors.
* @details This function checks for different types of errors and logs them on UART.
* @note None.
*/
static void gsmgnss_error_check( err_t error_flag );
/**
* @brief GSM/GNSS logs application buffer.
* @details This function logs data from application buffer.
* @note None.
*/
static void gsmgnss_log_app_buf ( void );
/**
* @brief GSM/GNSS response check.
* @details This function checks for response and returns the status of response.
*
* @return application status.
* See #err_t definition for detailed explanation.
* @note None.
*/
static err_t gsmgnss_rsp_check ( void );
/**
* @brief GSM/GNSS check connection.
* @details This function checks connection to the network and
* logs that status to UART.
*
* @note None.
*/
static void gsmgnss_check_connection( void );
/**
* @brief GNSS parser application.
* @param rsp Response buffer.
* @details This function logs GNSS data on the USB UART and stores data in gnss_info_message buffer.
*
* @note None.
*/
static void gnss_parser_application ( char *rsp );
// ------------------------------------------------------ APPLICATION FUNCTIONS
void application_init ( void )
{
log_cfg_t log_cfg;
gsmgnss_cfg_t cfg;
/**
* Logger initialization.
* Default baud rate: 115200
* Default log level: LOG_LEVEL_DEBUG
* @note If USB_UART_RX and USB_UART_TX
* are defined as HAL_PIN_NC, you will
* need to define them manually for log to work.
* See @b LOG_MAP_USB_UART macro definition for detailed explanation.
*/
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
gsmgnss_cfg_setup( &cfg );
GSMGNSS_MAP_MIKROBUS( cfg, MIKROBUS_1 );
gsmgnss_init( &gsmgnss, &cfg );
gsmgnss_module_power( &gsmgnss, GSMGNSS_MODULE_POWER_ON );
// dummy read
gsmgnss_process( );
gsmgnss_clear_app_buf( );
// AT
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_AT );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// ATI - product information
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_ATI );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CGMR - firmware version
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_CGMR );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CMEE - Report Mobile Equipment Error
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CMEE, "2" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// COPS - deregister from network
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_COPS, "2" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CGDCONT - set sim apn
gsmgnss_set_sim_apn( &gsmgnss, SIM_APN );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CFUN - full funtionality
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CFUN, "1" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// COPS - automatic mode
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_COPS, "0" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
// CREG - network registration status
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CREG, "1" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// QGNSSC - power ON GNSS
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_QGNSSC, "1" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
app_buf_len = 0;
app_buf_cnt = 0;
app_connection_status = WAIT_FOR_CONNECTION;
log_info( &logger, " Application Task " );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
void application_task ( void )
{
if ( app_connection_status == WAIT_FOR_CONNECTION )
{
// CREG - network registration status
gsmgnss_send_cmd_check( &gsmgnss, GSMGNSS_CMD_CREG );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 500 );
// CSQ - signal quality
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_CSQ );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
else
{
log_info( &logger, "CONNECTED TO NETWORK" );
// SMS message format - PDU mode
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_CMGF, "0" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
for( ; ; )
{
// Get GNSS info
gnss_parser_flag = 1;
gsmgnss_send_cmd_with_parameter( &gsmgnss, GSMGNSS_CMD_QGNSSRD, "\"NMEA/GGA\"" );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
if ( gnss_parser_flag == 0 )
{
log_printf( &logger, "> Sending message to phone number...\r\n" );
gsmgnss_send_sms_pdu ( &gsmgnss, SIM_SMSC, PHONE_NUMBER_TO_MESSAGE, gnss_info_message );
app_error_flag = gsmgnss_rsp_check( );
gsmgnss_error_check( app_error_flag );
// 30 seconds delay
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
}
}
}
}
int main ( void )
{
/* Do not remove this line or clock might not be set correctly. */
#ifdef PREINIT_SUPPORTED
preinit();
#endif
application_init( );
for ( ; ; )
{
application_task( );
}
return 0;
}
static void gsmgnss_clear_app_buf ( void )
{
memset( app_buf, 0, app_buf_len );
app_buf_len = 0;
app_buf_cnt = 0;
}
static err_t gsmgnss_process ( void )
{
err_t return_flag = APP_ERROR_DRIVER;
int32_t rx_size;
char rx_buff[ PROCESS_BUFFER_SIZE ] = { 0 };
rx_size = gsmgnss_generic_read( &gsmgnss, rx_buff, PROCESS_BUFFER_SIZE );
if ( rx_size > 0 )
{
int32_t buf_cnt = 0;
return_flag = APP_OK;
if ( app_buf_len + rx_size >= PROCESS_BUFFER_SIZE )
{
gsmgnss_clear_app_buf( );
return_flag = APP_ERROR_OVERFLOW;
}
else
{
buf_cnt = app_buf_len;
app_buf_len += rx_size;
}
for ( int32_t rx_cnt = 0; rx_cnt < rx_size; rx_cnt++ )
{
if ( rx_buff[ rx_cnt ] != 0 )
{
app_buf[ ( buf_cnt + rx_cnt ) ] = rx_buff[ rx_cnt ];
}
else
{
app_buf_len--;
buf_cnt--;
}
}
}
return return_flag;
}
static err_t gsmgnss_rsp_check ( void )
{
uint32_t timeout_cnt = 0;
uint32_t timeout = 100000;
err_t error_flag = gsmgnss_process( );
if ( ( error_flag != 0 ) && ( error_flag != -1 ) )
{
return error_flag;
}
while ( ( strstr( app_buf, RSP_OK ) == 0 ) && ( strstr( app_buf, RSP_ERROR ) == 0 ) )
{
error_flag = gsmgnss_process( );
if ( ( error_flag != 0 ) && ( error_flag != -1 ) )
{
return error_flag;
}
timeout_cnt++;
if ( timeout_cnt > timeout )
{
while ( ( strstr( app_buf, RSP_OK ) == 0 ) && ( strstr( app_buf, RSP_ERROR ) == 0 ) )
{
gsmgnss_send_cmd( &gsmgnss, GSMGNSS_CMD_AT );
gsmgnss_process( );
Delay_ms ( 100 );
}
gsmgnss_clear_app_buf( );
return APP_ERROR_TIMEOUT;
}
Delay_ms ( 1 );
}
gsmgnss_check_connection();
gsmgnss_log_app_buf();
return APP_OK;
}
static void gsmgnss_error_check( err_t error_flag )
{
if ( ( error_flag != 0 ) && ( error_flag != -1 ) )
{
switch ( error_flag )
{
case -2:
log_error( &logger, " Overflow!" );
break;
case -3:
log_error( &logger, " Timeout!" );
break;
default:
break;
}
}
}
static void gsmgnss_log_app_buf ( void )
{
if ( gnss_parser_flag == 1 )
{
gnss_parser_application( app_buf );
}
else
{
for ( int32_t buf_cnt = 0; buf_cnt < app_buf_len; buf_cnt++ )
{
log_printf( &logger, "%c", app_buf[ buf_cnt ] );
}
log_printf( &logger, "\r\n-----------------------------------\r\n" );
}
gsmgnss_clear_app_buf( );
}
static void gsmgnss_check_connection( void )
{
#define CONNECTED "+CREG: 1,1"
if ( strstr( app_buf, CONNECTED ) != 0 )
{
app_connection_status = CONNECTED_TO_NETWORK;
}
}
static void gnss_parser_application ( char *rsp )
{
char element_buf[ 200 ] = { 0 };
memset( gnss_info_message, 0, 200 );
gsmgnss_generic_parser( rsp, GSMGNSS_NMEA_GNGGA, GSMGNSS_GNGGA_LATITUDE, element_buf );
if ( strlen( element_buf ) )
{
strcpy( gnss_info_message, "GNSS info\n" );
strcat( gnss_info_message, "Latitude: " );
strncat( gnss_info_message, element_buf, 2 );
strcat( gnss_info_message, " deg, " );
strcat( gnss_info_message, &element_buf[ 2 ] );
strcat( gnss_info_message, " min" );
gsmgnss_generic_parser( rsp, GSMGNSS_NMEA_GNGGA, GSMGNSS_GNGGA_LONGITUDE, element_buf );
strcat( gnss_info_message, "\nLongitude: " );
strncat( gnss_info_message, element_buf, 3 );
strcat( gnss_info_message, " deg, " );
strcat( gnss_info_message, &element_buf[ 3 ] );
strcat( gnss_info_message, " min" );
memset( element_buf, 0, sizeof( element_buf ) );
gsmgnss_generic_parser( rsp, GSMGNSS_NMEA_GNGGA, GSMGNSS_GNGGA_ALTITUDE, element_buf );
strcat( gnss_info_message, "\nAltitude: " );
strcat( gnss_info_message, element_buf );
strcat( gnss_info_message, " m" );
log_printf( &logger, "%s", gnss_info_message );
gnss_parser_flag = 0;
}
else
{
log_printf( &logger, "Waiting for the position fix..." );
}
log_printf( &logger, "\r\n-----------------------------------\r\n" );
}
// ------------------------------------------------------------------------ END
