鸿蒙 LiteOS｜NBV2.1 开发板二维码实验踩坑全记录

silence909

153人浏览 · 2026-09-17 09:12:16

silence909 · 2026-09-17 09:12:16 发布

📝前言

基于NBV2.1 物联网主板 + 鸿蒙 LiteOS完成二维码实验。一开始我以为这套代码可以直接识别纸质二维码，实际跑通之后才发现：原有工程只实现了字符串编码，LCD 屏幕绘制输出二维码，摄像头解码识别外部二维码只是预留框架，并没有实现。

本文完整记录整个实验：整体架构、核心代码、现象结果、实际踩坑问题、问题排查思路与创新拓展，适合刚接触 LiteOS 多任务嵌入式开发的同学参考。

⚠️开发环境：硬件：NBV2.1 鸿蒙物联网开发板 OS：HarmonyOS‑LiteOS‑M 屏幕：SPI‑TFT 240*320 外设：DVP 摄像头接口、4 路按键、LED、BC35G NB‑IoT 模组

🏗整体系统架构

本实验采用 LiteOS 多任务设计，两个业务任务分工明确：

表格

任务	优先级	职责
control_task	0（高）	硬件主控、LED 状态指示、串口、NB‑IoT 模组业务，预留摄像头解码业务
view_task	1（低）	LCD 屏幕绘图、按键扫描、二维码编码绘制输出

💡重要概念区分（很多同学这里搞混）

编码：QR_CODE_Display()：输入字符串 → LCD 屏幕画出二维码，供手机扫码读取（本实验已实现）
解码：摄像头采集图像 → 算法解析纸质二维码得到文本（本工程只有框架，需要自己新增代码）

main函数只做硬件初始化、内核初始化、创建任务；LOS_Start()启动调度之后 main 死循环，所有业务逻辑全部交给任务执行，和裸机开发思维有很大区别。

🧩硬件简要原理

主控 STM32 运行 LiteOS 操作系统，负责任务调度、图像处理；
SPI‑TFT 屏幕通过 PE9~PE14 引脚与 MCU 相连，完成二维码图形渲染；
4 路 GPIO 按键，上拉输入模式，软件消抖；
LED1 作为系统运行指示灯，1s 闪烁一次判断任务是否正常调度；
DVP 摄像头接口预留，用于后续拓展二维码解码识别；
BC35G NB‑IoT 模组，可拓展将扫码数据上传云端。

💻核心代码片段

main.c 入口函数

int main(void)
{
    UINT32 uwRet = LOS_OK;
    HAL_Init();                    //硬件底层初始化
    sysclkinit();                  //系统时钟配置
    task_view_init();              //显示模块初始化
    task_control_init();           //控制模块初始化

    printf("\r\n        二维码识别实验        \r\n");
    printf("----------------------------------\r\n");
    printf("开始本实验：\r\n\r\n");

    uwRet = LOS_KernelInit();      //LiteOS内核初始化
    if (uwRet != LOS_OK)
    {
        return LOS_NOK;
    }
    uwRet = creat_view_task();     //创建显示任务
    uwRet = creat_control_task(); //创建控制任务

    LOS_Start();	//开启操作系统任务调度
    while (1)
    {
    }
}

main 函数不执行业务，只做初始化与任务创建。

view_task.c 核心‑二维码绘制函数

void QR_CODE_Display(uint8_t  *qrcode_data)
{
	uint8_t  i,j;
	uint16_t  x,y,p;
	uint16_t  old_point_color = POINT_COLOR;
	uint16_t  old_back_color = BACK_COLOR;
	BACK_COLOR = WHITE;
	POINT_COLOR = BLACK;
    #define   QR_CODE_SIZE     120
    #define   QR_CODE_X        45
    #define   QR_CODE_Y        65

	EncodeData((char *)qrcode_data); //字符串编码生成二维码矩阵
	if(m_nSymbleSize*2 > QR_CODE_SIZE)
	{
		return;
	}
	for(i=0;i<10;i++)
	{
		if((m_nSymbleSize*i*2) > QR_CODE_SIZE)	break;
	}
	p=(i-1)*3;
	x=QR_CODE_X;
	y=QR_CODE_Y;
	for(i=0;i<m_nSymbleSize;i++)
	{
		for(j=0;j<m_nSymbleSize;j++)
		{
			if(m_byModuleData[i][j]==0)
				LCD_Fill(x+p*i,y+p*j,x+p*(i+1)-1,y+p*(j+1)-1,WHITE);
			else
				LCD_Fill(x+p*i,y+p*j,x+p*(i+1)-1,y+p*(j+1)-1,BLACK);
		}
	}
	Gui_StrCenter(0, 240, BLACK, WHITE, "欢迎来到万物互联的智能世界", 16, 0);
	BACK_COLOR=old_back_color;
	POINT_COLOR=old_point_color;
}

逻辑：调用EncodeData()把字符串转为二维码矩阵，双重循环填充黑白方块，在屏幕指定位置渲染出二维码图案。

control_task.c 控制任务主循环

VOID control_task(VOID)
{
    UINT32 uwRet = LOS_OK;
    static uint32_t sys_time = 0;
    printf("** LED灯初始化\r\n");
    while(1)
    {
        ptl_Handle();
        if(HAL_GetTick() - sys_time > 1000)
        {
            sys_time = HAL_GetTick();
            led_toggle(LED1_PORT); //LED1每秒闪烁，判断任务存活
        }
        Get_Bc35g();
        ptl_Heartbeat_Handle();
        BC35G_Handle();
        uwRet = LOS_TaskDelay(10);
        if(uwRet != LOS_OK)
        {
            return;
        }
    }
}