48M 晶体校准¶
FAQ1 思澈是否提供金机？ 有哪些功能？ 怎么使用？¶
思澈提供金机，主要功能是通过无线（空口）方式来校准客户板子的48M 晶体。用户拿到的金机一般都是已经烧录好的，金机上电后，校准信号默认存在， 可以直接使用。
金机实物如下图：
使用步骤:
量产夹具通过程控电源供电，上电后夹具中PCBA上55x/56x/58x芯片的boot_mode脚处于拉高状态（52x上电后有一个2秒的启动等待期，此时通过串口烧写工具发送指令即可触发进入Boot Mode）。
打开量产烧录工具Impeller，
工具包含量产软件烧录和48M晶体校准等功能，工具左上角选择“校准”或“烧录+校准”，如下图所示点击校准参数，
弹出如下图所示对话框
红色方框选择无线方式，绿色方框为校准信道频率，参数设置与金机实物上标签标识的信道频率保持一致。
给金机拧上天线（金机附带），金机一般通过type-c供电，上电后靠近type-c处的红灯常亮。
点击工具Impeller左上角开始图标，如下图黄色箭头所示，工具开始运行对应功能。
注意事项
同一拉线或空间内，两个同信道的金机不能同时使用。
金机与夹具的直线距离为0.1m ~ 1m
一般情况下，各金机标识的信道频率是各不一样的。
FAQ2 48M晶体校准常见问题¶
48M晶体校准需要有校准金机，正常来说一个金机可以覆盖周围2米的范围。如果烧录工位较多且距离近较远时，需要用多个金机覆盖，确保各个金机的校准频点分散开，不可重合干扰。
思澈产品48M晶体校准操作流程如下（可参考 Impeller工具的说明文档）：
打开 Impeller，选择校准功能并配置校准参数中的频点同金机的频点一致
校准金机上电，目标板上电，然后点击校准按钮执行校准流程
如下所示是校准成功的log信息
校准成功 log 信息
Serial:c2,Chip:4,Package:3,Rev:2 Reason:00000000 \ | / - SiFli Corporation / | \ build on Oct 30 2025, 2.4.0 build 4f1f8907 2020 - 2022 Copyright by SiFli team NAND factory magic error 0x58ce33c5 vs 0x53450617 curent ver 20251030, otpbase 0x62000000 psram size:0x800000 addr:0x60000000 //-------------------------------------- ① 以上信息是驱动加载成功 R: ble_crystal_cali 20 6 0x71764129 1600 200 400 3 argv[1]: 20 argv[2]: 6 argv[3]: 0x71764129 argv[4]: 1600 argv[5]: 200 argv[6]: 400 argv[7]: 3 //-------------------------------------- ② 以上信息是收到校准命令 ble_crystal_cali init ble_crystal_cali start curtick1 2020 NAND factory magic error 0x58ce33c5 vs 0x53450617 FACTORY_CFG_ID_CRYSTAL read fail with 0 time:251249 cbank_sel:200 time:783749 cbank_sel:200 time:1279999 cbank_sel:200 time:1829997 cbank_sel:100 time:1871356 cbank_sel:180 time:1857543 cbank_sel:1c0 time:1852519 cbank_sel:1e0 time:1837507 cbank_sel:1f0 time:1808753 cbank_sel:1f8 time:1825000 cbank_sel:1f8 bleRx 2 (0 0) time:2336250 cbank_sel:1f8 bleRx 2 (1 1) time:2330000 cbank_sel:1f8 bleRx 2 (1 2) time:2382500 cbank_sel:1f8 curtick2 13120 //-------------------------------------- ③ 以上信息是校准流程 CRYSTAL_CALI_PASS 0x1f8 CRYSTAL_CALI_PASS 0x1f8 //-------------------------------------- ④ 以上信息是校准通过
校准过程中可能出现的异常问题
驱动文件未正常加载或执行
参考上面校准成功的log信息，如果标注的 ① 信息未输出，则说明驱动文件加载异常或者运行时异常，遇到这类问题首先让板子进入boot模式再次执行，依然无法解决需联系FAE做进一步调试。校准流程执行但未收到校准信号
当出现如下 log 类似信息，校准流程启动但显示超时未校准成功，则建议做如下排查：确认金机是否上电
确认校准工具的频点同金机频点是否一致
确认金机是否有天线并同目标板保持足够近的距离
更换金机来验证金机本身是否异常
更换频点（可更换其他频点的金机或联系FAE修改金机频点）确认是否该频点存在强干扰信号
校准失败(未收到金机信号) log 信息
Serial:c2,Chip:4,Package:3,Rev:2 Reason:00000000 \ | / - SiFli Corporation / | \ build on Oct 30 2025, 2.4.0 build 4f1f8907 2020 - 2022 Copyright by SiFli team curent ver 20251030, otpbase 0x62000000 psram size:0x800000 addr:0x60000000 //-------------------------------------- ① 以上信息是驱动加载成功 R: ble_crystal_cali 20 6 0x71764129 1600 200 400 3 argv[1]: 20 argv[2]: 6 argv[3]: 0x71764129 argv[4]: 1600 argv[5]: 200 argv[6]: 400 argv[7]: 3 //-------------------------------------- ② 以上信息是收到校准命令 ble_crystal_cali init ble_crystal_cali start curtick1 2020 NAND factory magic error 0x58ce33c5 vs 0x53450617 FACTORY_CFG_ID_CRYSTAL read fail with 0 sem outoftime, bt mac state: 87 macirq_cnt: 0 macirq_cntbak: 0 ... sem outoftime, bt mac state: 87 macirq_cnt: 0 macirq_cntbak: 0 timeout, curtick2 22199 intnum 0 //-------------------------------------- ③ 以上信息是校准流程，未收到校准信号，超时结束 CRYSTAL_CALI_FAIL CRYSTAL_CALI_FAIL //-------------------------------------- ④ 以上信息是校准失败
校准流程正常但参数超范围
当出现如下 log 类似信息，校准流程启动且正常完成，但显示校准参数超出预设范围导致失败，建议联系FAE同事确认48M晶体参数及外围电感电容是否合理，如果确认正常则可以通过修改Impeller工具下Impeller.ini文件来放宽参数范围。 在 Impeller.ini 文件中的 [CALI_SET] 子项中添加两行配置：
CALI_CBANK_MAX=0x3ff
CALI_CBANK_MAX=0x05校准失败(校准值超范围) log 信息
Serial:c2,Chip:4,Package:3,Rev:2 Reason:00000000 \ | / - SiFli Corporation / | \ build on Oct 30 2025, 2.4.0 build 4f1f8907 2020 - 2022 Copyright by SiFli team curent ver 20251030, otpbase 0x62000000 psram size:0x800000 addr:0x60000000 //-------------------------------------- ① 以上信息是驱动加载成功 R: ble_crystal_cali 20 6 0x71764129 1600 200 400 3 argv[1]: 20 argv[2]: 6 argv[3]: 0x71764129 argv[4]: 1600 argv[5]: 200 argv[6]: 400 argv[7]: 3 //-------------------------------------- ② 以上信息是收到校准命令 ble_crystal_cali init ble_crystal_cali start curtick1 2020 NAND factory magic error 0x58ce33c5 vs 0x53450617 FACTORY_CFG_ID_CRYSTAL read fail with 0 time:253760 cbank_sel:300 time:256252 cbank_sel:380 time:262499 cbank_sel:380 time:801246 cbank_sel:340 time:797500 cbank_sel:340 time:1362501 cbank_sel:340 time:1832501 cbank_sel:340 bleRx 2 (0 0) time:2325001 cbank_sel:340 bleRx 2 (1 1) time:2343751 cbank_sel:340 bleRx 2 (1 2) time:2338751 cbank_sel:340 curtick2 8309 CBANK_SEL value 0x340 out of range 0x40-0x300 //-------------------------------------- ③ 以上信息是校准流程，校准值超过约束范围 CRYSTAL_CALI_FAIL 0x340 CRYSTAL_CALI_FAIL 0x340 //-------------------------------------- ④ 以上信息是校准失败