PyOCD部分源码解析

mysoftlab

于 2025-03-27 22:55:31 发布

阅读量942

点赞数 15

分类专栏：单片机文章标签：单片机

本文链接：https://blog.youkuaiyun.com/2402_88871930/article/details/146573516

版权

单片机专栏收录该内容

2 篇文章

订阅专栏

PyOCD部分源码解析

1. 探测下载器流程

检测下载器部分代码：

ConnectHelper.list_connected_probes()
allProbes = ConnectHelper.get_all_connected_probes(blocking=False)
allProbes = DebugProbeAggregator.get_all_connected_probes(unique_id=unique_id)

使用静态方法进行探测，probe目录下实现了几种常见的调试器，如CMSIS DAP、Jlink等，采用插件加载的方式加载这些probe的子类，这些子类统一继承自DebugProbe。

cmsis_dap_probe.py内的get_all_connected_probes方法描述了如何发现dap设备。

cmsis_access_cmsis_dap.py中的DAPAccessCMSISDAP是具体实现细节，DAPAccess.get_connected_devices()，在此方法中调用两个接口，一个是CMSIS-DAPv1 interfaces，另一个是CMSIS-DAPv2 interfaces
board.py中根据target_override参数来实例化target：

# Convert dashes to underscores in the target type, and convert to lower case.
target = normalise_target_type_name(target)
self._target_type = target
self.target = TARGET[self._target_type](session)#实例化

2.硬件相关

插入CMSIS DAP，使用pyocd list命令能够获取到设备信息：

(base) C:\Users\Administrator>pyocd list
  #   Probe/Board                                   Unique ID      Target
---------------------------------------------------------------------------
  0   CMSIS-DAP by muselab-tech.com JCK CMSIS-DAP   0001A0000001   n/a

在设备管理器中可以看到设备类型和VID&PID：

在这里插入图片描述

3.loader子命令执行流程

（1）调用load_cmd.py中invoke方法
（2）ConnectHelper.session_with_chosen_probe方法获取session，该方法如下：

# Choose a probe.
probe = ConnectHelper.choose_probe(
    blocking=blocking,
    return_first=return_first,
    unique_id=unique_id,
)
if probe is None:
    return None
else:
    return Session(probe, auto_open=auto_open, options=options, **kwargs)

choose_probe方法调用流程如下：
● 首先获取所有已连接的设备ConnectHelper.get_all_connected_probes(blocking=blocking, unique_id=unique_id)；
● DebugProbeAggregator通过PROBE_CLASSES存储所有类型的下载器，如CMSIS-DAP等，通过load_plugin_classes_of_type(‘pyocd.probe’, PROBE_CLASSES, DebugProbe)方法扫描并注册基类为DebugProbe的类，load_plugin_classes_of_type返回所有继承自DebugProbe的类并添加到PROBE_CLASSES字典；
● pydapaccess.py中的get_connected_devices()方法获取已经连接的设备
● 调用dap_access_cmsis_dap.py中的get_connected_devices方法
● 通过调用_get_interfaces方法获取连接设备
● 分别通过v1_interfaces(USB_BACKEND)和v2_interfaces(USB_BACKEND_V2)来执行get_all_connected_interfaces
● interface目录下包含各种版本的DAP接口，可以通过环境变量来控制使用何种版本的接口，如果环境变量不指定，USB_BACKEND那么根据操作系统版本进行不同的操作，windows系统如果HidApiUSB.isAvailable，就优先使用HidApi，否则使用PyWinUSB.isAvailable就使用WinUSB，如果是MacOS则使用hidapiusb，如果是Linux则使用pyusb。
● USB_BACKEND_V2使用pyusb_v2
● 默认windows使用hidapi_backend.py
Session中board包含target的信息。

4.擦除流程

（1）ConnectHelper.session_with_chosen_probe获取session，session中的target为CoreSightTarget
（2）创建FlashEraser
（3）执行erase方法，该方法传递一个地址参数address，默认此处跟的是整片擦除，所以_mode为Mode.CHIP
（4）调用_chip_erase()方法
（5）执行以下代码：

if self._log_chip_erase:
            LOG.info("Erasing chip...")
        # Erase all flash regions. This may be overkill if either each region's algo erases
        # all regions on the chip. But there's no current way to know whether this will happen,
        # so prefer to be certain.
        for region in self._session.target.memory_map.iter_matching_regions(type=MemoryType.FLASH):
            if region.flash is not None:
                if region.flash.is_erase_all_supported:
                    region.flash.init(region.flash.Operation.ERASE)
                    region.flash.erase_all()
                    region.flash.cleanup()
                else:
                    self._sector_erase([(region.start, region.end)])
        if self._log_chip_erase:
                LOG.info("Chip erase complete")