Readme.md 77 KB

20261110

#define APP_VERSION "2.8.39" 景深融合选帧改为"积分最大连续高分段" + SLView 分支补亚像素平移配准

1) 选帧逻辑失效:融合结果比单帧还糊(src/cameramanager.cpp selectFuseFrames)

  · 现象:现场融合图细节糊成一片、背景灰雾,实测融合质量低于"直接用最清晰单帧"。
  · 根因:旧实现 = 从全局 argmax 向两侧扩展到"低于 2×median"为止,段长 <3 时
    回退成"中心帧邻域 0,-1,+1,…"。
    本样本(record_20261110093317)的 slview 评分曲线是"主峰 + 末端孤立尖刺":
      #140:0.82 → #166:1.648(峰) → #187:0.39 → #198:1.648
    #198 与 #166 的焦点图相关系数 0.9913,是同一焦面的重复帧。
    阈值 2×median=0.948 只有 #198 自己超过 → 含 argmax 的段长 1 < 3
    → 走中心邻域回退,选中 [#198,#197,…,#187]。
    这批帧相对峰值的评分 = [1.00, 0.337, 0.337, …, 0.415],
    即"1 张清晰帧 + 11 张离焦帧"一起加权平均。
  · 修复:改为在"评分 ≥ ratio×峰值"的连续段里取**段积分(Σscore)最大**的一段。
    · 积分同时惩罚"段太窄"与"评分低",比"围绕 argmax 取邻域"稳健;
    · 末端孤立尖刺的积分远小于主峰段 → 天然排除,不再需要"回退到中心邻域"分支;
    · ratio 从 0.97 往下降,取到第一个"段长 ≥6"的就停,避免一路放宽到全段;
    · 段长超 maxFrames 时等步长抽样,首尾都取到。
    同一数据集实测选出 [162..169](8 帧,评分均为峰值 95%~100%)。
  · 附带改动:删除已无用的 medianOf();补 #include <algorithm>/<cmath>/<vector>。
  · fuseRawVideoFrames 的 center 参数改注释说明:只用于异常兜底,
    不再强行把评分峰值帧塞进融合集合(否则又退化成"清晰帧+离焦帧"混合)。

2) SLView 融合分支缺配准(src/m_opencv.cpp 新增 alignTranslationSLView)

  · 根因:fuseAdvanced 的旧 AGD 分支有 ECC 配准(warpToReference),
    但 focus_algo=0/1 走的 SLView 分支完全没有配准。
    Z 扫描期间载物台/导轨存在横向漂移,本样本实测:
      旧选帧 187-198 区间最大漂移 2.83px
      跨段 150-198 最大漂移 3.98px
    不配准会让"逐像素选最清晰帧"的权重边界与物体边缘错开,
    边缘被多帧平均、细节抹平 —— 这是"融合比单帧还糊"的第二个来源。
  · 实现:只解 2 自由度平移(显微 Z 扫描的漂移主要是机械回程/导轨间隙,
    尺度与旋转可忽略;只做平移不引入额外重采样误差)。
    · 参考帧 = 清晰度最高的一帧(Laplacian 方差,缩图上算)→ 保持观感锚点不变;
    · 配准图长边限制 512px,Hann 窗抑制边界不连续污染互功率谱;
    · 位移 > 24px 或响应 < 0.05 判为失败,跳过该帧不中断融合;
    · 位移 < 0.6px 不重采样(省一次插值、避免无谓软化)。
  · 位移符号约定(已用合成图验证:内容平移 (+5,+3) → phaseCorrelate 返回
    (-4.99,-3.07);用 M=[[1,0,dx],[0,1,dy]] + WARP_INVERSE_MAP 回贴残差 0.33,
    反向则 17.4):M 的平移分量直接取 phaseCorrelate 返回值并加 WARP_INVERSE_MAP。
  · 实测作用域:新选帧 162-169 区间漂移仅 0.14px → 自动跳过,不引入插值软化;
    旧选帧 187-198 漂移 2.83px → 真正生效。属于"宽段自动保护、窄段零成本"。

3) PC 实测(record_20261110093317,2592x1944 BayerGR8,199 帧)

  评价指标:Q^AB/F(Xydeas-Petrovic 梯度保真度,同时惩罚细节丢失与伪造边缘)
            固定参考帧集 = 155..177 每 2 帧,保证分数可横比。
  均不后处理:
    单帧 #167        Q=1.8954  背景std=4.03  bg≥245=76.1%
    旧链路 187-198   Q=1.8302  背景std=4.10  bg≥245=74.8%   ← 低于单帧(融了不如不融)
    新链路 162-169   Q=1.9003  背景std=4.00  bg≥245=75.8%   ← 高于单帧
  均走 finishFusionImageClassic(2.0,3.0,0):
    单帧 #167 + 后处理   Q=1.8443  lapvar=157.1
    旧链路 + 后处理      Q=1.7772  lapvar=178.8
    新链路 + 后处理      Q=1.8500  lapvar=193.7   (相对旧链路 Q +4.1%、lapvar +8.3%)
  说明:Q 会惩罚锐化过冲,所以"后处理版"的 Q 低于"未后处理版"是正常的;
        后处理版之间横比才有效。
  · 纯黑像素:三种方案均为 0(finishFusionImageClassic 末尾的 repairDarkSpots 兜底)。
  · 后处理参数未改动:仍按现场指定 unsharpMask(2.0,3.0) + enhanceContrast(0),
    不重复叠加,fuseAdvanced 内部只做这一次。

4) 验证脚本(不入库,仅本地复盘):Test/fusion_lab/

  · rawv_io.py        读 .rawv;Bayer 必须用 XX2RGB 口径(与 cameramanager.cpp
                      decodeRawBufferToBgr 一致),用 XX2BGR 会导致 R/B 颠倒、
                      孢子由金褐变青蓝。
  · verify_applied.py 端到端复刻修改后的链路(选帧→配准→GFF→后处理)
  · verify_fair.py    公平基线 + 配准作用域(漂移 vs 帧区间)
  · test_select.cpp   选帧函数的独立编译+6 个场景行为校验
  · qabf.py / evaluate2.py  Q^AB/F 与 SSIM 评价实现

20261109

#define APP_VERSION "2.8.38" 融合开关/保留录像开关移入密码解锁区 + 修复开关显示与融合状态不一致

13) 融合开关显示与实际状态不一致(header/cameramanager.h、src/cameramanager.cpp)

  · 原因:fusionEnabled 的 getter 直接读 param::fusion_enable,而 MQTT(fusion_sw)、
    启动读库这两条路径改 param 时不会发任何信号 → QML 绑定不会重新求值,
    按钮/开关停在旧状态,状态串里的"融合:开/关"却是新值。
  · 修复:Frames 增加界面状态副本 m_fusionEnabled:
    · setFusionEnabled 同时写 param::fusion_enable 与 m_fusionEnabled 并发信号;
    · onFPSUpdated(约 1s 一次)里对齐一次 param 值,发现变化就
      QMetaObject::invokeMethod(..., Qt::QueuedConnection) 回主线程 emit
      fusionEnabledChanged(onFPSUpdated 可能在取流线程被调,QML 绑定必须在主线程刷新);
    · getter 改为返回 m_fusionEnabled。

14) 开关移入密码解锁区(qml/pages/TestPage.qml)

  · 删除画面左下角叠加的两个胶囊按钮。
  · 改为"高级控制"(密码 666888 解锁后 visible: motorUnlocked)里的两个 AppSwitch:
    "景深融合"、"保留录像(调试)",与电机控制同处一屏。
  · AppSwitch 不用 checked: frames.xxx 单向绑定(用户点开关时控件内部会给 checked 赋值、
    绑定被打断,之后 MQTT 改状态同步不回来),改为
    Component.onCompleted 赋初值 + onToggled 写回 + Connections 回灌。

20261109

#define APP_VERSION "2.8.37" 测试页新增融合开关按钮 / 临时调试按钮(保留录制帧)

11) 融合开关按钮(qml/pages/TestPage.qml、header/cameramanager.h、src/cameramanager.cpp)

  · Frames 新增 Q_PROPERTY bool fusionEnabled(READ fusionEnabled / WRITE setFusionEnabled /
    NOTIFY fusionEnabledChanged),读写的就是 param::fusion_enable ——
    与 MQTT fusion_sw 下发的是同一个运行时开关,processRecordedVideo 里判它:
    关掉时跳过景深融合、只保留最清晰帧,仍照常入库/上传。
  · 按钮只改内存值,不写 sqlite(现场临时切换用,重启后仍按库里/MQTT 的值)。
  · 位置:相机画面左下角,绿色"融合:开" / 红色"融合:关"。

12) 临时调试按钮:保留录制帧(同上三个文件)

  · Frames 新增 Q_PROPERTY bool debugKeepRecord(READ debugKeepRecord /
    WRITE setDebugKeepRecord / NOTIFY debugKeepRecordChanged),成员 m_debugKeepRecord
    默认 false,只存内存,不写库,重启复位。
  · handleRecordStop 里删除 rawv 前先判它:打开时只打
    "调试模式已开启,保留录制文件:..." 不执行 QFile::remove,便于复盘
    "哪一帧/清晰度对应哪个位置"。
  · 位置:融合按钮下方,黄色"保留录像:开" / 灰色"保留录像:关",默认关。

20261109

#define APP_VERSION "2.8.36" 录制完成当前帧再回复清晰度 / 融合后处理改为 unsharpMask(2.0,3.0)+enhanceContrast(0)

9) 先落盘、后算清晰度(header/cameramanager.h、src/cameramanager.cpp)

  · 之前 onMovDone 的顺序是:取预览帧 m_frame → Tenengrad 算清晰度 → 写 rawv → 回 focus。
    清晰度是拿"此刻最新的预览帧"算的,而写进 rawv 的是 m_afStepFrame,
    两者可能不是同一帧(取流线程在两者之间又更新了一帧),
    主板据此选最佳位置、判清晰度波动(阈值 100)都会失真。
  · 现在:
    a) processFrameAsync 录制期间除缓存原始帧 m_afStepFrame 外,同时缓存同一次取流循环的
       显示帧 m_afStepDisplay(converted 是每帧新建的 Mat,这里只是引用计数 +1,不拷贝像素);
    b) recordStepFrame(int timeoutMs, cv::Mat *displayOut) 在同一把 m_frameMutex 里取
       原始帧与显示帧,落盘成功后把该显示帧带回;
    c) onMovDone 先 recordStepFrame(内部已等真正落盘),**之后**才用带回的那一帧算
       Tenengrad 并回复 focus。未录制时仍用最新预览帧。
  · 效果:回复给主板的清晰度 = 刚刚写进 rawv 的那一帧,一步一帧严格对应。

10) 融合结果后处理改为现场指定链路(src/m_opencv.cpp finishFusionImage)

  · 现场口径:
       cv::Mat fused_sharp     = unsharpMask(image, 2.0, 3.0);
       cv::Mat Contrast_Image  = enhanceContrast(fused_sharp, 0);
  · 原来 finishFusionImage 是自研的"抗光晕限幅锐化(1.0/1.6) + 高光软膝 + CLAHE 半混(0.55)",
    锐度与对比度都偏软;现直接委托 finishFusionImageClassic(src, 2.0, 3.0, 0),
    避免两份实现各改一半后漂移(多图融合路径本来就调用它)。
  · 末尾仍保留 repairDarkSpots()(只抬亮、不会压暗),用于清理输入帧自带的坏点/黑块。
  · 代价(PC 暗场样本实测):边缘暗侧过冲 0 → 881px、死白 1026 → 3502px,
    即不再有抗光晕保护。若现场觉得黑边/死白明显,把 finishFusionImage 换回旧实现即可。

20261107

#define APP_VERSION "2.8.35" 步进扫描每步只录一帧 / 取消 32 位网格 / 上传进度改弹出进度条 / 界面显示已录制帧数 / FTP 上传显式建目录 / 修复上传进度不显示

1) 每步只录一帧(header/cameramanager.h、src/cameramanager.cpp)

  · 现象:移动 100 步写出 200 帧。
  · 原因:主板每次移动完成发 movy(带步号),但 focus 超时补发(hmi.c/control.c,
    超时 5s、最多补发 3 次)、重包等会让同一步号的 movy 再次到达,照单全收就多写一帧。
  · 修复:onMovDone 按步号去重,同一步号只落一帧,但仍然照常回 focus(不回会让主板
    继续补发,越补越多)。步号 1 额外加 15s 时间窗:新一轮扫描时 g_laf.step_cnt 从 0
    重新计数,只比步号会吞掉新一轮的第一帧。

2) 已录制帧数(header/cameramanager.h、src/cameramanager.cpp、qml/pages/TestPage.qml)

  · Frames 新增 Q_PROPERTY int recordedFrames + recordedFramesChanged();
    startRecord 清零,recordStepFrame / enqueueRecordFrame 每写一帧 +1。
  · TestPage 画面上新增"已录制帧数: N (录制中)",用于现场核对"N 步是否只录了 N 帧"。

3) 取消 32 位网格(qml/pages/PhotostitcherPage.qml)

  · 原为固定 8列×4行=32 格蛇形网格(右上角为 1),缺的位置显示"缺图"。
  · 现只显示真实存在的图片,不再预置 32 格;有序号的按序号升序,无序号(时间戳命名)
    按名称先后追加在末尾。序号角标保留。

4) 图片上传改为弹出式进度条(qml/pages/TestPage.qml)

  · 删除画面上叠加的上传进度圆 uploadSlot / 状态文字 uploadStatusSlot,
    fps 文字恢复占满整行宽度。
  · 新增 Popup + ProgressBar(居中偏上弹出,显示"上传中/完成/失败 + 文件名 + 百分比"),
    成功后 1.5s、失败后 5s 自动收起,点击弹层可立即关闭。

5) 修正画面信息文字挤在一起(qml/pages/TestPage.qml)

  · 原来 fps 单独放在 Row 里且 width: parent.width,Row 的宽度又来自子项,形成循环依赖,
    Row 高度解算不稳定,清晰度/帧数用 anchors.top 叠在它下面就会叠到一起。
  · 改为一个 Column 统一纵向排列(显式宽度 parent.width - dp(44)、spacing dp(4)、
    左边距/上边距各 dp(6)/dp(8)),子项宽度绑定 Column 宽度不再回退到自身;
    三行文字加 elide: Text.ElideRight,长文本不会顶出画面。

6) 录制改为"完全按串口信号存帧",彻底去掉持续录制(src/cameramanager.cpp、header/cameramanager.h)

  · 之前的实现是:非步进时由取流线程逐帧 enqueueRecordFrame() 写盘(持续录制),
    只有步进模式才按 movy 存帧。这与实际用法不符。
  · 现在取流线程一律不写盘:录制期间只把"最近一帧相机原始帧(Bayer8/YUYV)"缓存在
    m_afStepFrame 里;主板每移动到位、串口发来 movy,才由 onMovDone -> recordStepFrame()
    把这一帧写进 rawv 并等落盘,写完再回 focus。
  · 因此 rawv 里严格"一个位置一帧",与移动步数 1:1;删除 enqueueRecordFrame(),
    recordedFrames 只在 recordStepFrame() 里 +1;stopRecord 诊断日志改为
    "取流帧数 / 平均帧间隔 / 缓存耗时 / 转换耗时 / 实际写入帧数"。

7) FTP 上传路径改为平面目录(src/app_curlFunc.cpp、header/app_curlFunc.h、src/ImageStitcher.cpp)

  · 正确路径:ftp://8.136.98.49/photo_hard/<imei>/xxx.jpg
    即所有图片直接放在 photo_hard/<imei>/ 下,不再按本地归档创建 yyyyMMddhhmmss 子目录,
    也不建年/月/日层级(本地 Pictures/yyyy/MM/dd/<ts>/ 归档照旧,互不影响)。
  · 改动:performUpload 的 ftpSubDir 推导整段删除(含 archiveSubDir lambda),
    URL 改为 ftp://host/<remotePath>/<文件名>;parentPath 参数保留但不参与路径拼接;
    ImageStitcher 的融合图上传同样去掉 <ts> 子目录。
  · 目录创建:新增 CurlFtpUploader::ensureRemoteDir(),上传前按层级显式 MKD
    (/photo_hard → /photo_hard/<imei>),已存在报错忽略,m_createdDirs 缓存只建一次;
    兜底 CREATE_MISSING_DIRS 改为 CURLFTP_CREATE_DIR_RETRY(2)。
  · 日志:FTP建目录成功/返回 xxx、FTP上传目标: ftp://.../photo_hard/<imei>/xxx.jpg 可直接核对。

8) 修复"上传进度不显示"(qml/pages/TestPage.qml)

  · 上传进度 Popup 里用的是 page.uploadPercent / page.uploadFailed /
    page.uploadFileName / page.uploadWatermarkVisible,但 AppPage 根元素原来没有 id,
    `page` 是未定义标识符 → 绑定报 ReferenceError,visible 恒为 false,弹层永远不出现。
  · 修复:根元素加 id: page。

20261106

#define APP_VERSION "2.8.30" 修复"主板 OTA 升级完成后 MCU 版本号不变":下载的固件与发给主板的固件不是同一个文件

1) 根因:main.cpp 的 updateStm32() 把 FTP 下载的 .rbl 保存到

  <GenericDataLocation>/Android/data/com.yfkj.bzyv1/files/rtthread.rbl,
  而 downloadFinished 与 mserial.cpp 里传给 ymodem 的路径是
  <GenericDataLocation>/rtthread.rbl(存储卡根目录)。
  两者不是同一个文件,实际发出去的一直是根目录下历史遗留的旧包(日志里 209908 字节那个)。
  主板 bootloader(CBD_FOTA_BootLoader/rt_fota.c)只比对 RBL 头里的 download_version
  与当前运行版本,相同就打印 "No upgrade: fm_area[x] == app[x]" 直接跳过搬运,
  所以流程"走完"、不报错,但 MCU 版本号不变。

2) 修复:header/main.h 新增唯一入口 otaFirmwarePath() + BZY_APP_FILES_DIR,

  main.cpp(updateStm32 下载落盘、downloadFinished)与 mserial.cpp(主板 system will update)
  三处全部改用该函数,保证"下载的文件"就是"发送的文件"。

3) 两处触发点补日志:LOG("FilePath is: ... (exists= size=)"),

  升级时先看这一行,size 必须等于 FTP 上 Application_BZYV2.rbl 的字节数。

4) 注意:改后存储卡根目录的 /storage/emulated/0/rtthread.rbl 不再被使用,建议删除;

  升级前必须先完整下载一次新包(旧包留在私有目录里也不会被当成新包,
  主板按 RBL 头版本判定,版本没变依旧会 No upgrade)。

20261106

#define APP_VERSION "2.8.29"

对焦改为"主板线性步进 + 工控机逐位置记录帧"的握手模式,并修复清晰度值不显示

1) 修复界面清晰度值 photoclarity2_text 一直不显示(TestPage.qml):
   Row 会接管子项的 x/y,在 Row 内部写 anchors.top 被忽略,且 width: parent.width
   在 Row 内形成循环依赖,宽度被解成 0 与 fps 文字重叠。改为把该 AppText 移出 Row,
   锚定到状态行(新加 id: textRow)下方,宽度取父容器减进度圆宽度;
   onMovDone 里补 emit qulityStringChanged(),每步都刷新显示。

2) 帧率太慢/对焦慢:改为线性步进扫描(主板 hmi.c,AF_LINEAR_EN=1)
   - Y 轴初始化(下行到接近位)完成后,每次向下移动 AF_LINEAR_STEP=10 个脉冲;
   - 每步移动完成发 movy(带步号),工控机记帧后再回 focus 放行;
   - 清晰度出现过上升后,连续下降 AF_LINEAR_FALL_STOP=10 步判定越峰结束;
   - 最多移动 AF_LINEAR_MAX_STEP=100 步;结束后回最佳位置并上报 auto_focus;
   - 线性模式下跳过原来的预对焦(slide_pre_focus)与多阶段爬山;
   - 把 AF_LINEAR_EN 改成 0 即恢复原多阶段爬山实现。

3) 工控机侧按握手记录帧到 rawv(cameramanager.h/cpp)
   - 扫描期间不再按帧率逐帧写盘,取流线程只缓存最近一帧原始帧(m_afStepFrame);
   - onMovDone 收到 movy 后调用 recordStepFrame():通过 RawRecordWriter
     新增的 enqueueAndWait() 同步写一帧并等到真正落盘(AF_STEP_RECORD_TIMEOUT_MS
     =3000ms,超时仍回 focus),确认后才回 focus 让主板继续;
   - saveMatAsJpeg 进入步进记录模式(m_afStepRecord),并抑制 record_start,
     避免主板再走自己的"长时间下行录制"行程与步进互相打架;
   - 每步续期录制看门狗,语义变为"本步最长等待时间"(RECORD_TIMEOUT_MS=10s);
   - 新增 autoFocusDone -> handleRecordStop 连接:主板扫描结束即刻收尾,
     不再白等 10 秒看门狗。

4) 两侧超时兜底
   - 主板:focus 等待 AF_FOCUS_TIMEOUT_MS=5s,补发当前步号,重试
     AF_FOCUS_RETRY_MAX 次仍无回复则中止对焦、关灯、autotakepic=0 退出任务;
   - 工控机:看门狗超时 -> 结束录制并走分析/融合/上传流程退出任务。

20261106

#define APP_VERSION "2.8.28"
改为单点采集:只拍一个位置,不再执行 32 格滑台扫描

cameramanager.cpp 的 Frames::mov_x_z_run() 开头增加单点开关
(enableMultiPositionScan = false,默认关闭):
   原逻辑是 z0..z3 × x0..x7 共 32 格蛇形扫描,每保存一张图就向主板下发
   一条 movz/movx 移轴指令,主板跟随指令一路走完 32 个位置;
   现在拍照与录制融合完成后都不再下发移轴指令,z_step/x_step 恒为 0,
   所有图片文件名固定为 z0x0,滑台停在当前位置不动。
   拍照数量(camera 表 stitch_photonum)与文件名序号逻辑未改动;
   需要恢复 32 格扫描时把该开关改为 true 即可。

20261105

#define APP_VERSION "2.8.27"
与同级 q6_felgo_iot 做功能同步(以 q6_felgo_iot 为准),并保留本项目差异项

修复 OTA 下载 550(code=9):
   升级包仓库在 cbd_user 账号下(实测可列出 app.apk / Application_BZYV2.rbl),
   而 CurlHandler 默认用图片上传账号 bzy_user 下载,被服务器 550 拒绝。
   新增 CRED_OTA_UID/CRED_OTA_PWD(cbd_user),CurlHandler 增加 setuserpwd(),
   App 升级与主板升级两处下载在 start() 前切到 OTA 仓库账号。
   升级 URL 路径保持不变(未做任何路径调整)。

本次同步进来的功能:
   1) 频流/融合算法:新增 slview_focus(SLView 引导滤波 GFF 与多尺度 MS 融合),
      m_opencv 增加 finishFusionImage/finishFusionImageClassic/repairDarkSpots/
      suppressDeadPixels 等单帧融合后处理,cameramanager 增加单帧(融合一张图片)
      分支与融合结果评分;MQTT 可用 focus_algo 切换算法(0=GFF 1=MS 2=旧算法),
      持久化在 config 表 focus_algo 列(老库自动补列)。
   2) 相机参数:测试页增加相机型号/亮度/白平衡(模式与红蓝比例)显示与下发,
      cameramanager 增加对应属性;相机像素格式与采集参数读取同步。
   3) 相机连接状态:serial 每 3 秒后台枚举海康相机,主页状态栏显示"相机状态";
      定位信息卡片增加海拔、可视/已用卫星数(main.cpp 启用 QGeoSatelliteInfoSource)。
   4) 升级稳定性:ymodem 协议修复;mqtthandler 下载改为 QtConcurrent + curl_global
      单次初始化(不再每轮 cleanup 抽掉图片上传的地基);升级期间串口独占,丢弃
      下行 JSON,避免夹在 YMODEM 包之间导致升级失败;升级结果日志按成败分级。
   5) 配置持久化:MQTT configChange 时把屏幕参数(含 stitch_photonum)写回 camera 表;
      设置页增加"参数重置"(二次确认后串口下发 factory_reset)。

保留本项目(未同步)的差异项:
   - MQTT 主题前缀、FTP 主机/目录(app_credentials.h 中的 CRED_*)保持 bzy 系列;
   - 升级路径(CRED_OTA_APP_URL、MCU/主板升级文件 rtthread.rbl 的存放与下发)保持原样;
   - 拍照数量(camera 表 stitch_photonum 默认 2)与测试页上传进度水印保持原样,
     未引入 q6 的 32 格进度网格;
   - Android 包名 com.yfkj.bzyv1、config.json 的 identifier/title 保持原样;
   - armhf 平台的 eth0(EnjoySDK)/wifi 服务与 ControlsPage 网络配置页保持原样。

20260930

#define APP_VERSION "2.8.25"
修复 mysql.h 编译错误:块注释里的 `**/` 提前闭合了注释

报错形如:
    mysql.h:15:40: error: unknown type name 'storage'
    mysql.h:15:60: error: unexpected character <U+FF0C>
    mysql.h:17:22: error: character <U+FF1A> not allowed in an identifier
    (共 20 个错误,全部指向我新写的那段注释)

原因:注释里为了加粗路径写成了 `**/storage/emulated/0**`,
其中的 `*/` 正好是块注释结束符 —— C 的 `/* */` 不认识"加粗",
注释在这里就被提前闭合,后面的中文全被当成代码解析。

修复:把该段注释里的加粗标记去掉,不以 `**` 结尾紧跟 `/` 开头的路径。
另外用多行检索 `\*\s*\n\s*/` 确认没有"跨行成对"的同类问题
(注意 `/* */` 不按行解析:某行以 `*` 结尾、下一行以 `/` 开头也会提前闭合)。

20260930

#define APP_VERSION "2.8.25"
修复 config.db 打不开(unable to open database file)—— 库被放到了模拟存储上

现象:启动后配置库整个打不开,连锁报错刷屏:
    unable to open database file / Error opening database
    Error: Failed to connect database.
    之后 mqtt / mqtt_other / ftp / ftp_other / location / camera / config
    七张表全部 Fail to create table / Fail to insert data / Fail to query table

根因(两处,都在数据库路径上):
  1) 库路径用 QStandardPaths::GenericDataLocation 拼。**本机该值返回 /storage/emulated/0**
     (外置存储根目录 —— 由 main.cpp 打印的 appDataPath 反推确认:
      GenericDataLocation + "/Android/data/com.yfkj.bzyv1/files/" 得到的就是单层路径)。
     于是配置库落在 /storage/emulated/0/config.db。
     把 SQLite 库放在**模拟存储**上是不可靠的:可能因权限/挂载状态变化 open 失败
     (SQLITE_CANTOPEN → "unable to open database file"),且模拟存储走 FUSE,
     对 SQLite 依赖的文件锁支持不佳。
     注意:外置存储本身是可写的(日志文件 run_log.txt 就写在同一个目录且正常),
     所以这不是单纯的"没权限",而是"不该把库放这儿"。
  2) SqliteOperator::OpenDb() 只在"新建连接"分支里 setDatabaseName;
     而构造函数先一步建好了同名连接,于是走到 else 之外什么都不设 ——
     库名沿用了构造函数传进来的相对名 "config.db"(依赖进程 cwd),
     路径完全不受控。这是个独立的逻辑漏洞,一并修掉。

修复:新增统一的路径解析函数 QString appDbAbsolutePath(const QString &fileName)
  (声明在 header/mysql.h,实现在 src/mysql.cpp),规则:
    - 目标目录按优先级:应用私有目录优先
      Android → AppLocalDataLocation / AppDataLocation(如 /data/data/<pkg>/files)
      其它平台 → applicationDirPath
      再依次 currentPath、GenericDataLocation
    - **GenericDataLocation 被排除在"复用/新建目标"之外**,只作为旧库迁移来源
      (它的 isWritable() 可能返回 true,但放库仍会失败)
    - 若候选目录已有同名库→直接复用;都没有→取第一个真正可写且能创建的目录
    - 需要新建时,若旧位置(GenericDataLocation/当前目录)存在可读的库,
      先 copy 到新位置,**避免 MQTT / FTP / 相机等配置回落到默认值**
    - 结果按文件名缓存,进程内只解析一次
  替换了全部 5 处调用点:
    SqliteOperator 构造函数、SqliteOperator::OpenDb()、DatabaseInterface::openDatabase()、
    DatabaseInterface::ensureConfigDbOpen()、InsertJson_mqtt()(data.db)
  OpenDb() 同时补上"连接已存在时也校正库名(必要时先 close)"。

未改动:m_loger.cpp 的日志文件仍写在 GenericDataLocation 下(实测可用,
  且现场习惯直接去该目录取 run_log.txt,不动为好);main.cpp 的 appDataPath/
  appPicPath 与它们同理,保持原样。

20260930

#define APP_VERSION "2.8.25"
-101 仍存在 → 改为"多组参数自动试探",一轮定位厂商必填项

现场:MTU 已能设置(9000/4000 被驱动拒,降档到 2000 成功),root 探测正确(su 0 sh -c),
但静态 IP 一次性下发仍返回 -101。

新线索:getMcEthernetConfig() 读回来的**未设置字段是 "0.0.0.0" 而不是空串**,
而 McEthernetConfig 里正好定义了 public static final String NULL_IP_INFO = "0.0.0.0"。
→ 厂商用 "0.0.0.0" 当"未设置"哨兵,很可能**不接受空串 ""**(我们此前正是传的空串)。

由于厂商服务的必填项没有公开文档,改为**自动试探多组参数**,哪个成功用哪个,
并把每次的返回码打进日志,一次运行即可定位真实要求:
  变体1  空网关/DNS → 哨兵 "0.0.0.0"          (依 NULL_IP_INFO 推断,最可能正确)
  变体2  真实网关(同网段 .1) + DNS(114.114.114.114) (原生 Android 以太网静态配置必填项)
  变体3  空串 "" 原样传                       (回退验证)
  变体4  掩码用前缀长度 "24"                   (部分实现只认这种写法)
返回值新增 data.via 字段记录命中的方案(null-sentinel / with-gateway / raw-empty / prefix-length),
日志里也有 "setStaticIp 尝试: ... -> ret=xx" 与 "setStaticIp 成功(变体N...)"。

⚠️ 路由副作用提醒:若最终落到**变体2**(厂商强制要求网关/DNS),eth0 在系统看来就是
"带默认网关的网络",可能被 ConnectivityService 选为默认网络,影响 MQTT/FTP 出口。
已在 setupEth0 里对 via=with-gateway 显式打 WARN。届时需检查路由优先级
(可考虑 EnjoySDK 的 setNetworkPriority/changeNetworkPriority)。

20260930

#define APP_VERSION "2.8.25"
修复 setEthernetConfig -101(静态IP设不上) + MTU 无 root 时静默跳过

============ 1) 静态 IP 一直失败(-101)的根因:两步提交写法本身是错的 ============
现场日志:setStaticIp: 切静态模式失败 ret=-101

根因:我把"先设 STATIC 模式、再填 IP"理解成了要**分两次**调用
setEthernetConfig。但该方法会**校验整个配置对象**:静态模式下 IP/子网掩码必须合法,
否则一律返回 -101 (ENJOY_ETHERNET_MANAGER_ERROR_CONFIG_INVALID)。
第一次只改 mode 提交时,IP 仍是 DHCP 遗留的 0.0.0.0 → 校验必然失败。
也就是说这个写法**从一开始就注定失败**,跟网卡本身无关。

正确做法(也是"必须先设静态才能配 IP"的真实含义 —— 说的是配置里 mode 要是 STATIC,
而不是要分两次调用):mode=STATIC 与 IP/掩码/网关/DNS 在**同一次** setEthernetConfig 里给全。

改动:
  - EthernetBridge.setStaticIp():删掉"步骤1 先切模式",改为读当前配置做基底、
    一次性把 mode + IP + 掩码 + 网关 + DNS 配齐后单次下发。
  - EthernetBridge.setMode():语义收窄为**只用于切 DHCP**。传 STATIC 直接返回
    明确错误 "切静态模式需同时提供 IP,请调用 setStaticIp",避免再报无意义的 -101。
  - ControlsPage.qml:点「静态IP」只展开参数表单、**不再下发模式**(下发必定 -101),
    提示"请填写静态 IP 参数,然后点应用静态IP";点「DHCP」才真正下发(DHCP 不需要 IP)。

============ 2) MTU:无 root 时静默跳过(不再刷 EPERM 报错)============
现场日志:ifconfig: ioctl 8914/8922: Operation not permitted(三条),且刷了整段 ifconfig 输出。
用户反馈设备其实**是有 su 的** —— 问题出在我的提权探测写法:
原来把"所有候选里输出最长的那次"当结果,su 若失败/无输出,就会把非 root 那次
(/system/bin/sh) 的 EPERM 输出当成结论,既误判"无权限"又刷屏。

改动:
  - 新增 rootShellPrefix():用 `id -u` **显式确认能否拿到 uid==0**,确认不了即视为无 root;
    候选扩展为 su 0 sh -c / su root sh -c / su 0 -c / su root -c / su -c /
    /system/bin/su -c / /system/xbin/su -c,并缓存结果(整进程只探一次)。
  - setMtu():拿不到 root 就**直接跳过**,只留一条简短 LOG,不打印 ifconfig 报错;
    返回 {ok:false, skipped:true},调用方据此跳过。已确认 root 后再失败才按 errno
    区分 EINVAL(驱动不支持该值,可降档) / EPERM(SELinux 拦截,无解),且日志只记原因。
  - main.cpp setupEth0():MTU 失败由 WARN 降为 LOG —— MTU 只是可选的 Jumbo 帧优化,
    GigE 在 MTU 1500 下仍可通信,不该当异常报。
  - 顺序不变:仍是**先 MTU 后 IP**(MTU 要 ifconfig down/up 会重置网卡)。

遗留提示:若 -101 修好后依然报错,则可能是系统要求静态配置必须带网关
(目前 setupEth0 下发的 eth0 刻意不带网关,避免相机网卡抢默认路由影响 MQTT/FTP)。
届时可在界面里填写网关验证。

20260930

#define APP_VERSION "2.8.25"
【严重BUG修复】进入设置界面必现系统重启 —— 根因:误调 EnjoySDK.init()(武装硬件看门狗)

现象:进入触发网卡状态查询的界面后,系统必现重启。

定位过程:
  1) 全仓 grep `.init()`,只有新写的 EthernetBridge.java 调用过 EnjoySDK.init(),
     项目原有可正常工作代码(Backlight.java 等)从未调用 —— 锁定为本次引入。
  2) 反编译 EnjoySDKSupport.init() 字节码,发现它根本不是 SDK 初始化:
         isApiSupport();
         McWatchdogManager mgr =
             (McWatchdogManager) mContext.getSystemService("mcwatchdog");
         if (mgr == null) return -1;
         return mgr.init();          // ← 打开 /dev/watchdog,武装硬件看门狗
  3) 交叉验证 API 分组:EnjoySDK 的 init / isInited / kick / getSupportTimeOut /
     setTimeout / close / getTimeout / setConfig / getConfig 全部属于看门狗一族,
     且 setConfig 的参数类型就是 com.mc.android.mcwatchdog.McWatchdogConfig(只有 timeout 一个字段)。
  4) McWatchdogManager 是**系统框架类**(不在 AAR 内,通过 getSystemService("mcwatchdog") 获取),
     说明武装的是系统级硬件看门狗。

根因结论:
  init() 武装硬件看门狗后,程序没有(也不该)周期性 kick() 喂狗,
  硬件看门狗超时即强制复位 SoC → 系统重启。界面一进入就调用 status() → sdk() → init(),故必现。

修复:
  EthernetBridge.sdk() 中**彻底删除 sSdk.init() 调用**,只保留 new EnjoySDK(ctx)。
  网卡相关 API(switchEthernet / getEthernetDevices / getMcEthernetConfig /
  setEthernetConfig / getEthernetConnectState / getEthernetMacAddress)都不需要 init()。
  并在代码里写了醒目注释,禁止后人再加回 init(),也不要碰
  kick / setTimeout / setConfig(McWatchdogConfig) / close。

给现场的处置建议:
  硬件看门狗可能已被上一次运行武装且未必随软重启解除。
  若设备仍在反复重启,请**冷启动(断电 10 秒后重新上电)**,不要只做软重启。

另:已作废早期文档/记忆里"EnjoySDK 调用前必须先 init(),否则返回 -5"的说法 —— 那是错误前提,
正是它把方向带偏的。

20260930

#define APP_VERSION "2.8.25"
修复 ethernet_service.cpp 编译错误 + 网卡卡片默认 IP/MTU

1) 编译错误修复:
     src/ethernet_service.cpp:9: fatal error: 'QAndroidApplication' file not found
   原因:Qt6 里**没有** <QAndroidApplication> 这个头文件。
   QNativeInterface::QAndroidApplication::context() 由
   <QtCore/private/qandroidextras_p.h> 提供。
    改法与 wif_service.cpp 完全一致:
     #ifdef Q_OS_ANDROID
     #  include <QJniObject>
     #  include <QtCore/private/qandroidextras_p.h>
     #endif

    顺带修正了 JNI 调用方式(否则下一步就会编译/运行出错):
    - QJniObject **没有** callStaticObjectMethod(className, method, signature, QVariantList&)
      这个重载;用 QVariantList 传参会绑到 C 变参版,而 QVariantList 是非平凡类型,
      同样触发 "non-trivial type through variadic" 类错误。
    - 返回 String 的静态方法只能用 C 变参形式:
        QJniObject::callStaticObjectMethod(类名, 方法名, "签名", jobject, jstring, jint)
      返回基本类型用带显式签名的模板:
        QJniObject::callStaticMethod<jboolean>(类名, 方法名, "签名", 参数...)
    - 跨 C 变参只传 jobject/jstring/jint(指针与 int,无整型提升,绝对安全)。
      jboolean 是 unsigned char 会整型提升,有读取隐患 → 布尔语义统一用 int(1/0) 传,
      因此 EthernetBridge.setEnabled 的 Java 签名也改成了 int enable。
    - QJniObject 持有 JNI 引用,必须保持为具名局部变量存活到调用结束,
      不能把 .object() 从函数里返回出去。

2) 网卡配置默认值(按需求):
   - 静态 IP 默认预填 192.168.100.101(掩码 255.255.255.0)
   - 新增 MTU 输入项,默认 9000(Jumbo 帧)
   - 点「应用静态IP」时的顺序:**先 setMtu,再 setStaticIp**。
     【顺序很重要】setMtu 内部要 ifconfig down/up,会重置网卡;
     若先下发 IP 再改 MTU,刚设好的 IP 会被 down/up 冲掉。
     setupEth0() 里同样调整成了"先 MTU 后 IP"。
   - 若网卡已有配置,refresh() 会用实际值覆盖 IP/掩码/网关/DNS
     (MTU 不在 EnjoySDK 状态里,保持用户填写的默认值)。

3) 新增 MTU 支持(EnjoySDK 无此接口,只能走 shell):
   - EthernetService::setMtu(iface, mtu) —— Q_INVOKABLE,返回 {ok, applied, msg}
     内部 ifconfig down → mtu → up,再次 ifconfig 确认,以输出中是否含
     "MTU:<值>" 判定成功。
   - 需 CAP_NET_ADMIN(设备已 root 且 su 可用);提权依次尝试 su 0 / su root / 直接执行。
   - **失败必须按 errno 区分**(修复方向完全不同):
       Operation not permitted(EPERM) ⇒ 缺 root,su 没生效;
       Invalid argument(EINVAL)       ⇒ 已 root,驱动拒绝该 MTU 值(可试 4000/2000/1500)。
   - MTU 失败不影响已下发的 IP 配置,界面上单独提示,不阻断整体流程。
   - 说明:MTU 之所以没走 Java/EnjoySDK,是因为 AAR 里确实没有 MTU 接口
     (已逆向确认,见下方 API 清单)。

20260930

#define APP_VERSION "2.8.25"
两项需求:上传进度圆改挂 photoclarity_text 后 + eth 网卡改用 EnjoySDK 配置(含 QML 状态界面)

================= 需求 1:上传进度圆位置与显隐 =================
1) 位置:不是「融合」按钮后,而是 TestPage 的 photoclarity_text 文本控件后面。
   做法:在 photoclarity_text 所在的 Row 内、其后插入固定 dp(34) 占位 Item,
     圆形进度(dp(28))用 anchors.centerIn 在占位内居中。
   - 踩坑:photoclarity_text / photoclarity2_text 原本都是 `width: parent.width`
     (即 Row 宽度),会把整行撑满、把进度圆挤出行外。必须改为
     `width: parent.width - dp(34)` 给进度圆让位。
   - photoclarity2_text 上原有的 `anchors.top: photoclarity_text.bottom` 在 Row 里
     本就无效(Row 自行管理 y),此处未改动其定位方式,只调整了宽度。
2) 显隐:只在触发上传时展示,上传完成后关闭展示。
   onFinished 里去掉 uploadHideTimer.restart(),改为直接
     `uploadWatermarkVisible = false`(3 秒延迟隐藏的 Timer 仅保留给手动复位清理用)。
3) PhotostitcherPage 的整块上传进度代码全部移除(属性/Timer/Connections/融合按钮后的圆形槽位),
   只保留 TestPage 一处监听 curl_picture,避免两处重复刷新。
   该页保留一行注释说明上传进度在 TestPage 展示。
4) 顺带修一个状态不一致缺陷:refresh() 里原会用回读的 r.mode 覆盖 useDhcp,
   导致用户刚点"静态IP"、系统回值还没刷新时,界面被弹回 DHCP。
   改为 refresh(iface, keepMode),设置后回读传 keepMode=true 不覆盖用户选择。

================= 需求 2:eth 网卡改用 EnjoySDK =================
背景:之前用 shell ifconfig + su 改网卡反复失败。根因是改 MTU/静态 IP 需要
CAP_NET_ADMIN,普通 app uid 必然 EPERM("Operation not permitted"),未 root 时 su 也无效。
EnjoySDK 走系统 EthernetService(system uid),普通应用即可下发配置,且由系统服务持久化。

【关键约束:必须先切 STATIC 模式才能设 IP】
DHCP 模式下 IP 由 DHCP 服务器分配,setEthernetConfig 不接受调用方指定的 IP,
直接设会被拒(ENJOY_ETHERNET_MANAGER_ERROR_CONFIG_INVALID = -101)。
正确顺序:setMode(STATIC) → 填 IP/掩码/网关/DNS → setEthernetConfig 下发。
该顺序已在 EthernetBridge.setStaticIp() 内部封装,QML 侧无需关心。

新增文件:
- android/src/com/yfkj/bzyv1/EthernetBridge.java
    封装 EnjoySDK 有线网卡能力,Context 由 C++ 传入(与 Backlight.java 一致),
    所有方法返回 JSON 字符串便于一次返回多字段:
      isSupported / getDevices / getStatus / setMode / setStaticIp / setEnabled
    常量:mode DHCP=1 STATIC=2 PPPOE=3 UNKNOWN=4
          linkState DISCONNECTED=0 CONNECTING=1 CONNECTED=2 DISCONNECTING=3 UNKNOWN=4
          错误码 0=OK -2=DEVICE_NOT_SUPPORT -3=SDK_NOT_SUPPORT -5=SERVICE_NOT_START -101=CONFIG_INVALID
- header/ethernet_service.h + src/ethernet_service.cpp
    Q_INVOKABLE 封装,解析 Java 返回的 JSON 为 QVariantMap:
      isSupported() / devices() / status(iface) /
      setDhcp(iface, useDhcp) / setStaticIp(iface, ip, mask, gateway, dns) /
      setEnabled(iface, enabled) / lastError()
    非 Android 平台全部安全返回失败码,不会崩溃。
- CMakeLists.txt:加入上述两个文件。
- main.cpp:#include <ethernet_service.h>,注册上下文属性 `ethernet`,
    并把 setupEth0() 从 QGuiApplication 创建后移到 engine.load() 之后
    (EnjoySDK 需要 Android Context,由 QtAndroidActivity 持有,
      QGuiApplication 刚建好时取不到;QML 引擎起来后才保证可用)。

setupEth0() 改造:
  1) 静态 IP 主路径改走 EthernetService.setStaticIp(eth0, 192.168.100.101, /24);
     不支持 EnjoySDK 时才回退 ifconfig+su 兜底。
  2) MTU 仍走 ifconfig+su 阶梯降级(9000→4000→2000→1500),
     因为 EnjoySDK 未提供 MTU 接口;失败只 WARN 不致命
     (GigE 在 MTU 1500 下仍可通信,仅大帧带宽利用率下降)。
  3) 补 ifconfig 链路上补 `up`(原命令 down 后未 up)。

QML 状态界面(qml/pages/ControlsPage.qml):
  在原「联网状态」卡片后新增「有线网卡」AppCard,默认展示 eth1、可切 eth0/eth1:
  链路状态(带颜色条:已连接绿/连接中黄/未连接红)、MAC、模式、掩码、网关、
  DHCP/静态 切换、网卡开关、静态 IP 参数表单(地址/掩码/网关/DNS)与应用按钮、
  操作结果提示。补充 `import QtQuick.Layouts`(该页原先没有)。
  - 主题色用 Theme.textColor(项目里没有 Theme.textPrimaryColor)。
  - 静态参数区用 visible 而非 opacity:需要真正收起、不占布局空间。

附:EnjoySDK AAR 逆向得到的网卡 API(供后续参考,位于
    android/libs/EnjoySDK-CompatibleVersion-V1.0.2-3.aar):
  com.mc.android.mcethernet.McEthernetConfig  —— mode/ipV4Address/subnetMask/gateway/dns/backupDns
  com.hzmct.enjoysdk.api.EnjoySDK 的网卡相关方法:
    switchEthernet(boolean, String)、isEthernetEnable(String)、getEthernetMacAddress(String)、
    getEthernetDevices()、getEthernetConnectState(String)、
    getMcEthernetConfig(String)、setEthernetConfig(McEthernetConfig, String)

20260930

#define APP_VERSION "2.8.25"
上传进度圆形水印收尾:清理过期注释/空处理函数 + 修正显隐动画矛盾
    1) qml/pages/LocalNotificationPage.qml:删除挂载在 curl_picture 上的空 Connections
       (原 onProgressChanged(uploadedPercent) / onFinished(success,error) 参数个数与真实信号不匹配,
         且三处理函数全空、注释仍写"32 格进度网格")。改为一段说明注释:
         上传进度由 TestPage / PhotostitcherPage 的 UploadWaterProgress 就地监听展示,本页不重复挂。
       真实信号签名(header/app_curlFunc.h):
         progressChanged(double uploadedPercent, QString filePath)
         finished(bool success, QString filePath, QString error)
         downloadStart(QString tips)
    2) UploadWaterProgress.qml 补 `import Felgo 4.0`:
       组件里用到 dp() / sp() / AppText,与 controls/ 下其他控件(如 SettingCard、InfoCard)
       保持一致,确保命名空间与类型一定能解析。
    3) 修正显隐动画矛盾(重要):
       - 根因:**`visible: false` 会跳过 Canvas 的 `onPaint`**,同一元素上再用 `opacity`
         做过渡会彻底失效(表现为水印瞬间消失、淡入淡出白做)。二者只能二选一。
       - PhotostitcherPage:原先外层占位 Item 与内层组件同时按 uploadWatermarkVisible 设 opacity,
         内层还写了 visible。现改为 —— 外层 Item 只占位(不设 visible/opacity,否则会与内层
         透明度相乘拖慢过渡、且 visible 变化会让后面的"删除/关闭"按钮左右跳动),
         内层只用 opacity + Behavior(200ms InOutQuad),保持 visible 恒 true 让 Canvas 持续重绘。
       - TestPage:圆形水印与状态文字由 visible 硬切改为 opacity 过渡
         (visible: page.uploadWatermarkVisible + Behavior on opacity)。
         该处是纯 overlay、不参与 Row/布局,改 opacity 无布局副作用。
         注意**不要写 `visible: opacity > 0`**:组件内部波纹动画的 running 条件依赖
         root.visible,会与 opacity 形成双向耦合的绑定回环。
       - 组件内波纹动画 running 条件含 root.visible,淡出时动画停摆、相位冻结在末帧;
         因 resetUploadWatermark() 会同时把 uploadPercent 归零 + uploadWatermarkVisible 置 false,
         配合 opacity 归零无视觉残留,故保持现状。
    4) 排查结论:源码中已无 32 格进度网格残留(build/ 下命中的均为构建产物副本,无需手改)。
       PhotostitcherPage.qml 里剩余的"32格"指的是图片蛇形排版(8列x4行),属另一功能,予以保留。
       另确认 UploadWaterProgress 无需注册到 qmldir(qml/helper/qmldir 只服务 Constants 单例),
       引用它的两页均已 import "../controls"。

20260930

#define APP_VERSION "2.8.25"
上传进度 UI 重做:方形水印 → 圆形灌水进度,并挂到「融合」按钮文字后面:
    1) 新增控件 qml/controls/UploadWaterProgress.qml(圆形 + 灌水效果,可复用)
       - 视觉:外圈细圆环 + 内部自下而上灌水填充,水面叠加两个谐波正弦形成流动感,
         圆心显示百分比;失败时整体转红 #e74c3c,正常绿 #28a779。
       - 属性:percent(0~100) / failed / diameter(默认 dp(56))。
       - 实现要点:整块用 Canvas 绘制。
         **Item.clip 只裁剪矩形、不裁剪圆角**,靠 clip 属性做圆形裁剪会失效(会被切成方形),
         必须用 Canvas 里的 ctx.arc() + ctx.clip() 才是可靠的圆形裁剪。
       - Canvas 只在 requestPaint() 时重绘,故用 Connections 监听
         percent / failed / wavePhase 变化并显式 requestPaint();
         另接 onWidthChanged/onHeightChanged。
       - 波纹相位由 NumberAnimation on wavePhase 驱动(1600ms 循环),
         仅在 visible && 0<percent<100 时 running,静止时不空转。
       - 振幅 amp 取 min(dp(2), r*0.12),随直径自适应,避免小尺寸时溢出圆外。
    2) TestPage.qml:原矩形水印(宽 dp(280) 的 Column 卡片)替换为
       UploadWaterProgress(diameter dp(64)),下方保留一行小字显示状态与文件名
       (AppText,ElideMiddle,dp(11))。
    3) PhotostitcherPage.qml:新增同名上传状态属性 + Connections(onProgressChanged/onFinished)
       + uploadHideTimer(3s 自动隐藏),并把圆形进度挂在「融合」按钮后面。
       布局做法:圆形进度作为底部按钮 Row 里「融合」按钮的下一个元素(外层 Item 固定 dp(34) 占位,
       只用 opacity 切换显隐),这样紧跟文字且不挤压相邻按钮。
       - 踩坑:**不要用 anchors.verticalCenter 给 Row 的子项定位**,Row 会自行管理子项 y 坐标,
         两者冲突。圆形进度自身用 anchors.centerIn: parent 在占位 Item 内居中即可。
       - 也未采用 AppButton 的 rightItem —— 该属性在 QML 侧仅是声明(实际布局在 C++ 侧
         QtQuickTemplates2),无法确认它是否参与 implicitWidth 计算,贸然使用可能挤压相邻按钮。
       - 若用 visible 直接切换 Row 内元素,会导致后面的「删除/关闭」按钮左右跳动,故改用 opacity。
    4) 顺带修正 TestPage/PhotostitcherPage 的注释与 LocalNotificationPage.qml:70 的过期说明
       (仍写着"32 格进度网格",已改为圆形进度)。

20260930

#define APP_VERSION "2.8.25"
eth0 配置改为分步执行 + MTU 阶梯降级(现场日志显示 root 已可用但 MTU 被驱动拒绝):
    现场新日志:setupEth0: eth0 配置未完成 (IP=FAIL MTU=FAIL root=yes)
                ifconfig: ioctl 8922: Invalid argument
    关键认知修正 —— 必须按 errno 区分两类失败,处理方式完全不同:
        "Operation not permitted"(EPERM) => 缺 CAP_NET_ADMIN,su 没生效
            (设备未 root / su 不存在 / 被 SELinux 拦)。无权限。
        "Invalid argument"(EINVAL)       => 已经拿到 root,是驱动拒绝了该 ioctl 的参数。
            本平台 sunxi-gmac 就是这种:设 MTU 9000 被拒(硬件/驱动上限低于 9000)。
        上一版日志里三条 ioctl 全是 EPERM,本次 root=yes 且只剩 8922 EINVAL,
        说明 su 提权链路本身没问题,是 MTU 参数不被支持。
    ioctl 错误码对照(ifconfig 打印的是十六进制值):
        8914 = SIOCSIFFLAGS (down/up)   8922 = SIOCSIFMTU (mtu)
        8916 = SIOCSIFADDR (ip/netmask) 8915 = SIOCGIFADDR (读 ip)
    结构重构(src/main.cpp setupEth0):
        - 抽出 runAsRoot(shCmd, okRoot) lambda:内部依次尝试 su 0 / su root / 直接执行,
          返回合并输出并通过 okRoot 回传是否拿到 uid==0;优先保留"已拿到 root"的那份输出。
          (删除了原先已无用的 tag 字段与 bestTag 变量)
        - 步骤1 单独探测 root:跑 "id -u",首行为 "0" 才继续,否则直接给出系统侧配置指引后返回,
          不再空转。
        - 步骤2 MTU 改为阶梯降级 9000 → 4000 → 2000 → 1500,取驱动接受的最大值。
          **MTU 设不上去不再是致命错误**:GigE 在 1500 下仍可通信,只是大帧带宽利用率下降,
          故全部候选失败时只 WARN 并继续,不再让整个配置失败。
        - 步骤3 静态 IP 独立重试最多 8 轮(每轮间隔 500ms 等驱动/链路就绪),
          这是 GigE 相机能被搜到的前提,失败才 ERROR。
        - 收尾统一再 ifconfig 一次打印最终状态,日志明确区分
          "MTU=9000" 与 "MTU=默认(不支持Jumbo)" 两种成功形态。

20260930

#define APP_VERSION "2.8.25"
修复 main.cpp 编译失败(spdlog/fmt 变参不接受非 POD 类型):
    报错:
        core.h:1735 error: cannot pass object of non-trivial type 'QString' through variadic method;
                    call will abort at runtime [-Wnon-pod-varargs]
        core.h:1757 error: static assertion failed due to requirement 'formattable':
                    Cannot format an argument. To make type T formattable provide a formatter<T>
    原因:setupEth0() 中 `QString bestTag;` 被直接传给 ERROR(...)。
          fmt 以 C 变参方式接收参数,QString 是非平凡类型(non-trivial),不能按值跨变参边界传递
          (即使有 formatter 也过不了这一关),必须转成 const char* 或 std::string。
    修复:bestTag 由 QString 改为 const char *(Attempt::tag 本就是字符串字面量,无需转换),
          赋值 bestTag = a.tag 直接可用,不产生悬垂指针。
    项目约定:本项目 LOG/WARN/ERROR 宏传入的 Qt 字符串必须显式转换,
          QString → .toStdString(),const char* 可直接传;禁止把 QString 裸传给日志宏。

20260930

#define APP_VERSION "2.8.25"
移除测试维护页 32 格上传进度网格,改为画面上的单张上传进度水印:
    业务前提:CurlFtpUploader 内部是串行队列(std::deque<UploadJob> + QWaitCondition,
              见 header/app_curlFunc.h runLoop),任何来源(采集图片/补录重传/日志)都 FIFO 逐张上传,
              不会并发 —— 所以"32 格网格"这种按序号并发铺开的展示与实际行为不符,是冗余设计。
    删除内容(qml/pages/TestPage.qml):
        - property uploadGridSerials(32 个蛇形序号码数组)与 ListModel uploadGridModel;
        - Component.onCompleted 里的 32 次 model.append 初始化;
        - uploadSerialFromPath() 路径解析、uploadSerialToIndex() 蛇形换算、
          setUploadCell()、resetUploadGrid() 四个函数;
        - GridLayout(8列) + Repeater 32 格进度格子 + DragHandler 拖动逻辑;
        - 顺带移除已无使用者的 import QtQuick.Layouts。
    新增替代(qml/pages/TestPage.qml):
        - 页面属性:uploading / uploadPercent / uploadFileName / uploadFailed /
          uploadWatermarkVisible,以及 resetUploadWatermark();
        - Connections target: curl_picture:
            onProgressChanged(percent, filePath) → 直接更新整体进度,
                文件名取路径末段(split(/[\\/]/).pop()),避免长路径撑开水印;
            onFinished(success, filePath, error) → 置成功/失败态,
                并 restart uploadHideTimer 保留水印 3 秒再自动隐藏,便于现场确认结果;
        - uploadHideTimer(interval 3000, repeat false) 控制结束后自动隐藏;
        - 水印 UI:半透明黑底(#B3000000) + 圆角,固定宽 dp(280),
            画面顶部居中(anchors.topMargin dp(16), z:10),
            含标题(正在上传/上传完成/上传失败)、文件名(ElideMiddle)、进度条、百分比;
            成功绿 #28a779 / 失败红 #e74c3c,进度条带 120ms 动画;
        - onCameraStaChanged 中的 resetUploadGrid() 改为 resetUploadWatermark()。
    布局注意:水印宽度固定 dp(280),内部 Column 用 anchors 填充而非
          "父宽 = 子 implicitWidth",避免 QML 布局反馈循环。

20260930

#define APP_VERSION "2.8.25"
修复权限管理界面(PermissionPage)没有返回按钮:
    现象:从"系统设置"页点【权限管理】进入后,界面无任何返回入口,只能按 Android 物理返回键。
    根因:qml/pages/PermissionPage.qml 第 24 行 navigationBarHidden: true
          —— Felgo 的返回按钮渲染在导航栏左侧,隐藏导航栏等于把返回入口一并去掉。
          该页是被 ProfilePage.qml:474 用 navigationStack.push(permission_component)
          压入的第二层页面(栈深度 > 0),本应显示返回按钮。
          对照:ProfilePage.qml:17 同样隐藏了导航栏,但它是 NavigationStack 的 initialPage
          (Main.qml:196),栈深度 0,不需要返回按钮,所以没问题 —— 不能一概而论地隐藏。
    修复:navigationBarHidden 改为 false,并加注释说明本页是 push 进去的第二层页面、
          绝不能隐藏导航栏,同时给出参照样本与导航栏主题配置来源(Main.qml onInitTheme)。
    布局无需调整:AppPage 内容由 NavigationStack 的 pageContainer 承载,
          已自动定位在导航栏(navBar)下方,页面内 anchors.top: parent.top 仍正确。
    项目约定(本项目新增,务必遵守):
        - navigationStack.push() 压入的页面,一律 navigationBarHidden: false;
          只有 NavigationStack 的 initialPage 才允许隐藏导航栏。
        - 全项目当前仅两处 push:permission_component 与 sqlite_component,
          两者都保留导航栏(return 按钮由 Felgo 自动渲染,无需自绘)。
        - 隐藏导航栏前先确认该页是否为栈底页面,可用 navigationStack.depth 判断。

20260930

#define APP_VERSION "2.8.25"
修复 GigE 网口静态IP / Jumbo帧(MTU 9000) 配置失败(eth1 setup failed + ifconfig ioctl EPERM):
    现象:main.cpp setupEth0() 输出
        eth1 setup failed: eth0  Link encap:Ethernet  HWaddr ... Driver sunxi-gmac
              UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
              Interrupt:131
        ifconfig: ioctl 8914: Operation not permitted
        ifconfig: ioctl 8922: Operation not permitted
        ifconfig: ioctl 8916: Operation not permitted
    ioctl 错误码解码(ifconfig 打印的是请求的十六进制值):
        8914 = 0x8914 SIOCSIFFLAGS -> ifconfig eth0 down / up
        8922 = 0x8922 SIOCSIFMTU   -> ifconfig eth0 mtu 9000
        8916 = 0x8916 SIOCSIFADDR  -> ifconfig eth0 192.168.100.101
    三个特权 ioctl 全部 EPERM,而只读的 `ifconfig eth0` 成功(输出 MTU:1500 且无 inet addr 行),
    说明 eth0 处于"接口 UP 但没有 IP"的半可用状态,GigE 相机搜不到 192.168.100.101。
    根因:是 EPERM 而非 EACCES —— 说明进程缺少 CAP_NET_ADMIN 能力,即 su 根本没生效
          (设备未 root / su 不存在 / 被 SELinux 拦截)。普通应用进程无法配置网卡 MTU 与静态IP。
    代码层面的可诊断性缺陷(原实现的真正问题):
        原 setupEth0() 三次提权尝试(su 0 / su root / 直接执行)共用同一个 out 变量且每次覆盖,
        最终只打印最后一次兜底调用的输出,su 是否存在、是否提权成功等关键信息全部丢失,
        现场只能看到一堆无意义的 EPERM,无法判断卡在哪一环。
    修改(src/main.cpp setupEth0):
        - 命令串最前面加 `id -u`,提权成功时 stdout 首行即 "0",su 不可用时首行为错误文本,一眼可判;
        - 三种提权方式改为带 tag 的结构体数组(su-0 / su-root / plain),逐个记录;
        - 每种方式的输出不再互相覆盖,单独判定是否拿到 IP / MTU;
        - 失败诊断优先保留"已拿到 root"的那份输出(最能说明是命令/内核限制而非提权失败);
        - 若首轮三种方式全部没拿到 root,直接放弃重试并给出根治指引,不再空转 10 轮拖慢启动;
        - 成功/失败日志补齐 IP、MTU、root 三个维度,便于现场一眼判断卡在哪一环;
        - 修正日志措辞:原日志打 "eth1" 但函数处理的是 eth0,误导排查;
        - waitForFinished 由 5000ms 降到 3000ms,超时补 kill() 回收子进程,避免僵尸堆积;
        - ifconfig 各子命令补 2>&1,保证错误信息进入管道而不是丢在 stderr。
    根治方式(已写入代码注释,推荐走系统侧配置,不依赖应用内 su):
        1) 静态 IP:Android 10 EthernetService 支持静态 IP 下发,
           在 /system/etc/ethernet/config.xml 为 eth0 增加 StaticIPSettings(192.168.100.101/24),
           由系统服务(system uid)完成,无需 root;
        2) Jumbo 帧:在 init.rc 或 /system/etc/init.d/ 开机脚本执行 "ifconfig eth0 mtu 9000";
        3) 若坚持应用内配置,APK 必须预置为系统应用(platform 签名 + sharedUserId)。
    现场待确认:当前源码 src/main.cpp 中 setupEth0() 调用是注释掉的(//setupEth0();),
        而线上包日志表明该调用是打开的 —— 说明设备上的 APK 与当前源码不一致,
        需要确认线上包对应的代码版本,并决定是否恢复该调用。

20260930

#define APP_VERSION "2.8.25"
【真正根因已定位并修复】权限授予后启动崩溃 SIGSEGV fault addr 0x0 —— 崩溃在主线程 QtMainLoopThread,
    之前"tid≠pid 说明崩在子线程"的判断是错的(见下方"定位手段更正"):
    完整 native backtrace(tombstone / F DEBUG):
        #00 libQt6Network    (QNetworkAddressEntry::ip() const+4)
        #01 libapp_bzy_armhf_7 (JsonFunc::BoardMessage()+482)
        #02 libapp_bzy_armhf_7 (SerialThread::readBoardData()+42)
        #03 libapp_bzy_armhf_7 (SerialThread::qt_metacall(...)+42)
        #04~#16 libQt6Qml     (QML 信号发射链)
        #17 libQt6QmlMeta    (QQmlTimer::ticked()+20)
        #18~#27 QCoreApplication::exec / QEventLoop::exec / main+10868
    崩溃链:qml/Main.qml 中 interval:1000 的 Timer → serial.readBoardData()
            → JsonFunc::BoardMessage() → QNetworkAddressEntry::ip()。
    根因:src/m_json.cpp 中原代码
              param::net_ipv4 = interface.addressEntries().first().ip().toString();
          addressEntries() 返回空 QList 时,Qt6 的 first() 不做边界检查,
          返回内部 d 指针为 nullptr 的默认构造 QNetworkAddressEntry,
          紧接着调 .ip() 即空指针解引用 → fault addr 0x0。
          触发时机:Android 授完网络权限后接口才 IsUp,但 DHCP 尚未分配地址,
          addressEntries() 为空;而 Main.qml 的 1 秒 Timer 已开始每秒调用 readBoardData()。
    修复(src/m_json.cpp BoardMessage):
        - 先筛掉非 IsUp 与 IsLoopBack 接口;
        - 再遍历 addressEntries(),逐项过滤 addr.isNull()/isEmpty() 及非 IPv4 协议;
        - 只有拿到合法 IPv4 才写入 param::net_* 并 break;
        - 一个都没拿到时清空 param::net_name/description/mac/ipv4 并输出日志,
          避免把脏数据同步给 MCU;
        - 补充 #include <QHostAddress> 与 <QAbstractSocket>。
    定位手段更正(重要,避免重复踩坑):
        - Qt for Android 主 GUI 线程的 comm 就是 "qtMainLoopThrea"("qtMainLoopThread" 截断到 15 字符),
          **不代表**是子线程继承来的;不能凭线程名判断线程身份。
        - 崩溃行 "in tid T (name), pid P" 中 tid ≠ pid,也不能断定崩在子线程;
          正确判据是 backtrace 里是否出现 QCoreApplication::exec / QEventLoop::exec / main
          —— 出现即主线程事件循环栈。本例 backtrace 末尾正是 exec → main,故崩在主线程。
        - Android 上定位 native 崩溃应直接取完整 backtrace(tombstone / F DEBUG),
          按符号逐帧还原调用链,比按 tid/线程名猜测快得多。

20260930

#define APP_VERSION "2.8.25"
(以下为此前基于错误假设所做的防御性加固,保留但并非本次崩溃的根因)
修复权限授予后新出现的启动崩溃(SIGSEGV fault addr 0x0, qtMainLoopThrea):
    定位关键:曾误判为崩溃线程 tid(17869) ≠ 主线程 pid(17835),据此怀疑 SerialThread 子线程
              与主线程构造之间的启动竞态。真实根因见上一条(BoardMessage 空指针)。
    根因1(误判,实为无害的加固):header/mserial.h 中 YMODEM *m_ymodem; 与 SqliteOperator *sqlConfig;
              两个指针均未初始化,为野指针。SerialThread 对象在主线程构造,
              而 run() 里的 new YMODEM(&m_serialPort) 在串口子线程执行,存在启动竞态;
              一旦在赋值前经 startUpgrade()/getYmodem() 解引用即 SIGSEGV(fault addr 0x0)。
              修复:两指针在声明处初始化为 nullptr。
    根因2:mserial.cpp run() 中 4 个 YMODEM 信号连接写在 open() 成功之后,
              串口打开失败时提前 return,连接从未建立(MCU 升级指令无人接收)且 m_ymodem 泄漏。
              修复:把 connect 全部前移到 open() 之前,open 失败只影响收发,不影响对象图完整性。
    加固:saveMcuParam / recoverMcuParam / update_dat_f_main 三处补 sqlConfig 判空
          (三者分别可由串口子线程与 QML 主线程触发);init() 增加"未找到 ttyS3/ttySR3"的显式告警,
          避免现场只看到 Failed to open serial port 而不知真实原因。
    附:selectSerialPortName() 仅匹配 ttyS3/ttySR3,找不到时返回空串,
        会导致 setPortName("") + open() 必然失败,需现场确认实际串口名。

20260930

#define APP_VERSION "2.8.25"
修复启动期QML 警告与 license key 报错:
    1、qml/config.json 的 "stage" 为空字符串,App 运行时无法确定构建阶段,
       导致 license key 校验失败,日志报 Invalid license key set for plugin: "VPlay" "2.0"。
       改为 "stage": "publish",与 CMakeLists.txt 中 PRODUCT_STAGE "publish" 保持一致。
    2、Connections 隐式 onFoo 语法在 Qt6 已废弃,日志报
       QML Connections: Implicitly defined onFoo properties are deprecated,
       按官方提示改为新语法 function onFoo(<arguments>) { ... }:
        - qml/model/DataModel.qml  6 处(onFetchTodos / onFetchTodoDetails / onStoreTodo
          / onClearCache / onLogin / onLogout)
        - qml/pages/TodoListPage.qml  1 处(onTodoStored)
       注意:仅 Connections 块内的 onFoo 需改;普通对象的 onXxx: function(){} 属合法写法,无需改动。
    附:本次启动崩溃(SIGSEGV fault addr 0x7, qtMainLoopThrea)根因为文件权限未授予,
        需在 INITLOG 之前完成权限申请。

20260930

#define APP_VERSION "2.8.25"
修复串口到MQTT 的信号槽参数不匹配导致编译失败:
    编译报错:static assertion failed ... The slot requires more arguments than the signal provides
              (SignalType::ArgumentCount 1 >= SlotType::ArgumentCount 2 求值为 1 >= 2)
    原因:MqttHandler::publish_m(const QByteArray &message, quint8 qos = 0) 带默认参数,
          但Qt 的指针式 connect(&SerialThread::dataUpload, &MqttHandler::publish_m)
          按成员函数指针的实际签名匹配,槽被判定为 2 个参数,信号只有 1 个,
          默认值在指针式连接中不生效,故必须用 lambda 补齐参数。
    修改:src/main.cpp 中 SerialThread::dataUpload -> MqttHandler::publish_m 的连接
          改为 lambda 形式 publish_m(data),与同文件 Frames::dataUpload 的既有写法保持一致。
    注意:新增带默认参数的槽并用指针式连接时,同样会踩此坑,需改用 lambda 或 QOverload。

20260930

#define APP_VERSION "2.8.25"
修复Android Java 包名与项目包名不一致问题,统一为 com.yfkj.bzyv1:
    1、android/src 下 9 个 Java 文件的 package 声明由 com.yfkj.cb.Q6iot 改为 com.yfkj.bzyv1
        (QtAndroidService、MyQtActivity、Backlight、StatusBarCtr、BootBroadcastReceiver、
          PermissionHelper、PermissionAccessibilityService、IExitGetOneFrame、CameraManager 注释行);
    2、QtAndroidService 中 import com.yfkj.cb.Q6iot.R 改为 import com.yfkj.bzyv1.R;
    3、StatusBarCtr 中 FileProvider authority 改为 com.yfkj.bzyv1.fileProvider,
        与 AndroidManifest.xml 中 provider 的 authorities 保持一致;
    4、Backlight 中麦充保活 McKeepAliveApp.setPackagename 改为 com.yfkj.bzyv1;
    5、同步修正 C++ 侧 JNI 类路径,防止运行期 ClassNotFound:
        header/m_json.h、header/mserial.h、src/mqtthandler.cpp、src/PermissionBridge.cpp、src/main.cpp
    说明:包名基准以 CMakeLists.txt 的 PRODUCT_IDENTIFIER、qml/config.json 的 identifier
         及 AndroidManifest.xml 的 package 为准,三者原本已统一为 com.yfkj.bzyv1。
         后续新增 Java 文件必须放在 android/src/com/yfkj/bzyv1/ 并使用该包名。

20260731

#define APP_VERSION "1.19.11"
1、取消模糊检测;
2、同时上传清晰照片和融合照片;
#define APP_VERSION "1.19.10"
1、把所有使用qdebug打印log的函数修改为SPDLOG;
2、降低图像融合前图像检测的阈值;
#define APP_VERSION "1.18.10"
    融合前的推荐检测顺序
    1. 空图 / 加载失败
    2. 全黑 (mean < 15)
    3. 全白 (mean > 240)
    4. 过曝截断 (overRatio > 0.05)
    5. 欠曝截断 (underRatio > 0.10)
    6. 低纹理 (stdDev < 5)
    7. 低边缘密度 (edgeRatio < 0.005)
    8. 运动模糊 (Laplacian var < 100)
    9. 高噪 (noiseVar > 400)
    10. 镜头遮挡 (blockVariance 某块 < 全局20%)

20260730

#define APP_VERSION "1.18.9"
1、增加景深融合的MQTT开关:
    {
        "jsonrpc": "2.0",
        "method": "fusion_sw",
        "params": {
          "enable": 0
        },
        "id": 1
    }

20260730

#define APP_VERSION "1.17.9"
1、使用静态融合,动态融合性能不足实现复杂;
2、增加融合过程展示;
3、拍照界面的图像信息展示优化;

20260725

#define APP_VERSION "1.16.9"
1、修复迈冲屏输入156715无法退出;
2、引入动态景深融合;

20260724

#define APP_VERSION "1.15.9"
1、修复同一张图片上传两次;

20260723

#define APP_VERSION "1.15.8"
1、降低黑图过滤的阈值为5;
2、增加网飞sdk霸屏及默认网卡参数设置;
3、上传成功延迟5S关闭弹窗;
4、修复导入海康SDK后打开相机程序卡死,系统重启,回退旧SDK;

20260710

#define APP_VERSION "1.15.7"
1、修复胶带使用量展示
2、图像对比度增强;

20260710

#define APP_VERSION "1.15.6"
1、修复屏幕无法设置坐标

20260709

#define APP_VERSION "1.15.5"
1、界面ui更新:
    滑台控制、相机参数设置、调试增加密码保护【666888】
    主界面增加胶带使用量状态展示(达到100时弹窗提示) [还需要增加重置胶带使用量的控件]
    设置坐标从工作状态界面移到测试界面的高级设置中
2、增图像增强算法:
    景深融合、
    对比度增强
    图像锐化
3、图像查看界面及后端,可以显示年月日归档目录下的子目录(主要是对焦过程归档)
    可以对多张图片选中后进行景深融合;
4、APP名称修改为:孢子捕捉仪1.3
5、拍照完成后对图像进行锐化,清晰度会有提升,同时上传锐化前后的照片,所以每次拍照上传两张照片【测试阶段,根据效果后续改为一张】;

20260626

#define APP_VERSION "1.14.5"
1、针对MCU丢参数的更新,解析到坐标为0时主动恢复参数到MCU;
2、修复保存的MCU JSON参数不完整;
3、修复上传日志的路径不正确导致无法上传日志;

20260527

#define APP_VERSION "1.13.5"
    1、增加相机曝光值保存到用户参数;
#define APP_VERSION "1.13.4"
    1、完善信号强度的获取;

20260519

#define APP_VERSION "1.12.4"
    1、修复图片补录路径不存在导致重复失败,并且弹窗文字累计问题;
    2、温控状态测试胶带无反应:增加弹窗提示;

20260430

#define APP_VERSION "1.11.4"
1. 增加串口及MQTT消息展示,通过测试界面的按钮开关;

20260425

#define APP_VERSION "1.10.4"
1. 修复立即拍照按钮执行完成后不恢复
    处理措施:在关闭相机信号处理时,关闭按钮;

20260425

#define APP_VERSION "1.10.3"
1、qml界面优化
2、修复启动花屏问题,启动前删除缓存
3、调整APP升级路径:ftp://8.136.98.49/_UPDATE_FILE/Android/BZYV2/armv7a/app.apk
4、调整MCU升级路径:ftp://8.136.98.49/_UPDATE_FILE/Android/BZYV2/armv7a/Application_BZYV2.rbl
5、升级功能优化;
6、主界面增加温控值修改;
    增加采集分钟的设置;

20260417

#define APP_VERSION "1.8.26"
更新说明:
    1、每次启动都发送恢复MCU参数的JSON,防止MCU启动后工控机还没启动,无法收到恢复指令的情况.
    2、针对丢照片问题进行优化改进,处理因拍照过程中断电导致的图片没有上传,处理逻辑如下:
    完整流程
    保存图片 → saveMatAsJpeg → 立即 emit signal_cache_image(path) → 触发 storage_Picture_Takephoto(path) → 原始路径存入 DB
    上传成功 → CurlFtpUploader::finished(true) → storage_Picture(true, path) → 从 DB 删除原路径记录
    上传失败 → storage_Picture(false, path) → cacheImagePath 重命名文件为 history-*.jpg 并入库 → 等待重传定时器触发 signal_reupload_image(history_path) 
        重新上传
    3、修复IMEI未保存到数据库问题;

20260413

#define APP_VERSION "1.8.25"
更新说明:
    1、修复日志无法上传问题.

20260410

#define APP_VERSION "1.8.24"
更新说明:
    1、优化和主板的通信协议,取消发{“cmd”:“read”},而是发{"cmd": "synchronization","ext":{}}
        效率提升
    2、修复相机已经打开的状态进行对焦拍照会导致相机关闭
    3、增加MCU参数备份与恢复:
        备份:{"jsonrpc":"2.0","method":"sync_param","params":{"reboot_time":751,"ds":1,"collecting_sh1":11,"collt_min_sh1":0,"collecting_eh1":16,"collt_min_eh1":0,"collecting_sh2":0,"collt_min_sh2":0,"collecting_eh2":0,"collt_min_eh2":0,"collecting_sh3":0,"collt_min_sh3":0,"collecting_eh3":0,"collt_min_eh3":0,"tpl":5,"tph":70,"x_init_dis":1300,"y_init_dis":1600},"id":1}
        收到此指令时发送上面json到mcu:{"jsonrpc":"2.0","method":"recover_param","id":1} 

202600309

#define APP_VERSION "1.7.23"
更新说明:
    1、修复Ymodem升级问题,优化代码结构,Ymodem类放在SerialThread中使用;

20260131

#define APP_VERSION "1.6.23"
更新说明:
    1、完善信号强度的获取与上报;

20260130

#define APP_VERSION "1.5.23"
更新说明:
    1、修复串口发送字节数溢出导致程序崩溃;

20260126

#define APP_VERSION "1.5.22"
更新说明:
    1、更新Felgo版本       
    QT版本:V8.3.0
    NDK版本:27.2
    2、增加日志上传,共存储10个日志文件,每个10MB大小:
    指令:
    {
    "jsonrpc": "2.0",
    "method": "upload_log",
    "params": {
      "filename": "run_log.txt"
    },
    "id": 1
  }

20260122

#define APP_VERSION "1.4.22"
更新说明:
    增加网口相机拍照前设置IP功能,解决IP丢失无法打开相机问题;
    增加曝光值显示;

20260119

#define APP_VERSION "1.3.22"
更新说明:
    优化代码结构;

20251206

#define APP_VERSION "1.3.21"
更新说明:
    串口解析使用lwjson
    取图接口调整
    增加Y轴坐标校准

20251113

#define APP_VERSION "1.3.20"
更新说明:
    自动对焦:闪退问题解决,自动对焦过程中退出程序,再次启动APP后执行对焦拍照会触发闪退;
    原因:GPS定位成功后释放时机,延迟释放即可解决;

20251110

#define APP_VERSION "1.3.18"
更新说明:
    修复主函数数据库逻辑问题;

20251104

#define APP_VERSION "1.3.18"
更新说明:
    修复mqtt不停上报最新数据问题;

20251103

#define APP_VERSION "1.3.17"
更新说明:
    修复读取/设置主板参数/数据后  mqtt不上报最新数据问题;

20251101

#define APP_VERSION "1.3.16"
更新说明:
    修复FTP上传图片失败问题,构建curl时还未读取到IMEI

20251101

#define APP_VERSION "1.3.15"
更新说明:
    增加设置IMEI功能

20250829

#define APP_VERSION "1.2.10"
更新说明:
    增加每隔24小时系统重启;