STM32+LibHaru实战：为嵌入式设备生成加密PDF文件

1. 为什么要在STM32上生成加密PDF最近接了个智能水表项目客户要求设备能定期生成带加密的用水报告PDF。刚开始觉得在单片机上搞PDF简直是天方夜谭毕竟连Python生成PDF都要折腾半天。但实测下来用STM32F4系列配合LibHaru完全可行RAM占用控制在30KB以内加密性能比预想的流畅得多。传统嵌入式设备记录数据都是直接存TXT或CSV但遇到这三种情况就抓瞎了需要专业排版比如发票、报告防止数据被篡改比如医疗设备记录跨平台查看手机/PC都能直接打开LibHaru这个开源库正好解决了这些问题。它用纯C编写不依赖外部库特别适合移植到STM32。我实测F407ZGT6192KB RAM跑起来毫无压力生成10页PDF只要3秒AES-128加密额外消耗不到1秒。2. 环境搭建与库移植2.1 硬件选型要点先说说我的硬件配置主控STM32F407ZGT6192KB RAM/1MB Flash存储MicroSD卡FAT32格式开发环境Keil MDK-ARM V5关键指标验证RAM占用实测生成PDF时峰值占用28.7KB包含FATFS缓冲区Flash占用LibHaru库编译后约86KB开启加密功能生成速度平均每页300ms含中文渲染如果手头只有F103系列建议选C8T664KB RAM以上型号且需要做以下优化关闭LibHaru的调试输出减少PDF页面对象缓存数量使用更小的FATFS缓冲区512字节2.2 源码移植实战从GitHub下载最新版LibHaru当前2.4.4git clone https://github.com/libharu/libharu移植关键步骤删除所有与Linux系统调用相关的文件如hpdf_utils.c替换内存管理接口// 替换原生的malloc/free #define HPDF_Malloc(size) my_malloc(size) #define HPDF_Free(ptr) my_free(ptr)修改文件操作接口HPDF_File_Rec { FIL fp; // 替换为FATFS的文件句柄 };遇到最头疼的问题是时间函数依赖。解决方案是在hpdf_utils.c里硬编码时间HPDF_GetCurrentDateTime() { HPDF_DateTime dt {2023,1,1,0,0,0}; // 按实际需求修改 return dt; }3. PDF加密功能实现3.1 加密参数配置LibHaru支持两种加密方式标准加密RC4-40bit强加密AES-128bit推荐使用AES加密配置示例HPDF_SetPassword(pdf, owner_pwd, user_pwd); HPDF_SetEncryptionMode(pdf, HPDF_ENCRYPT_R3, 16); // AES-128权限控制参数权限标志位功能说明HPDF_ENABLE_READ允许打印HPDF_ENABLE_PRINT允许内容复制HPDF_ENABLE_COPY禁止修改文档结构实测发现个坑如果只设置用户密码Adobe阅读器仍然会要求输入所有者密码。建议两个密码都设置哪怕设成相同的。3.2 内存优化技巧在hpdf_conf.h里调整这些宏#define HPDF_DEF_PAGE_NUM 5 // 减少预分配页面数 #define HPDF_DEF_PAGE_OBJS 10 // 降低对象缓存 #define HPDF_USE_UNICODE 0 // 关闭Unicode支持如需中文必须开启特别提醒开启中文支持时需要额外引入字体文件约60KB建议用外部Flash存储字体库。4. 完整开发流程演示4.1 工程配置在Keil中添加这些源文件src/ ├── hpdf_doc.c ├── hpdf_page.c ├── hpdf_font.c └── hpdf_encrypt.c # 加密核心模块必备的FatFS配置#define _USE_LFN 1 // 启用长文件名 #define _CODE_PAGE 936 // 中文编码支持4.2 生成加密PDF示例完整代码框架void generate_pdf() { HPDF_Doc pdf HPDF_New(error_handler, NULL); // 设置加密 HPDF_SetPassword(pdf, 123456, NULL); HPDF_SetPermission(pdf, HPDF_ENABLE_READ); // 添加页面 HPDF_Page page HPDF_AddPage(pdf); HPDF_Page_BeginText(page); // 写入内容 HPDF_Page_TextOut(page, 50, 750, 设备序列号: STM32F407-001); HPDF_Page_TextOut(page, 50, 730, 生成时间: 2023-08-20); // 保存到SD卡 FIL file; f_open(file, report.pdf, FA_WRITE | FA_CREATE_ALWAYS); HPDF_SaveToStream(pdf); while(HPDF_Stream_Size(pdf) 0) { HPDF_BYTE buf[128]; HPDF_UINT len 128; HPDF_Stream_Read(pdf, buf, len); f_write(file, buf, len, NULL); } f_close(file); HPDF_Free(pdf); }4.3 性能优化建议流式写入对于大文件建议分块写入SD卡避免内存爆满字体精简只嵌入使用的字符集通过HPDF_UseCNTFonts对象复用重复使用HPDF_Image等对象减少内存分配我在项目中发现提前计算好文本占位可以节省30%内存。比如中文字符按3字节计算英文字符按1字节这样能精确控制缓冲区大小。5. 常见问题解决方案问题1编译时报错undefined reference to __aeabi_assert解决方法在Keil的Target Options中勾选Use MicroLIB问题2生成的PDF在电脑上打不开检查步骤确认文件头写入正确%PDF-1.4验证文件结束符%%EOF用二进制工具查看SD卡实际写入内容问题3加密后文件大小激增优化方案设置HPDF_SetCompressionMode(pdf, HPDF_COMP_ALL)避免频繁切换绘图状态最近帮客户调试时遇到个奇葩情况某品牌SD卡在FATFS写入超过4KB就会丢数据。后来换成三星EVO卡问题消失建议选择工业级TF卡。6. 进阶开发技巧6.1 动态内容生成结合FreeRTOS可以实现在线PDF生成void pdf_task(void *pv) { while(1) { if(xQueueReceive(data_queue, sensor_data, portMAX_DELAY)) { HPDF_Page_TextOut(page, x, y, sensor_data.value); x 50; // 自动换行 if(x 500) { x50; y-20; } } } }6.2 二维码集成通过移植qrcodegen库实现HPDF_Image_AddQRCode(pdf_page, x, y, size, https://example.com);实测在F407上生成QR码约需80ms比预想的快很多。注意调整纠错等级建议用LOW级别节省资源6.3 多语言支持中文显示解决方案将.ttf字体文件转换为C数组通过HPDF_LoadTTFontFromFile加载设置编码为GB2312我整理了个简宋体精简字库包含3500常用汉字体积从3MB压缩到128KB需要可以私信我发你。