初学者
10 分钟

无论身在何处,凭借SARA-G350和PIC32MZ1024EFH064保持与世界的连接

您的全球通信钥匙,紧凑的解决方案

GSM 4 Click with PIC32MZ clicker

已发布 6月 24, 2024

点击板

GSM 4 Click

开发板

PIC32MZ clicker

编译器

NECTO Studio

微控制器单元

PIC32MZ1024EFH064

我们的紧凑型四频段GSM蜂窝网络通信解决方案确保您在全球范围内保持不间断的连接,无论您身在何处,都可以联系到您。

A

A

硬件概览

它是如何工作的?

GSM 4 Click基于u-blox的SARA-G350,这是一款四频2.5G GSM/GPRS模块。它覆盖850/900MHz和1800/1900MHz的频率。它符合10级规范,具有4个下载插槽/2个上传插槽,总共支持5个插槽。该模块是Click板的主要组件,由多个内部模块或部分组成,例如天线切换部分、射频收发器部分、内存、电源管理以及最重要的 - 移动基带处理器。SARA-G350模块提供广泛的音频功能,包括半速率、全速率、增强全速率和自适应多速率语音编解码器、出色的回声消除和降噪、多个预编程音频配置文件、专业的免提算法,所有这些都可以通过AT命令进行配置。音频DSP部分集成在模块中,仅需要一些外部组件。可通过4极3.5mm音频插孔连接耳机。Click板背面的Micro SIM卡插槽用于安装Micro SIM卡。没有有效的SIM卡,该设备无法使用,该SIM卡允许连接到移动网络。支持1.8V和3V SIM卡

类型。模块正常工作所需的电压约为4V,它来自Microchip的MCP1826,这是一款1A低压降(LDO)稳压器,通过5V的mikroBUS™总线导出。SARA-G350的数字部分由内部1.8V供电,因此需要调理将主控MCU与模块连接的通信总线。SARA-G350从其内部LDO输出1.8V输出,为TXB0106的一侧提供所需的参考电压,该器件是一款6位双向电平转换和电压转换器,具有来自德州仪器的自动方向感测。GSM 4 Click使用标准的2线UART接口与主控MCU通信,包括常用的UART RX、TX和硬件流控制引脚UART RTS和CTS。UART接口支持从2400 bps到115.2 kbps的波特率,并支持高达115.2 kbps的自动波特率检测。自动波特率检测模式默认设置。除了我们提供的库之外,您还可以使用标准的AT命令集。如果将GSM 4 Click用于电话呼叫或类似应用,RI引脚是一个振铃指示器。PWR引脚

用于像PWR按钮一样为模块供电。模块主控MCU的状态可以通过STA引脚读取。相同的线路也通过STAT LED进行路由以进行可视化呈现。此外,对于此模块,还有TX LED。GSM 4 Click通过micro-USB连接器提供USB接口,路由到FT230X IC,这是来自FTDI公司的成熟的USB到UART解决方案。除了电平转换器IC外,来自SARA-G350的相同UART线路也被路由到此USB到UART IC,通过个人计算机和USB连接方便地访问SARA-G350模块。有两个LED,红色和黄色,标有TX和RX,用于提供USB到UART通信的视觉反馈。此Click板可以通过PWR SEL跳线选择3.3V或5V逻辑电压级别操作。此外,此Click板配备了一个包含易于使用的函数和示例代码的库,可用于进一步的开发。

GSM 4 Click hardware overview image

功能概述

开发板

PIC32MZ Clicker 是一款紧凑型入门开发板,它将 Click 板™的灵活性带给您喜爱的微控制器,使其成为实现您想法的完美入门套件。它配备了一款板载 32 位带有浮点单元的 Microchip PIC32MZ 微控制器,一个 USB 连接器,LED 指示灯,按钮,一个 mikroProg 连接器,以及一个用于与外部电子设备接口的头部。得益于其紧凑的设计和清晰易识别的丝网标记,它提供了流畅且沉浸式的工作体验,允许在任

何情况下、任何地方都能访问。PIC32MZ Clicker 开 发套件的每个部分都包含了使同一板块运行最高效的必要组件。除了可以选择 PIC32MZ Clicker 的编程方式,使用 USB HID mikroBootloader 或通过外部 mikroProg 连接器为 PIC,dsPIC 或 PIC32 编程外,Clicker 板还包括一个干净且调节过的开发套件电源供应模块。USB Micro-B 连接可以提供多达 500mA 的电流,这足以操作所有板载和附加模块。所有 

mikroBUS™ 本身支持的通信方法都在这块板上,包 括已经建立良好的 mikroBUS™ 插槽、重置按钮以及若干按钮和 LED 指示灯。PIC32MZ Clicker 是 Mikroe 生态系统的一个组成部分,允许您在几分钟内创建新的应用程序。它由 Mikroe 软件工具原生支持,得益于大量不同的 Click 板™(超过一千块板),其数量每天都在增长,它涵盖了原型制作的许多方面。

PIC32MZ clicker double side image

微控制器概述 

MCU卡片 / MCU

default

建筑

PIC32

MCU 内存 (KB)

1024

硅供应商

Microchip

引脚数

64

RAM (字节)

524288

你完善了我!

配件

橡胶天线GSM/GPRS直角天线是我们广泛产品系列中所有GSM Click板的理想伴侣。这款专用天线旨在通过卓越的功能优化您的无线连接。它具有广泛的频率范围,涵盖824-894/1710-1990MHz或890-960/1710-1890MHz,可以处理各种频段,确保无缝可靠的连接。该天线阻抗为50欧姆,增益为2dB,增强了信号的接收和发送。其70/180MHz的带宽为各种应用提供了灵活性。垂直极化进一步增强了其性能。这款天线最大输入功率容量为50W,即使在苛刻的条件下也能确保强大的通信。其紧凑的长度为50mm,具有SMA公头连接器,是您无线通信需求的多功能紧凑解决方案。

GSM 4 Click accessories image

使用的MCU引脚

mikroBUS™映射器

Status Output
RE4
AN
Module Power Up
RE5
RST
UART RTS
RG9
CS
NC
NC
SCK
NC
NC
MISO
NC
NC
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
Ring Indicator
RB3
PWM
UART CTS
RB5
INT
UART TX
RB2
TX
UART RX
RB0
RX
NC
NC
SCL
NC
NC
SDA
Power Supply
5V
5V
Ground
GND
GND
1

“仔细看看!”

Click board™ 原理图

GSM 4 Click Schematic schematic

一步一步来

项目组装

PIC32MZ clicker front image hardware assembly

从选择您的开发板和Click板™开始。以PIC32MZ clicker作为您的开发板开始。

PIC32MZ clicker front image hardware assembly
GNSS2 Click front image hardware assembly
Prog-cut hardware assembly
GNSS2 Click complete accessories setup image hardware assembly
Micro B Connector Clicker Access - upright/background hardware assembly
Necto image step 2 hardware assembly
Necto image step 3 hardware assembly
Necto image step 4 hardware assembly
Necto image step 5 hardware assembly
Necto image step 6 hardware assembly
Flip&Click PIC32MZ MCU step hardware assembly
Necto No Display image step 8 hardware assembly
Necto image step 9 hardware assembly
Necto image step 10 hardware assembly
Debug Image Necto Step hardware assembly

实时跟踪您的结果

应用程序输出

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 4 Click驱动程序的API。

关键函数:

  • gsm4_set_sim_apn - 设置SIM卡的APN。

  • gsm4_send_sms_text - 向电话号码发送文本消息。

  • gsm4_send_sms_pdu - 以PDU模式向电话号码发送文本消息。

开源

代码示例

完整的应用程序代码和一个现成的项目可以通过NECTO Studio包管理器直接安装到NECTO Studio 应用程序代码也可以在MIKROE的GitHub账户中找到。

/*!
 * @file main.c
 * @brief GSM 4 Click Example.
 *
 * # Description
 * Application example shows device capability of connecting to the network and
 * sending SMS or TCP/UDP messages using standard "AT" commands.
 *
 * The demo application is composed of two sections :
 *
 * ## Application Init
 * Initializes the driver, tests the communication by sending "AT" command, and after that restarts the device.
 *
 * ## Application Task
 * Application task is split in few stages:
 *  - GSM4_CONFIGURE_FOR_NETWORK:
 * Sets configuration to device to be able to connect to the network.
 *
 *  - GSM4_WAIT_FOR_CONNECTION:
 * Waits for the network registration indicated via CREG URC event and then checks
 * the connection status.
 *
 *  - GSM4_CONFIGURE_FOR_EXAMPLE:
 * Sets the device configuration for sending SMS or TCP/UDP messages depending on the selected demo example.
 *
 *  - GSM4_EXAMPLE:
 * Depending on the selected demo example, it sends an SMS message (in PDU or TXT mode) or TCP/UDP message.
 *
 * By default, the TCP/UDP example is selected.
 *
 * ## Additional Function
 * - static void gsm4_clear_app_buf ( void )
 * - static err_t gsm4_process ( void )
 * - static void gsm4_error_check( err_t error_flag )
 * - static void gsm4_log_app_buf ( void )
 * - static err_t gsm4_rsp_check ( uint8_t *rsp )
 * - static err_t gsm4_configure_for_connection( void )
 * - static err_t gsm4_check_connection( void )
 * - static err_t gsm4_configure_for_messages( void )
 * - static err_t gsm4_send_message( void )
 *
 * @note
 * In order for the examples to work, user needs to set the APN and SMSC (SMS PDU mode only)
 * of entered SIM card as well as the phone number (SMS mode only) to which he wants to send an SMS.
 * Enter valid values for the following macros: SIM_APN, SIM_SMSC and PHONE_NUMBER_TO_MESSAGE.
 * Example:
    SIM_APN "internet"
    SIM_SMSC "+381610401"
    PHONE_NUMBER_TO_MESSAGE "+381659999999"
 *
 * @author Stefan Filipovic
 *
 */

#include "board.h"
#include "log.h"
#include "gsm4.h"
#include "conversions.h"

// Example selection macros
#define EXAMPLE_TCP_UDP                     0               // Example of sending messages to a TCP/UDP echo server
#define EXAMPLE_SMS                         1               // Example of sending SMS to a phone number
#define DEMO_EXAMPLE                        EXAMPLE_TCP_UDP // Example selection macro

// SIM APN config
#define SIM_APN                             "internet"      // Set valid SIM APN

// SMS example parameters
#define SIM_SMSC                            ""              // Set valid SMS Service Center Address - only in SMS PDU mode
#define PHONE_NUMBER_TO_MESSAGE             ""              // Set Phone number to message
#define SMS_MODE                            "1"             // SMS mode: "0" - PDU, "1" - TXT

// TCP/UDP example parameters
#define REMOTE_IP                           "77.46.162.162" // TCP/UDP echo server IP address
#define REMOTE_PORT                         "51111"         // TCP/UDP echo server port

// Message content
#define MESSAGE_CONTENT                     "GSM 4 click board - demo example."

// Application buffer size
#define APP_BUFFER_SIZE                     256
#define PROCESS_BUFFER_SIZE                 256

/**
 * @brief Example states.
 * @details Predefined enum values for application example state.
 */
typedef enum
{
    GSM4_CONFIGURE_FOR_NETWORK = 1,
    GSM4_WAIT_FOR_CONNECTION,
    GSM4_CONFIGURE_FOR_EXAMPLE,
    GSM4_EXAMPLE

} gsm4_example_state_t;

static gsm4_t gsm4;
static log_t logger;

/**
 * @brief Application example variables.
 * @details Variables used in application example.
 */
static uint8_t app_buf[ APP_BUFFER_SIZE ] = { 0 };
static int32_t app_buf_len = 0;
static err_t error_flag;
static gsm4_example_state_t example_state;

/**
 * @brief Clearing application buffer.
 * @details This function clears memory of application
 * buffer and reset its length and counter.
 */
static void gsm4_clear_app_buf ( void );

/**
 * @brief Data reading function.
 * @details This function reads data from device and
 * appends it to the application buffer.
 * @return @li @c  0 - Some data is read.
 *         @li @c -1 - Nothing is read.
 * See #err_t definition for detailed explanation.
 */
static err_t gsm4_process ( void );

/**
 * @brief Check for errors.
 * @details This function checks for different types of
 * errors and logs them on UART or logs the response if no errors occured.
 * @param[in] error_flag  Error flag to check.
 */
static void gsm4_error_check ( err_t error_flag );

/**
 * @brief Logs application buffer.
 * @details This function logs data from application buffer.
 */
static void gsm4_log_app_buf ( void );

/**
 * @brief Response check.
 * @details This function checks for response and
 * returns the status of response.
 * @param[in] rsp  Expected response.
 * @return @li @c  0 - OK response.
 *         @li @c -2 - Timeout error.
 *         @li @c -3 - Command error.
 *         @li @c -4 - Unknown error.
 * See #err_t definition for detailed explanation.
 */
static err_t gsm4_rsp_check ( uint8_t *rsp );

/**
 * @brief Configure device for connection to the network.
 * @details Sends commands to configure and enable
 * connection to the specified network.
 * @return @li @c  0 - OK response.
 *         @li @c -2 - Timeout error.
 *         @li @c -3 - Command error.
 *         @li @c -4 - Unknown error.
 * See #err_t definition for detailed explanation.
 */
static err_t gsm4_configure_for_network ( void );

/**
 * @brief Wait for connection signal.
 * @details Wait for connection signal from CREG URC.
 * @return @li @c  0 - OK response.
 *         @li @c -2 - Timeout error.
 *         @li @c -3 - Command error.
 *         @li @c -4 - Unknown error.
 * See #err_t definition for detailed explanation.
 */
static err_t gsm4_check_connection ( void );

/**
 * @brief Configure device for example.
 * @details Configure device for the specified example.
 * @return @li @c  0 - OK response.
 *         @li @c -2 - Timeout error.
 *         @li @c -3 - Command error.
 *         @li @c -4 - Unknown error.
 * See #err_t definition for detailed explanation.
 */
static err_t gsm4_configure_for_example ( void );

/**
 * @brief Execute example.
 * @details This function executes SMS or TCP/UDP example depending on the DEMO_EXAMPLE macro.
 * @return @li @c  0 - OK response.
 *         @li @c -2 - Timeout error.
 *         @li @c -3 - Command error.
 *         @li @c -4 - Unknown error.
 * See #err_t definition for detailed explanation.
 */
static err_t gsm4_example ( void );

void application_init ( void ) 
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    gsm4_cfg_t gsm4_cfg;  /**< Click config object. */

    /**
     * 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.
    gsm4_cfg_setup( &gsm4_cfg );
    GSM4_MAP_MIKROBUS( gsm4_cfg, MIKROBUS_1 );
    if ( UART_ERROR == gsm4_init( &gsm4, &gsm4_cfg ) )
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );
        for ( ; ; );
    }
    
    gsm4_process( );
    gsm4_clear_app_buf( );

    // Check communication
    gsm4_send_cmd( &gsm4, GSM4_CMD_AT );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    gsm4_error_check( error_flag );
    
    // Restart device
    #define RESTART_DEVICE "1,1"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_CFUN, RESTART_DEVICE );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    gsm4_error_check( error_flag );
    
    log_info( &logger, " Application Task " );
    example_state = GSM4_CONFIGURE_FOR_NETWORK;
}

void application_task ( void )
{
    switch ( example_state )
    {
        case GSM4_CONFIGURE_FOR_NETWORK:
        {
            if ( GSM4_OK == gsm4_configure_for_network( ) )
            {
                example_state = GSM4_WAIT_FOR_CONNECTION;
            }
            break;
        }
        case GSM4_WAIT_FOR_CONNECTION:
        {
            if ( GSM4_OK == gsm4_check_connection( ) )
            {
                example_state = GSM4_CONFIGURE_FOR_EXAMPLE;
            }
            break;
        }
        case GSM4_CONFIGURE_FOR_EXAMPLE:
        {
            if ( GSM4_OK == gsm4_configure_for_example( ) )
            {
                example_state = GSM4_EXAMPLE;
            }
            break;
        }
        case GSM4_EXAMPLE:
        {
            gsm4_example( );
            break;
        }
        default:
        {
            log_error( &logger, " Example state." );
            break;
        }
    }
}

void main ( void ) 
{
    application_init( );

    for ( ; ; ) 
    {
        application_task( );
    }
}

static void gsm4_clear_app_buf ( void )
{
    memset( app_buf, 0, app_buf_len );
    app_buf_len = 0;
}

static err_t gsm4_process ( void )
{
    uint8_t rx_buf[ PROCESS_BUFFER_SIZE ] = { 0 };
    int32_t rx_size = 0;
    rx_size = gsm4_generic_read( &gsm4, rx_buf, PROCESS_BUFFER_SIZE );
    if ( rx_size > 0 ) 
    {
        int32_t buf_cnt = app_buf_len;
        if ( ( ( app_buf_len + rx_size ) > APP_BUFFER_SIZE ) && ( app_buf_len > 0 ) ) 
        {
            buf_cnt = APP_BUFFER_SIZE - ( ( app_buf_len + rx_size ) - APP_BUFFER_SIZE );
            memmove ( app_buf, &app_buf[ APP_BUFFER_SIZE - buf_cnt ], buf_cnt );
        }
        for ( int32_t rx_cnt = 0; rx_cnt < rx_size; rx_cnt++ ) 
        {
            if ( rx_buf[ rx_cnt ] ) 
            {
                app_buf[ buf_cnt++ ] = rx_buf[ rx_cnt ];
                if ( app_buf_len < APP_BUFFER_SIZE )
                {
                    app_buf_len++;
                }
            }
        }
        return GSM4_OK;
    }
    return GSM4_ERROR;
}

static err_t gsm4_rsp_check ( uint8_t *rsp )
{
    uint32_t timeout_cnt = 0;
    uint32_t timeout = 120000;
    gsm4_clear_app_buf( );
    gsm4_process( );
    while ( ( 0 == strstr( app_buf, rsp ) ) &&
            ( 0 == strstr( app_buf, GSM4_RSP_ERROR ) ) )
    {
        gsm4_process( );
        if ( timeout_cnt++ > timeout )
        {
            gsm4_clear_app_buf( );
            return GSM4_ERROR_TIMEOUT;
        }
        Delay_ms( 1 );
    }
    Delay_ms( 100 );
    gsm4_process( );
    if ( strstr( app_buf, rsp ) )
    {
        return GSM4_OK;
    }
    else if ( strstr( app_buf, GSM4_RSP_ERROR ) )
    {
        return GSM4_ERROR_CMD;
    }
    else
    {
        return GSM4_ERROR_UNKNOWN;
    }
}

static void gsm4_error_check ( err_t error_flag )
{
    switch ( error_flag )
    {
        case GSM4_OK:
        {
            gsm4_log_app_buf( );
            break;
        }
        case GSM4_ERROR:
        {
            log_error( &logger, " Overflow!" );
            break;
        }
        case GSM4_ERROR_TIMEOUT:
        {
            log_error( &logger, " Timeout!" );
            break;
        }
        case GSM4_ERROR_CMD:
        {
            log_error( &logger, " CMD!" );
            break;
        }
        case GSM4_ERROR_UNKNOWN:
        default:
        {
            log_error( &logger, " Unknown!" );
            break;
        }
    }
    Delay_ms( 500 );
}

static void gsm4_log_app_buf ( void )
{
    for ( int32_t buf_cnt = 0; buf_cnt < app_buf_len; buf_cnt++ )
    {
        log_printf( &logger, "%c", app_buf[ buf_cnt ] );
    }
}

static err_t gsm4_configure_for_network ( void )
{
    err_t func_error = GSM4_OK;
#if ( ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP ) || ( DEMO_EXAMPLE == EXAMPLE_SMS ) )
    Delay_ms ( 5000 );
    // Deregister from network
    #define DEREGISTER_FROM_NETWORK "2"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_COPS, DEREGISTER_FROM_NETWORK );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    
    // Set SIM APN
    gsm4_set_sim_apn( &gsm4, SIM_APN );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );

    // Enable full functionality
    #define FULL_FUNCTIONALITY "1"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_CFUN, FULL_FUNCTIONALITY );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );

    // Enable network registartion
    #define ENABLE_REG "2"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_CREG, ENABLE_REG );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    
    // Automatic registration
    #define AUTOMATIC_REGISTRATION "0"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_COPS, AUTOMATIC_REGISTRATION );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
#endif
    return func_error;
}

static err_t gsm4_check_connection ( void )
{
#if ( ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP ) || ( DEMO_EXAMPLE == EXAMPLE_SMS ) )
    #define CONNECTED "+CREG: 2,1"
    gsm4_send_cmd_check ( &gsm4, GSM4_CMD_CREG );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    gsm4_error_check( error_flag );
    if ( strstr( app_buf, CONNECTED ) )
    {
        Delay_ms( 100 );
        // Check signal quality
        gsm4_send_cmd( &gsm4, GSM4_CMD_CSQ );
        error_flag = gsm4_rsp_check( GSM4_RSP_OK );
        gsm4_error_check( error_flag );
        #define NO_SIGNAL "99,99"
        if ( !strstr( app_buf, NO_SIGNAL ) )
        {
            Delay_ms ( 1000 );
            return error_flag;
        }
    }
    Delay_ms ( 1000 );
    return GSM4_ERROR;
#endif
    return GSM4_OK;
}

static err_t gsm4_configure_for_example ( void )
{
    err_t func_error = GSM4_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    #define ACTIVATE_PDP_CONTEXT "1,1"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_CGACT, ACTIVATE_PDP_CONTEXT );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    #define ACTIVATE_PDP_PROFILE "0,3"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_UPSDA, ACTIVATE_PDP_PROFILE );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_CMGF, SMS_MODE );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
#else
    #error "No demo example selected"
#endif
    return func_error;
}

static err_t gsm4_example ( void )
{
     err_t func_error = GSM4_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    uint8_t cmd_buf[ 100 ] = { 0 };
    uint8_t urc_buf[ 20 ] = { 0 };
    uint16_t timeout_cnt = 0;
    uint16_t timeout = 30000;
    uint8_t * __generic_ptr socket_num_buf = 0;
    uint8_t tcp_socket_num[ 2 ] = { 0 }; 
    uint8_t udp_socket_num[ 2 ] = { 0 }; 
    
    // Create TCP socket
    #define RSP_USOCR "+USOCR: "
    #define TCP_PROTOCOL "6"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOCR, TCP_PROTOCOL );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    socket_num_buf = strstr( app_buf, RSP_USOCR ) + strlen ( RSP_USOCR );
    tcp_socket_num[ 0 ] = *socket_num_buf;
    gsm4_error_check( error_flag );
    
    // Create UDP socket
    #define UDP_PROTOCOL "17"
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOCR, UDP_PROTOCOL );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    socket_num_buf = strstr( app_buf, RSP_USOCR ) + strlen ( RSP_USOCR );
    udp_socket_num[ 0 ] = *socket_num_buf;
    gsm4_error_check( error_flag );
    
    // Connect TCP socket to remote IP and port
    strcpy( cmd_buf, tcp_socket_num );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, REMOTE_IP );
    strcat( cmd_buf, "\"," );
    strcat( cmd_buf, REMOTE_PORT );
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOCO, cmd_buf );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    
    // Connect UDP socket to remote IP and port
    strcpy( cmd_buf, udp_socket_num );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, REMOTE_IP );
    strcat( cmd_buf, "\"," );
    strcat( cmd_buf, REMOTE_PORT );
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOCO, cmd_buf );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );

    // Get message length
    uint8_t message_len_buf[ 5 ] = { 0 };
    uint16_t message_len = strlen( MESSAGE_CONTENT );
    uint16_to_str( message_len, message_len_buf );
    l_trim( message_len_buf );
    r_trim( message_len_buf );
    
    // Write message to TCP socket
    strcpy( cmd_buf, tcp_socket_num );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, MESSAGE_CONTENT );
    strcat( cmd_buf, "\"" );
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOWR, cmd_buf );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    
    // Read response message from TCP socket
    #define URC_READ_SOCKET_DATA "+UUSORD: "
    strcpy( urc_buf, URC_READ_SOCKET_DATA );
    strcat( urc_buf, tcp_socket_num );
    for ( ; ; )
    {
        gsm4_process( );
        uint8_t * __generic_ptr start_response_buf = strstr( app_buf, urc_buf );
        if ( start_response_buf )
        {
            Delay_ms( 100 );
            gsm4_process( ); 
            uint8_t response_len_buf[ 5 ] = { 0 };
            uint8_t * __generic_ptr start_response_len = strstr( start_response_buf, "," ) + 1;
            memcpy ( response_len_buf, start_response_len, app_buf_len - ( start_response_len - app_buf ) );
            strcpy( cmd_buf, tcp_socket_num );
            strcat( cmd_buf, "," );
            strcat( cmd_buf, response_len_buf );
            gsm4_log_app_buf( );
            gsm4_clear_app_buf( );
            gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USORD, cmd_buf );
            error_flag = gsm4_rsp_check( GSM4_RSP_OK );
            func_error |= error_flag;
            gsm4_error_check( error_flag );
            break;
        }
        if ( timeout_cnt++ > timeout )
        {
            break;
        }
        Delay_ms( 1 );
    }
    timeout_cnt = 0;
    
    // Write message to UDP socket
    strcpy( cmd_buf, udp_socket_num );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, MESSAGE_CONTENT );
    strcat( cmd_buf, "\"" );
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOWR, cmd_buf );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    
    // Read response message from UDP socket
    strcpy( urc_buf, URC_READ_SOCKET_DATA );
    strcat( urc_buf, udp_socket_num );
    for ( ; ; )
    {
        gsm4_process( );
        uint8_t * __generic_ptr start_response_buf = strstr( app_buf, urc_buf );
        if ( start_response_buf )
        {
            Delay_ms( 100 );
            gsm4_process( );
            uint8_t response_len_buf[ 5 ] = { 0 };
            uint8_t * __generic_ptr start_response_len = strstr( start_response_buf, "," ) + 1;
            memcpy ( response_len_buf, start_response_len, app_buf_len - ( start_response_len - app_buf ) );
            strcpy( cmd_buf, udp_socket_num );
            strcat( cmd_buf, "," );
            strcat( cmd_buf, response_len_buf );
            gsm4_log_app_buf( );
            gsm4_clear_app_buf( );
            gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USORF, cmd_buf );
            error_flag = gsm4_rsp_check( GSM4_RSP_OK );
            func_error |= error_flag;
            gsm4_error_check( error_flag );
            break;
        }
        if ( timeout_cnt++ > timeout )
        {
            break;
        }
        Delay_ms( 1 );
    }
    
    // Close TCP socket
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOCL, tcp_socket_num );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    
    // Close UDP socket
    gsm4_send_cmd_with_par( &gsm4, GSM4_CMD_USOCL, udp_socket_num );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    Delay_ms( 5000 );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    // Check SMS mode
    #define CMGF_PDU "+CMGF: 0"
    #define CMGF_TXT "+CMGF: 1"
    gsm4_send_cmd_check( &gsm4, GSM4_CMD_CMGF );
    error_flag = gsm4_rsp_check( GSM4_RSP_OK );
    func_error |= error_flag;
    gsm4_error_check( error_flag );
    if ( strstr( app_buf, CMGF_PDU ) )
    {
        // Send SMS in PDU mode
        gsm4_send_sms_pdu( &gsm4, SIM_SMSC, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag = gsm4_rsp_check( GSM4_RSP_OK );
        func_error |= error_flag;
        gsm4_error_check( error_flag );
    }
    else if ( strstr( app_buf, CMGF_TXT ) )
    {
        // Send SMS in TXT mode
        gsm4_send_sms_text ( &gsm4, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag = gsm4_rsp_check( GSM4_RSP_OK );
        func_error |= error_flag;
        gsm4_error_check( error_flag );
    }
    Delay_ms( 10000 );
    Delay_ms( 10000 );
    Delay_ms( 10000 );
#else
    #error "No demo example selected"
#endif
    return func_error;
}

// ------------------------------------------------------------------------ END

额外支持

资源

喜欢这个项目吗?

'购买此套件' 按钮会直接带您进入购物车,您可以在购物车中轻松添加或移除产品。