|
|
# 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计算机视觉库 |