初学者
10 分钟

体验与LARA-R6401和PIC18F86J10连接的下一个前沿

LTE Cat.1 - 创新与安全的交汇点!

4G LTE 2 Click - Voice (for North America) with EasyPIC PRO v8

已发布 11月 30, 2024

点击板

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

开发板

EasyPIC PRO v8

编译器

NECTO Studio

微控制器单元

PIC18F86J10

通过我们的LTE Cat.1多频段解决方案,发现连接的新高度——旨在无缝连接并安全提升您在北美的业务运营。

A

A

硬件概览

它是如何工作的?

4G LTE 2 Click - Voice(适用于北美)基于u-blox的LARA-R6401,这是一款LARA-R6系列的多频段多模式模块,支持LTE Cat 1 FDD和LTE Cat 1 TDD无线接入技术(18个LTE频段),并具备3G UMTS/HSPA和2G GSM/GPRS/EGPRS回退功能,为北美市场提供无妥协的连接解决方案。此Click板™代表了具有全球覆盖和所有相关移动网络运营商认证的数据和语音解决方案,提供了极大的灵活性和对语音/音频应用的支持。多功能接口和特性使LARA-R6401非常适合需要中速数据、无缝连接、卓越覆盖、低延迟和数据流传输的广泛应用,如资产追踪、远程信息处理、远程监控、销售点终端等。LARA-R6401模块提供了LTE语音(VoLTE)和从LTE到3G或2G无线承载的电路交换回退(CSFB)音频服务,用户可以通过板载3.5毫米音频插孔访问。这种音频接口可以通过AT命令进行配置,将数字音频数据传输到/从外部设备作为

板载音频编解码器。该模块需要3.8V的电源。因此,Click板™集成了一个降压(DC-DC降压)转换器,由德州仪器的TPS7A7002提供稳定的3.8V电源,能够在出现高电流峰值时(通常在设备启动时)缓解输入电压下降问题。模块点火(开机)引脚标记为PWR,并连接到mikroBUS™插座上的RST引脚,提供开关操作以打开/关闭对LARA-R6401的电源供应。LARA-R6401通过UART接口与MCU通信,使用常用的UART RX和TX引脚以及硬件流控制引脚UART CTS、RTS、RI(发送准备就绪、接收准备就绪和振铃指示器)。默认配置下,UART以115200 bps的速度运行,通过u-blox提供的AT命令与主机MCU传输和交换数据。除了UART接口,LARA-R6401还允许I2C接口作为I2C主机,可以按照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板™可以通过VCC SEL跳线选择3.3V或5V逻辑电压电平运行。这样,3.3V和5V的MCU都可以正确使用通信线路。此外,此Click板™配备了包含易于使用的功能和示例代码的库,可用于进一步开发的参考。

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

功能概述

开发板

EasyPIC PRO v8 是一款专为快速开发嵌入式应用而设计的开发板。它支持多种高引脚计数的 8 位 PIC 微控制器,来自 Microchip,不论其引脚数量如何,并具备一系列独特功能,例如首次通过 WiFi 的嵌入式调试器/程序员。开发板布局合理,设计周到,确保最终用户在一个地方可以找到所有必要的元素,如开关、按钮、指示灯、连接器等。得益于创新的制造技术,EasyPIC PRO v8 提供了流畅而沉浸式的工作体验,

允许在任何情况下、任何地方都能访问。EasyPIC  PRO v8 开发板的每个部分都包含了使同一板块运行最高效的必要组件。除了先进的集成 CODEGRIP 程序/调试模块,该模块提供许多有价值的编程/调试选项并与 Mikroe 软件环境无缝集成外,该板还包括一个为开发板提供的干净且调节过的电源供应模块。它可以使用广泛的外部电源,包括电池、外部 12V 电源供应,以及通过 USB Type-C(USB-C)连接器的电

源。通信选项包括 USB-UART、USB DEVICE 和  Ethernet,还包括广受好评的 mikroBUS™ 标准、为 MCU 卡提供的标准化插座(SiBRAIN 标准),以及两种显示选项(图形和基于字符的 LCD)。EasyPIC PRO v8 是 Mikroe 快速开发生态系统的一个重要组成部分,由 Mikroe 软件工具原生支持,得益于大量不同的 Click 板™(超过一千块板),其数量每天都在增长,它涵盖了原型制作和开发的许多方面。

EasyPIC PRO v8 horizontal image

微控制器概述 

MCU卡片 / MCU

MCU CARD 2 for PIC PIC18F86J10 front image

类型

8th Generation

建筑

PIC

MCU 内存 (KB)

64

硅供应商

Microchip

引脚数

80

RAM (字节)

2048

你完善了我!

配件

这款多频段LTE橡胶天线具有可调角度,是我们提供的所有基于3G/4G LTE的Click板™以及其他需要在所有主要蜂窝频段上实现卓越吞吐量的设备的绝佳选择。天线配有SMA公头连接器,可直接安装在Click板™或SMA母头模块连接器上。天线位置可按45⁰增量(0⁰/45⁰/90⁰)进行调整。

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

使用的MCU引脚

mikroBUS™映射器

Module Status
RA0
AN
Power-ON
RJ4
RST
UART RTS
RJ0
CS
NC
NC
SCK
NC
NC
MISO
NC
NC
MOSI
Power Supply
3.3V
3.3V
Ground
GND
GND
Ring Indicator
RE0
PWM
UART CTS
RB0
INT
UART TX
RG1
TX
UART RX
RG2
RX
I2C Clock
RC3
SCL
I2C Data
RC4
SDA
Power Supply
5V
5V
Ground
GND
GND
1

“仔细看看!”

Click board™ 原理图

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

一步一步来

项目组装

Fusion for PIC v8 front image hardware assembly

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

Fusion for PIC v8 front image hardware assembly
GNSS2 Click front image hardware assembly
SiBRAIN for PIC32MZ1024EFK144 front image 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 Compiler Selection Step Image hardware assembly
NECTO Output Selection Step Image hardware assembly
Necto image step 6 hardware assembly
Necto 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”替换为要显示的参数。

软件支持

库描述

该库包含 4G LTE 2 Click - Voice(适用于北美)Click 驱动程序的 API。

关键功能:

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

  • c4glte2voicena_set_sim_apn - 此函数设置SIM卡的APN。

  • c4glte2voicena_send_sms_text - 此函数向电话号码发送短信。

开源

代码示例

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

/*!
 * @file main.c
 * @brief 4G LTE 2 Voice-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:
 *  - C4GLTE2VOICENA_CONFIGURE_FOR_NETWORK:
 * Sets configuration to device to be able to connect to the network.
 *
 *  - C4GLTE2VOICENA_WAIT_FOR_CONNECTION:
 * Waits for the network registration indicated via CREG URC event and then checks the connection status.
 *
 *  - C4GLTE2VOICENA_CONFIGURE_FOR_EXAMPLE:
 * Sets the device configuration for sending SMS or TCP/UDP messages depending on the selected demo example.
 *
 *  - C4GLTE2VOICENA_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 c4glte2voicena_clear_app_buf ( void )
 * - static err_t c4glte2voicena_process ( void )
 * - static void c4glte2voicena_error_check( err_t error_flag )
 * - static void c4glte2voicena_log_app_buf ( void )
 * - static err_t c4glte2voicena_rsp_check ( void )
 * - static err_t c4glte2voicena_cfg_for_network( void )
 * - static err_t c4glte2voicena_check_connection( void )
 * - static err_t c4glte2voicena_cfg_for_example( void )
 * - static err_t c4glte2voicena_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 "c4glte2voicena.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                             "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                     "4G LTE 2 Voice-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
{
    C4GLTE2VOICENA_CONFIGURE_FOR_NETWORK = 1,
    C4GLTE2VOICENA_WAIT_FOR_CONNECTION,
    C4GLTE2VOICENA_CONFIGURE_FOR_EXAMPLE,
    C4GLTE2VOICENA_EXAMPLE

} c4glte2voicena_example_state_t;

static c4glte2voicena_t c4glte2voicena;
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 c4glte2voicena_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 c4glte2voicena_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 c4glte2voicena_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 c4glte2voicena_error_check( err_t error_flag );

/**
 * @brief Logs application buffer.
 * @details This function logs data from application buffer.
 */
static void c4glte2voicena_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 c4glte2voicena_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 c4glte2voicena_cfg_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 c4glte2voicena_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 c4glte2voicena_cfg_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 c4glte2voicena_example( void );

void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    c4glte2voicena_cfg_t c4glte2voicena_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.
    c4glte2voicena_cfg_setup( &c4glte2voicena_cfg );
    C4GLTE2VOICENA_MAP_MIKROBUS( c4glte2voicena_cfg, MIKROBUS_1 );
    if ( UART_ERROR == c4glte2voicena_init( &c4glte2voicena, &c4glte2voicena_cfg ) )
    {
        log_error( &logger, " Application Init Error. " );
        log_info( &logger, " Please, run program again... " );
        for ( ; ; );
    }
    c4glte2voicena_set_power_state ( &c4glte2voicena, C4GLTE2VOICENA_POWER_STATE_OFF );
    c4glte2voicena_set_power_state ( &c4glte2voicena, C4GLTE2VOICENA_POWER_STATE_ON );
    c4glte2voicena_process( );
    c4glte2voicena_clear_app_buf( );
    app_buf_len = 0;
    app_buf_cnt = 0;

    // Check communication
    c4glte2voicena_send_cmd( &c4glte2voicena, C4GLTE2VOICENA_CMD_AT );
    error_flag = c4glte2voicena_rsp_check( );
    c4glte2voicena_error_check( error_flag );

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

void application_task ( void )
{
    switch ( example_state )
    {
        case C4GLTE2VOICENA_CONFIGURE_FOR_NETWORK:
        {
            if ( C4GLTE2VOICENA_OK == c4glte2voicena_cfg_for_network( ) )
            {
                example_state = C4GLTE2VOICENA_WAIT_FOR_CONNECTION;
            }
            break;
        }
        case C4GLTE2VOICENA_WAIT_FOR_CONNECTION:
        {
            if ( C4GLTE2VOICENA_OK == c4glte2voicena_check_connection( ) )
            {
                example_state = C4GLTE2VOICENA_CONFIGURE_FOR_EXAMPLE;
            }
            break;
        }
        case C4GLTE2VOICENA_CONFIGURE_FOR_EXAMPLE:
        {
            if ( C4GLTE2VOICENA_OK == c4glte2voicena_cfg_for_example( ) )
            {
                example_state = C4GLTE2VOICENA_EXAMPLE;
            }
            break;
        }
        case C4GLTE2VOICENA_EXAMPLE:
        {
            c4glte2voicena_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 c4glte2voicena_clear_app_buf ( void )
{
    memset( app_buf, 0, app_buf_len );
    app_buf_len = 0;
    app_buf_cnt = 0;
}

static err_t c4glte2voicena_process ( void )
{
    int32_t rx_size;
    char rx_buff[ PROCESS_BUFFER_SIZE ] = { 0 };
    rx_size = c4glte2voicena_generic_read( &c4glte2voicena, rx_buff, PROCESS_BUFFER_SIZE );
    if ( rx_size > 0 )
    {
        int32_t buf_cnt = 0;
        if ( ( app_buf_len + rx_size ) > PROCESS_BUFFER_SIZE )
        {
            c4glte2voicena_clear_app_buf(  );
            return C4GLTE2VOICENA_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 C4GLTE2VOICENA_OK;
    }
    return C4GLTE2VOICENA_ERROR;
}

static err_t c4glte2voicena_rsp_check ( void )
{
    uint32_t timeout_cnt = 0;
    uint32_t timeout = 120000;
    err_t error_flag = c4glte2voicena_process( );
    if ( ( C4GLTE2VOICENA_OK != error_flag ) && ( C4GLTE2VOICENA_ERROR != error_flag ) )
    {
        return error_flag;
    }
    while ( ( 0 == strstr( app_buf, C4GLTE2VOICENA_RSP_OK ) ) &&
            ( 0 == strstr( app_buf, C4GLTE2VOICENA_RSP_ERROR ) ) )
    {
        error_flag = c4glte2voicena_process( );
        if ( ( C4GLTE2VOICENA_OK != error_flag ) && ( C4GLTE2VOICENA_ERROR != error_flag ) )
        {
            return error_flag;
        }
        if ( timeout_cnt++ > timeout )
        {
            c4glte2voicena_clear_app_buf( );
            return C4GLTE2VOICENA_ERROR_TIMEOUT;
        }
        Delay_ms ( 1 );
    }
    if ( strstr( app_buf, C4GLTE2VOICENA_RSP_OK ) )
    {
        return C4GLTE2VOICENA_OK;
    }
    else if ( strstr( app_buf, C4GLTE2VOICENA_RSP_ERROR ) )
    {
        return C4GLTE2VOICENA_ERROR_CMD;
    }
    else
    {
        return C4GLTE2VOICENA_ERROR_UNKNOWN;
    }
}

static void c4glte2voicena_error_check( err_t error_flag )
{
    switch ( error_flag )
    {
        case C4GLTE2VOICENA_OK:
        {
            c4glte2voicena_log_app_buf( );
            break;
        }
        case C4GLTE2VOICENA_ERROR:
        {
            log_error( &logger, " Overflow!" );
            break;
        }
        case C4GLTE2VOICENA_ERROR_TIMEOUT:
        {
            log_error( &logger, " Timeout!" );
            break;
        }
        case C4GLTE2VOICENA_ERROR_CMD:
        {
            log_error( &logger, " CMD!" );
            break;
        }
        case C4GLTE2VOICENA_ERROR_UNKNOWN:
        default:
        {
            log_error( &logger, " Unknown!" );
            break;
        }
    }
    c4glte2voicena_clear_app_buf(  );
    Delay_ms ( 500 );
}

static void c4glte2voicena_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 c4glte2voicena_cfg_for_network( void )
{
    err_t func_error = C4GLTE2VOICENA_OK;
    // Deregister from network
    #define DEREGISTER_FROM_NETWORK "2"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_COPS, DEREGISTER_FROM_NETWORK );
    error_flag = c4glte2voicena_rsp_check();
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );
    
    // Set SIM APN
    c4glte2voicena_set_sim_apn( &c4glte2voicena, SIM_APN );
    error_flag = c4glte2voicena_rsp_check();
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );

    // Enable full functionality
    #define FULL_FUNCTIONALITY "1"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_CFUN, FULL_FUNCTIONALITY );
    error_flag = c4glte2voicena_rsp_check();
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );

    // Automatic registration
    #define AUTOMATIC_REGISTRATION "0"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_COPS, AUTOMATIC_REGISTRATION );
    error_flag = c4glte2voicena_rsp_check();
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );

    // Enable network registartion
    #define ENABLE_REG "2"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_CREG, ENABLE_REG );
    error_flag = c4glte2voicena_rsp_check();
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );
    return func_error;
}

static err_t c4glte2voicena_check_connection( void )
{
    #define CONNECTED "+CREG: 1"
    c4glte2voicena_process( );
    if ( strstr( app_buf, CONNECTED ) )
    {
        Delay_ms ( 100 );
        c4glte2voicena_process( );
        c4glte2voicena_log_app_buf( );
        log_printf( &logger, "\r\n" );
        c4glte2voicena_clear_app_buf( );
        // Check signal quality
        c4glte2voicena_send_cmd( &c4glte2voicena, C4GLTE2VOICENA_CMD_CSQ );
        error_flag = c4glte2voicena_rsp_check( );
        c4glte2voicena_error_check( error_flag );
        return error_flag;
    }
    return C4GLTE2VOICENA_ERROR;
}

static err_t c4glte2voicena_cfg_for_example( void )
{
    err_t func_error = C4GLTE2VOICENA_OK;
#if ( DEMO_EXAMPLE == EXAMPLE_TCP_UDP )
    #define ACTIVATE_PDP_CONTEXT "1,1"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_CGACT, ACTIVATE_PDP_CONTEXT );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );
#elif ( DEMO_EXAMPLE == EXAMPLE_SMS )
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_CMGF, SMS_MODE );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );
#else
    #error "No demo example selected"
#endif
    return func_error;
}

static err_t c4glte2voicena_example( void )
{
    err_t func_error = C4GLTE2VOICENA_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"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOCR, TCP_PROTOCOL );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    socket_num_buf = strstr( app_buf, RSP_USOCR ) + strlen ( RSP_USOCR );
    tcp_socket_num[ 0 ] = *socket_num_buf;
    c4glte2voicena_error_check( error_flag );

    // Create UDP socket
    #define UDP_PROTOCOL "17"
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOCR, UDP_PROTOCOL );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    socket_num_buf = strstr( app_buf, RSP_USOCR ) + strlen ( RSP_USOCR );
    udp_socket_num[ 0 ] = *socket_num_buf;
    c4glte2voicena_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 );
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOCO, cmd_buf );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_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 );
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOCO, cmd_buf );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_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, "\"" );
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOWR, cmd_buf );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_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 ( ; ; )
    {
        c4glte2voicena_process( );
        uint8_t * __generic_ptr start_response_buf = strstr( app_buf, urc_buf );
        if ( start_response_buf )
        {
            Delay_ms ( 100 );
            c4glte2voicena_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 );
            c4glte2voicena_log_app_buf( );
            c4glte2voicena_clear_app_buf( );
            c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USORD, cmd_buf );
            error_flag = c4glte2voicena_rsp_check( );
            func_error |= error_flag;
            c4glte2voicena_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, "\"" );
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOWR, cmd_buf );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_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 ( ; ; )
    {
        c4glte2voicena_process( );
        uint8_t * __generic_ptr start_response_buf = strstr( app_buf, urc_buf );
        if ( start_response_buf )
        {
            Delay_ms ( 100 );
            c4glte2voicena_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 );
            c4glte2voicena_log_app_buf( );
            c4glte2voicena_clear_app_buf( );
            c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USORD, cmd_buf );
            error_flag = c4glte2voicena_rsp_check( );
            func_error |= error_flag;
            c4glte2voicena_error_check( error_flag );
            break;
        }
        if ( timeout_cnt++ > timeout )
        {
            break;
        }
        Delay_ms ( 1 );
    }
    
    // Close TCP socket
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOCL, tcp_socket_num );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_error_check( error_flag );
    
    // Close UDP socket
    c4glte2voicena_send_cmd_par( &c4glte2voicena, C4GLTE2VOICENA_CMD_USOCL, udp_socket_num );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    c4glte2voicena_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"
    c4glte2voicena_send_cmd_check( &c4glte2voicena, C4GLTE2VOICENA_CMD_CMGF );
    error_flag = c4glte2voicena_rsp_check( );
    func_error |= error_flag;
    if ( strstr( app_buf, CMGF_PDU ) )
    {
        c4glte2voicena_error_check( error_flag );
        // Send SMS in PDU mode
        c4glte2voicena_send_sms_pdu( &c4glte2voicena, SIM_SMSC, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag = c4glte2voicena_rsp_check( );
        func_error |= error_flag;
    }
    else if ( strstr( app_buf, CMGF_TXT ) )
    {
        c4glte2voicena_error_check( error_flag );
        // Send SMS in TXT mode
        c4glte2voicena_send_sms_text ( &c4glte2voicena, PHONE_NUMBER_TO_MESSAGE, MESSAGE_CONTENT );
        error_flag = c4glte2voicena_rsp_check( );
        func_error |= error_flag;
    }
    c4glte2voicena_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

额外支持

资源

喜欢这个项目吗?

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