﻿================================================================================
                                样例使用说明
================================================================================
Date            Author      IAR       MDK       GCC
2024-09-13      CDT         7.70      5.36      gcc-arm-none-eabi-10.3-2021.10-win32

================================================================================
平台说明
================================================================================
GCC工程，由Eclipse IDE外挂GNU-ARM Toolchain，再结合pyOCD GDB Server实现工程的编译、
链接和调试。在用Eclipse导入工程后，请将xxxx_PyOCDDebug中pyocd-gdbserver和SVD文件
设置为正确的路径；请将xxxx_PyOCDDownload中pyocd设置为正确的路径。注意，这些路径不
能包含非英文字符。

================================================================================
功能描述
================================================================================
本样例展示数据安全保护功能

================================================================================
测试环境
================================================================================
测试用板:
---------------------
EV_A4A8_LQ176_Rev1.0

辅助工具:
---------------------
无

辅助软件:
---------------------
xhsc_auth.exe

================================================================================
使用步骤
================================================================================
一、操作前特别注意
1）保护等级3使能后，只能通过用户程序片擦解锁
2）OTP功能使能后，片擦解锁功能无效

二、操作步骤
1）打开工程，配置保护等级
   在 hc32a4xx_conf.h 中修改 EXAMPLE_DATA_PROTECT_SELECTION 宏的值
   默认配置为保护等级1: EXAMPLE_DATA_PROTECT_ENABLE_LV1
2）编译、启动IDE的下载和调试功能
3）对测试用板重新上电、确认 LED 蓝灯亮
4）根据配置的保护等级执行对应的操作

  A）EXAMPLE_DATA_PROTECT_ENABLE_LV1 配置对应的操作
    a）查看保护状态：通过xhsc_auth.exe可查看到 “安全保护1状态 Lock”
    b）解锁保护等级1：可通过以下任一方式解锁
     --在xhsc_auth.exe中输入密码 “111111111111”，解锁后显示 “安全保护1状态 Unlock”
     --在xhsc_auth.exe中点击片擦按钮，解锁后显示 “安全保护1状态 Free”
     --先按下测试用板上的 K5 键，再按下 K0 键

  B）EXAMPLE_DATA_PROTECT_ENABLE_LV2 配置对应的操作
    a）查看保护状态：通过xhsc_auth.exe可查看到 “安全保护2状态 Lock”
    b）解锁保护等级2：可通过以下任一方式解锁
     --在xhsc_auth.exe中点击片擦按钮，解锁后显示 “安全保护2状态 Free”
     --先按下测试用板上的 K5 键，再按下 K0 键

  C）EXAMPLE_DATA_PROTECT_ENABLE_LV3 配置对应的操作
    a）查看保护状态：通过xhsc_auth.exe可查看到 “安全保护3状态 Lock”
    b）解锁保护等级3：只能通过用户程序片擦解锁
     --先按下测试用板上的 K5 键，再按下 K0 键

================================================================================
注意
================================================================================
1）在bus_hold时，进行编程和擦除请勿单步调试，单步调试有可能使芯片发生未知错误
2）当使用xhsc_auth.exe连接测试用板时遇到“connect fail”的提示，并且切换了interface（在
xhsc_auth.exe界面上显示为TIF）或点击刷新按钮后仍有相同提示，请按照以下步骤重新建立连接：
    a）确认J-link设备与PC及测试用板之间的连接正常
    b）对测试用板重新上电
    c）点击xhsc_auth.exe上的刷新按钮
    d）如果问题依然存在，请重启 xhsc_auth.exe 软件再试
3）通过xhsc_auth.exe密码解锁安全保护1之后，若还需继续实验，请先片擦芯片并重新上电后再进行

================================================================================
