MainCar - 主车远端服务程序

• 本程序用于嵌入式比赛中Android部分识别/控制相关功能的实现。
• 程序最初版写于2022-09
• 作者：UnknownObject； 技术支持：UnknownNetworkService

使用和后续开发说明

1. 本程序在开发时（2022-09）使用的SDK/NDK/Gradle版本是最新的，后续开发时注意随时更新版本并记录在本文档中：
   • Target SDK版本：32
   • Compile SDK版本：32
   • Min SDK版本：26
   • Gradle Plugin版本：7.2.1
   • Gradle版本：7.3.3
   • Android Studio IDE版本：2021.2.1
2. 本程序识别与图像处理相关功能均使用C/C++以原生库的形式实现
3. 部分算法/库文件引用（或改编、合并、抽取）自其他第三方库，尽可能地不要改动它们
4. 如有项目结构/用法上的更新，记得更新这个文档

项目结构简述

源代码

• cpp -> 所有的C/C++源代码文件
  • lib_hyper_lpr -> 开源库HyperLPR的导出，用于进行车牌识别
    • include -> HyperLPR头文件
    • src -> HyperLPR源文件
    • javaWarpper.cpp -> HyperLPR中负责提供Java接口的文件
  • lib_serial_port -> 从Google示例中抽取的串口通信库
  • opencv_libqr -> 从OpenCV源代码中提取并改写的多个二维码检测/分离库
  • CMakeLists.txt -> 用于CMake编译的工程文件，记录着所有的原生库信息和如何进行编译
  • car_license.h/car_license.cpp -> 基于模板匹配的车牌识别
  • car_license_ocr.h/car_license_ocr.cpp -> 基于OCR的车牌识别（图像预处理部分）
  • color_reco.h/color_reco.cpp -> 颜色识别库（仅作为形状颜色识别的子库使用，无除自检外的Java接口）
  • debug_logger.h -> 用于调试的原生库日志再封装
  • env_test.cpp -> NDK编译与原生OpenCV自检库，用于检查库是否正确导入及NDK动态库是否能正常加载
  • image_processor.h/image_processor.cpp -> 形状颜色和交通标志识别的图像预处理库（仅作为子库使用，无除自检外的Java接口）
  • main_car_aes.h/main_car_aes.cpp -> 数据处理算法库，这个库中的内容需要根据比赛时的算法现场编写
  • ocr_text.h/ocr_text.cpp -> OCR（光学字符识别）的图像预处理库
  • opencv_support.h/opencv_support.cpp -> 图像格式转换库，提供Android中Bitmap与OpenCV中Mat的互相转换
  • public_types.h/public_types.cpp -> 识别中使用到的类/结构体/枚举类型的定义
  • qr_code_decode.h/qr_code_decode.cpp -> 二维码识别的图像预处理和切分
  • shape_color_reco.h/shape_color_reco.cpp -> 形状颜色识别
  • shape_reco.h/shape_reco.cpp -> 形状识别库（仅作为形状颜色识别的子库使用，无除自检外的Java接口）
  • traffic_light.h/traffic_light.cpp -> 交通灯识别
  • traffic_sign.h/traffic_sign.cpp -> 基于模板匹配的交通标志识别
• java -> 所有的Java源代码文件
  • com.uns.maincar -> 主包名
    • communication -> 通信相关代码
      • CommandEncoder -> 指令编码类
      • CommandDecoder -> 指令解码类
      • DataTransferCore -> 通信接口，定义了基本的通信函数
      • SerialPortTransferCore -> 通信接口的实现类，实现了串口通信
      • WifiTransferCore -> 通信接口的实现类，实现了Wifi通信
    • constrants -> 常量和枚举类型定义
      • Commands -> 与主车通信的指令定义
      • Flags -> 主/从车的移动控制指令和一些其他的常量
      • GlobalColor -> 颜色种类的枚举类型
      • GlobalShape -> 形状种类的枚举类型
      • GlobalSignType -> 交通标志种类的枚举类型
    • cpp_interface -> 原生库对应的Java接口类
      • hyperlpr -> HyperLPR的接口库
        • DeepAssetUtil -> HyperLPR资源管理接口
        • PlateRecognition -> HyperLPR识别接口
      • CarLicense -> 车牌识别接口类，包含模板匹配、OCR、HyperLPR三种识别方式
      • EnvTest -> 自检接口类，包含了全部的原生库自检
      • MainCarAES -> 数据处理算法接口类
      • OCR -> OCR接口类，提供静态文本识别功能并对基于OCR的车牌识别提供支持
      • QRDecode -> 二维码识别接口类，提供单个/多个二维码识别功能
      • ShapeColor -> 形状颜色识别接口类
      • TrafficLight -> 交通灯识别接口类
      • TrafficSign -> 交通标志识别接口类
    • gui -> 图形用户界面（Activity）
      • MainActivity -> 程序主界面和初始化
      • MovementController -> 主车和从车的移动控制（警告：该功能并不完善，仅供调试及娱乐用途）
      • PermissionGetter -> 外部存储权限获取
    • tools -> 一些工具类
      • ImageReleaser -> 车牌和交通标志的模板图释放类
      • OCRDataReleaser -> OCR训练模型释放类
      • TextFilter -> 文本过滤器

资源文件

• assets
  • lpr -> HyperLPR的资源文件
• res
  • drawable
    • cl_x.jpg -> 车牌识别的字符模板
    • tf_x.jpg -> 交通标志识别的模板
    • ocr_self_test.png -> OCR自检图片
    • qr_decode_test -> 二维码识别自检图片
  • raw
    • chi_sim.traineddata -> 简体中文OCR模型
    • eng.traineddata -> 英文（和数字）OCR模型

第三方库

• libs
  • camerautil.jar -> 百科融创摄像头操作库
  • zxingcpp-release.aar -> ZXing二维码识别库
• opencv -> OpenCV计算机视觉库