中级
30 分钟

使用LARA-R6401D-00B和PIC32MZ2048EFH100保持连接和控制,实现安全可靠的物联网通信

面向北美应用的专业级多频段LTE Cat 1纯数据解决方案

4G LTE 2 Click - Data (for North America) with Flip&Click PIC32MZ

已发布 11月 28, 2024

点击板

4G LTE 2 Click - Data (for North America)

开发板

Flip&Click PIC32MZ

编译器

NECTO Studio

微控制器单元

PIC32MZ2048EFH100

释放 IoT 项目的全部潜力,这款紧凑型数据专用解决方案为北美地区提供安全可靠的连接

A

A

硬件概览

它是如何工作的?

4G LTE 2 Click - Data(for North America)基于 u-blox 的 LARA-R6401D 模块(LARA-R6401D-00B),这是一个专业级多频段、多模式模块,支持 LTE Cat 1 FDD(包括 8 个 LTE 频段:B2、4、5、12、13、14、66、71),为北美地区提供无与伦比的连接解决方案。此 Click 板™ 仅支持数据传输,具有所有相关 MNO 认证,尽管不支持语音/音频应用,但仍然提供了极大的灵活性。其多功能接口和特性使得 LARA-R6401D 非常适合需要中等数据速率、优越覆盖范围和数据流传输的各种应用,例如资产追踪、车联网、远程监控、销售点终端等。该模块需要 3.8V 电源,因此此 Click 板™ 集成了 Texas Instruments 的降压(DC-DC)转换器 TPS7A7002,可提供稳定的 3.8V 电源,能够在设备启动时电流高峰出现时减轻输入电压的波动。模块的点火(电源开/关)引脚标记为 PWR,并连接到 mikroBUS™ 插槽上的 RST 引

脚,用于控制模块的电源开关。LARA-R6401D 使用 UART 接口与 MCU 通信,包括常用的 UART RX 和 TX 引脚,以及硬件流控制引脚 UART CTS、RTS 和 RI(Clear to Send、Ready to Send 和 Ring Indicator)。默认配置下,它以 115200 bps 的速度运行,通过 u-blox 提供的 AT 指令与主机 MCU 进行数据传输和交换。除了 UART 接口外,LARA-R6401D 还支持通过 I2C 接口作为主机,与 I2C 从设备通信。此 Click 板™ 还配备了一个 USB Type-C 连接器,仅用于诊断目的。模块作为 USB 设备运行,可以连接到任何安装了兼容驱动程序的 USB 主机。此外,此板还配备了必要的组件和电路,以支持模块系列的音频接口。但在当前版本中,由于板上模块的限制,音频接口并未启用,因此相应组件未焊接到板上。除了上述引脚,此 Click 板™ 还包含两个附加 LED 指示灯:一个黄色 LED 标记为 STATUS,与

mikroBUS™ AN 引脚(STS)和 LED 相连,用于可视化网络连接状态;另一个红色 LED 标记为 TX,用于指示模块的传输状态。LTE 蜂窝网络使用空间复用天线技术,允许使用多个天线以提高接收效果。因此,除了主要的 TX/RX 天线外,此 Click 板™ 还使用了一个辅助的 RX 多样性天线,以增强信号接收能力。除了 SMA 连接器外,4G LTE 2 Click 还具有一个 Nano-SIM 卡插槽,提供多种连接和接口选项,以及多个测试点(标记为 TP1 到 TP3),便于模块的重启和测试。此 Click 板™ 可在 3.3V 或 5V 逻辑电压水平下运行,可通过 VCC SEL 跳线选择电压,以便 3.3V 和 5V 的 MCU 都能正确使用通信线路。此外,此 Click 板™ 提供一个包含易于使用的功能和示例代码的库,可作为进一步开发的参考。

4G LTE 2 Click - Data (for North America) hardware overview image

功能概述

开发板

Flip&Click PIC32MZ 是一款紧凑型开发板,设计为一套完整的解决方案,它将 Click 板™的灵活性带给您喜爱的微控制器,使其成为实现您想法的完美入门套件。它配备了一款板载 32 位 PIC32MZ 微控制器,Microchip 的 PIC32MZ2048EFH100,四个 mikroBUS™ 插槽用于 Click 板™连接,两个 USB 连接器,LED 指示灯,按钮,调试器/程序员连接器,以及两个与 Arduino-UNO 引脚兼容的头部。得益于创

新的制造技术,它允许您快速构建具有独特功能和特性的小工具。Flip&Click PIC32MZ 开发套件的每个部分都包含了使同一板块运行最高效的必要组件。此外,还可以选择 Flip&Click PIC32MZ 的编程方式,使用 chipKIT 引导程序(Arduino 风格的开发环境)或我们的 USB HID 引导程序,使用 mikroC、mikroBasic 和 mikroPascal for PIC32。该套件包括一个通过 USB 类型-C(USB-C)连接器的干净且调

节过的电源供应模块。所有 mikroBUS™ 本身支持的 通信方法都在这块板上,包括已经建立良好的 mikroBUS™ 插槽、用户可配置的按钮和 LED 指示灯。Flip&Click PIC32MZ 开发套件允许您在几分钟内创建新的应用程序。它由 Mikroe 软件工具原生支持,得益于大量不同的 Click 板™(超过一千块板),其数量每天都在增长,它涵盖了原型制作的许多方面。

Flip&Click PIC32MZ double image

微控制器概述 

MCU卡片 / MCU

default

建筑

PIC32

MCU 内存 (KB)

2048

硅供应商

Microchip

引脚数

100

RAM (字节)

524288

你完善了我!

配件

868MHz 直角橡胶天线是一款紧凑且多功能的无线通信解决方案。它在 868-915MHz 的频率范围内运行,确保最佳的信号接收和传输。天线具有 50 欧姆的阻抗,兼容多种设备和系统。其 2dB 的增益增强了信号强度并扩展了通信范围。垂直极化进一步提高了信号的清晰度。设计能够处理高达 50W 的输入功率,使其成为各种应用的坚固选择。这款天线长度仅为 48mm,既低调又实用。其 SMA 公头连接器确保与您的设备建立安全可靠的连接。无论您是在处理物联网设备、远程传感器,还是其他无线技术,868MHz 直角天线都能为您提供无缝通信所需的性能和灵活性。

4G LTE 2 Click - Data (for North America) accessories 1 image

LTE Flat Rotation Antenna 是增强 3G/4G LTE 设备性能的多功能选择。凭借 700-2700MHz 的宽频率范围,它确保在全球主要蜂窝频段上的最佳连接。该平板天线采用 SMA 公头连接器,便于直接连接到设备或 SMA 模块连接器。其亮点之一是可调角度,可按 45⁰ 增量(0⁰/45⁰/90⁰)设置,允许您微调天线的方向以获得最佳信号接收。具有 50Ω 阻抗和 <2.0:1 的电压驻波比 (VSWR),此天线确保可靠高效的连接。其 5dB 增益、垂直极化和全向辐射图形增强了信号强度,适用于各种应用。天线长度为 196mm,宽度为 38mm,提供紧凑但有效的解决方案来改善您的连接。最大输入功率为 50W,能够满足各种设备的需求。

4G LTE 2 Click - Data (for North America) accessories 2 image

使用的MCU引脚

mikroBUS™映射器

Module Status
RB11
AN
Power-ON
RE2
RST
UART RTS
RA0
CS
NC
NC
SCK
NC
NC
MISO
NC
NC
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
Ring Indicator
RC14
PWM
UART CTS
RD9
INT
UART TX
RE3
TX
UART RX
RG9
RX
I2C Clock
RA2
SCL
I2C Data
RA3
SDA
Power Supply
5V
5V
Ground
GND
GND
1

“仔细看看!”

Click board™ 原理图

4G LTE 2 Click - Data (for North America) Schematic schematic

一步一步来

项目组装

Flip&Click PIC32MZ front image hardware assembly

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

Flip&Click PIC32MZ front image hardware assembly
GNSS2 Click front image hardware assembly
Prog-cut hardware assembly
GNSS2 Click complete accessories setup image hardware assembly
Board mapper by product7 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”替换为要显示的参数。

软件支持

库描述

该库包含 4G LTE 2 Click - Data (for North America) 驱动程序的 API。

关键功能:

  • c4glte2datana_set_power_state - 此函数通过在高电平状态下设置特定时间来切换PWR引脚,从而设置所需的电源状态。

  • c4glte2datana_set_sim_apn - 此函数为SIM卡设置接入点名称(APN)。

  • c4glte2datana_send_sms_text - 此函数向指定电话号码发送短信。

开源

代码示例

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

/*!
 * @file main.c
 * @brief 4G LTE 2 Data-NA 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, restarts the module and tests the communication.
 *
 * ## Application Task
 * Application task is split in few stages:
 *  - C4GLTE2DATANA_CONFIGURE_FOR_NETWORK:
 * Sets configuration to device to be able to connect to the network.
 *
 *  - C4GLTE2DATANA_WAIT_FOR_CONNECTION:
 * Waits for the network registration indicated via CREG URC event and then checks the connection status.
 *
 *  - C4GLTE2DATANA_CONFIGURE_FOR_EXAMPLE:
 * Sets the device configuration for sending SMS or TCP/UDP messages depending on the selected demo example.
 *
 *  - C4GLTE2DATANA_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 c4glte2datana_clear_app_buf ( void )
 * - static err_t c4glte2datana_process ( void )
 * - static void c4glte2datana_error_check( err_t error_flag )
 * - static void c4glte2datana_log_app_buf ( void )
 * - static err_t c4glte2datana_rsp_check ( void )
 * - static err_t c4glte2datana_configure_for_network( void )
 * - static err_t c4glte2datana_check_connection( void )
 * - static err_t c4glte2datana_configure_for_example( void )
 * - static err_t c4glte2datana_example( 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 "c4glte2datana.h"
#include "generic_pointer.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                             ""              // 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                     "4G LTE 2 Data-NA Click board - demo example."

// Application buffer size
#define PROCESS_BUFFER_SIZE                 300

/**
 * @brief Example states.
 * @details Predefined enum values for application example state.
 */
typedef enum
{
    C4GLTE2DATANA_CONFIGURE_FOR_NETWORK = 1,
    C4GLTE2DATANA_WAIT_FOR_CONNECTION,
    C4GLTE2DATANA_CONFIGURE_FOR_EXAMPLE,
    C4GLTE2DATANA_EXAMPLE

} c4glte2datana_example_state_t;

static c4glte2datana_t c4glte2datana;
static log_t logger;

/**
 * @brief Application example variables.
 * @details Variables used in application example.
 */
static char app_buf[ PROCESS_BUFFER_SIZE ] = { 0 };
static int32_t app_buf_len = 0;
static int32_t app_buf_cnt = 0;
static err_t error_flag;
static c4glte2datana_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 c4glte2datana_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 c4glte2datana_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.
 */
static void c4glte2datana_error_check( err_t error_flag );

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

/**
 * @brief Response check.
 * @details This function checks for response and
 * returns the status of 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 c4glte2datana_rsp_check ( void );

/**
 * @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 c4glte2datana_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 c4glte2datana_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 c4glte2datana_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 c4glte2datana_example( void );

void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    c4glte2datana_cfg_t c4glte2datana_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.
    c4glte2datana_cfg_setup( &c4glte2datana_cfg );
    C4GLTE2DATANA_MAP_MIKROBUS( c4glte2datana_cfg, MIKROBUS_1 );
    if ( UART_ERROR == c4glte2datana_init( &c4glte2datana, &c4glte2datana_cfg ) )
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );
        for ( ; ; );
    }
    c4glte2datana_set_power_state ( &c4glte2datana, C4GLTE2DATANA_POWER_STATE_OFF );
    c4glte2datana_set_power_state ( &c4glte2datana, C4GLTE2DATANA_POWER_STATE_ON );
    c4glte2datana_process( );
    c4glte2datana_clear_app_buf( );
    app_buf_len = 0;
    app_buf_cnt = 0;

    // Check communication
    c4glte2datana_send_cmd( &c4glte2datana, C4GLTE2DATANA_CMD_AT );
    error_flag = c4glte2datana_rsp_check( );
    c4glte2datana_error_check( error_flag );

    log_info( &logger, " Application Task " );
    example_state = C4GLTE2DATANA_CONFIGURE_FOR_NETWORK;
}

void application_task ( void )
{
    switch ( example_state )
    {
        case C4GLTE2DATANA_CONFIGURE_FOR_NETWORK:
        {
            if ( C4GLTE2DATANA_OK == c4glte2datana_configure_for_network( ) )
            {
                example_state = C4GLTE2DATANA_WAIT_FOR_CONNECTION;
            }
            break;
        }
        case C4GLTE2DATANA_WAIT_FOR_CONNECTION:
        {
            if ( C4GLTE2DATANA_OK == c4glte2datana_check_connection( ) )
            {
                example_state = C4GLTE2DATANA_CONFIGURE_FOR_EXAMPLE;
            }
            break;
        }
        case C4GLTE2DATANA_CONFIGURE_FOR_EXAMPLE:
        {
            if ( C4GLTE2DATANA_OK == c4glte2datana_configure_for_example( ) )
            {
                example_state = C4GLTE2DATANA_EXAMPLE;
            }
            break;
        }
        case C4GLTE2DATANA_EXAMPLE:
        {
            c4glte2datana_example( );
            break;
        }
        default:
        {
            log_error( &logger, " Example state." );
            break;
        }
    }
}

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 c4glte2datana_clear_app_buf ( void )
{
    memset( app_buf, 0, app_buf_len );
    app_buf_len = 0;
    app_buf_cnt = 0;
}

static err_t c4glte2datana_process ( void )
{
    int32_t rx_size;
    char rx_buff[ PROCESS_BUFFER_SIZE ] = { 0 };
    rx_size = c4glte2datana_generic_read( &c4glte2datana, rx_buff, PROCESS_BUFFER_SIZE );
    if ( rx_size > 0 )
    {
        int32_t buf_cnt = 0;
        if ( ( app_buf_len + rx_size ) > PROCESS_BUFFER_SIZE )
        {
            c4glte2datana_clear_app_buf(  );
            return C4GLTE2DATANA_ERROR;
        }
        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 C4GLTE2DATANA_OK;
    }
    return C4GLTE2DATANA_ERROR;
}

static err_t c4glte2datana_rsp_check ( void )
{
    uint32_t timeout_cnt = 0;
    uint32_t timeout = 120000;
    err_t error_flag = c4glte2datana_process( );
    if ( ( C4GLTE2DATANA_OK != error_flag ) && ( C4GLTE2DATANA_ERROR != error_flag ) )
    {
        return error_flag;
    }
    while ( ( 0 == strstr( app_buf, C4GLTE2DATANA_RSP_OK ) ) &&
            ( 0 == strstr( app_buf, C4GLTE2DATANA_RSP_ERROR ) ) )
    {
        error_flag = c4glte2datana_process( );
        if ( ( C4GLTE2DATANA_OK != error_flag ) && ( C4GLTE2DATANA_ERROR != error_flag ) )
        {
            return error_flag;
        }
        if ( timeout_cnt++ > timeout )
        {
            c4glte2datana_clear_app_buf( );
            return C4GLTE2DATANA_ERROR_TIMEOUT;
        }
        Delay_ms ( 1 );
    }
    if ( strstr( app_buf, C4GLTE2DATANA_RSP_OK ) )
    {
        return C4GLTE2DATANA_OK;
    }
    else if ( strstr( app_buf, C4GLTE2DATANA_RSP_ERROR ) )
    {
        return C4GLTE2DATANA_ERROR_CMD;
    }
    else
    {
        return C4GLTE2DATANA_ERROR_UNKNOWN;
    }
}

static void c4glte2datana_error_check( err_t error_flag )
{
    switch ( error_flag )
    {
        case C4GLTE2DATANA_OK:
        {
            c4glte2datana_log_app_buf( );
            break;
        }
        case C4GLTE2DATANA_ERROR:
        {
            log_error( &logger, " Overflow!" );
            break;
        }
        case C4GLTE2DATANA_ERROR_TIMEOUT:
        {
            log_error( &logger, " Timeout!" );
            break;
        }
        case C4GLTE2DATANA_ERROR_CMD:
        {
            log_error( &logger, " CMD!" );
            break;
        }
        case C4GLTE2DATANA_ERROR_UNKNOWN:
        default:
        {
            log_error( &logger, " Unknown!" );
            break;
        }
    }
    c4glte2datana_clear_app_buf(  );
    Delay_ms ( 500 );
}

static void c4glte2datana_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 c4glte2datana_configure_for_network( void )
{
    err_t func_error = C4GLTE2DATANA_OK;
    // Deregister from network
    #define DEREGISTER_FROM_NETWORK "2"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_COPS, DEREGISTER_FROM_NETWORK );
    error_flag = c4glte2datana_rsp_check();
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );
    
    // Set SIM APN
    c4glte2datana_set_sim_apn( &c4glte2datana, SIM_APN );
    error_flag = c4glte2datana_rsp_check();
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );

    // Enable full functionality
    #define FULL_FUNCTIONALITY "1"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_CFUN, FULL_FUNCTIONALITY );
    error_flag = c4glte2datana_rsp_check();
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );

    // Automatic registration
    #define AUTOMATIC_REGISTRATION "0"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_COPS, AUTOMATIC_REGISTRATION );
    error_flag = c4glte2datana_rsp_check();
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );

    // Enable network registartion
    #define ENABLE_REG "2"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_CREG, ENABLE_REG );
    error_flag = c4glte2datana_rsp_check();
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );
    return func_error;
}

static err_t c4glte2datana_check_connection( void )
{
    #define CONNECTED "+CREG: 1"
    c4glte2datana_process( );
    if ( strstr( app_buf, CONNECTED ) )
    {
        Delay_ms ( 100 );
        c4glte2datana_process( );
        c4glte2datana_log_app_buf( );
        log_printf( &logger, "\r\n" );
        c4glte2datana_clear_app_buf( );
        // Check signal quality
        c4glte2datana_send_cmd( &c4glte2datana, C4GLTE2DATANA_CMD_CSQ );
        error_flag = c4glte2datana_rsp_check( );
        c4glte2datana_error_check( error_flag );
        return error_flag;
    }
    return C4GLTE2DATANA_ERROR;
}

static err_t c4glte2datana_configure_for_example( void )
{
    err_t func_error = C4GLTE2DATANA_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    #define ACTIVATE_PDP_CONTEXT "1,1"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_CGACT, ACTIVATE_PDP_CONTEXT );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_CMGF, SMS_MODE );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );
#else
    #error "No demo example selected"
#endif
    return func_error;
}

static err_t c4glte2datana_example( void )
{
    err_t func_error = C4GLTE2DATANA_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    char cmd_buf[ 100 ] = { 0 };
    char 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"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOCR, TCP_PROTOCOL );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    socket_num_buf = strstr( app_buf, RSP_USOCR ) + strlen ( RSP_USOCR );
    tcp_socket_num[ 0 ] = *socket_num_buf;
    c4glte2datana_error_check( error_flag );

    // Create UDP socket
    #define UDP_PROTOCOL "17"
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOCR, UDP_PROTOCOL );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    socket_num_buf = strstr( app_buf, RSP_USOCR ) + strlen ( RSP_USOCR );
    udp_socket_num[ 0 ] = *socket_num_buf;
    c4glte2datana_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 );
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOCO, cmd_buf );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_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 );
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOCO, cmd_buf );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_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, "\"" );
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOWR, cmd_buf );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );

    // Read response message from TCP socket
    #define URC_READ_SOCKET_DATA_TCP "+UUSORD: "
    strcpy( urc_buf, URC_READ_SOCKET_DATA_TCP );
    strcat( urc_buf, tcp_socket_num );
    for ( ; ; )
    {
        c4glte2datana_process( );
        uint8_t * __generic_ptr start_response_buf = strstr( app_buf, urc_buf );
        if ( start_response_buf )
        {
            Delay_ms ( 100 );
            c4glte2datana_process( );
            uint8_t response_len_buf[ 5 ] = { 0 };
            char * __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 );
            c4glte2datana_log_app_buf( );
            c4glte2datana_clear_app_buf( );
            c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USORD, cmd_buf );
            error_flag = c4glte2datana_rsp_check( );
            func_error |= error_flag;
            c4glte2datana_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, "\"" );
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOWR, cmd_buf );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );

    // Read response message from UDP socket
    #define URC_READ_SOCKET_DATA_UDP "+UUSORD: "
    strcpy( urc_buf, URC_READ_SOCKET_DATA_UDP );
    strcat( urc_buf, udp_socket_num );
    for ( ; ; )
    {
        c4glte2datana_process( );
        uint8_t * __generic_ptr start_response_buf = strstr( app_buf, urc_buf );
        if ( start_response_buf )
        {
            Delay_ms ( 100 );
            c4glte2datana_process( );
            uint8_t response_len_buf[ 5 ] = { 0 };
            char * __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 );
            c4glte2datana_log_app_buf( );
            c4glte2datana_clear_app_buf( );
            c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USORD, cmd_buf );
            error_flag = c4glte2datana_rsp_check( );
            func_error |= error_flag;
            c4glte2datana_error_check( error_flag );
            break;
        }
        if ( timeout_cnt++ > timeout )
        {
            break;
        }
        Delay_ms ( 1 );
    }
    
    // Close TCP socket
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOCL, tcp_socket_num );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );
    
    // Close UDP socket
    c4glte2datana_send_cmd_with_parameter( &c4glte2datana, C4GLTE2DATANA_CMD_USOCL, udp_socket_num );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    c4glte2datana_error_check( error_flag );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    // Check SMS mode
    #define CMGF_PDU "+CMGF: 0"
    #define CMGF_TXT "+CMGF: 1"
    c4glte2datana_send_cmd_check( &c4glte2datana, C4GLTE2DATANA_CMD_CMGF );
    error_flag = c4glte2datana_rsp_check( );
    func_error |= error_flag;
    if ( strstr( app_buf, CMGF_PDU ) )
    {
        c4glte2datana_error_check( error_flag );
        // Send SMS in PDU mode
        c4glte2datana_send_sms_pdu( &c4glte2datana, SIM_SMSC, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag = c4glte2datana_rsp_check( );
        func_error |= error_flag;
    }
    else if ( strstr( app_buf, CMGF_TXT ) )
    {
        c4glte2datana_error_check( error_flag );
        // Send SMS in TXT mode
        c4glte2datana_send_sms_text ( &c4glte2datana, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag = c4glte2datana_rsp_check( );
        func_error |= error_flag;
    }
    c4glte2datana_error_check( 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 );
#else
    #error "No demo example selected"
#endif
    return func_error;
}

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

额外支持

资源

喜欢这个项目吗?

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