高级
30 分钟

使用SIM7672E和PIC18F4455确保欧洲物联网应用的LTE Cat 1连接及GNSS支持

可靠的物联网LTE Cat.1和GNSS连接解决方案

LTE Cat.1 7 Click with EasyPIC v8

已发布 1月 23, 2025

点击板

LTE Cat.1 7 Click

开发板

EasyPIC v8

编译器

NECTO Studio

微控制器单元

PIC18F4455

具备 LTE Cat 1 连接和 GNSS 支持的解决方案,非常适合车队管理、计量监控、安防监控及工业路由器等应用

A

A

硬件概览

它是如何工作的?

LTE Cat.1 7 Click 基于 SIMCom 的 SIM7672E LTE Cat 1 模块,采用最新的 QCX216 芯片组,覆盖欧洲和澳大利亚等地区。SIM7672E 支持 LTE-FDD 无线通信模式,最高下行速率为 10Mbps,上行速率为 5Mbps。此外,该模块支持多个 LTE 频段(B1/B3/B7/B8/B20/B28),集成了多星座 GNSS 支持、内置多个网络协议,并兼容多种操作系统的驱动程序(适用于 Windows、Linux 和 Android 的 USB 驱动)及 AT 命令。凭借广泛的功能,该 Click 板™ 非常适合车载信息服务、计量监控、安防设备、工业路由器和远程诊断等多种物联网应用。SIM7672E 与主机 MCU 通过 UART 接口通信,使用标准的 UART RX 和 TX 引脚以及硬件流控制引脚(CTS/RTS/RI - 清除发送/准备发送/响铃指示器)进行数据传输。模块默认通信速度为 115200bps,可通过 AT 命令实现高效数据交换。此 Click 板™ 还包括一个 USB Type C 接口,用于电源和数据传输,符合 USB 2.0 规范(仅

限外围设备)。此外,板后部配备了一个 USB 固件升级开关(标记为 USB BOOT),用于管理固件升级。开关的“0”位置为正常运行模式,“1”位置用于通过 USB 升级固件,确保升级过程简单直观。LTE Cat.1 7 Click 包括多项增强实用性和控制功能的附加功能。PWR 按钮允许用户轻松控制模块开关机,而 RESET 按钮则提供快速复位模块的功能。这些功能还可以通过 mikroBUS™ 引脚 PWR 和 RST 数字控制,提供更大的灵活性。此外,这些控制还配有专用测试点,便于调试和测试。板载多种视觉指示器,用于提供实时状态更新。黄色 NET LED 指示模块的当前网络状态:当 LED 常亮时,设备正在搜索网络;快速闪烁(200ms 开/关)表示数据传输或 4G 网络注册;当 LED 熄灭时,设备处于关闭或睡眠模式。红色 STAT LED 指示模块的电源状态:模块关闭时熄灭,模块开启时亮起。绿色 PPS LED 每秒发出一次来自 SIM7672E 的同步脉冲信号。该板还配备了两个 u.Fl

 接口,用于连接 MIKROE 提供的 LTE 和 GNSS 天线,例如 LTE 扁平旋转天线和主动 GPS 天线,同时结合 IPEX-SMA 电缆提供灵活高效的连接选项。此外,用户可以通过 GNSS ANT 跳线轻松选择 GNSS 天线的电源电压(3.3V 或 5V)。LTE Cat.1 7 Click 配备了一个 micro SIM 卡插槽,支持 1.8V 和 3.0V 的 uSIM 卡,确保兼容各种蜂窝网络,用户可以根据具体应用选择最合适的服务提供商。此 Click 板™ 可通过 VCC SEL 跳线选择以 3.3V 或 5V 逻辑电压运行。由于 SIM7672E 模块运行于 3.8V,板上使用了 TXB0106 逻辑电平转换器,以确保模块的正确运行和精确信号电平转换。这样,无论是 3.3V 还是 5V 的 MCU 都能正常使用通信线路。此外,该 Click 板™ 附带一个库,包含易于使用的函数和示例代码,可作为进一步开发的参考。

LTE Cat.1 7 Click hardware overview image

功能概述

开发板

EasyPIC v8 是一款专为快速开发嵌入式应用的需求而特别设计的开发板。它支持许多高引脚计数的8位PIC微控制器,来自Microchip,无论它们的引脚数量如何,并且具有一系列独特功能,例如首次集成的调试器/程序员。开发板布局合理,设计周到,使得最终用户可以在一个地方找到所有必要的元素,如开关、按钮、指示灯、连接器等。得益于创新的制造技术,EasyPIC v8 提供了流畅而沉浸式的工作体验,允许在任何情况下、任何地方、任何时候都能访问。

EasyPIC v8 开发板的每个部分都包含了使同一板块运行最高效的必要组件。除了先进的集成CODEGRIP程 序/调试模块,该模块提供许多有价值的编程/调试选项和与Mikroe软件环境的无缝集成外,该板还包括一个干净且调节过的开发板电源供应模块。它可以使用广泛的外部电源,包括电池、外部12V电源供应和通过USB Type-C(USB-C)连接器的电源。通信选项如USB-UART、USB DEVICE和CAN也包括在内,包括 广受好评的mikroBUS™标准、两种显示选项(图形和

基于字符的LCD)和几种不同的DIP插座。这些插座覆盖了从最小的只有八个至四十个引脚的8位PIC MCU的广泛范围。EasyPIC v8 是Mikroe快速开发生态系统的一个组成部分。它由Mikroe软件工具原生支持,得益于大量不同的Click板™(超过一千块板),其数量每天都在增长,它涵盖了原型制作和开发的许多方面。

EasyPIC v8 horizontal image

微控制器概述 

MCU卡片 / MCU

PIC18F4455

建筑

PIC

MCU 内存 (KB)

24

硅供应商

Microchip

引脚数

40

RAM (字节)

2048

你完善了我!

配件

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 Cat.1 7 Click accessories 1 image

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

LTE Cat.1 7 Click accessories 3 image

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

LTE Cat.1 7 Click accessories 2 image

使用的MCU引脚

mikroBUS™映射器

Module Power-ON
RA2
AN
Reset / ID SEL
RE1
RST
UART RTS / ID COMM
RE0
CS
NC
NC
SCK
NC
NC
MISO
NC
NC
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
Ring Indicator
RC0
PWM
UART CTS
RB0
INT
UART TX
RC6
TX
UART RX
RC7
RX
NC
NC
SCL
NC
NC
SDA
Power Supply
5V
5V
Ground
GND
GND
1

“仔细看看!”

Click board™ 原理图

LTE Cat.1 7 Click Schematic schematic

一步一步来

项目组装

EasyPIC v8 front image hardware assembly

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

EasyPIC v8 front image hardware assembly
GNSS2 Click front image hardware assembly
MCU DIP 40 hardware assembly
GNSS2 Click complete accessories setup image hardware assembly
EasyPIC v8 Access DIPMB 1 - upright/background hardware assembly
Necto image step 2 hardware assembly
Necto image step 3 hardware assembly
Necto image step 4 hardware assembly
NECTO Compiler Selection Step Image hardware assembly
NECTO Output Selection Step Image hardware assembly
Necto image step 6 hardware assembly
Necto DIP image step 7 hardware assembly
Necto image step 8 hardware assembly
Necto image step 9 hardware assembly
Necto image step 10 hardware assembly
Necto PreFlash Image 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 Cat.1 7 Click 演示应用程序使用 NECTO Studio开发,确保与 mikroSDK 的开源库和工具兼容。该演示设计为即插即用,可与所有具有 mikroBUS™ 插座的 开发板、入门板和 mikromedia 板完全兼容,用于快速实现和测试。

示例描述
此示例展示了设备连接到网络、发送 SMS 或 TCP/UDP 消息,以及通过标准 "AT" 命令检索 GNSS 数据的能力。

关键功能:

  • ltecat17_cfg_setup - 配置对象初始化函数。

  • ltecat17_init - 初始化函数。

  • ltecat17_set_sim_apn - 设置 SIM 卡的 APN。

  • ltecat17_cmd_run - 向 Click 模块发送指定命令的函数。

  • ltecat17_set_power_state - 通过设置 PWR 引脚的高电平时间以切换到所需电源状态。

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

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

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

  • LTECAT17_CONFIG_CONNECTION: 配置设备以连接到网络(仅适用于 SMS 或 TCP/UDP 示例)。

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

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

  • LTECAT17_EXAMPLE: 根据所选的演示示例,它可以发送 SMS 消息(PDU 或 TXT 模式)、TCP/UDP 消息,或等待 GPS 修复以从 GNSS 检索位置信息。默认情况下选择 TCP/UDP 示例。

为了使示例正常运行(GNSS 示例除外),用户需要设置所插入 SIM 卡的 APN 和 SMSC(仅适用于 SMS PDU 模式),以及目标手机号码(仅适用于 SMS 模式)。请为以下宏定义输入有效值:SIM_APN、SIM_SMSC 和 PHONE_NUMBER_TO_MESSAGE。

示例:

  • SIM_APN "internet"

  • SIM_SMSC "+381610401"

  • PHONE_NUMBER_TO_MESSAGE "+381659999999"

开源

代码示例

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

/*!
 * @file main.c
 * @brief LTE Cat.1 7 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:
 *  - LTECAT17_POWER_UP:
 * Powers up the device, performs a device factory reset and reads system information.
 *
 *  - LTECAT17_CONFIG_CONNECTION:
 * Sets configuration to device to be able to connect to the network (used only for SMS or TCP/UDP demo examples).
 *
 *  - LTECAT17_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).
 *
 *  - LTECAT17_CONFIG_EXAMPLE:
 * Configures device for the selected example.
 *
 *  - LTECAT17_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 ltecat17_clear_app_buf ( void )
 * - static void ltecat17_log_app_buf ( void )
 * - static err_t ltecat17_process ( ltecat17_t *ctx )
 * - static err_t ltecat17_read_response ( ltecat17_t *ctx, uint8_t *rsp )
 * - static err_t ltecat17_power_up ( ltecat17_t *ctx )
 * - static err_t ltecat17_config_connection ( ltecat17_t *ctx )
 * - static err_t ltecat17_check_connection ( ltecat17_t *ctx )
 * - static err_t ltecat17_config_example ( ltecat17_t *ctx )
 * - static err_t ltecat17_example ( ltecat17_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_TO_MESSAGE.
 * Example:
    SIM_APN "internet"
    SIM_SMSC "+381610401"
    PHONE_NUMBER_TO_MESSAGE "+381659999999"
 *
 * @author Stefan Filipovic
 *
 */

#include "board.h"
#include "log.h"
#include "ltecat17.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_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                     "LTE Cat.1 7 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
{
    LTECAT17_POWER_UP = 1,
    LTECAT17_CONFIG_CONNECTION,
    LTECAT17_CHECK_CONNECTION,
    LTECAT17_CONFIG_EXAMPLE,
    LTECAT17_EXAMPLE

} ltecat17_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 ltecat17_app_state_t app_state = LTECAT17_POWER_UP;

static ltecat17_t ltecat17;
static log_t logger;

/**
 * @brief LTE Cat.1 7 clearing application buffer.
 * @details This function clears memory of application buffer and reset its length.
 * @note None.
 */
static void ltecat17_clear_app_buf ( void );

/**
 * @brief LTE Cat.1 7 log application buffer.
 * @details This function logs data from application buffer to USB UART.
 * @note None.
 */
static void ltecat17_log_app_buf ( void );

/**
 * @brief LTE Cat.1 7 data reading function.
 * @details This function reads data from device and concatenates data to application buffer. 
 * @param[in] ctx : Click context object.
 * See #ltecat17_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 ltecat17_process ( ltecat17_t *ctx );

/**
 * @brief LTE Cat.1 7 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 #ltecat17_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.
 *         @li @c -4 - Unknown error.
 * See #err_t definition for detailed explanation.
 * @note None.
 */
static err_t ltecat17_read_response ( ltecat17_t *ctx, uint8_t *rsp );

/**
 * @brief LTE Cat.1 7 power up function.
 * @details This function powers up the device, performs device factory reset and reads system information.
 * @param[in] ctx : Click context object.
 * See #ltecat17_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 ltecat17_power_up ( ltecat17_t *ctx );

/**
 * @brief LTE Cat.1 7 config connection function.
 * @details This function configures and enables connection to the specified network.
 * @param[in] ctx : Click context object.
 * See #ltecat17_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 ltecat17_config_connection ( ltecat17_t *ctx );

/**
 * @brief LTE Cat.1 7 check connection function.
 * @details This function checks the connection to network.
 * @param[in] ctx : Click context object.
 * See #ltecat17_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 ltecat17_check_connection ( ltecat17_t *ctx );

/**
 * @brief LTE Cat.1 7 config example function.
 * @details This function configures device for the selected example.
 * @param[in] ctx : Click context object.
 * See #ltecat17_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 ltecat17_config_example ( ltecat17_t *ctx );

/**
 * @brief LTE Cat.1 7 example function.
 * @details This function executes SMS, TCP/UDP or GNSS example depending on the DEMO_EXAMPLE macro.
 * @param[in] ctx : Click context object.
 * See #ltecat17_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 ltecat17_example ( ltecat17_t *ctx );

void application_init ( void ) 
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    ltecat17_cfg_t ltecat17_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.
    ltecat17_cfg_setup( &ltecat17_cfg );
    LTECAT17_MAP_MIKROBUS( ltecat17_cfg, MIKROBUS_1 );
    if ( UART_ERROR == ltecat17_init( &ltecat17, &ltecat17_cfg ) ) 
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }
    
    log_info( &logger, " Application Task " );

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

void application_task ( void ) 
{
    switch ( app_state )
    {
        case LTECAT17_POWER_UP:
        {
            if ( LTECAT17_OK == ltecat17_power_up( &ltecat17 ) )
            {
                app_state = LTECAT17_CONFIG_CONNECTION;
                log_printf( &logger, ">>> APP STATE - CONFIG CONNECTION <<<\r\n\n" );
            }
            break;
        }
        case LTECAT17_CONFIG_CONNECTION:
        {
            if ( LTECAT17_OK == ltecat17_config_connection( &ltecat17 ) )
            {
                app_state = LTECAT17_CHECK_CONNECTION;
                log_printf( &logger, ">>> APP STATE - CHECK CONNECTION <<<\r\n\n" );
            }
            break;
        }
        case LTECAT17_CHECK_CONNECTION:
        {
            if ( LTECAT17_OK == ltecat17_check_connection( &ltecat17 ) )
            {
                app_state = LTECAT17_CONFIG_EXAMPLE;
                log_printf( &logger, ">>> APP STATE - CONFIG EXAMPLE <<<\r\n\n" );
            }
            break;
        }
        case LTECAT17_CONFIG_EXAMPLE:
        {
            if ( LTECAT17_OK == ltecat17_config_example( &ltecat17 ) )
            {
                app_state = LTECAT17_EXAMPLE;
                log_printf( &logger, ">>> APP STATE - EXAMPLE <<<\r\n\n" );
            }
            break;
        }
        case LTECAT17_EXAMPLE:
        {
            ltecat17_example( &ltecat17 );
            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 ltecat17_clear_app_buf ( void ) 
{
    memset( app_buf, 0, app_buf_len );
    app_buf_len = 0;
}

static void ltecat17_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 ltecat17_process ( ltecat17_t *ctx ) 
{
    uint8_t rx_buf[ PROCESS_BUFFER_SIZE ] = { 0 };
    int32_t overflow_bytes = 0;
    int32_t rx_cnt = 0;
    int32_t rx_size = ltecat17_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 LTECAT17_OK;
    }
    return LTECAT17_ERROR;
}

static err_t ltecat17_read_response ( ltecat17_t *ctx, uint8_t *rsp ) 
{
    #define READ_RESPONSE_TIMEOUT_MS    120000
    uint32_t timeout_cnt = 0;
    ltecat17_clear_app_buf ( );
    ltecat17_process( ctx );
    while ( ( 0 == strstr( app_buf, rsp ) ) &&
            ( 0 == strstr( app_buf, LTECAT17_RSP_ERROR ) ) )
    {
        ltecat17_process( ctx );
        if ( timeout_cnt++ > READ_RESPONSE_TIMEOUT_MS )
        {
            ltecat17_log_app_buf( );
            ltecat17_clear_app_buf( );
            log_error( &logger, " Timeout!" );
            return LTECAT17_ERROR_TIMEOUT;
        }
        Delay_ms( 1 );
    }
    Delay_ms ( 200 );
    ltecat17_process( ctx );
    ltecat17_log_app_buf( );
    if ( strstr( app_buf, rsp ) )
    {
        log_printf( &logger, "--------------------------------\r\n" );
        return LTECAT17_OK;
    }
    return LTECAT17_ERROR_CMD;
}

static err_t ltecat17_power_up ( ltecat17_t *ctx )
{
    err_t error_flag = LTECAT17_OK;
    
    uint8_t power_state = LTECAT17_POWER_STATE_OFF;
    for ( ; ; )
    {
        ltecat17_process( ctx );
        ltecat17_clear_app_buf ( );
        // Wake up UART interface
        ltecat17_cmd_run( ctx, LTECAT17_CMD_AT );

        log_printf( &logger, ">>> Check communication.\r\n" );
        ltecat17_cmd_run( ctx, LTECAT17_CMD_AT );
        if ( ( ( LTECAT17_OK == ltecat17_process( ctx ) ) && strstr( app_buf, LTECAT17_RSP_OK ) ) )
        {
            power_state = LTECAT17_POWER_STATE_ON;
            break;
        }
        else if ( LTECAT17_POWER_STATE_OFF == power_state )
        {
            power_state = LTECAT17_POWER_STATE_ON;
            log_printf( &logger, ">>> Power up device.\r\n" );
            ltecat17_set_power_state ( ctx, LTECAT17_POWER_STATE_ON );
        }
        else if ( LTECAT17_POWER_STATE_ON == power_state )
        {
            power_state = LTECAT17_POWER_STATE_OFF;
            log_printf( &logger, ">>> Power down device.\r\n" );
            ltecat17_set_power_state ( ctx, LTECAT17_POWER_STATE_OFF );
        }
    }
    ltecat17_cmd_run( ctx, LTECAT17_CMD_AT );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    
    log_printf( &logger, ">>> Factory reset.\r\n" );
    ltecat17_cmd_run( ctx, LTECAT17_CMD_FACTORY_RESET );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Get device model ID.\r\n" );
    ltecat17_cmd_run( ctx, LTECAT17_CMD_GET_MODEL_ID );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Get device software version ID.\r\n" );
    ltecat17_cmd_run( ctx, LTECAT17_CMD_GET_SW_VERSION );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Get device serial number.\r\n" );
    ltecat17_cmd_run( ctx, LTECAT17_CMD_GET_SERIAL_NUM );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    return error_flag;
}

static err_t ltecat17_config_connection ( ltecat17_t *ctx )
{
    err_t error_flag = LTECAT17_OK;
#if ( ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP ) || ( DEMO_EXAMPLE == EXAMPLE_SMS ) )
    log_printf( &logger, ">>> Deregister from network.\r\n" );
    #define DEREGISTER_FROM_NETWORK "2"
    ltecat17_cmd_set( ctx, LTECAT17_CMD_OPERATOR_SELECTION, DEREGISTER_FROM_NETWORK );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Set SIM APN.\r\n" );
    ltecat17_set_sim_apn( &ltecat17, SIM_APN );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    
    log_printf( &logger, ">>> Enable full functionality.\r\n" );
    #define FULL_FUNCTIONALITY "1"
    ltecat17_cmd_set( ctx, LTECAT17_CMD_SET_PHONE_FUNCTIONALITY, FULL_FUNCTIONALITY );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Enable network registration.\r\n" );
    #define ENABLE_REG "2"
    ltecat17_cmd_set( ctx, LTECAT17_CMD_NETWORK_REGISTRATION, ENABLE_REG );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Set automatic registration.\r\n" );
    #define AUTOMATIC_REGISTRATION "0"
    ltecat17_cmd_set( ctx, LTECAT17_CMD_OPERATOR_SELECTION, AUTOMATIC_REGISTRATION );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
#endif
    return error_flag;
}

static err_t ltecat17_check_connection ( ltecat17_t *ctx )
{
    err_t error_flag = LTECAT17_OK;
#if ( ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP ) || ( DEMO_EXAMPLE == EXAMPLE_SMS ) )
    log_printf( &logger, ">>> Check network registration.\r\n" );
    #define CONNECTED "+CEREG: 2,1"
    ltecat17_cmd_get ( &ltecat17, LTECAT17_CMD_NETWORK_REGISTRATION );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    if ( strstr( app_buf, CONNECTED ) )
    {
        Delay_ms ( 1000 );
        log_printf( &logger, ">>> Check signal quality.\r\n" );
        ltecat17_cmd_run( &ltecat17, LTECAT17_CMD_SIGNAL_QUALITY_REPORT );
        error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    }
    else
    {
        error_flag = LTECAT17_ERROR;
        Delay_ms ( 1000 );
        Delay_ms ( 1000 );
    }
#endif
    return error_flag;
}

static err_t ltecat17_config_example ( ltecat17_t *ctx )
{
    err_t error_flag = LTECAT17_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    log_printf( &logger, ">>> Activate PDP context.\r\n" );
    #define ACTIVATE_PDP_CONTEXT "1,1"
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_ACTIVATE_PDP_CONTEXT, ACTIVATE_PDP_CONTEXT );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Show PDP address.\r\n" );
    #define PDP_CID "1"
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_SHOW_PDP_ADDRESS, PDP_CID );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    
    log_printf( &logger, ">>> Check TCPIP service.\r\n" );
    #define NETWORK_OPEN "+NETOPEN: 1"
    ltecat17_cmd_get ( &ltecat17, LTECAT17_CMD_START_TCPIP_SERVICE );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    if ( !strstr ( app_buf, NETWORK_OPEN ) )
    {
        log_printf( &logger, ">>> Start TCPIP service.\r\n" );
        ltecat17_cmd_run ( &ltecat17, LTECAT17_CMD_START_TCPIP_SERVICE );
        error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    }

    log_printf( &logger, ">>> Set RX mode to manually.\r\n" );
    #define RX_MODE_MANUALLY "1"
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_RECEIVE_DATA_VIA_CONNECTION, RX_MODE_MANUALLY );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    log_printf( &logger, ">>> Select SMS format.\r\n" );
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_SELECT_SMS_FORMAT, SMS_MODE );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
#elif ( DEMO_EXAMPLE == EXAMPLE_GNSS )
    log_printf( &logger, ">>> Turn on GNSS power supply.\r\n" );
    #define GNNS_TURN_ON "1"
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_GNSS_POWER_CONTROL, GNNS_TURN_ON );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
#endif
    return error_flag;
}

static err_t ltecat17_example ( ltecat17_t *ctx )
{
    err_t error_flag = LTECAT17_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    uint8_t cmd_buf[ 100 ] = { 0 };
    
    log_printf( &logger, ">>> Open TCP connection.\r\n" );
    #define TCP_LINK_NUM "0"
    #define TCP_CONN_TYPE "TCP"
    strcpy( cmd_buf, TCP_LINK_NUM );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, TCP_CONN_TYPE );
    strcat( cmd_buf, "\",\"" );
    strcat( cmd_buf, REMOTE_IP );
    strcat( cmd_buf, "\"," );
    strcat( cmd_buf, REMOTE_PORT );
    ltecat17_cmd_set ( &ltecat17, LTECAT17_CMD_OPEN_TCP_UDP_CONNECTION, cmd_buf );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Open UDP connection.\r\n" );
    #define UDP_LINK_NUM "1"
    #define UDP_CONN_TYPE "UDP"
    #define UDP_LOCAL_PORT "5000"
    strcpy( cmd_buf, UDP_LINK_NUM );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, UDP_CONN_TYPE );
    strcat( cmd_buf, "\",,," );
    strcat( cmd_buf, UDP_LOCAL_PORT );
    ltecat17_cmd_set ( &ltecat17, LTECAT17_CMD_OPEN_TCP_UDP_CONNECTION, cmd_buf );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_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_LINK_NUM );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    ltecat17_cmd_set ( &ltecat17, LTECAT17_CMD_SEND_DATA_VIA_CONNECTION, cmd_buf );
    Delay_ms ( 100 );
    ltecat17_generic_write ( &ltecat17, MESSAGE_CONTENT, message_len );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_URC_RECEIVED_DATA );
    log_printf( &logger, ">>> Read response from TCP connection.\r\n" );
    #define RX_DATA_READ "2"
    strcpy( cmd_buf, RX_DATA_READ );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, TCP_LINK_NUM );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_RECEIVE_DATA_VIA_CONNECTION, cmd_buf );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );

    log_printf( &logger, ">>> Write message to UDP connection.\r\n" );
    strcpy( cmd_buf, UDP_LINK_NUM );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    strcat( cmd_buf, ",\"" );
    strcat( cmd_buf, REMOTE_IP );
    strcat( cmd_buf, "\"," );
    strcat( cmd_buf, REMOTE_PORT );
    ltecat17_cmd_set ( &ltecat17, LTECAT17_CMD_SEND_DATA_VIA_CONNECTION, cmd_buf );
    Delay_ms ( 100 );
    ltecat17_generic_write ( &ltecat17, MESSAGE_CONTENT, message_len );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_URC_RECEIVED_DATA );
    log_printf( &logger, ">>> Read response from UDP connection.\r\n" );
    strcpy( cmd_buf, RX_DATA_READ );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, UDP_LINK_NUM );
    strcat( cmd_buf, "," );
    strcat( cmd_buf, message_len_buf );
    ltecat17_cmd_set( &ltecat17, LTECAT17_CMD_RECEIVE_DATA_VIA_CONNECTION, cmd_buf );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    
    log_printf( &logger, ">>> Close TCP connection.\r\n" );
    ltecat17_cmd_set ( &ltecat17, LTECAT17_CMD_CLOSE_TCP_UDP_CONNECTION, TCP_LINK_NUM );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    
    log_printf( &logger, ">>> Close UDP connection.\r\n" );
    ltecat17_cmd_set ( &ltecat17, LTECAT17_CMD_CLOSE_TCP_UDP_CONNECTION, UDP_LINK_NUM );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    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"
    log_printf( &logger, ">>> Check SMS format.\r\n" );
    ltecat17_cmd_get( &ltecat17, LTECAT17_CMD_SELECT_SMS_FORMAT );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    if ( strstr( app_buf, CMGF_PDU ) )
    {
        // Send SMS in PDU mode
        log_printf( &logger, ">>> Send SMS in PDU mode.\r\n" );
        ltecat17_send_sms_pdu( &ltecat17, SIM_SMSC, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    }
    else if ( strstr( app_buf, CMGF_TXT ) )
    {
        // Send SMS in TXT mode
        log_printf( &logger, ">>> Send SMS in TXT mode.\r\n" );
        ltecat17_send_sms_text ( &ltecat17, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag |= ltecat17_read_response( ctx, LTECAT17_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 info.\r\n" );
    ltecat17_cmd_run ( &ltecat17, LTECAT17_CMD_GET_GNSS_INFO );
    error_flag |= ltecat17_read_response( ctx, LTECAT17_RSP_OK );
    Delay_ms ( 1000 );
#else
    #error "No demo example selected"
#endif
    return error_flag;
}

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

额外支持

资源

喜欢这个项目吗?

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