first commit
This commit is contained in:
admin committed
commit
669f49b1d6
342 files changed
+320811
No files matched your search
@@ -0,0 +1,331 @@
|
||||
# PX3 地图拷贝功能流程图
|
||||
|
||||
## 1. 文档说明
|
||||
|
||||
| 项目 | 内容 |
|
||||
|---|---|
|
||||
| 适用工程 | `YX_MainInterface_ZhongQi` |
|
||||
| 适用平台 | Android 4.4 PX3 车机 |
|
||||
| 新流程适用范围 | PX3 且 eMMC 判定为 32G 的设备 |
|
||||
| 旧设备兼容 | 非 32G 设备继续使用原 TF 卡地图流程 |
|
||||
| 文档依据 | 2026-09-09 当前代码实现 |
|
||||
|
||||
本文档只描述当前有效的 ZIP 地图方案。Map 分区正式文件直接位于 `/mnt/map` 根目录，不再使用旧路径 `/mnt/map/amapauto9/amapauto9.zip`。
|
||||
|
||||
## 2. 固定路径
|
||||
|
||||
| 用途 | 当前路径 |
|
||||
|---|---|
|
||||
| U 盘地图压缩包 | `/mnt/usb_storage/amapauto9.zip` |
|
||||
| Map 导入临时文件 | `/mnt/map/amapauto9.zip.part` |
|
||||
| Map 正式地图压缩包 | `/mnt/map/amapauto9.zip` |
|
||||
| 内部地图目录 | `/mnt/sdcard/amapauto9/data/navi/compile_v2/chn` |
|
||||
| 内部语音目录 | `/mnt/sdcard/amapauto9/data/voice` |
|
||||
| 解压中标记 | `/mnt/sdcard/amapauto9/.yaxon_map_copying` |
|
||||
| 解压完成标记 | `/mnt/sdcard/amapauto9/.yaxon_map_complete` |
|
||||
| 旧设备 TF 卡地图 | `/mnt/external_sd0/amapauto9` |
|
||||
|
||||
ZIP 内只处理以下两个目录：
|
||||
|
||||
```text
|
||||
amapauto9/data/navi/compile_v2/chn/...
|
||||
amapauto9/data/voice/...
|
||||
```
|
||||
|
||||
## 3. 总体流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["设备启动"] --> B["BSP 挂载 tfcard 分区到 /mnt/map"]
|
||||
B --> C["设置 /mnt/map 属主 system:system 和权限 0770"]
|
||||
C --> D{"/mnt/map 挂载成功且 system UID 可写?"}
|
||||
D -- "否" --> E["U盘导入和Map删除不可执行<br/>提示检查Map分区挂载权限"]
|
||||
D -- "是" --> F["主界面和工程菜单可使用地图功能"]
|
||||
|
||||
F --> G{"入口类型"}
|
||||
G -- "点击导航" --> H["执行导航入口流程"]
|
||||
G -- "进入工程模式" --> I["执行地图数据管理流程"]
|
||||
```
|
||||
|
||||
## 4. 导航入口流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A0["主界面加载功能图标"] --> A1{"车辆配置是否有记录仪?"}
|
||||
A1 -- "否" --> A2["MAIN_ICON3或MAIN_ICON4<br/>当前不显示导航图标"]
|
||||
A1 -- "是" --> A3["MAIN_ICON或MAIN_ICON2<br/>显示导航图标"]
|
||||
A3 --> A["用户点击主界面导航图标"]
|
||||
A --> B{"是否为 PX3 + 32G eMMC?"}
|
||||
|
||||
B -- "否" --> C{"/mnt/external_sd0/amapauto9 是否存在?"}
|
||||
C -- "是" --> D["启动高德导航"]
|
||||
C -- "否" --> E["提示插入含离线地图的 TF 卡"]
|
||||
|
||||
B -- "是" --> F{"当前是否有地图任务正在执行?"}
|
||||
F -- "是" --> G["进入地图初始化页<br/>恢复并显示后台任务状态"]
|
||||
F -- "否" --> H{"内部地图快速检查是否可用?"}
|
||||
H -- "是" --> D
|
||||
H -- "否" --> I["进入地图初始化页"]
|
||||
|
||||
I --> J{"/mnt/map/amapauto9.zip 是否存在且非空?"}
|
||||
J -- "否" --> K["提示地图数据不可用<br/>联系服务人员"]
|
||||
J -- "是" --> L["自动启动 Map 到 sdcard 解压任务"]
|
||||
L --> M["显示初始化提示、进度条和百分比"]
|
||||
M --> N{"任务结果"}
|
||||
N -- "成功" --> O["显示初始化完成<br/>本次不直接打开导航"]
|
||||
N -- "失败" --> P["显示失败原因<br/>允许重试或返回"]
|
||||
N -- "用户返回" --> Q["可选后台运行、停止任务或继续等待"]
|
||||
```
|
||||
|
||||
当前代码的 32G 判定流程：
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["读取 /proc/partitions 中 mmcblk0 总块数"] --> B{"读取结果是否有效?"}
|
||||
B -- "是" --> C["块数乘1024，得到物理容量字节数"]
|
||||
B -- "否" --> D["读取 /sys/block/mmcblk0/size"]
|
||||
D --> E{"读取结果是否有效?"}
|
||||
E -- "是" --> F["扇区数乘512，得到物理容量字节数"]
|
||||
E -- "否" --> G["容量类型 UNKNOWN<br/>不进入32G内部地图流程"]
|
||||
C --> H{"容量是否在 24GiB 到 40GiB 之间?"}
|
||||
F --> H
|
||||
H -- "是" --> I["判定为 EMMC_32G"]
|
||||
H -- "否" --> J["继续判断8G范围或判定UNKNOWN"]
|
||||
I --> K{"Build.PRODUCT、DEVICE或MODEL 是否为 rkpx3?"}
|
||||
K -- "是" --> L["启用32G内部地图流程"]
|
||||
K -- "否" --> M["不启用内部地图流程"]
|
||||
```
|
||||
|
||||
物理容量首次读取成功后会缓存在进程内，后续判断不重复读取块设备节点。
|
||||
|
||||
内部地图快速检查条件：
|
||||
|
||||
1. 不存在 `.yaxon_map_copying` 未完成标记。
|
||||
2. `chn`、`voice` 目录存在。
|
||||
3. 核心文件 `chn/a0/m1.ans` 非空。
|
||||
4. `chn` 中存在区域目录，`voice` 中存在非空语音文件。
|
||||
5. Map 正式 ZIP 存在时，完成标记必须匹配 ZIP 的文件大小和修改时间。
|
||||
6. Map 正式 ZIP 不存在时，兼容旧设备已经存在的内部地图数据。
|
||||
|
||||
## 5. 工程模式入口流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["进入工程模式"] --> B{"是否为 PX3 + 32G eMMC?"}
|
||||
B -- "否" --> C["不显示 地图数据管理 入口"]
|
||||
B -- "是" --> D["显示 地图数据管理 入口"]
|
||||
D --> E["进入地图数据管理页"]
|
||||
E --> F["后台检测 eMMC、U盘、Map压缩包和内部地图状态"]
|
||||
F --> G{"选择操作"}
|
||||
|
||||
G --> H["从U盘导入到Map分区"]
|
||||
G --> I["删除Map分区地图"]
|
||||
G --> J["复制地图到sdcard目录"]
|
||||
G --> K["清除sdcard地图数据"]
|
||||
|
||||
H --> L["执行U盘导入流程"]
|
||||
I --> M["二次确认后删除正式ZIP和part文件"]
|
||||
J --> N["执行Map解压流程"]
|
||||
K --> O["二次确认后执行内部地图清理流程"]
|
||||
|
||||
L --> P["刷新页面状态"]
|
||||
M --> P
|
||||
N --> P
|
||||
O --> P
|
||||
```
|
||||
|
||||
工程页四项操作互相独立，不会自动串联。首次部署建议顺序为：
|
||||
|
||||
```text
|
||||
必要时删除Map分区旧地图
|
||||
-> 从U盘导入到Map分区
|
||||
-> 复制地图到sdcard目录
|
||||
```
|
||||
|
||||
## 6. 从 U 盘导入到 Map 分区
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["点击 从U盘导入到Map分区"] --> B{"设备是否为 PX3 + 32G?"}
|
||||
B -- "否" --> X1["提示仅支持32G设备"]
|
||||
B -- "是" --> C{"U盘是否已挂载?"}
|
||||
C -- "否" --> X2["提示先插入U盘"]
|
||||
C -- "是" --> D{"U盘根目录是否存在非空 amapauto9.zip?"}
|
||||
D -- "否" --> X3["提示未找到地图压缩包"]
|
||||
D -- "是" --> E{"Map正式ZIP或part是否已存在?"}
|
||||
E -- "是" --> X4["提示先删除Map分区旧数据"]
|
||||
E -- "否" --> F{"/mnt/map 是否为目录且可写?"}
|
||||
F -- "否" --> X5["提示Map分区不可写"]
|
||||
F -- "是" --> G["读取ZIP64中央目录"]
|
||||
|
||||
G --> H{"ZIP结构、白名单目录和核心文件是否合法?"}
|
||||
H -- "否" --> X6["提示地图压缩包无效"]
|
||||
H -- "是" --> I{"Map剩余空间 >= ZIP大小 + 32MiB?"}
|
||||
I -- "否" --> X7["提示Map分区存储空间不足"]
|
||||
I -- "是" --> J["流式复制到 /mnt/map/amapauto9.zip.part"]
|
||||
|
||||
J --> K["同步文件并校验源、目标大小"]
|
||||
K --> L["再次校验目标ZIP结构"]
|
||||
L --> M{"校验是否成功?"}
|
||||
M -- "否" --> N["删除part并返回失败"]
|
||||
M -- "是" --> O["同目录重命名为 /mnt/map/amapauto9.zip"]
|
||||
O --> P["显示导入成功"]
|
||||
|
||||
J -. "取消、拔出U盘或I/O异常" .-> N
|
||||
```
|
||||
|
||||
说明：`.part` 是正在复制的临时文件，校验成功后直接重命名为正式 ZIP，不会在 Map 分区长期保留两份完整压缩包。
|
||||
|
||||
## 7. Map 解压到 sdcard
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["导航页自动初始化<br/>或工程页点击复制地图到sdcard目录"] --> B["MapDataCopyService 接收任务"]
|
||||
B --> C{"是否已有地图任务运行?"}
|
||||
C -- "是" --> X1["拒绝重复启动并显示当前任务"]
|
||||
C -- "否" --> D["停止高德进程并等待文件释放"]
|
||||
D --> E{"高德是否已停止?"}
|
||||
E -- "否" --> X2["取消操作并提示失败"]
|
||||
E -- "是" --> F{"Map正式ZIP是否存在且非空?"}
|
||||
F -- "否" --> X3["提示Map地图源不存在"]
|
||||
F -- "是" --> G["读取ZIP64中央目录并生成白名单解压计划"]
|
||||
|
||||
G --> H{"压缩格式、路径和必需条目是否合法?"}
|
||||
H -- "否" --> X4["提示压缩包无效"]
|
||||
H -- "是" --> I["只处理 chn 和 voice 文件"]
|
||||
I --> J{"是否为未完成恢复或ZIP身份变化?"}
|
||||
J -- "是" --> K["受管文件全部重新解压"]
|
||||
J -- "否" --> L["目标文件大小相同则跳过<br/>缺失或大小不同则解压"]
|
||||
|
||||
K --> M["计算本次所需新增空间"]
|
||||
L --> M
|
||||
M --> N{"sdcard剩余空间 >= 新增空间 + 300MiB?"}
|
||||
N -- "否" --> X5["提示内部存储空间不足"]
|
||||
N -- "是" --> O["写入 .yaxon_map_copying 标记并同步"]
|
||||
|
||||
O --> P["按计划流式解压并实时校验条目大小和CRC"]
|
||||
P --> Q["每累计约512MiB执行批量sync"]
|
||||
Q --> R{"全部计划文件校验是否通过?"}
|
||||
R -- "否" --> X6["保留未完成状态<br/>返回失败或允许重试"]
|
||||
R -- "是" --> S["写入 .yaxon_map_complete 完成标记"]
|
||||
S --> T["删除 .yaxon_map_copying 并最终sync"]
|
||||
T --> U["任务进度置为100%并提示成功"]
|
||||
U --> V["后台重启高德进程<br/>使其重新初始化离线地图"]
|
||||
```
|
||||
|
||||
当前写入策略：
|
||||
|
||||
- 新增文件直接写正式目标，写入失败时删除不完整文件。
|
||||
- 覆盖已有文件时使用 `.yaxon_part` 临时文件，再重命名替换。
|
||||
- 解压过程边写边计算 CRC；完成前进度最高显示 `99.9%`，最终成功后显示 `100%`。
|
||||
- 当前差异计划以目标文件大小判断是否跳过；解压写入的文件会校验 ZIP 中记录的大小和 CRC。
|
||||
|
||||
## 8. 删除 Map 分区地图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["点击 删除Map分区地图"] --> B{"正式ZIP或part是否存在?"}
|
||||
B -- "否" --> C["提示Map分区无地图数据"]
|
||||
B -- "是" --> D["显示二次确认弹框"]
|
||||
D -- "取消" --> E["不做修改"]
|
||||
D -- "确认" --> F{"/mnt/map 是否可写?"}
|
||||
F -- "否" --> G["提示Map分区不可写"]
|
||||
F -- "是" --> H["删除 /mnt/map/amapauto9.zip"]
|
||||
H --> I["删除 /mnt/map/amapauto9.zip.part"]
|
||||
I --> J{"两个文件是否均已删除?"}
|
||||
J -- "是" --> K["提示删除成功"]
|
||||
J -- "否" --> L["提示删除失败"]
|
||||
```
|
||||
|
||||
该操作只删除地图正式 ZIP 和残留 `.part`，不会删除 `/mnt/map` 目录，也不会清理 Map 分区中的其他文件。
|
||||
|
||||
## 9. 清除 sdcard 地图数据
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["点击 清除sdcard地图数据"] --> B{"是否存在受管地图或语音数据?"}
|
||||
B -- "否" --> C["提示sdcard无地图数据"]
|
||||
B -- "是" --> D["显示慎重操作二次确认弹框"]
|
||||
D -- "取消" --> E["不做修改"]
|
||||
D -- "确认" --> F["停止高德进程并等待文件释放"]
|
||||
F --> G["写入未完成标记并同步"]
|
||||
G --> H["清空 chn 目录内容<br/>保留 chn 目录本身"]
|
||||
H --> I["清理 voice 中可重新导入的数据<br/>保留 voice 目录本身和指定配置"]
|
||||
I --> J["删除完成标记"]
|
||||
J --> K{"清理是否全部成功?"}
|
||||
K -- "否" --> L["保留未完成状态并提示失败"]
|
||||
K -- "是" --> M["删除未完成标记并最终sync"]
|
||||
M --> N["提示清理成功"]
|
||||
```
|
||||
|
||||
必须保留的语音内容：
|
||||
|
||||
```text
|
||||
/mnt/sdcard/amapauto9/data/voice/voice_conf
|
||||
/mnt/sdcard/amapauto9/data/voice/common.irf
|
||||
/mnt/sdcard/amapauto9/data/voice/isstts.cfg
|
||||
/mnt/sdcard/amapauto9/data/voice/xiaoyan.irf
|
||||
```
|
||||
|
||||
## 10. 后台任务和页面交互
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["Activity 发起地图操作"] --> B["绑定同进程 MapDataCopyService"]
|
||||
B --> C["Service 保证同一时刻只有一个地图任务"]
|
||||
C --> D["MapDataCopyManager 在工作线程执行文件操作"]
|
||||
D --> E["Service 保存操作类型、进度、字节数和结果快照"]
|
||||
E --> F{"用户操作"}
|
||||
|
||||
F -- "停留页面" --> G["页面持续刷新进度和提示"]
|
||||
F -- "按Home" --> H["Activity离开，Service继续后台执行"]
|
||||
F -- "再次进入" --> I["重新绑定Service并恢复当前快照"]
|
||||
F -- "按返回" --> J["弹框选择后台运行、停止任务或继续等待"]
|
||||
|
||||
D --> K{"任务完成时页面是否绑定?"}
|
||||
K -- "是" --> L["页面显示结果弹框并刷新状态"]
|
||||
K -- "否" --> M["Service 使用Toast提示后台结果"]
|
||||
```
|
||||
|
||||
页面进度回调按当前交互约定节流，最多约每 `500ms` 更新一次，减少主线程刷新开销。
|
||||
|
||||
## 11. 工程页状态显示
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
A["Map分区状态"] --> A1["无数据<br/>正式ZIP和part均不存在"]
|
||||
A --> A2["数据不完整<br/>存在part或正式ZIP小于7GiB"]
|
||||
A --> A3["数据完整<br/>正式ZIP不小于7GiB且无part"]
|
||||
|
||||
B["内部地图状态"] --> B1["无数据<br/>chn和voice无受管数据"]
|
||||
B --> B2["数据不完整<br/>有未完成标记或受管数据小于10GiB"]
|
||||
B --> B3["数据完整<br/>无未完成标记且受管数据不小于10GiB"]
|
||||
```
|
||||
|
||||
以上三态用于工程页面快速展示，不替代实际导入、解压时的 ZIP 结构、空间、文件大小和 CRC 校验。
|
||||
|
||||
## 12. BSP 前置条件与验证边界
|
||||
|
||||
BSP 侧目标启动顺序：
|
||||
|
||||
```rc
|
||||
mount ext4 /dev/block/platform/emmc/by-name/tfcard /mnt/map wait noatime nodiratime nosuid nodev noexec noauto_da_alloc,discard
|
||||
chown system system /mnt/map
|
||||
chmod 0770 /mnt/map
|
||||
```
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A["编译包含BSP修改的固件"] --> B["烧录boot或完整固件"]
|
||||
B --> C["重启设备"]
|
||||
C --> D["检查 /proc/mounts 中 /mnt/map 挂载来源和rw状态"]
|
||||
D --> E["检查 ls -ld /mnt/map 的属主和权限"]
|
||||
E --> F["使用系统应用执行U盘导入和删除"]
|
||||
F --> G["重启后再次复测，确认权限持续有效"]
|
||||
```
|
||||
|
||||
截至 2026-09-09，本次可访问的 BSP 文件
|
||||
`Z:\znzc\003_zhongqi\android4.4_rkpx3_zhongqi_pro\device\rockchip\rksdk\ZQ_PRO_32G\ZQ_PRO_32G_init.rc`
|
||||
仍保留两条 `/mnt/map` 挂载和 `start chmodmap`，尚未呈现上面的目标顺序。因此这里描述的是应用正常工作的前置要求，不表示该 BSP 修改已经进入源码或固件。
|
||||
|
||||
BSP 修改是否进入最终镜像、设备重启后 `/mnt/map` 是否仍可写，以及完整地图导入和解压结果，均必须以编译产物和真机日志为准。
|
||||
Reference in new issue
Block a user