【基于MCX N947】USB 一线通监控副屏

NXP管管

【基于MCX N947】USB 一线通监控副屏

环境搭建
环境变量配置
为了提高一些编译的速度，选择了在 Linux 系统下进行开发，在 Linux 上开发 N947 需要先安装 env 工具 https://github.com/RT-Thread/env ，按照说明文档进行安装即可，然后配置一些环境变量如下


其中 /opt/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-eabi/bin 是自己的编译工具链的路径，/home/book/rt-thread 是 rt-thread 根目录的路径

1. source ~/.env/env.sh
   
2. 
   
3. export RTT_CC=gcc
   
4. 
   
5. export RTT_ROOT=/home/book/rt-thread
   
6. 
   
7. export RTT_DIR=/home/book/rt-thread
   
8. 
   
9. export RTT_EXEC_PATH=/opt/arm-gnu-toolchain-13.2.Rel1-x86_64-arm-none-eabi/bin
   
10. 
    
11. export PATH=$PATH:$RTT_EXEC_PATH

复制代码

如果需要将 N947 的例程从 rt-thread 的根文件夹中独立出来的话，需要删除工程中 Kconfig 文件的这行代码

代码高亮
这里使用 VSCode 中的 Clang 插件，代码高亮和补全可以通过使用编译时候生成的 compile_commands.json 文件来实现，而 RT-Thread 的工程是采用的 scons 工具，所以可以使用 scons_compiledb 这个 python 包来生成 compile_commands.json 实现代码高亮，修改过的 SConstruct 文件如下

1. import os
   
2. 
   
3. import sys
   
4. 
   
5. import rtconfig
   
6. 
   
7. import scons_compiledb
   
8. 
   
9. if os.getenv('RTT_ROOT'):
   
10. 
    
11.     RTT_ROOT = os.getenv('RTT_ROOT')
    
12. 
    
13. else:
    
14. 
    
15.     RTT_ROOT = os.path.normpath(os.getcwd() + '/../../../../..')
    
16. 
    
17. sys.path = sys.path + [os.path.join(RTT_ROOT, 'tools')]
    
18. 
    
19. try:
    
20. 
    
21.     from building import *
    
22. 
    
23. except:
    
24. 
    
25.     print('Cannot found RT-Thread root directory, please check RTT_ROOT')
    
26. 
    
27.     print(RTT_ROOT)
    
28. 
    
29.     exit(-1)
    
30. 
    
31. TARGET = 'rtthread.' + rtconfig.TARGET_EXT
    
32. 
    
33. if rtconfig.PLATFORM == 'armcc':
    
34. 
    
35.     env = Environment(tools = ['mingw'],
    
36. 
    
37.         AS = rtconfig.AS, ASFLAGS = rtconfig.AFLAGS,
    
38. 
    
39.         CC = rtconfig.CC, CFLAGS = rtconfig.CFLAGS,
    
40. 
    
41.         CXX = rtconfig.CXX, CXXFLAGS = rtconfig.CXXFLAGS,
    
42. 
    
43.         AR = rtconfig.AR, ARFLAGS = '-rc',
    
44. 
    
45.         LINK = rtconfig.LINK, LINKFLAGS = rtconfig.LFLAGS,
    
46. 
    
47.         # overwrite cflags, because cflags has '--C99'
    
48. 
    
49.         CXXCOM = '$CXX -o $TARGET --cpp -c $CXXFLAGS $_CCCOMCOM $SOURCES')
    
50. 
    
51. else:
    
52. 
    
53.     env = Environment(tools = ['mingw'],
    
54. 
    
55.         AS = rtconfig.AS, ASFLAGS = rtconfig.AFLAGS,
    
56. 
    
57.         CC = rtconfig.CC, CFLAGS = rtconfig.CFLAGS,
    
58. 
    
59.         CXX = rtconfig.CXX, CXXFLAGS = rtconfig.CXXFLAGS,
    
60. 
    
61.         AR = rtconfig.AR, ARFLAGS = '-rc',
    
62. 
    
63.         LINK = rtconfig.LINK, LINKFLAGS = rtconfig.LFLAGS,
    
64. 
    
65.         CXXCOM = '$CXX -o $TARGET -c $CXXFLAGS $_CCCOMCOM $SOURCES')
    
66. 
    
67. env.PrependENVPath('PATH', rtconfig.EXEC_PATH)
    
68. 
    
69. scons_compiledb.enable(env)
    
70. 
    
71. env.CompileDb()
    
72. 
    
73. if rtconfig.PLATFORM in ['iccarm']:
    
74. 
    
75.     env.Replace(CCCOM = ['$CC $CFLAGS $CPPFLAGS $_CPPDEFFLAGS $_CPPINCFLAGS -o $TARGET $SOURCES'])
    
76. 
    
77.     env.Replace(ARFLAGS = [''])
    
78. 
    
79.     env.Replace(LINKCOM = env["LINKCOM"] + ' --map rtthread.map')
    
80. 
    
81. Export('RTT_ROOT')
    
82. 
    
83. Export('rtconfig')
    
84. 
    
85. SDK_ROOT = os.path.abspath('./')
    
86. 
    
87. if os.path.exists(SDK_ROOT + '/Libraries'):
    
88. 
    
89.     libraries_path_prefix = SDK_ROOT + '/Libraries'
    
90. 
    
91. else:
    
92. 
    
93.     libraries_path_prefix = os.path.dirname(SDK_ROOT) + '/Libraries'
    
94. 
    
95. SDK_LIB = libraries_path_prefix
    
96. 
    
97. Export('SDK_LIB')
    
98. 
    
99. # prepare building environment
    
100. 
     
101. objs = PrepareBuilding(env, RTT_ROOT, has_libcpu=False)
     
102. 
     
103. objs.extend(SConscript(os.path.join(libraries_path_prefix, 'drivers', 'SConscript')))
     
104. 
     
105. # include cmsis
     
106. 
     
107. objs.extend(SConscript(os.path.join(libraries_path_prefix, rtconfig.BSP_LIBRARY_TYPE, 'SConscript')))
     
108. 
     
109. # make a building
     
110. 
     
111. DoBuilding(TARGET, objs)

复制代码

最终搭建完成的效果如下所示，代码高亮十分方便查看代码

LVGL 适配
屏幕拓展板
FRDM-MCXN947 这个开发板预留了一个 FlexIO 接口可以适配 8080 的并口屏，于是做了一个屏幕拓展板，把手里闲置的屏幕用起来

实物如下，触摸排线座子有点偏下，不过不影响功能

屏幕手册说明分辨率是 240*320 驱动芯片是 ST7789V、触摸芯片是 FT6336G，而官方的 SDK 中是有 ST7796 和 FT5406 的驱动代码的，后续还需要稍作修改

驱动适配
在官方的 SDK 中有 ST7796 和 FT5406 的驱动程序，直接移植过来即可，同时也把 EDMA 和 SMARTDMA 的驱动复制了过来，修改一下屏幕的初始化序列即可驱动屏幕

LVGL 适配
将SDK中的 lvgl_support 复制到工程中，修改屏幕的宽高为 240*320

然后在 board 中新建一个 lv_conf.h 文件，填入关于 LVGL 的一些配置，因为许多配置在 menuconfig 中有所设置，所以这里的配置项并不多

1. #ifndef LV_CONF_H
   
2. 
   
3. #define LV_CONF_H
   
4. 
   
5. #include <rtconfig.h>
   
6. 
   
7. #define LV_USE_SYSMON           1
   
8. 
   
9. #define LV_USE_PERF_MONITOR     0
   
10. 
    
11. #define LV_COLOR_DEPTH          16
    
12. 
    
13. #define LV_HOR_RES_MAX          240
    
14. 
    
15. #define LV_VER_RES_MAX          320
    
16. 
    
17. #define LV_COLOR_16_SWAP        0
    
18. 
    
19. #define BSP_USING_LVGL_BENCHMARK_DEMO
    
20. 
    
21. #define BSP_USING_LVGL_WIDGETS_DEMO
    
22. 
    
23. #ifdef BSP_USING_LVGL_DAVE2D
    
24. 
    
25.     #define LV_USE_DRAW_DAVE2D      1
    
26. 
    
27. #endif
    
28. 
    
29. #ifdef BSP_USING_LVGL_WIDGETS_DEMO
    
30. 
    
31.     #define LV_USE_DEMO_WIDGETS 1
    
32. 
    
33.     #define LV_DEMO_WIDGETS_SLIDESHOW   0
    
34. 
    
35. #endif  /* BSP_USING_LVGL_WIDGETS_DEMO */
    
36. 
    
37. /*Benchmark your system*/
    
38. 
    
39. #ifdef BSP_USING_LVGL_BENCHMARK_DEMO
    
40. 
    
41.     #define LV_USE_DEMO_BENCHMARK 1
    
42. 
    
43.     /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/
    
44. 
    
45.     #define LV_DEMO_BENCHMARK_RGB565A8  1
    
46. 
    
47.     #define LV_FONT_MONTSERRAT_14       1
    
48. 
    
49.     #define LV_FONT_MONTSERRAT_24       1
    
50. 
    
51. #endif  /* BSP_USING_LVGL_BENCHMARK_DEMO */
    
52. 
    
53. /*Stress test for LVGL*/
    
54. 
    
55. #ifdef BSP_USING_LVGL_STRESS_DEMO
    
56. 
    
57.     #define LV_USE_DEMO_STRESS 1
    
58. 
    
59. #endif  /* BSP_USING_LVGL_STRESS_DEMO */
    
60. 
    
61. /*Render test for LVGL*/
    
62. 
    
63. #ifdef BSP_USING_LVGL_RENDER_DEMO
    
64. 
    
65.     #define LV_USE_DEMO_RENDER 1
    
66. 
    
67. #endif  /* BSP_USING_LVGL_RENDER_DEMO */
    
68. 
    
69. /*Music player demo*/
    
70. 
    
71. #ifdef BSP_USING_LVGL_MUSIC_DEMO
    
72. 
    
73.     #define LV_USE_DEMO_MUSIC 1
    
74. 
    
75.     #define LV_DEMO_MUSIC_SQUARE    1
    
76. 
    
77.     #define LV_DEMO_MUSIC_LANDSCAPE 0
    
78. 
    
79.     #define LV_DEMO_MUSIC_ROUND     0
    
80. 
    
81.     #define LV_DEMO_MUSIC_LARGE     0
    
82. 
    
83.     #define LV_DEMO_MUSIC_AUTO_PLAY 0
    
84. 
    
85.     #define LV_FONT_MONTSERRAT_12   1
    
86. 
    
87.     #define LV_FONT_MONTSERRAT_16   1
    
88. 
    
89. #endif  /* BSP_USING_LVGL_MUSIC_DEMO */
    
90. 
    
91. #endif

复制代码

复制过来的 lvgl_support 中有对 FreeRTOS 的支持，这里将 FreeRTOS 的 API 修改为 RTT 的 API，例如如下这段代码

并且 N947 的驱动程序有 EDMA + FlexIO 和 SMARTDMA + FlexIO 两种驱动方式，具体区别不太了解，不过可以运行 LVGL 的 Benchmark 测试来看下结果，左边是 SMARTDMA 运行的结果，右边是 EDMA 的结果，可以看到前者的 FPS 更高。后续也就继续采用 SMARTDMA + FlexIO 的驱动方式

界面设计
然后使用 GUI Guider 设计一个界面，生成绘制界面的代码，然后添加到工程中

还需要修改工程文件夹中的 rtconfig.py，增加一个 LV_LVGL_H_INCLUDE_SIMPLE 的预定义，因为生成的代码默认包含 lvgl.h 是 #include "lvgl/lvgl.h"


CFLAGS = DEVICE + ' -Wall -D__FPU_PRESENT -DLV_LVGL_H_INCLUDE_SIMPLE'
最终适配完成的 LVGL 代码和 GUI Guider 的代码目录如下，LVGL 的 UI 绘制代码段如图右边所示，具体代码可见开源地址

USB 通讯
适配 CDC
完成了下位机的界面的初始化绘制，后续的任务当然就是怎么把数据采集并发送给下位机来更新界面的数据了，下面先完成 USB 的通讯，这里使用的是 RTT 官方推荐的 CherryUSB 这个开源 USB 协议栈

将如下链接中的适配代码复制到工程中


https://github.com/CherryUSB/cherryusb_mcx


因为传输的数据比较单一，这里使用串口屏的思路，直接用 CDC_ACM 的通讯方式，也就是在上位机显示为一个 USB 转串口设备，直接使用串口 API 完成通讯


将 RTT 根目录中 rt-thread/components/drivers/usb/cherryusb/demo 文件夹中的 CDC_ACM 例程复制到工程中，并且把根目录中的这两行代码屏蔽

修改工程中的 cherryusb_port.c 文件，添加对 CDC_ACM 的支持

1. 
   
2. /*
   
3. 
   
4. * Copyright (c) 2006-2024, RT-Thread Development Team
   
5. 
   
6. *
   
7. 
   
8. * SPDX-License-Identifier: Apache-2.0
   
9. 
   
10. *
    
11. 
    
12. * Change Logs:
    
13. 
    
14. * Date           Author       Notes
    
15. 
    
16. * 2024/04/23     sakumisu    first version
    
17. 
    
18. */
    
19. 
    
20. #include <rtthread.h>
    
21. 
    
22. #include <board.h>
    
23. 
    
24. /* low level init here, this has implemented in cherryusb */
    
25. /* low level deinit here, this has implemented in cherryusb */
    
26. #ifdef RT_CHERRYUSB_DEVICE_TEMPLATE_CDC_ACM
    
27. int cherryusb_devinit(void)
    
28. {
    
29.     // extern void cherryusb_devinit(uint8_t busid, uintptr_t reg_base);
    
30.     extern void cdc_acm_init(uint8_t busid, uintptr_t reg_base);
    
31.     cdc_acm_init(0, USBHS1__USBC_BASE);
    
32.     return 0;
    
33. }
    
34. INIT_COMPONENT_EXPORT(cherryusb_devinit);
    
35. #endif
    
36. #ifdef RT_CHERRYUSB_DEVICE_TEMPLATE_MSC
    
37. int cherryusb_devinit(void)
    
38. 
    
39. {
    
40.     extern void msc_ram_init(uint8_t busid, uintptr_t reg_base);
    
41.     msc_ram_init(0, USBHS1__USBC_BASE);
    
42.     return 0;
    
43. }
    
44. INIT_COMPONENT_EXPORT(cherryusb_devinit);
    
45. #endif
    
46. #ifdef RT_CHERRYUSB_HOST
    
47. #include "usbh_core.h"
    
48. int cherryusb_hostinit(void)
    
49. {
    
50.     usbh_initialize(0, USBHS1__USBC_BASE);
    
51.     return 0;
    
52. }
    
53. INIT_COMPONENT_EXPORT(cherryusb_hostinit);
    
54. #endif

复制代码

将刚才复制到工程中的 CDC_ACM 的 demo 程序中端点收发的程序做如下修改，增加对于输入信息的回显

1. void usbd_cdc_acm_bulk_out(uint8_t busid, uint8_t ep, uint32_t nbytes)
   
2. 
   
3. {
   
4. 
   
5.     USB_LOG_RAW("actual out len:%d\r\n", nbytes);
   
6. 
   
7.     /* setup next out ep read transfer */
   
8. 
   
9.     usbd_ep_start_read(busid, CDC_OUT_EP, read_buffer, 2048);
   
10. 
    
11.     for (int i = 0; i < nbytes; i++) {
    
12. 
    
13.         printf("%02x ", read_buffer[i]);
    
14. 
    
15.     }
    
16. 
    
17.     printf("\r\n");
    
18. 
    
19. }

复制代码

验证
然后插上开发板的 USB HS 那个 USB 接口，用串口工具发个数据包

可以看到 已经识别成了 USB 串行设备，PID 和 VID 也是我自己设置的 0xE6E9 和 0x1122，后续上位机与开发板建立通讯锁定 COM 号就是依靠 PID VID 来查询实现，使用串口工具给开发板发送的数据也可以正常接收到


上位机
时间原因上位机做的比较简单，实现了如下几个功能：


读取电脑的 CPU、GPU 的占用率和温度信息、获取当前时间
根据 VID、PID 查询 COM来与开发板通讯，下发采集数据与时间
增加帧头后发送到下位机，固定长度 32+2 个字节

下位机数据更新
在开发板端增加一个 thread 来负责把 USB 接收到的数据更新到屏幕上面，使用 LVGL 的 API 直接修改数据即可，代码如下


数据结构体

1. typedef struct
   
2. 
   
3. {
   
4. 
   
5.     uint16_t cpu_usage;
   
6. 
   
7.     uint16_t mem_usage;
   
8. 
   
9.     uint16_t gpu_usage;
   
10. 
    
11.     uint16_t cpu_freq;
    
12. 
    
13.     uint16_t cpu_temperature;
    
14. 
    
15.     uint16_t gpu_temperature;
    
16. 
    
17.     uint16_t board_temperature;
    
18. 
    
19. } monitor_info_u16_t;
    
20. 
    
21. typedef struct {
    
22. 
    
23.     uint16_t wYear;
    
24. 
    
25.     uint16_t wMonth;
    
26. 
    
27.     uint16_t wDayOfWeek;
    
28. 
    
29.     uint16_t wDay;
    
30. 
    
31.     uint16_t wHour;
    
32. 
    
33.     uint16_t wMinute;
    
34. 
    
35.     uint16_t wSecond;
    
36. 
    
37.     uint16_t wMilliseconds;
    
38. 
    
39. } mytime_t;

复制代码

在 USB 端点输出的回调函数中增加消息队列发送函数

1. void usbd_cdc_acm_bulk_out(uint8_t busid, uint8_t ep, uint32_t nbytes)
   
2. 
   
3. {
   
4. 
   
5.     USB_LOG_RAW("actual out len:%d\r\n", nbytes);
   
6. 
   
7.     /* setup next out ep read transfer */
   
8. 
   
9.     usbd_ep_start_read(busid, CDC_OUT_EP, read_buffer, 2048);
   
10. 
    
11.     for (int i = 0; i < nbytes; i++) {
    
12. 
    
13.         printf("%02x ", read_buffer[i]);
    
14. 
    
15.     }
    
16. 
    
17.     printf("\r\n");
    
18. 
    
19.     if (34 == nbytes)
    
20. 
    
21.     {
    
22. 
    
23.         rt_mq_send(&usb_mq, read_buffer, 34);
    
24. 
    
25.     }
    
26. 
    
27. }

复制代码

main 函数中的接收消息队列

1. uint8_t read_buffer[128];
   
2. 
   
3. while (1)
   
4. 
   
5. {
   
6. 
   
7.     /* 从消息队列中接收消息 */
   
8. 
   
9.     if (rt_mq_recv(&usb_mq, read_buffer, 34, RT_WAITING_FOREVER) > 0)
   
10. 
    
11.     {
    
12. 
    
13.         mytime_t* p_time_u16 = (mytime_t*)(read_buffer + 2);
    
14. 
    
15.         monitor_info_u16_t* p_info_u16 = (monitor_info_u16_t *)(read_buffer + 2 + sizeof(mytime_t));
    
16. 
    
17.         rt_kprintf("wYear         %u\r\n", p_time_u16->wYear);
    
18. 
    
19.         rt_kprintf("wMonth        %u\r\n", p_time_u16->wMonth);
    
20. 
    
21.         rt_kprintf("wDayOfWeek    %u\r\n", p_time_u16->wDayOfWeek);
    
22. 
    
23.         rt_kprintf("wDay          %u\r\n", p_time_u16->wDay);
    
24. 
    
25.         rt_kprintf("wHour         %u\r\n", p_time_u16->wHour);
    
26. 
    
27.         rt_kprintf("wMinute       %u\r\n", p_time_u16->wMinute);
    
28. 
    
29.         rt_kprintf("wSecond       %u\r\n", p_time_u16->wSecond);
    
30. 
    
31.         rt_kprintf("wMilliseconds %u\r\n", p_time_u16->wMilliseconds);
    
32. 
    
33.         rt_kprintf("cpu_usage         %u\r\n", p_info_u16->cpu_usage);
    
34. 
    
35.         rt_kprintf("mem_usage         %u\r\n", p_info_u16->mem_usage);
    
36. 
    
37.         rt_kprintf("gpu_usage         %u\r\n", p_info_u16->gpu_usage);
    
38. 
    
39.         rt_kprintf("cpu_freq          %u\r\n", p_info_u16->cpu_freq);
    
40. 
    
41.         rt_kprintf("cpu_temperature   %u\r\n", p_info_u16->cpu_temperature);
    
42. 
    
43.         rt_kprintf("gpu_temperature   %u\r\n", p_info_u16->gpu_temperature);
    
44. 
    
45.         rt_kprintf("board_temperature %u\r\n", p_info_u16->board_temperature);
    
46. 
    
47.         lv_label_set_text_fmt(guider_ui.screen_label_cpu_temp, "%2d", p_info_u16->cpu_temperature);
    
48. 
    
49.         lv_label_set_text_fmt(guider_ui.screen_label_gpu_temp, "%2d", p_info_u16->gpu_temperature);
    
50. 
    
51.         lv_label_set_text_fmt(guider_ui.screen_label_cpu_load, "%2d", p_info_u16->cpu_usage);
    
52. 
    
53.         lv_label_set_text_fmt(guider_ui.screen_label_gpu_load, "%2d", p_info_u16->gpu_usage);
    
54. 
    
55.         lv_arc_set_value(guider_ui.screen_arc_gpu_load, p_info_u16->gpu_usage);
    
56. 
    
57.         lv_arc_set_value(guider_ui.screen_arc_gpu_temp, p_info_u16->gpu_temperature);
    
58. 
    
59.         lv_label_set_text_fmt(guider_ui.screen_time, "%02d:%02d", p_time_u16->wHour, p_time_u16->wMinute);
    
60. 
    
61.         lv_label_set_text_fmt(guider_ui.screen_date, "%02d.%02d.%02d", p_time_u16->wYear, p_time_u16->wMonth, p_time_u16->wDay);
    
62. 
    
63.     }
    
64. 
    
65. }

复制代码

成品效果
目前支持了对于时间、日期、CPU、GPU 的占用率和温度信息，其他的信息还在完善当中

下位机代码可见GitHub：https://github.com/POMIN-163/FRDM-MCXN947-USB-Monitor
————————————————
文章出处：本文为RT-Thread论坛用户「pomin」的原创文章
原文链接：https://club.rt-thread.org/ask/article/fd0a9bdab79b7c65.html

阅读全文

eefocus_3891719

为大佬点赞

jobszheng5

像这种在linux系统编译，真的可以加快编译进度吗？