کار با QuecOpen در ماژول EC200U

۱۴۰۱-۰۳-۱۵

6 دقیقه

قبلا در مطلب “معرفی قابلیت QuecOpen در ماژول های کویکتل” در مورد QuecOpen صحبت کردیم و اشاره کردیم که به کمک این قابلیت میتونیم کدنویسی خودمون رو روی ماژول انجام بدیم و نیازی به کنترلر خارجی نداشته باشیم ، حالا در این آموزش میخوایم نحوه اجرای یک Hello World رو روی EC200U بررسی کنیم ،پس با سیسوگ همراه باشید.

برای کدنویسی این ماژول ما IDE خاصی نداریم ، تنها چیزی که داریم یه SDK هست که البته غیر از اون هم به چیز دیگه ای نیاز نداریم ، شما میتونید برای ادیت کد ها از هر ادیتوری که میخواید استفاده کنید.

کامندهایی که برای بیلد کردن پروژه موجود هستند هم ، قابل اجرا توی ویندوز و لینوکس هستند ، ما برای نوشتن این مطلب از ویندوز استفاده میکنیم.

اول از همه باید پوشه sdk رو اکسترکت کنیم ، تصویر زیر ساختار این پوشه رو نشون میده

QuecOpen csdk

وارد پوشه sdk میشیم و برای اطمینان از درست بودن فایل هامون ، قبل از اینکه تغییری در اونها بدیم یکبار پروژمون رو build میکنیم. برای اینکار از PowerShell استفاده میکنیم و دستور زیر رو اجرا میکنیم

.\build_all.bat new EC200UEU_AA appimage

1	.\build_all.bat new EC200UEU_AA appimage

در صورت موفقیت آمیز بودن با این پیغام مواجه میشیم

...
.\hex\flash_test_fdl.elf
.\hex\flash_test_fdl.img
.\hex\flash_test_fdl.map
.\hex\partinfo.bin
30 File(s) copied
        1 file(s) moved.
        1 file(s) moved.
D:\LTE01R02A05_C_SDK_U\target\EC200UEU_AA_APPIMAGE\prepack\8915DM_cat1_open-cat1_UIS8915DM_BB_RF_SS_NoVolte_cus-release.pac
        1 file(s) moved.
.\target.cmake
1 File(s) copied
.\hex\examples\APPIMAGE_APP.elf
.\hex\examples\APPIMAGE_APP.img
.\hex\examples\APPIMAGE_APP.map
.\hex\examples\APPIMAGE_APP.pac
.\hex\examples\APPIMAGE_APP.sign.img
.\hex\examples\APPIMAGE_APP_prepack.cpio
6 File(s) copied

        1 file(s) moved.
        1 file(s) moved.
        1 file(s) moved.

Sat 05/28/2022
START TIME:  17:09:41.39
END TIME:    17:11:20.16

PS D:\LTE01R02A05_C_SDK_U>

...

.\hex\flash_test_fdl.elf

.\hex\flash_test_fdl.img

.\hex\flash_test_fdl.map

.\hex\partinfo.bin

30 File(s) copied

1 file(s) moved.

D:\LTE01R02A05_C_SDK_U\target\EC200UEU_AA_APPIMAGE\prepack\8915DM_cat1_open-cat1_UIS8915DM_BB_RF_SS_NoVolte_cus-release.pac

1 file(s) moved.

.\target.cmake

1 File(s) copied

.\hex\examples\APPIMAGE_APP.elf

.\hex\examples\APPIMAGE_APP.img

.\hex\examples\APPIMAGE_APP.map

.\hex\examples\APPIMAGE_APP.pac

.\hex\examples\APPIMAGE_APP.sign.img

.\hex\examples\APPIMAGE_APP_prepack.cpio

6 File(s) copied

1 file(s) moved.

Sat 05/28/2022

START TIME: 17:09:41.39

END TIME: 17:11:20.16

PS D:\LTE01R02A05_C_SDK_U>

خب حالا میریم سراغ نوشتن کد خودمون…

اول از همه باید بگم که sdk به صورت دیفالت شامل app های کوچیک هست که هر کدومشون یه کاری رو انجام میدند و هر کدوم هم توی یک thread جدا اجرا میشند ، نقطه شروع پردازنده هم برای پردازش کد ها فایل ql_init.c توی مسیر components\ql-application\init هست که تابع appimg_enter در اون صدا زده میشه.

int appimg_enter(void *param)
{
	QlOSStatus err = QL_OSI_SUCCESS;
	ql_task_t ql_init_task = NULL;
	
    QL_INIT_LOG("init demo enter: %s @ %s", QL_APP_VERSION, QL_APP_BUILD_RELEASE_TYPE);
    prvInvokeGlobalCtors();
    if(0 == strcasecmp(QL_APP_BUILD_RELEASE_TYPE, "release"))
    {
    	ql_dev_cfg_wdt(1);
        //open the kernel log
    	//ql_quec_trace_enable(1);
    }
    else
    {
    	ql_dev_cfg_wdt(0);
        //close the kernel log
    	//ql_quec_trace_enable(0);
    }

    /*Caution: GPIO pin must be initialized here, otherwise the pin status cannot be determined*/
    ql_pin_cfg_init();
	
    err = ql_rtos_task_create(&ql_init_task, 1024*4, APP_PRIORITY_NORMAL, "ql_init", ql_init_demo_thread, NULL, 1);
	if(err != QL_OSI_SUCCESS)
    {
		QL_INIT_LOG("init failed");
	}
    
    return err;
}

int appimg_enter(void *param)

{

QlOSStatus err = QL_OSI_SUCCESS;

ql_task_t ql_init_task = NULL;

QL_INIT_LOG("init demo enter: %s @ %s", QL_APP_VERSION, QL_APP_BUILD_RELEASE_TYPE);

prvInvokeGlobalCtors();

if(0 == strcasecmp(QL_APP_BUILD_RELEASE_TYPE, "release"))

{

ql_dev_cfg_wdt(1);

//open the kernel log

//ql_quec_trace_enable(1);

}

else

{

ql_dev_cfg_wdt(0);

//close the kernel log

//ql_quec_trace_enable(0);

}

/*Caution: GPIO pin must be initialized here, otherwise the pin status cannot be determined*/

ql_pin_cfg_init();

err = ql_rtos_task_create(&ql_init_task, 1024*4, APP_PRIORITY_NORMAL, "ql_init", ql_init_demo_thread, NULL, 1);

if(err != QL_OSI_SUCCESS)

{

QL_INIT_LOG("init failed");

}

return err;

}

همونطور که توی خط 24 کد بالا میبینید ، یک thread جدید ایجاد شده که بدنه تابع اون به این صورت هست :

static void ql_init_demo_thread(void *param)
{
    QL_INIT_LOG("init demo thread enter, param 0x%x", param);

/*Caution:If the macro of secure boot and the function are opened, download firmware and restart will enable secure boot.
          the secret key cannot be changed forever*/    
#ifdef QL_APP_FEATURE_SECURE_BOOT
    //ql_dev_enable_secure_boot();
#endif

#if 0
    ql_gpio_app_init();
    ql_gpioint_app_init();
#endif

#ifdef QL_APP_FEATURE_LEDCFG
    ql_ledcfg_app_init();
#endif

#ifdef QL_APP_FEATURE_AUDIO
    //ql_audio_app_init();
#ifdef QL_APP_FEATURE_HEADSET_DET
    //ql_headset_det_app_init();
#endif
#endif

...

static void ql_init_demo_thread(void *param)

{

QL_INIT_LOG("init demo thread enter, param 0x%x", param);

/*Caution:If the macro of secure boot and the function are opened, download firmware and restart will enable secure boot.

the secret key cannot be changed forever*/

#ifdef QL_APP_FEATURE_SECURE_BOOT

//ql_dev_enable_secure_boot();

#endif

#if 0

ql_gpio_app_init();

ql_gpioint_app_init();

#endif

#ifdef QL_APP_FEATURE_LEDCFG

ql_ledcfg_app_init();

#endif

#ifdef QL_APP_FEATURE_AUDIO

//ql_audio_app_init();

#ifdef QL_APP_FEATURE_HEADSET_DET

//ql_headset_det_app_init();

#endif

...

در اینجا هر زیر اپلیکیشنی که بخوایم استفاده کنیم میتونیم فعالش کنیم ، ما برای تست Hello World خودمون ، تابع ql_uart_app_init رو از کامنت در میاریم.

#ifdef QL_APP_FEATURE_UART
    ql_uart_app_init();
#endif

#ifdef QL_APP_FEATURE_UART

ql_uart_app_init();

#endif

حالا به سراغ فایل uart_demo.c در مسیر components\ql-application\peripheral میریم . نقطه شروع ما توی این فایل همون تابع ql_uart_app_init هست که در اون یک thread ایجاد کرده که تابع ql_uart_demo_thread در اون اجرا میشه

ql_rtos_task_create(&uart_task, QL_UART_TASK_STACK_SIZE, QL_UART_TASK_PRIO, "QUARTDEMO", ql_uart_demo_thread, NULL, QL_UART_TASK_EVENT_CNT);

1	ql_rtos_task_create(&uart_task, QL_UART_TASK_STACK_SIZE, QL_UART_TASK_PRIO, "QUARTDEMO", ql_uart_demo_thread, NULL, QL_UART_TASK_EVENT_CNT);

در ادامه میتونید پارامتر های این تابع رو بررسی کنید

quecOpen rtos task create

دستورات دیگر RTOS و نحوه پیاده سازی اونها در فایل Quectel_EC200U_Series_QuecOpen_RTOS_Development_Guide_V1.0 به طور کامل توضیح داده شده.

خب ، حالا به تابع ql_uart_demo_thread میریم

static void ql_uart_demo_thread(void *param)
{
    int ret = 0;
	QlOSStatus err = 0;
    ql_uart_config_s uart_cfg = {0};
    int write_len = 0;
    ql_uart_tx_status_e tx_status;
    unsigned char data[] = "hello uart demo\r\n";

    /***********************************************************
	Note start:
        1.If the BAUD rate is QL UART BAUD_AUTO,a string of 'at'should be sent at least once to identify the baud rate.
        2.Once the baud rate is identified, it cannot be changed unless restarted.
    ************************************************************/
    uart_cfg.baudrate = QL_UART_BAUD_115200;
    uart_cfg.flow_ctrl = QL_FC_NONE;
    uart_cfg.data_bit = QL_UART_DATABIT_8;
    uart_cfg.stop_bit = QL_UART_STOP_1;
    uart_cfg.parity_bit = QL_UART_PARITY_NONE;

    ret = ql_uart_set_dcbconfig(QL_UART_PORT_2, &uart_cfg);
    QL_UART_DEMO_LOG("ret: 0x%x", ret);
	if(QL_UART_SUCCESS != ret)
	{
		goto exit;
	}
	
	/***********************************************************
	Note start:
		1. If QL_UART_PORT_1 is selected for use, there is no need to set TX and RX pin and function
		2. According to the QuecOpen GPIO table, user should select the correct PIN to set function
		3. CTS and RTS pins (UART2 and UART3) also need to be initialized if hardware flow control function is required
	************************************************************/
	ret = ql_pin_set_func(QL_UART2_TX_PIN, QL_UART2_TX_FUNC);
	if(QL_GPIO_SUCCESS != ret)
	{
		goto exit;
	}
	ret = ql_pin_set_func(QL_UART2_RX_PIN, QL_UART2_RX_FUNC);
	if(QL_GPIO_SUCCESS != ret)
	{
		goto exit;
	}
	/*Note end*/
	
    ret = ql_uart_open(QL_UART_PORT_2);
    QL_UART_DEMO_LOG("ret: 0x%x", ret);

	if(QL_UART_SUCCESS == ret)
	{
	    ret = ql_uart_register_cb(QL_UART_PORT_2, ql_uart_notify_cb);
	    QL_UART_DEMO_LOG("ret: 0x%x", ret);

	    memset(&uart_cfg, 0, sizeof(ql_uart_config_s));
	    ret = ql_uart_get_dcbconfig(QL_UART_PORT_2, &uart_cfg);
	    QL_UART_DEMO_LOG("ret: 0x%x, baudrate=%d, flow_ctrl=%d, data_bit=%d, stop_bit=%d, parity_bit=%d", 
	                        ret, uart_cfg.baudrate, uart_cfg.flow_ctrl, uart_cfg.data_bit, uart_cfg.stop_bit, uart_cfg.parity_bit);
	    
	    while(1)
	    {
	        write_len = ql_uart_write(QL_UART_PORT_2, data, strlen((char *)data));
	        QL_UART_DEMO_LOG("write_len:%d", write_len);
            ql_uart_get_tx_fifo_status(QL_UART_PORT_2, &tx_status);
            QL_UART_DEMO_LOG("tx_status:%d", tx_status);
	        ql_rtos_task_sleep_ms(20000);
	    }
	}

exit:
    err = ql_rtos_task_delete(NULL);
	if(err != QL_OSI_SUCCESS)
	{
		QL_UART_DEMO_LOG("task deleted failed");
	}
}

static void ql_uart_demo_thread(void *param)

{

int ret = 0;

QlOSStatus err = 0;

ql_uart_config_s uart_cfg = {0};

int write_len = 0;

ql_uart_tx_status_e tx_status;

unsigned char data[] = "hello uart demo\r\n";

/***********************************************************

Note start:

1.If the BAUD rate is QL UART BAUD_AUTO,a string of 'at'should be sent at least once to identify the baud rate.

2.Once the baud rate is identified, it cannot be changed unless restarted.

************************************************************/

uart_cfg.baudrate = QL_UART_BAUD_115200;

uart_cfg.flow_ctrl = QL_FC_NONE;

uart_cfg.data_bit = QL_UART_DATABIT_8;

uart_cfg.stop_bit = QL_UART_STOP_1;

uart_cfg.parity_bit = QL_UART_PARITY_NONE;

ret = ql_uart_set_dcbconfig(QL_UART_PORT_2, &uart_cfg);

QL_UART_DEMO_LOG("ret: 0x%x", ret);

if(QL_UART_SUCCESS != ret)

{

goto exit;

}

/***********************************************************

Note start:

1. If QL_UART_PORT_1 is selected for use, there is no need to set TX and RX pin and function

2. According to the QuecOpen GPIO table, user should select the correct PIN to set function

3. CTS and RTS pins (UART2 and UART3) also need to be initialized if hardware flow control function is required

************************************************************/

ret = ql_pin_set_func(QL_UART2_TX_PIN, QL_UART2_TX_FUNC);

if(QL_GPIO_SUCCESS != ret)

{

goto exit;

}

ret = ql_pin_set_func(QL_UART2_RX_PIN, QL_UART2_RX_FUNC);

if(QL_GPIO_SUCCESS != ret)

{

goto exit;

}

/*Note end*/

ret = ql_uart_open(QL_UART_PORT_2);

QL_UART_DEMO_LOG("ret: 0x%x", ret);

if(QL_UART_SUCCESS == ret)

{

ret = ql_uart_register_cb(QL_UART_PORT_2, ql_uart_notify_cb);

QL_UART_DEMO_LOG("ret: 0x%x", ret);

memset(&uart_cfg, 0, sizeof(ql_uart_config_s));

ret = ql_uart_get_dcbconfig(QL_UART_PORT_2, &uart_cfg);

QL_UART_DEMO_LOG("ret: 0x%x, baudrate=%d, flow_ctrl=%d, data_bit=%d, stop_bit=%d, parity_bit=%d",

ret, uart_cfg.baudrate, uart_cfg.flow_ctrl, uart_cfg.data_bit, uart_cfg.stop_bit, uart_cfg.parity_bit);

while(1)

{

write_len = ql_uart_write(QL_UART_PORT_2, data, strlen((char *)data));

QL_UART_DEMO_LOG("write_len:%d", write_len);

ql_uart_get_tx_fifo_status(QL_UART_PORT_2, &tx_status);

QL_UART_DEMO_LOG("tx_status:%d", tx_status);

ql_rtos_task_sleep_ms(20000);

}

exit:

err = ql_rtos_task_delete(NULL);

if(err != QL_OSI_SUCCESS)

{

QL_UART_DEMO_LOG("task deleted failed");

}

همونطور که مشخصه ، توی خط 15 تا 21 تنطیمات UART (مثل BAUD RATE , DATA BIT , …) رو مشخص کرده ، بعد از اون توی خط 34 و 39 کد بالا ، پین های مربوطه رو برای rx و tx مشخص کرده و عملکرد اونها رو برای uart مشخص کرده ؛ الان میخوایم ببینیم که این دو پین QL_UART2_TX_PIN و QL_UART2_RX_PIN از روی سخت افزار کدوم پایه ها میشند ، توی فایل components\ql-application\peripheral\inc\ql_pin_cfg.h این دو پایه به این صورت تعریف شدند:

//for uart demo
#define QL_UART2_TX_PIN                     QUEC_PIN_UART2_TXD
#define QL_UART2_RX_PIN                     QUEC_PIN_UART2_RXD

//for uart demo

#define QL_UART2_TX_PIN QUEC_PIN_UART2_TXD

#define QL_UART2_RX_PIN QUEC_PIN_UART2_RXD

و بعد از اون توی فایل components\ql-kernel\inc\quec_pin_index.h دوباره به این صورت تعریف شدند:

#define QUEC_PIN_DNAME_SDMMC1_CLK        32
#define QUEC_PIN_DNAME_KEYOUT_4          81
#define QUEC_PIN_DNAME_KEYOUT_5          82
#define QUEC_PIN_DNAME_KEYIN_4           137
#define QUEC_PIN_DNAME_KEYIN_5           138

/*************** Pin ****************/
#define QUEC_PIN_UART2_RXD         QUEC_PIN_DNAME_KEYIN_4
#define QUEC_PIN_UART2_TXD         QUEC_PIN_DNAME_KEYIN_5

#define QUEC_PIN_UART3_RXD         QUEC_PIN_DNAME_KEYOUT_4
#define QUEC_PIN_UART3_TXD         QUEC_PIN_DNAME_KEYOUT_5
/***********    EC200U End    ***********/

#define QUEC_PIN_DNAME_SDMMC1_CLK 32

#define QUEC_PIN_DNAME_KEYOUT_4 81

#define QUEC_PIN_DNAME_KEYOUT_5 82

#define QUEC_PIN_DNAME_KEYIN_4 137

#define QUEC_PIN_DNAME_KEYIN_5 138

/*************** Pin ****************/

#define QUEC_PIN_UART2_RXD QUEC_PIN_DNAME_KEYIN_4

#define QUEC_PIN_UART2_TXD QUEC_PIN_DNAME_KEYIN_5

#define QUEC_PIN_UART3_RXD QUEC_PIN_DNAME_KEYOUT_4

#define QUEC_PIN_UART3_TXD QUEC_PIN_DNAME_KEYOUT_5

/*********** EC200U End ***********/

و در نهایت پایه های 137 و 138 میشند.

quecOpen pinmux uart ec200u

البته این پایه ها روی بردی که در فروشگاه سیسوگ موجود هست به راحتی قابل دسترسیه

quecOpen pinmux uart ec200u board

شاید به نظر کمی بیهوده بیاد که چندمرحله مختلف برای مشخص کردن یک پین تعریف شده ، اما اینطور نیست ! اگر شما هم از همین استاندارد برای کدنویسی پیروی کنید میتونید بدون تغییر ، کدی که برای مثلا ماژول ec200u نوشتید رو روی eg915u هم استفاده کنید.

به سراغ کد بر میگردیم و توی خط 8 ، متنی که میخوایم چاپ کنیم رو تغییر میدیم

unsigned char data[] = "Hello World\r\n";

1	unsigned char data[] = "Hello World\r\n";

زمان توقف رو هم از 20 ثانیه به 1 ثانیه کاهش میدیم (خط 65)

ql_rtos_task_sleep_ms(1000);

1	ql_rtos_task_sleep_ms(1000);

با دستور زیر کدمون رو کامپایل میکنیم

.\build_all.bat r EC200UEU_AA appimage

1	.\build_all.bat r EC200UEU_AA appimage

خروجی ما توی پوشه target\EC200UEU_AA_APPIMAGE قرار میگیره

quecOpen image

برای پروگرام نیازه که اول دستور AT+QDOWNLOAD رو برای ماژول ارسال کنیم ، بعد از اون ماژول ریست میشه و یه پورت جدید با نام Diag شناخته میشه

کار با QuecOpen در ماژول EC200U

حالا از نرم افزار QFlash نسخه 5.7 استفاده کرده و فایل 8915DM_cat1_open_APPIMAGE_merge.pac رو انتخاب میکنیم و ماژول رو پروگرام میکنیم.

quecopen qflash

با وصل کردن یک مبدل سریال به پایه های AUX_RXD و AUX_TXD ماژول میتونیم خروجی رو بررسی کنیم.

quecOpen ec200u helloworld

برای کسب اطلاعات بیشتر و دریافت اطلاعات مورد نیاز و SDK برای کار با QuecOpen این فرم زیر را تکمیل کرده تا با شما تماس گرفته شود.

اطلاعات

لینک و اشتراک

کار با QuecOpen در ماژول EC200U

Mahdi.h

پالت | بازار خرید و فروش قطعات الکترونیک

آیسی | موتور جستجوی قطعات الکترونیک

فروشگاه سیسوگ

سیسوگ فروم | محلی برای پاسخ پرسش‌های شما

نویسنده شو !

نویسنده شو !

پالت | بازار خرید و فروش قطعات الکترونیک

آیسی | موتور جستجوی قطعات الکترونیک

فروشگاه سیسوگ

سیسوگ فروم | محلی برای پاسخ پرسش‌های شما

دیدگاه ها

سینا گفت :

Mahdi.h گفت :

سینا گفت :

Mahdi.h گفت :

امیر گفت :

Mahdi.h گفت :

zahra گفت :

SABA ABIRI گفت :

Mahdi.h گفت :

zahra گفت :

مهدی صالحی زاده گفت :

Mahdi.h گفت :

مهدی صالحی زاده گفت :

Sisoog Os گفت :

سیدمحمد مهدی صالحی زاده گفت :

نویسنده شو !

نویسنده شو !

آموزش ها

منو و لینک‌ها

کار با QuecOpen در ماژول EC200U

شاید برای شما مفید باشد

تولد ستاره ای نوظهور در...

راه اندازی GSM Modem با...

رونمایی از ماژول های جدید...

Mahdi.h

پالت | بازار خرید و فروش قطعات الکترونیک

آیسی | موتور جستجوی قطعات الکترونیک

فروشگاه سیسوگ

سیسوگ فروم | محلی برای پاسخ پرسش‌های شما

نویسنده شو !

نویسنده شو !

پالت | بازار خرید و فروش قطعات الکترونیک

آیسی | موتور جستجوی قطعات الکترونیک

فروشگاه سیسوگ

سیسوگ فروم | محلی برای پاسخ پرسش‌های شما

دیدگاه ها

سینا گفت :

Mahdi.h گفت :

سینا گفت :

Mahdi.h گفت :

امیر گفت :

Mahdi.h گفت :

zahra گفت :

SABA ABIRI گفت :

Mahdi.h گفت :

zahra گفت :

مهدی صالحی زاده گفت :

Mahdi.h گفت :

مهدی صالحی زاده گفت :

Sisoog Os گفت :

سیدمحمد مهدی صالحی زاده گفت :

نویسنده شو !

نویسنده شو !

آموزش ها

منو و لینک‌ها

شبکه‌های اجتماعی