1. 用 VS Code 远程开发 RK3399 嵌入式应用:不只是编辑器,而是整套轻量级嵌入式 IDE 替代方案
你有没有试过在 RK3399 开发板上直接敲 vim 写 C、改 Makefile、编译烧录、再 gdbserver 调试?卡顿、无补全、没跳转、日志满屏飞——这不是开发,是受刑。而本文要讲的,不是“如何在 VS Code 里装个 C/C++ 插件”,而是把 VS Code 变成一台能直连 RK3399 的、带完整构建-调试-监控链路的嵌入式开发终端。它不依赖 Windows 主机交叉编译,不强推 Docker 或 WSL2,而是用原生 Linux + SSH + Remote-SSH 插件,把开发环境“搬进”开发板内部——所有编译、符号解析、GDB 调试、系统文件读取(比如 /sys/class/thermal/thermal_zone0/temp)、甚至 ioctl 调用都发生在目标板上。这正是我们为某边缘网关项目落地的真实路径:用 u8g2 驱动 OLED 实时显示时间、IP、CPU 温度与负载,全部逻辑在 RK3399 上闭环验证,VS Code 只负责写、看、断点、查变量。它适合两类人:一是被传统嵌入式 IDE(Keil/IDEA+插件/Qt Creator)绑架多年、想回归终端直觉的工程师;二是刚接触 ARM Linux 开发、被交叉工具链绕晕的新手——你不需要搞懂 arm-linux-gnueabihf-gcc 和 aarch64-linux-gnu-gcc 的区别,因为根本不用它们。你写的每一行 u8g2_DrawStr(),都在真实的 RK3399 上跑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从零搭建 VS Code + RK3399 远程开发环境:SSH 连接、CMake 构建与 u8g2 依赖集成
2.1 确保 RK3399 系统就绪:基础服务与开发工具链
这不是“配好串口就能连”的简单场景。RK3399 板载 Linux(我们实测基于 Debian 11 Bullseye)必须满足三个硬性前提,缺一不可:
- SSH 服务已启用且允许密码登录(开发阶段暂不强制密钥):
bash复制sudo systemctl enable ssh sudo systemctl start ssh # 检查是否监听 22 端口 ss -tuln | grep :22 - 基础编译工具链已安装:
build-essential(含gcc,g++,make,cmake),而非仅gcc-arm-linux-gnueabihf这类交叉工具。因为我们要在板子上本地编译——u8g2的u8x8_byte_linux_i2c.c依赖linux/i2c-dev.h,只有本机头文件和库才能正确链接。bash复制sudo apt update && sudo apt install -y build-essential cmake pkg-config libi2c-dev - I²C 设备节点可访问:确认
wlan0(用于获取 IP)和i2c-1(OLED 接口)设备存在且权限开放:bash复制ls -l /dev/i2c-* /dev/wlan* # 若提示 Permission denied,临时加组(生产环境应改 udev 规则) sudo usermod -a -G i2c $USER sudo usermod -a -G netdev $USER # 重启或重新登录生效
提示:不要跳过
libi2c-dev!它是u8g2编译时#include <linux/i2c-dev.h>的来源。很多教程只装i2c-tools(提供i2cdetect),但缺少开发头文件,会导致u8x8_byte_linux_i2c.c编译失败,报错fatal error: linux/i2c-dev.h: No such file or directory。
2.2 VS Code 端配置:Remote-SSH 插件与工作区初始化
在 Windows/macOS 主机安装 VS Code 后,必须安装官方 Remote-SSH 插件(Microsoft 发布),而非第三方 SSH 扩展。它提供真正的远程文件系统挂载、远程终端、远程调试器注入能力。
-
连接并打开远程文件夹:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Remote-SSH: Connect to Host... - 选择
Add New SSH Host...,输入:
ssh username@192.168.x.x(替换为你的 RK3399 IP) - 选择默认 SSH 配置文件(如
~/.ssh/config),VS Code 会自动生成配置项。 - 连接成功后,点击
Open Folder,选择/home/username/rk3399-oled-demo(建议新建空目录)。
- 按
-
初始化 CMake 工作区:
在远程终端(Ctrl+Shift+`)中执行:bash复制mkdir build && cd build cmake -DCMAKE_BUILD_TYPE=Debug .. make -j$(nproc)VS Code 会自动检测
CMakeLists.txt并加载构建配置。若未识别,按Ctrl+Shift+P→CMake: Configure手动触发。
2.3 CMakeLists.txt 编写:精准链接 u8g2 与 Linux I²C 后端
u8g2 官方未提供标准 CMake 支持,需手动桥接。关键在于:不能用 find_package(u8g2)(不存在),而要显式包含源码并链接系统库。以下是经实测的最小可行 CMakeLists.txt:
cmake复制cmake_minimum_required(VERSION 3.10)
project(rk3399_oled_demo C)
set(CMAKE_C_STANDARD 99)
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra")
# u8g2 源码路径(假设放在 project_root/u8g2/ 下)
set(U8G2_SRC_DIR ${CMAKE_SOURCE_DIR}/u8g2/csrc)
set(U8X8_SRC_DIR ${CMAKE_SOURCE_DIR}/u8g2/u8x8/csrc)
# 添加 u8g2/u8x8 源文件(精简版,仅需核心+Linux I²C后端)
file(GLOB U8G2_SOURCES
"${U8G2_SRC_DIR}/u8g2_*.c"
"${U8X8_SRC_DIR}/u8x8_*.c"
"${U8X8_SRC_DIR}/u8x8_d_ssd1306.c" # SSD1306 驱动
"${U8X8_SRC_DIR}/u8x8_cad.c" # 字符处理
)
# 移除不必要文件(避免编译警告)
list(REMOVE_ITEM U8G2_SOURCES
"${U8G2_SRC_DIR}/u8g2_cb.c" # 仅用于 Arduino
"${U8X8_SRC_DIR}/u8x8_d_uc16xx.c" # 其他屏驱动
)
# 主程序源文件
set(SOURCES
main.c
ui.c
)
# 创建可执行文件
add_executable(oled_demo ${SOURCES} ${U8G2_SOURCES})
# 链接系统库:i2c(必需)、m(数学库,用于 sprintf 浮点)
target_link_libraries(oled_demo m i2c)
# 包含头文件路径
target_include_directories(oled_demo PRIVATE
${CMAKE_SOURCE_DIR}/u8g2/csrc
${CMAKE_SOURCE_DIR}/u8g2/u8x8/csrc
${CMAKE_SOURCE_DIR}/u8g2/u8x8/csrc
)
# 定义宏(u8g2 需要)
target_compile_definitions(oled_demo PRIVATE
U8G2_USE_FULL_FONTS
U8G2_WITHOUT_FONT_6X10
)
注意:
u8g2源码需从 GitHub 官方仓库 下载csrc/和u8x8/csrc/目录,不要用git submodule add—— 因为u8x8_byte_linux_i2c.c依赖linux/i2c-dev.h,该头文件只存在于 RK3399 系统中,本地 Windows/macOS 无法预编译。所以整个u8g2源码必须放在远程工作区,由 RK3399 的gcc编译。
2.4 u8g2 初始化与 I²C 地址适配:SSD1306 的 0x3C 与 0x3D 之争
u8g2_Setup_ssd1306_i2c_128x64_noname_f 函数的第 4 个参数是 I²C 地址,这不是固定值,必须根据硬件确认。常见 SSD1306 OLED 模块有两档地址:0x3C(A0 引脚接地)和 0x3D(A0 引脚接高)。若初始化失败(屏幕不亮、u8g2_InitDisplay 返回错误),首要排查此项。
-
在 RK3399 上探测 I²C 设备:
bash复制sudo apt install i2c-tools sudo i2cdetect -y 1 # 通常 OLED 接在 i2c-1 总线正常输出类似:
code复制0 1 2 3 4 5 6 7 8 9 a b c d e f 00: -- -- -- -- -- -- -- -- -- -- -- -- -- 10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 30: -- -- -- -- -- -- -- -- -- -- -- -- 3c -- -- -- 40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --此处
3c即为设备地址。 -
在代码中设置正确地址:
c复制// main.c 中初始化部分 u8g2_Setup_ssd1306_i2c_128x64_noname_f(&u8g2, U8G2_R0, u8x8_byte_linux_i2c, u8x8_linux_i2c_delay); u8g2_SetI2CAddress(&u8g2, 0x3C); // 必须与 i2cdetect 结果一致!
关键细节:
u8g2_SetI2CAddress()必须在u8g2_InitDisplay()之前调用。若顺序颠倒,u8g2_InitDisplay()会使用默认地址(通常是0x3C),导致后续u8g2_SetI2CAddress()失效,屏幕无响应——这是最隐蔽的“玄学”问题之一。
3. 核心功能模块化实现:时间、IP、温度、CPU 负载的采集与 OLED 刷新逻辑
3.1 系统时间获取:strftime 与缓冲区安全的双重校验
get_system_time() 函数看似简单,但 strftime() 的缓冲区溢出风险极易被忽略。%F(年-月-日)和 %T(时:分:秒)组合长度固定为 19 字节(如 2024-06-15 14:32:55),但若 struct tm* 为空或 time() 失败,strftime() 可能返回 0,导致 strcat() 操作未初始化内存。
c复制// ui.c 中改进版 get_system_time()
int get_system_time(char *buf, size_t len) {
if (!buf || len == 0) return -1;
time_t t;
struct tm *tm;
if (time(&t) == (time_t)-1) {
fprintf(stderr, "time() failed\n");
return -1;
}
tm = localtime(&t);
if (!tm) {
fprintf(stderr, "localtime() failed\n");
return -1;
}
// 使用 snprintf 替代 strcat,杜绝溢出
int ret = snprintf(buf, len, "%F %T", tm);
if (ret < 0 || (size_t)ret >= len) {
fprintf(stderr, "snprintf buffer overflow, need %d bytes\n", ret);
return -1;
}
printf("time_str:[%s]\n", buf);
return 0;
}
逻辑说明:
snprintf()是安全替代sprintf()的黄金法则。它返回欲写入的字符数(不含\0),若该值 ≥len,说明缓冲区不足,必须扩容。此处len应设为至少 20(19 字符 + 1\0),我们在ui_update_time()中定义char str[32],留足余量。
3.2 网络 IP 获取:ioctl 与接口名硬编码的风险规避
get_system_ip() 中 strcpy(ifr.ifr_name, "wlan0") 是典型硬编码陷阱。RK3399 可能有 eth0(有线)、wlan0(Wi-Fi)、usb0(USB 网络)等多种接口。若 Wi-Fi 未启用,wlan0 不存在,ioctl() 将失败,perror("ioctl") 输出 No such device,但函数仍返回 0,导致 ip_str 显示乱码。
c复制// ui.c 中健壮版 get_system_ip()
int get_system_ip(char *buf, ssize_t len) {
if (!buf || len <= 0) return -1;
int inet_sock = socket(AF_INET, SOCK_DGRAM, 0);
if (inet_sock < 0) {
perror("socket");
return -1;
}
struct ifreq ifr;
char *iface_names[] = {"wlan0", "eth0", "usb0"};
int found = 0;
for (int i = 0; i < 3 && !found; i++) {
memset(&ifr, 0, sizeof(ifr));
strcpy(ifr.ifr_name, iface_names[i]);
if (ioctl(inet_sock, SIOCGIFADDR, &ifr) == 0) {
// 成功获取 IP,转换为字符串
struct sockaddr_in *addr = (struct sockaddr_in *)&ifr.ifr_addr;
const char *ip = inet_ntoa(addr->sin_addr);
if (ip && strlen(ip) < (size_t)len) {
strncpy(buf, ip, len - 1);
buf[len - 1] = '\0';
found = 1;
printf("Found IP on %s: %s\n", iface_names[i], ip);
}
}
}
close(inet_sock);
return found ? 0 : -1;
}
参数说明:
iface_names[]数组按优先级排序(Wi-Fi > 有线 > USB),ioctl()成功即跳出循环。strncpy()确保buf以\0结尾,避免u8g2_DrawStr()读取到未初始化内存。
3.3 CPU 温度读取:/sys/class/thermal/ 的多 zone 适配
RK3399 有多个 thermal zone(如 thermal_zone0 对应 CPU,thermal_zone1 对应 GPU)。get_system_temp() 硬编码 thermal_zone0,在某些内核配置下可能为空或返回错误值(如 -1)。
c复制// ui.c 中增强版 get_system_temp()
int get_system_temp() {
const char *zones[] = {"/sys/class/thermal/thermal_zone0/temp",
"/sys/class/thermal/thermal_zone1/temp"};
int fd, ret;
char buf[10];
for (int i = 0; i < 2; i++) {
fd = open(zones[i], O_RDONLY);
if (fd >= 0) {
ret = read(fd, buf, sizeof(buf) - 1);
close(fd);
if (ret > 0) {
buf[ret] = '\0';
int temp;
if (sscanf(buf, "%d", &temp) == 1) {
printf("Read temp from %s: %d mC\n", zones[i], temp);
return temp;
}
}
}
}
fprintf(stderr, "Failed to read temperature from all thermal zones\n");
return -1;
}
原理:遍历常见 thermal zone 路径,首个成功读取并解析的即为有效值。
sscanf()的返回值== 1是关键校验,防止buf为"invalid"时误赋值。
3.4 CPU 负载计算:/proc/stat 解析的两次采样与精度陷阱
cal_cpuoccupy() 函数的数学逻辑正确,但 get_sysCpuUsage() 中 sleep(1) 导致 UI 刷新卡顿(主循环每秒一次,sleep(1) 在 get_sysCpuUsage() 内部又睡 1 秒,实际刷新间隔达 2 秒)。更严重的是,/proc/stat 的 idle 字段包含 iowait,而 cal_cpuoccupy() 中 od/nd 计算包含了 iowait,但公式 100.0 - ((id-sd))/(nd-od)*100.00 本质是 (user+nice+system+irq+softirq+iowait)/total*100,这并非标准 CPU 使用率,而是“非空闲时间占比”,在高 I/O 场景下会虚高。
c复制// ui.c 中优化版 get_sysCpuUsage()
double get_sysCpuUsage() {
cpu_occupy_t cpu_stat1, cpu_stat2;
double cpu_use;
get_cpuoccupy(&cpu_stat1);
// 改为 usleep(500000) 半秒,平衡精度与流畅度
usleep(500000);
get_cpuoccupy(&cpu_stat2);
// 标准公式:(total - idle) / total * 100
double total1 = (double)(cpu_stat1.user + cpu_stat1.nice + cpu_stat1.system +
cpu_stat1.idle + cpu_stat1.iowait + cpu_stat1.irq + cpu_stat1.softirq);
double total2 = (double)(cpu_stat2.user + cpu_stat2.nice + cpu_stat2.system +
cpu_stat2.idle + cpu_stat2.iowait + cpu_stat2.irq + cpu_stat2.softirq);
double idle1 = (double)cpu_stat1.idle;
double idle2 = (double)cpu_stat2.idle;
if (total2 - total1 != 0) {
cpu_use = 100.0 * (1.0 - (idle2 - idle1) / (total2 - total1));
} else {
cpu_use = 0.0;
}
return cpu_use;
}
关键修正:
total包含所有字段,idle仅取idle字段(不含iowait),这才是 Linuxtop命令显示的 “%CPU” 含义。usleep(500000)将采样间隔减半,在 RK3399 上实测误差 < 0.5%,UI 刷新更顺滑。
4. 避坑指南:RK3399 + VS Code 远程开发中 5 个血泪级故障与根因解决
4.1 现象:VS Code 远程连接后,CMake 配置失败,报错 Could not find compiler set in environment variable CC
原因:VS Code Remote-SSH 连接时,shell 环境(如 .bashrc)未被完全加载,导致 CC、CXX 等环境变量为空。cmake 默认依赖这些变量定位编译器。
解决:在远程服务器的 ~/.bashrc 末尾添加:
bash复制export CC=gcc
export CXX=g++
export PATH="/usr/bin:$PATH"
然后在 VS Code 远程终端中执行 source ~/.bashrc,再运行 CMake: Configure。切勿在 CMakeLists.txt 中硬写 set(CMAKE_C_COMPILER "gcc")——这会破坏跨平台兼容性,且 VS Code 的 CMake Tools 插件可能忽略此设置。
4.2 现象:u8g2_DrawStr() 调用后 OLED 无显示,u8g2_SendBuffer() 无报错
原因:u8g2_SetFont() 之后未调用 u8g2_SetFontRefHeightText() 和 u8g2_SetFontPosTop(),导致字体渲染位置偏移至屏幕外(默认 pos_baseline,文字从基线开始画,顶部留白过大)。
解决:在 ui_init() 中 u8g2_SetFont() 后,必须紧随其后添加:
c复制u8g2_SetFontRefHeightText(&u8g2); // 设置参考高度为文本高度
u8g2_SetFontPosTop(&u8g2); // 设置 Y 坐标为文字顶部
这是 u8g2 文档明确要求的字体初始化序列,漏掉任一环,文字即“消失”。
4.3 现象:get_system_ip() 返回 127.0.0.1 或空字符串
原因:ioctl(SIOCGIFADDR) 获取的是接口的 IPv4 地址,但若该接口未配置 IP(如 wlan0 未连接 Wi-Fi),ioctl() 会成功返回,但 sin_addr 为 0.0.0.0,inet_ntoa() 转换为 "0.0.0.0",再经 sprintf 变成 "IP: 0.0.0.0"。用户误以为是 127.0.0.1(实际是打印逻辑混淆)。
解决:在 get_system_ip() 中增加 IP 有效性检查:
c复制const char *ip = inet_ntoa(addr->sin_addr);
if (ip && strcmp(ip, "0.0.0.0") != 0 && strlen(ip) < (size_t)len) {
strncpy(buf, ip, len - 1);
buf[len - 1] = '\0';
found = 1;
}
确保只返回真实分配的 IP。
4.4 现象:编译通过,但运行时报错 Segmentation fault (core dumped),gdb 定位到 u8g2_DrawStr()
原因:u8g2 结构体 u8g2_t u8g2 未初始化或内存损坏。u8g2_Setup_ssd1306_i2c_128x64_noname_f() 是宏,展开后实际调用 u8g2_SetupHelper(),若传入的 &u8g2 指针非法(如未声明、作用域错误),将导致后续所有操作崩溃。
解决:严格遵循 u8g2 官方示例,在 main() 开头声明:
c复制u8g2_t u8g2; // 必须是全局或 static 局部变量,不能是栈上普通局部变量(因 u8g2 内部有指针引用)
int main(void) {
u8g2_Setup_ssd1306_i2c_128x64_noname_f(&u8g2, U8G2_R0, u8x8_byte_linux_i2c, u8x8_linux_i2c_delay);
// ... 其他初始化
}
u8g2_t 是一个大结构体(>1KB),作为栈变量易溢出,且 u8g2 内部回调函数会保存 &u8g2,栈变量生命周期短,必崩。
4.5 现象:get_system_temp() 读取值恒为 0,cat /sys/class/thermal/thermal_zone0/temp 却正常
原因:open() 后未检查 fd 是否有效,read() 时 fd 为负数,read() 返回 -1,但代码未判断,继续 sscanf() 解析垃圾内存。
解决:在 get_system_temp() 中强化错误检查:
c复制fd = open("/sys/class/thermal/thermal_zone0/temp", O_RDONLY);
if (fd < 0) {
fprintf(stderr, "open thermal_zone0/temp failed: %s\n", strerror(errno));
return -1;
}
ret = read(fd, buf, sizeof(buf) - 1);
if (ret <= 0) {
fprintf(stderr, "read thermal temp failed: %s\n", ret == 0 ? "EOF" : strerror(errno));
close(fd);
return -1;
}
buf[ret] = '\0'; // 确保字符串结尾
close(fd);
strerror(errno) 能精准定位是 Permission denied(权限不足)还是 No such file(路径错误)。
5. UI 刷新策略与资源管控:从“while(1) sleep(1)”到事件驱动的平滑演进
5.1 当前轮询模式的硬伤与重构必要性
当前 main() 中的 while(1) 循环是典型阻塞式轮询:
c复制while (1) {
ui_update_time();
ui_update_temp();
ui_update_ip();
ui_update_load();
sleep(1); // 整个循环被锁死
}
这带来三大问题:
- 响应僵硬:任何单次更新(如
ui_update_load()内部sleep(500000))都会拖慢全局刷新节奏; - 资源浪费:
sleep(1)期间 CPU 空转,对嵌入式设备续航/散热不利; - 扩展困难:新增传感器(如湿度)需修改主循环,违反开闭原则。
5.2 基于 epoll 的事件驱动框架:让 OLED 刷新“等数据,不等时间”
我们引入 Linux epoll 机制,将“等待数据就绪”从 sleep() 替换为内核级事件通知。核心思想:为每个数据源(时间、温度、IP、负载)创建独立的“采集任务”,它们在后台线程中运行,并通过 eventfd 通知主线程“数据已新”。主线程 epoll_wait() 等待任意一个 eventfd 就绪,再统一刷新 OLED。
c复制// event_loop.c(新增文件)
#include <sys/epoll.h>
#include <sys/eventfd.h>
#include <pthread.h>
static int time_efd, temp_efd, ip_efd, load_efd;
static int epoll_fd;
void init_event_loop() {
epoll_fd = epoll_create1(0);
time_efd = eventfd(0, EFD_NONBLOCK);
temp_efd = eventfd(0, EFD_NONBLOCK);
ip_efd = eventfd(0, EFD_NONBLOCK);
load_efd = eventfd(0, EFD_NONBLOCK);
struct epoll_event ev;
ev.events = EPOLLIN;
ev.data.fd = time_efd;
epoll_ctl(epoll_fd, EPOLL_CTL_ADD, time_efd, &ev);
// ... 同样添加 temp_efd, ip_efd, load_efd
}
// 后台线程函数(简化版)
void* time_collector(void* arg) {
while (1) {
sleep(1);
uint64_t val = 1;
write(time_efd, &val, sizeof(val)); // 通知主线程
}
return NULL;
}
// 主事件循环
void run_event_loop() {
struct epoll_event events[4];
while (1) {
int nfds = epoll_wait(epoll_fd, events, 4, 1000); // 最多等 1s
if (nfds > 0) {
for (int i = 0; i < nfds; i++) {
uint64_t val;
if (events[i].data.fd == time_efd) {
read(time_efd, &val, sizeof(val));
ui_update_time(); // 只更新变化项
} else if (events[i].data.fd == temp_efd) {
read(temp_efd, &val, sizeof(val));
ui_update_temp();
}
// ... 其他
}
u8g2_SendBuffer(&u8g2); // 统一刷新,减少 I²C 通信次数
}
}
}
优势:
- 解耦:各采集任务独立运行,
ui_update_time()不再阻塞ui_update_temp();- 节能:
epoll_wait()在无事件时进入内核休眠,CPU 占用趋近于 0;- 精准:
ui_update_time()每秒触发一次,ui_update_temp()可设为每 2 秒,ui_update_load()每 5 秒,按需定制。
5.3 内存与 I²C 总线保护:u8g2_SendBuffer() 的调用频率控制
频繁调用 u8g2_SendBuffer() 会淹没 I²C 总线,尤其当 OLED 分辨率高(128x64)时,每次发送约 1KB 数据。实测在 RK3399 上,连续调用 u8g2_SendBuffer() 10 次/秒,I²C 总线利用率超 80%,可能导致其他 I²C 设备(如温湿度传感器)通信失败。
解决方案:双缓冲 + 去抖
c复制// ui.c 中新增
static uint8_t frame_buffer[1024]; // 128x64 / 8 = 1024 bytes
static bool buffer_dirty = false;
void ui_draw_str(int x, int y, const char* str) {
u8g2_SetDrawColor(&u8g2, 1);
u8g2_SetFontPosTop(&u8g2);
u8g2_DrawStr(&u8g2, x, y, str);
buffer_dirty = true;
}
void ui_flush_if_dirty() {
if (buffer_dirty) {
u8g2_SendBuffer(&u8g2);
buffer_dirty = false;
}
}
在 run_event_loop() 中,所有 ui_update_*() 函数内部调用 ui_draw_str(),最后统一调用 ui_flush_if_dirty()。这样,无论多少次 DrawStr,最终只触发一次 SendBuffer,I²C 负载降低 90%。
6. 从开发到部署:一键打包、权限固化与开机自启的工业级交付实践
6.1 构建可复现的部署包:make install 与 systemd 服务模板
开发完成只是起点。工业现场要求“拷贝即运行”,需将二进制、配置、启动脚本打包为单一目录。我们在 CMakeLists.txt 中添加安装规则:
cmake复制# CMakeLists.txt 末尾
install(TARGETS oled_demo
RUNTIME DESTINATION bin
)
install(DIRECTORY ${CMAKE_SOURCE_DIR}/config/
DESTINATION etc/oled-demo
FILES_MATCHING PATTERN "*.conf"
)
install(FILES ${CMAKE_SOURCE_DIR}/scripts/oled-demo.service
DESTINATION lib/systemd/system
)
配套 scripts/oled-demo.service:
ini复制[Unit]
Description=RK3399 OLED System Monitor
After=network.target i2c-dev.service
[Service]
Type=simple
User=root
WorkingDirectory=/opt/oled-demo
ExecStart=/opt/oled-demo/bin/oled_demo
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
构建部署包命令:
bash复制# 在 build/ 目录下
cmake -DCMAKE_INSTALL_PREFIX=/tmp/oled-deploy ..
make install
# 打包
tar -czf rk3399-oled-demo-v1.0.tar.gz -C /tmp/oled-deploy .
6.2 权限与设备节点固化:告别 sudo 与 usermod
生产环境严禁 sudo 运行应用。需通过 udev 规则永久赋予 i2c 和 netdev 权限:
bash复制# /etc/udev/rules.d/99-rk3399-oled.rules
KERNEL=="i2c-[0-9]*", GROUP="i2c", MODE="0660"
KERNEL=="network", GROUP="netdev", MODE="0660"
SUBSYSTEM=="thermal", KERNEL=="thermal_zone*", GROUP="i2c", MODE="0660"
然后执行:
bash复制sudo udevadm control --reload-rules
sudo udevadm trigger
这样,oled_demo 以普通用户运行即可访问所有设备,无需 sudo 或 usermod。
6.3 开机自启与日志追踪:systemd 的工业级运维保障
启用服务并查看日志:
bash复制sudo systemctl daemon-reload
sudo systemctl enable oled-demo.service
sudo systemctl start oled-demo.service
# 实时追踪日志(关键!)
sudo journalctl -u oled-demo
