高级
30 分钟

使用 SARA-R520M10 和 ATmega328P 实现通信与定位功能的完美结合

全球 LTE Cat M1/NB2 连接解决方案,集成 GNSS 定位,专为物联网而设计

LTE IoT 16 Click with Arduino UNO Rev3

已发布 4月 16, 2025

点击板

LTE IoT 16 Click

开发板

Arduino UNO Rev3

编译器

NECTO Studio

微控制器单元

ATmega328P

Global LTE-M / NB-IoT 连接与 GNSS 追踪功能,专为物联网应用中的远程监控而打造

A

A

硬件概览

它是如何工作的?

LTE IoT 16 Click 基于 u-blox 的 SARA-R52 系列中的 SARA-R520M10 模块,这是一款支持 LTE-M 和 NB-IoT 的蜂窝模块。该模块构建于 u-blox 第二代自主 UBX-R52 蜂窝芯片组上,并集成了 u-blox M10 GNSS 接收器,专为高性能的全球物联网应用而设计。它支持在多个全球频段(1、2、3、4、5、8、12、13、18、19、20、25、26、28、66、71、85)上的 LTE Cat M1 和 LTE Cat NB2 连接,结合了 3GPP Release 14 和 Release 15 的关键功能,确保增强的覆盖范围、改进的数据速率、低功耗和可靠的移动性。通过 23dBm 的 LTE 发射功率,SARA-R520M10 可实现强大而稳定的蜂窝通信能力。该模块集成了 u-blox M10 GNSS 芯片,能够在 LTE 通信的同时提供精确的定位数据,适用于需要持续或周期性定位跟踪的应用场景。板载的 SpotNow 功能进一步提升其实用性,通过 UBX-R52 芯片组直接实现低功耗定位,适用于偶尔定位的场合,无需单独的 

GNSS 接收器。SARA-R52 系列在安全性方面也表现出色,支持安全启动、安全更新和受保护的生产流程。此外,它还支持 u-blox 的 MQTT Anywhere 和 MQTT Flex 服务,可通过减少数据开销和空中时间来优化通信,从而降低能耗并延长设备寿命。该模块同时获得了 AWS IoT Core 和 Microsoft Azure 的认证,可无缝集成至云端物联网生态系统。SARA-R520M10 与主控 MCU 之间的通信通过 UART 接口完成,使用标准的 UART RX 和 TX 引脚,以及用于数据流控制的 CTS/RTS/RI 引脚。默认通信速率为 115200bps,可通过 AT 指令进行数据交换。该 Click 板还配备 USB Type C 接口,用于电源和数据传输,符合 USB 2.0 标准(仅用于诊断目的)。LTE IoT 16 Click 具备多项额外功能,提升其实用性和可控性。PWR 按钮用于轻松开关模块电源,RESET 按钮可快速复位模块;这两个功能也可通过 mikroBUS™ 的 PWR 和 RST 引脚进行数字控制,并设有测试点以方

便调试。板载有多个状态指示灯:红色 NET LED 指示模块的网络状态(如已注册、未注册或正在传输数据);黄色 STAT LED 指示模块的电源状态(如关机、深度睡眠或活动状态);蓝色 PPS LED 指示时间脉冲信号,用于需要精确时间同步的应用。本板还配备两个 u.Fl 天线连接器,分别用于 LTE 主天线和可选的 GNSS 天线,兼容 MIKROE 提供的 LTE Flat 和 GPS Active 天线,搭配 IPEX-SMA 电缆,便于灵活连接。它还具备一个 micro SIM 卡座,支持 1.8V 和 3.0V 的 uSIM 卡,确保与多种蜂窝网络兼容,并允许用户根据自身需求选择合适的运营商。此 Click 板支持 3.3V 或 5V 逻辑电平的操作,可通过 VCC SEL 跳线进行选择。由于 SARA-R520M10 模块工作在 3.8V,板载的 TXB0106 电平转换器确保通信正常进行,使得支持 3.3V 和 5V 的 MCU 都可兼容使用。此外,本板还附带易于使用的函数库及示例代码,可作为进一步开发的参考。

LTE IoT 16 Click hardware overview image

功能概述

开发板

Arduino UNO 是围绕 ATmega328P 芯片构建的多功能微控制器板。它为各种项目提供了广泛的连接选项,具有 14 个数字输入/输出引脚,其中六个支持 PWM 输出,以及六个模拟输入。其核心组件包括一个 16MHz 的陶瓷谐振器、一个 USB 连接器、一个电

源插孔、一个 ICSP 头和一个复位按钮,提供了为板 子供电和编程所需的一切。UNO 可以通过 USB 连接到计算机,也可以通过 AC-to-DC 适配器或电池供电。作为第一个 USB Arduino 板,它成为 Arduino 平台的基准,"Uno" 符号化其作为系列首款产品的地

位。这个名称选择,意为意大利语中的 "一",是为了 纪念 Arduino Software(IDE)1.0 的推出。最初与 Arduino Software(IDE)版本1.0 同时推出,Uno 自此成为后续 Arduino 发布的基础模型,体现了该平台的演进。

Arduino UNO Rev3 double side image

微控制器概述 

MCU卡片 / MCU

default

建筑

AVR

MCU 内存 (KB)

32

硅供应商

Microchip

引脚数

28

RAM (字节)

2048

你完善了我!

配件

Click Shield for Arduino UNO 具有两个专有的 mikroBUS™ 插座,使所有 Click board™ 设备能够轻松与 Arduino UNO 板进行接口连接。Arduino UNO 是一款基于 ATmega328P 的微控制器开发板,为用户提供了一种经济实惠且灵活的方式来测试新概念并构建基于 ATmega328P 微控制器的原型系统,结合了性能、功耗和功能的多种配置选择。Arduino UNO 具有 14 个数字输入/输出引脚(其中 6 个可用作 PWM 输出)、6 个模拟输入、16 MHz 陶瓷谐振器(CSTCE16M0V53-R0)、USB 接口、电源插座、ICSP 头和复位按钮。大多数 ATmega328P 微控制器的引脚都连接到开发板左右两侧的 IO 引脚,然后再连接到两个 mikroBUS™ 插座。这款 Click Shield 还配备了多个开关,可执行各种功能,例如选择 mikroBUS™ 插座上模拟信号的逻辑电平,以及选择 mikroBUS™ 插座本身的逻辑电压电平。此外,用户还可以通过现有的双向电平转换电压转换器使用任何 Click board™,无论 Click board™ 运行在 3.3V 还是 5V 逻辑电压电平。一旦将 Arduino UNO 板与 Click Shield for Arduino UNO 连接,用户即可访问数百种 Click board™,并兼容 3.3V 或 5V 逻辑电压电平的设备。

Click Shield for Arduino UNO 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,能够满足各种设备的需求。

LTE IoT 16 Click accessories 1 image

主动 GPS 天线旨在增强您的 GPS 和 GNSS Click 板™ 的性能。这款外置天线结构坚固,适用于各种天气条件。凭借 1575.42MHz 的频率范围和 50Ohm 的阻抗,它确保了可靠的信号接收。天线在较宽的角度范围内提供大于 -4dBic 的增益,确保超过 75% 的覆盖率。± 5MHz 的带宽进一步保证了精确的数据采集。天线采用右旋圆极化 (RHCP),提供稳定的信号接收。其紧凑的尺寸为 48.5×39×15mm,配有 2 米长的电缆,安装方便。磁性天线类型与 SMA 公连接器确保了安全便捷的连接。如果您需要为定位设备提供可靠的外置天线,我们的主动 GPS 天线是完美的解决方案。

LTE IoT 16 Click accessories 2 image

IPEX-SMA 电缆是一种射频 (RF) 电缆组件。"IPEX" 指的是 IPEX 连接器,这是一种常用于小型电子设备的微型同轴连接器。"SMA" 代表 SubMiniature Version A,是另一种常用于射频应用的同轴连接器。IPEX-SMA 电缆组件的一端是 IPEX 连接器,另一端是 SMA 连接器,使其能够连接使用这些特定连接器的设备或组件。这些电缆常用于 WiFi 或蜂窝天线、GPS 模块以及其他需要可靠且低损耗连接的射频通信系统。

LTE IoT 16 Click accessories 3 image

使用的MCU引脚

mikroBUS™映射器

Module Power-ON
PC0
AN
Reset / ID SEL
PD2
RST
UART RTS / ID COMM
PB2
CS
NC
NC
SCK
NC
NC
MISO
NC
NC
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
Ring Indicator
PD6
PWM
UART CTS
PC3
INT
UART TX
PD0
TX
UART RX
PD1
RX
NC
NC
SCL
NC
NC
SDA
Power Supply
5V
5V
Ground
GND
GND
1

“仔细看看!”

Click board™ 原理图

LTE IoT 16 Click Schematic schematic

一步一步来

项目组装

Click Shield for Arduino UNO front image hardware assembly

从选择您的开发板和Click板™开始。以Arduino UNO Rev3作为您的开发板开始。

Click Shield for Arduino UNO front image hardware assembly
Arduino UNO Rev3 front image hardware assembly
Charger 27 Click front image hardware assembly
Prog-cut hardware assembly
Charger 27 Click complete accessories setup image hardware assembly
Board mapper by product8 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
Arduino UNO 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”替换为要显示的参数。

软件支持

库描述

LTE IoT 16 Click 演示应用程序使用 NECTO Studio开发,确保与 mikroSDK 的开源库和工具兼容。该演示设计为即插即用,可与所有具有 mikroBUS™ 插座的 开发板、入门板和 mikromedia 板完全兼容,用于快速实现和测试。

示例描述
此示例展示了设备连接至网络、发送短信或 TCP/UDP 消息,或通过标准 “AT” 指令从 GNSS 获取数据的功能。

关键功能:

  • lteiot16_cfg_setup - 初始化 Click 配置结构体为初始值。

  • lteiot16_init - 初始化此 Click 板所需的所有引脚和外设。

  • lteiot16_set_sim_apn - 设置 SIM 卡的 APN。

  • lteiot16_send_sms_text - 发送文本短信至指定电话号码。

  • lteiot16_cmd_set - 设置 Click 模块指定指令的值。

应用初始化
初始化驱动程序和日志记录器。

应用任务
应用任务分为多个阶段:

  • LTEIOT16_POWER_UP: 为设备上电,执行出厂重置并读取系统信息。

  • LTEIOT16_CONFIG_CONNECTION: 配置设备以连接网络(仅用于短信或 TCP/UDP 示例)。

  • LTEIOT16_CHECK_CONNECTION: 等待通过 CEREG 指令报告的网络注册,然后检查信号质量(仅用于短信或 TCP/UDP 示例)。

  • LTEIOT16_CONFIG_EXAMPLE: 为所选示例配置设备。

  • LTEIOT16_EXAMPLE: 根据所选演示示例,发送短信(PDU 或 TXT 模式)、TCP/UDP 消息,或等待获取 GPS 定位以从 GNSS 获取位置信息。默认选择 TCP/UDP 示例。

开源

代码示例

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

/*!
 * @file main.c
 * @brief LTE IoT 16 Click Example.
 *
 * # Description
 * Application example shows device capability of connecting to the network and
 * sending SMS or TCP/UDP messages, or retrieving data from GNSS using standard "AT" commands.
 *
 * The demo application is composed of two sections :
 *
 * ## Application Init
 * Initializes the driver and logger.
 *
 * ## Application Task
 * Application task is split in few stages:
 *  - LTEIOT16_POWER_UP:
 * Powers up the device, performs a device factory reset and reads system information.
 *
 *  - LTEIOT16_CONFIG_CONNECTION:
 * Sets configuration to device to be able to connect to the network (used only for SMS or TCP/UDP demo examples).
 *
 *  - LTEIOT16_CHECK_CONNECTION:
 * Waits for the network registration indicated via CEREG command and then checks the signal quality report 
 * (used only for SMS or TCP/UDP demo examples).
 *
 *  - LTEIOT16_CONFIG_EXAMPLE:
 * Configures device for the selected example.
 *
 *  - LTEIOT16_EXAMPLE:
 * Depending on the selected demo example, it sends an SMS message (in PDU or TXT mode) or TCP/UDP message or 
 * waits for the GPS fix to retrieve location info from GNSS.
 *
 * By default, the TCP/UDP example is selected.
 *
 * ## Additional Function
 * - static void lteiot16_clear_app_buf ( void )
 * - static void lteiot16_log_app_buf ( void )
 * - static err_t lteiot16_process ( lteiot16_t *ctx )
 * - static err_t lteiot16_read_response ( lteiot16_t *ctx, uint8_t *rsp )
 * - static err_t lteiot16_power_up ( lteiot16_t *ctx )
 * - static err_t lteiot16_config_connection ( lteiot16_t *ctx )
 * - static err_t lteiot16_check_connection ( lteiot16_t *ctx )
 * - static err_t lteiot16_config_example ( lteiot16_t *ctx )
 * - static err_t lteiot16_example ( lteiot16_t *ctx )
 *
 * @note
 * In order for the examples to work (except GNSS example), 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.
 * Example:
    SIM_APN "internet"
    SIM_SMSC "+381610401"
    PHONE_NUMBER "+381659999999"
 *
 * @author Stefan Filipovic
 *
 */

#include "board.h"
#include "log.h"
#include "lteiot16.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 EXAMPLE_GNSS                        2               // Example of retrieving location info from GNSS
#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                        ""              // Set Phone number to message
#define SMS_MODE                            "0"             // 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                     "LTE IoT 16 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
{
    LTEIOT16_POWER_UP = 1,
    LTEIOT16_CONFIG_CONNECTION,
    LTEIOT16_CHECK_CONNECTION,
    LTEIOT16_CONFIG_EXAMPLE,
    LTEIOT16_EXAMPLE

} lteiot16_app_state_t;

/**
 * @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 lteiot16_app_state_t app_state = LTEIOT16_POWER_UP;

static lteiot16_t lteiot16;
static log_t logger;

/**
 * @brief LTE IoT 16 clearing application buffer.
 * @details This function clears memory of application buffer and reset its length.
 * @note None.
 */
static void lteiot16_clear_app_buf ( void );

/**
 * @brief LTE IoT 16 log application buffer.
 * @details This function logs data from application buffer to USB UART.
 * @note None.
 */
static void lteiot16_log_app_buf ( void );

/**
 * @brief LTE IoT 16 data reading function.
 * @details This function reads data from device and concatenates data to application buffer. 
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @return @li @c  0 - Read some data.
 *         @li @c -1 - Nothing is read.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_process ( lteiot16_t *ctx );

/**
 * @brief LTE IoT 16 read response function.
 * @details This function waits for a response message, reads and displays it on the USB UART.
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @param[in] rsp  Expected response.
 * @return @li @c  0 - OK response.
 *         @li @c -2 - Timeout error.
 *         @li @c -3 - Command error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_read_response ( lteiot16_t *ctx, uint8_t *rsp );

/**
 * @brief LTE IoT 16 power up function.
 * @details This function powers up the device, performs a factory reset and reads system information.
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @return @li @c    0 - OK.
 *         @li @c != 0 - Read response error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_power_up ( lteiot16_t *ctx );

/**
 * @brief LTE IoT 16 config connection function.
 * @details This function configures and enables connection to the specified network.
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @return @li @c    0 - OK.
 *         @li @c != 0 - Read response error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_config_connection ( lteiot16_t *ctx );

/**
 * @brief LTE IoT 16 check connection function.
 * @details This function checks the connection to network.
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @return @li @c    0 - OK.
 *         @li @c != 0 - Read response error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_check_connection ( lteiot16_t *ctx );

/**
 * @brief LTE IoT 16 config example function.
 * @details This function configures device for the selected example.
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @return @li @c    0 - OK.
 *         @li @c != 0 - Read response error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_config_example ( lteiot16_t *ctx );

/**
 * @brief LTE IoT 16 example function.
 * @details This function executes SMS or TCP/UDP depending on the DEMO_EXAMPLE macro.
 * @param[in] ctx : Click context object.
 * See #lteiot16_t object definition for detailed explanation.
 * @return @li @c    0 - OK.
 *         @li @c != 0 - Read response error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t lteiot16_example ( lteiot16_t *ctx );

void application_init ( void ) 
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    lteiot16_cfg_t lteiot16_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.
    lteiot16_cfg_setup( &lteiot16_cfg );
    LTEIOT16_MAP_MIKROBUS( lteiot16_cfg, MIKROBUS_1 );
    if ( UART_ERROR == lteiot16_init( &lteiot16, &lteiot16_cfg ) ) 
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }
    
    log_info( &logger, " Application Task " );

    app_state = LTEIOT16_POWER_UP;
    log_printf( &logger, ">>> APP STATE - POWER UP <<<\r\n\n" );
}

void application_task ( void ) 
{
    switch ( app_state )
    {
        case LTEIOT16_POWER_UP:
        {
            if ( LTEIOT16_OK == lteiot16_power_up( &lteiot16 ) )
            {
                app_state = LTEIOT16_CONFIG_CONNECTION;
                log_printf( &logger, ">>> APP STATE - CONFIG CONNECTION <<<\r\n\n" );
            }
            break;
        }
        case LTEIOT16_CONFIG_CONNECTION:
        {
            if ( LTEIOT16_OK == lteiot16_config_connection( &lteiot16 ) )
            {
                app_state = LTEIOT16_CHECK_CONNECTION;
                log_printf( &logger, ">>> APP STATE - CHECK CONNECTION <<<\r\n\n" );
            }
            break;
        }
        case LTEIOT16_CHECK_CONNECTION:
        {
            if ( LTEIOT16_OK == lteiot16_check_connection( &lteiot16 ) )
            {
                app_state = LTEIOT16_CONFIG_EXAMPLE;
                log_printf( &logger, ">>> APP STATE - CONFIG EXAMPLE <<<\r\n\n" );
            }
            break;
        }
        case LTEIOT16_CONFIG_EXAMPLE:
        {
            if ( LTEIOT16_OK == lteiot16_config_example( &lteiot16 ) )
            {
                app_state = LTEIOT16_EXAMPLE;
                log_printf( &logger, ">>> APP STATE - EXAMPLE <<<\r\n\n" );
            }
            break;
        }
        case LTEIOT16_EXAMPLE:
        {
            lteiot16_example( &lteiot16 );
            break;
        }
        default:
        {
            log_error( &logger, " APP 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 lteiot16_clear_app_buf ( void ) 
{
    memset( app_buf, 0, app_buf_len );
    app_buf_len = 0;
}

static void lteiot16_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 lteiot16_process ( lteiot16_t *ctx ) 
{
    uint8_t rx_buf[ PROCESS_BUFFER_SIZE ] = { 0 };
    int32_t overflow_bytes = 0;
    int32_t rx_cnt = 0;
    int32_t rx_size = lteiot16_generic_read( ctx, rx_buf, PROCESS_BUFFER_SIZE );
    if ( ( rx_size > 0 ) && ( rx_size <= APP_BUFFER_SIZE ) ) 
    {
        if ( ( app_buf_len + rx_size ) > APP_BUFFER_SIZE ) 
        {
            overflow_bytes = ( app_buf_len + rx_size ) - APP_BUFFER_SIZE;
            app_buf_len = APP_BUFFER_SIZE - rx_size;
            memmove ( app_buf, &app_buf[ overflow_bytes ], app_buf_len );
            memset ( &app_buf[ app_buf_len ], 0, overflow_bytes );
        }
        for ( rx_cnt = 0; rx_cnt < rx_size; rx_cnt++ ) 
        {
            if ( rx_buf[ rx_cnt ] ) 
            {
                app_buf[ app_buf_len++ ] = rx_buf[ rx_cnt ];
            }
        }
        return LTEIOT16_OK;
    }
    return LTEIOT16_ERROR;
}

static err_t lteiot16_read_response ( lteiot16_t *ctx, uint8_t *rsp ) 
{
    #define READ_RESPONSE_TIMEOUT_MS    120000
    uint32_t timeout_cnt = 0;
    lteiot16_clear_app_buf ( );
    lteiot16_process( ctx );
    while ( ( 0 == strstr( app_buf, rsp ) ) &&
            ( 0 == strstr( app_buf, LTEIOT16_RSP_ERROR ) ) )
    {
        lteiot16_process( ctx );
        if ( timeout_cnt++ > READ_RESPONSE_TIMEOUT_MS )
        {
            lteiot16_log_app_buf( );
            lteiot16_clear_app_buf( );
            log_error( &logger, " Timeout!" );
            return LTEIOT16_ERROR_TIMEOUT;
        }
        Delay_ms( 1 );
    }
    Delay_ms ( 200 );
    lteiot16_process( ctx );
    lteiot16_log_app_buf( );
    if ( strstr( app_buf, rsp ) )
    {
        log_printf( &logger, "--------------------------------\r\n" );
        return LTEIOT16_OK;
    }
    return LTEIOT16_ERROR_CMD;
}

static err_t lteiot16_power_up ( lteiot16_t *ctx )
{
    err_t error_flag = LTEIOT16_OK;

    uint8_t power_state = LTEIOT16_POWER_STATE_OFF;
    for ( ; ; )
    {
        lteiot16_process( ctx );
        lteiot16_log_app_buf ( );
        lteiot16_clear_app_buf ( );
        // Wake up UART interface
        lteiot16_cmd_run( ctx, LTEIOT16_CMD_AT );

        log_printf( &logger, ">>> Check communication.\r\n" );
        lteiot16_cmd_run( ctx, LTEIOT16_CMD_AT );
        if ( ( ( LTEIOT16_OK == lteiot16_process( ctx ) ) && strstr( app_buf, LTEIOT16_RSP_OK ) ) )
        {
            power_state = LTEIOT16_POWER_STATE_ON;
            break;
        }
        else if ( LTEIOT16_POWER_STATE_OFF == power_state )
        {
            power_state = LTEIOT16_POWER_STATE_ON;
            log_printf( &logger, ">>> Power up device.\r\n" );
            lteiot16_set_power_state ( ctx, LTEIOT16_POWER_STATE_ON );
        }
        else if ( LTEIOT16_POWER_STATE_ON == power_state )
        {
            power_state = LTEIOT16_POWER_STATE_OFF;
            log_printf( &logger, ">>> Power down device.\r\n" );
            lteiot16_set_power_state ( ctx, LTEIOT16_POWER_STATE_OFF );
        }
    }
    lteiot16_cmd_run( ctx, LTEIOT16_CMD_AT );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    
    log_printf( &logger, ">>> Factory reset.\r\n" );
    lteiot16_cmd_run( ctx, LTEIOT16_CMD_FACTORY_RESET );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Get device software version ID.\r\n" );
    lteiot16_cmd_run( ctx, LTEIOT16_CMD_GET_SW_VERSION );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Get device serial number.\r\n" );
    lteiot16_cmd_run( ctx, LTEIOT16_CMD_GET_SERIAL_NUM );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    return error_flag;
}

static err_t lteiot16_config_connection ( lteiot16_t *ctx )
{
    err_t error_flag = LTEIOT16_OK;
#if ( ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP ) || ( DEMO_EXAMPLE == EXAMPLE_SMS ) )
    log_printf( &logger, ">>> Configure network status LED.\r\n" );
    #define NETWORK_STATUS_LED "16,2"
    lteiot16_cmd_set( ctx, LTEIOT16_CMD_GPIO_CONFIG, NETWORK_STATUS_LED );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Configure module status LED.\r\n" );
    #define MODULE_STATUS_LED "23,10"
    lteiot16_cmd_set( ctx, LTEIOT16_CMD_GPIO_CONFIG, MODULE_STATUS_LED );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Deregister from network.\r\n" );
    #define DEREGISTER_FROM_NETWORK "2"
    lteiot16_cmd_set( ctx, LTEIOT16_CMD_OPERATOR_SELECTION, DEREGISTER_FROM_NETWORK );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Set SIM APN.\r\n" );
    lteiot16_set_sim_apn( &lteiot16, SIM_APN );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    
    log_printf( &logger, ">>> Enable full functionality.\r\n" );
    #define FULL_FUNCTIONALITY "1"
    lteiot16_cmd_set( ctx, LTEIOT16_CMD_SET_MODULE_FUNCTIONALITY, FULL_FUNCTIONALITY );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Enable network registration.\r\n" );
    #define ENABLE_REG "2"
    lteiot16_cmd_set( ctx, LTEIOT16_CMD_EPS_NETWORK_REGISTRATION, ENABLE_REG );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Set automatic registration.\r\n" );
    #define AUTOMATIC_REGISTRATION "0"
    lteiot16_cmd_set( ctx, LTEIOT16_CMD_OPERATOR_SELECTION, AUTOMATIC_REGISTRATION );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
#endif
    return error_flag;
}

static err_t lteiot16_check_connection ( lteiot16_t *ctx )
{
    err_t error_flag = LTEIOT16_OK;
#if ( ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP ) || ( DEMO_EXAMPLE == EXAMPLE_SMS ) )
    log_printf( &logger, ">>> Check network registration.\r\n" );
    #define CONNECTED "+CEREG: 2,1"
    lteiot16_cmd_get ( &lteiot16, LTEIOT16_CMD_EPS_NETWORK_REGISTRATION );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    if ( strstr( app_buf, CONNECTED ) )
    {
        Delay_ms ( 1000 );
        log_printf( &logger, ">>> Check signal quality.\r\n" );
        lteiot16_cmd_run ( &lteiot16, LTEIOT16_CMD_SIGNAL_QUALITY_REPORT );
        error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    }
    else
    {
        error_flag = LTEIOT16_ERROR;
        Delay_ms ( 1000 );
        Delay_ms ( 1000 );
    }
#endif
    return error_flag;
}

static err_t lteiot16_config_example ( lteiot16_t *ctx )
{
    err_t error_flag = LTEIOT16_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    log_printf( &logger, ">>> Activate PDP context.\r\n" );
    #define ACTIVATE_PDP_CONTEXT "1,1"
    lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_ACTIVATE_PDP_CONTEXT, ACTIVATE_PDP_CONTEXT );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    log_printf( &logger, ">>> Show PDP address.\r\n" );
    #define PDP_CID "1"
    lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_SHOW_PDP_ADDRESS, PDP_CID );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    log_printf( &logger, ">>> Select SMS format.\r\n" );
    lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_SELECT_SMS_FORMAT, SMS_MODE );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
#elif ( DEMO_EXAMPLE == EXAMPLE_GNSS )
    log_printf( &logger, ">>> Check GNSS enable.\r\n" );
    lteiot16_cmd_get( &lteiot16, LTEIOT16_CMD_GNSS_POWER_MANAGEMENT );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    #define GNSS_POWERED_OFF "+UGPS: 0"
    if ( strstr( app_buf, GNSS_POWERED_OFF ) )
    {
        log_printf( &logger, ">>> Enable GNSS.\r\n" );
        #define ENABLE_GNSS "1,0,1"
        lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_GNSS_POWER_MANAGEMENT, ENABLE_GNSS );
        error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
        Delay_ms ( 1000 );
    }
    log_printf( &logger, ">>> Enable NMEA $GGA messages.\r\n" );
    #define ENABLE_NMEA_GGA "1"
    lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_GET_GNSS_FIX_DATA, ENABLE_NMEA_GGA );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
#endif
    return error_flag;
}

static err_t lteiot16_example ( lteiot16_t *ctx )
{
    err_t error_flag = LTEIOT16_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    uint8_t cmd_buf[ 100 ] = { 0 };
    uint8_t * __generic_ptr socket_num_buf = 0;
    uint8_t tcp_socket_num[ 2 ] = { 0 };
    uint8_t udp_socket_num[ 2 ] = { 0 };
    log_printf( &logger, ">>> Create TCP socket.\r\n" );
    #define TCP_PROTOCOL "6"
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_CREATE_SOCKET, TCP_PROTOCOL );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    socket_num_buf = strstr( app_buf, LTEIOT16_URC_CREATE_SOCKET ) + strlen ( LTEIOT16_URC_CREATE_SOCKET );
    if ( NULL != socket_num_buf )
    {
        tcp_socket_num[ 0 ] = *socket_num_buf;
    }

    log_printf( &logger, ">>> Create UDP socket.\r\n" );
    #define UDP_PROTOCOL "17"
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_CREATE_SOCKET, UDP_PROTOCOL );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    socket_num_buf = strstr( app_buf, LTEIOT16_URC_CREATE_SOCKET ) + strlen ( LTEIOT16_URC_CREATE_SOCKET );
    if ( NULL != socket_num_buf )
    {
        udp_socket_num[ 0 ] = *socket_num_buf;
    }

    log_printf( &logger, ">>> Open TCP connection.\r\n" );
    strcpy( cmd_buf, tcp_socket_num );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, REMOTE_IP );
    strcat( cmd_buf, "\"," );
    strcat( cmd_buf, REMOTE_PORT );
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_CONNECT_SOCKET, cmd_buf );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Open UDP connection.\r\n" );
    strcpy( cmd_buf, udp_socket_num );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, REMOTE_IP );
    strcat( cmd_buf, "\"," );
    strcat( cmd_buf, REMOTE_PORT );
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_CONNECT_SOCKET, cmd_buf );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    // Get message length
    uint8_t message_len_buf[ 10 ] = { 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 );

    log_printf( &logger, ">>> Write message to TCP connection.\r\n" );
    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, "\"" );
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_WRITE_SOCKET_DATA, cmd_buf );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_URC_RECEIVED_DATA );
    log_printf( &logger, ">>> Read response from TCP connection.\r\n" );
    strcpy( cmd_buf, tcp_socket_num );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_READ_SOCKET_DATA, cmd_buf );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );

    log_printf( &logger, ">>> Write message to UDP connection.\r\n" );
    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, "\"" );
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_WRITE_SOCKET_DATA, cmd_buf );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_URC_RECEIVED_DATA );
    log_printf( &logger, ">>> Read response from UDP connection.\r\n" );
    strcpy( cmd_buf, udp_socket_num );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    lteiot16_cmd_set( &lteiot16, LTEIOT16_CMD_READ_SOCKET_DATA, cmd_buf );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    
    log_printf( &logger, ">>> Close TCP connection.\r\n" );
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_CLOSE_SOCKET, tcp_socket_num );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    
    log_printf( &logger, ">>> Close UDP connection.\r\n" );
    lteiot16_cmd_set ( &lteiot16, LTEIOT16_CMD_CLOSE_SOCKET, udp_socket_num );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    #define CMGF_PDU "+CMGF: 0"
    #define CMGF_TXT "+CMGF: 1"
    log_printf( &logger, ">>> Check SMS format.\r\n" );
    lteiot16_cmd_get( &lteiot16, LTEIOT16_CMD_SELECT_SMS_FORMAT );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    if ( strstr( app_buf, CMGF_PDU ) )
    {
        log_printf( &logger, ">>> Send SMS in PDU mode.\r\n" );
        lteiot16_send_sms_pdu( &lteiot16, SIM_SMSC, PHONE_NUMBER, MESSAGE_CONTENT );
        error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    }
    else if ( strstr( app_buf, CMGF_TXT ) )
    {
        log_printf( &logger, ">>> Send SMS in TXT mode.\r\n" );
        lteiot16_send_sms_text ( &lteiot16, PHONE_NUMBER, MESSAGE_CONTENT );
        error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    }
    // 30 seconds delay
    for ( uint8_t delay_cnt = 0; delay_cnt < 30; delay_cnt++ )
    {
        Delay_ms ( 1000 );
    }
#elif ( DEMO_EXAMPLE == EXAMPLE_GNSS )
    log_printf( &logger, ">>> Get GNSS fix data.\r\n" );
    lteiot16_cmd_get( &lteiot16, LTEIOT16_CMD_GET_GNSS_FIX_DATA );
    error_flag |= lteiot16_read_response( ctx, LTEIOT16_RSP_OK );
    if ( app_buf_len > ( sizeof ( LTEIOT16_RSP_GGA ) + LTEIOT16_GGA_ELEMENT_SIZE ) ) 
    {
        uint8_t element_buf[ 100 ] = { 0 };
        if ( LTEIOT16_OK == lteiot16_parse_gga( app_buf, LTEIOT16_GGA_LATITUDE, element_buf ) )
        {
            if ( strlen( element_buf ) > 0 )
            {
                log_printf( &logger, "Latitude: %.2s degrees, %s minutes\r\n", element_buf, &element_buf[ 2 ] );
                lteiot16_parse_gga( app_buf, LTEIOT16_GGA_LONGITUDE, element_buf );
                log_printf( &logger, "Longitude: %.3s degrees, %s minutes\r\n", element_buf, &element_buf[ 3 ] );
                memset( element_buf, 0, sizeof( element_buf ) );
                lteiot16_parse_gga( app_buf, LTEIOT16_GGA_ALTITUDE, element_buf );
                log_printf( &logger, "Altitude: %s m\r\n", element_buf );
            }
            else
            {
                log_printf( &logger, "Waiting for the position fix...\r\n" );
            }
            Delay_ms ( 5 );
            log_printf( &logger, "--------------------------------\r\n" );
            lteiot16_clear_app_buf(  );
        }
    }
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
    Delay_ms ( 1000 );
#else
    #error "No demo example selected"
#endif
    return error_flag;
}

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

额外支持

资源

喜欢这个项目吗?

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