STEPBYSTEP设计一个RISC-V仿真器之二:OpenOCD适配新的设备驱动

原创 嵌入式Lee 2024-12-04 08:30

一. 前言

前面我们分享了openocd的构建过程,以及使用gdb进行仿真调试,为开发做好了准备。现在我们就来分享如何为openocd适配新的驱动,即适配新的仿真器硬件。

二. 适配新的驱动过程

假设我们要添加一个我们自己的xxlink硬件驱动。

2.1.修改配置configure.ac

修改configure.ac

先添加适配器类型,在

m4_define([USB1_ADAPTERS],下添加一行

[[xxlink], [XXLINK devices], [XXLINK]],

AC_ARG_ENABLE 部分,添加内容如下:

AC_ARG_ENABLE([xxlink],

AS_HELP_STRING([--enable-xxlink], [Enable building support for XXLINK]),

[build_xxlink=$enableval], [build_xxlink=no])

AS_IF 部分,添加内容如下:

AS_IF([test "x$build_xxlink" = "xyes"], [

AC_DEFINE([BUILD_XXLINK], [1], [1 if you want XXLINK.])

], [

AC_DEFINE([BUILD_XXLINK], [0], [0 if you don't want XXLINK.])

])

AM_CONDITIONAL 部分,添加内容如下:

AM_CONDITIONAL([XXLINK], [test "x$build_xxlink" = "xyes"])

2.2.添加驱动源码

参考ft232r.c

添加xxlink.c

即要实现

struct adapter_driver xxlink_adapter_driver = {

};

可以看到要实现一个新的驱动只要实现该结构体就可以了,

可以看到jtag操作就是要实现

xxlink_interface..execute_queue,这个我们后文再分享。

我们先实现简单的框架保证能先编译

2.3添加编译

src\jtag\drivers\Makefile.am中添加

if XXLINK

DRIVERFILES += %D%/xxlink.c

endif

src\jtag\interface.h中申明全局变量xxlink_adapter_driver

最后添加一行

extern struct adapter_driver xxlink_adapter_driver;

src\jtag\interfaces.c中数组adapter_drivers最后添加

#if BUILD_XXLINK == 1

&xxlink_adapter_driver,

#endif

Make后会自动在build\config.h

生成宏

/* 0 if you don't want XXLINK. */

#define BUILD_XXLINK 1

2.4构建

添加--enable-xxlink参数使能编译对应的驱动

../configure --prefix=/home/qinyunti/openocd/build --enable-xxlink

看到会打印

XXLINK devices yes

make -j4

make install

2.5添加配置文件

tcl/target

新建文件xxlink.cfg

adapter driver xxlink

adapter speed 1000

xxlink vid_pid 0x1122 0x3344

make install时会自动复制到build\share\openocd\scripts\interface

一. 驱动传递参数

以上我们分享了如何添加一个驱动支持,现在驱动只是一个简单的框架还未实现任何功能,

我们先来了解openocd是如何找到我们实现的驱动,如何给驱动传递参数的。这有助于我们后面驱动的实现,比如我们要给驱动做一些参数配置等。

使用仿真跟踪方便查看执行过程

gdb --args bin/openocd.exe -f xxlink.cfg

3.1如何确定调用哪个驱动

我们一开始肯定想要知道openocd是如何找到我们的驱动的。

实际上openocd都是通过命令行中传入的参数-f指定的cfg文件来实现的。

cfg文件可以认为是一个脚本文件,openocd会解析该文件中的命令行,根据字符串进行匹配,调用对应的命令处理函数。

我们来看如何识别驱动的过程:

.\openocd.exe -f xxlink.cfg执行时

执行到main->openocd_main->openocd_thread->parse_cmdline_args->

char *command = alloc_printf("script {%s}", optarg); 之后

malloc了缓存command,且其内容初始化为了"script {xxlink.cfg}",可以指定多个cfg文件

继续

add_config_command(command);

config_file_names char **指针,

首先将其realloc扩展一个char* 指针位置,

然后strdup动态分配空间,将cfg字符串复制到该动态空间,

config_file_names[num_config_files-1]指向该动态空间。

num_config_files++;记录有多少个配置文件

void add_config_command(const char *cfg){    num_config_files++;    config_file_names = realloc(config_file_names, (num_config_files + 1) * sizeof(char *));
    config_file_names[num_config_files-1] = strdup(cfg);    config_file_names[num_config_files] = NULL;}

然后处理配置文件

openocd_thread->parse_config_file

如果上面没有指定配置文件即config_file_names为空,则使用默认配置文件

script openocd.cfg

如果指定了配置文件,则遍历配置文件config_file_names

每个配置文件都调用command_run_line进行处理

int parse_config_file(struct command_context *cmd_ctx){    int retval;    char **cfg;
    if (!config_file_names) {        command_run_line(cmd_ctx, "script openocd.cfg");        return ERROR_OK;    }
    cfg = config_file_names;
    while (*cfg) {        retval = command_run_line(cmd_ctx, *cfg);        if (retval != ERROR_OK)            return retval;        cfg++;    }
    return ERROR_OK;}

command_run_line

调用retcode = Jim_Eval_Named(interp, line, NULL, 0);

即整个过程是根据xxlink.cfg中的

adapter driver xxlink

先根据adapter匹配interface_command_handlers.name = "adapter"

继续搜寻子命令.chain = adapter_command_handlers,

根据driver匹配adapter_command_handlers.name = "driver",

调用.handler = handle_adapter_driver_command,

handle_adapter_driver_command中匹配xxlinkadapter_drivers这个数组成员的

name, 匹配之后设置全局变量记录使用的驱动adapter_driver = adapter_drivers[i];

3.2驱动命令

如果我们要给驱动传递一些参数怎么做呢,依旧是通过cfg文件中的命令行来实现。

先写一个简单的驱动程序测试

类似adapter driver xxlink

xxlink.cfg

xxlink vid_pid 0x1122 0x3344

会根据xxlink找到驱动

xxlink_adapter_driver

然后找到xxlink_command_handlers匹配

.name = "xxlink",

下一级还是子命令

.chain = xxlink_subcommand_handlers,

继续找到xxlink_subcommand_handlers匹配

.name = "vid_pid",

回调

.handler = xxlink_handle_vid_pid_command,


对应的代码如下

Xxlink.c

// SPDX-License-Identifier: GPL-2.0-or-later
/*************************************************************************** *   Copyright (C) 2024              xx                                    * *   xxxxx@xxx.xx                                                          * ***************************************************************************/
#ifdef HAVE_CONFIG_H#include "config.h"#endif
#if IS_CYGWIN == 1#include "windows.h"#undef LOG_ERROR#endif
/* project specific includes */#include #include #include #include #include "libusb_helper.h"
/* system includes */#include #include #include #include #include
static uint16_t xxlink_vid = 0x0403;static uint16_t xxlink_pid = 0x6001;
static int xxlink_init(void){    LOG_DEBUG("xxlink_init");           return ERROR_OK;}
static int xxlink_quit(void){    LOG_DEBUG("xxlink_quit");           return ERROR_OK;}
static int xxlink_speed_div(int divisor, int *khz){    /* Maximum 3 Mbaud. */    if (divisor == 0)        *khz = 3000;    else if (divisor == 1)        *khz = 2000;    else        *khz = 3000 / divisor;    LOG_DEBUG("xxlink_speed_div divisor=%d rate %d khz", divisor, *khz);        return ERROR_OK;}
static int xxlink_khz(int khz, int *divisor){    if (khz == 0) {        LOG_DEBUG("RCLK not supported");        return ERROR_FAIL;    }
    /* Calculate frequency divisor. */    if (khz > 2500)        *divisor = 0;       /* Special case: 3 MHz */    else if (khz > 1700)        *divisor = 1;       /* Special case: 2 MHz */    else {        *divisor = (2*3000 / khz + 1) / 2;        if (*divisor > 0x3FFF)            *divisor = 0x3FFF;    }    LOG_DEBUG("xxlink_khz %d divisor=%d", khz, *divisor);    return ERROR_OK;}
static int xxlink_speed(int divisor){    int baud = (divisor == 0) ? 3000000 :        (divisor == 1) ? 2000000 :        3000000 / divisor;    LOG_DEBUG("xxlink_speed(%d) rate %d bits/sec", divisor, baud);
    //if (jtag_libusb_control_transfer(adapter,    //  LIBUSB_REQUEST_TYPE_VENDOR | LIBUSB_RECIPIENT_DEVICE | LIBUSB_ENDPOINT_OUT,    //  SIO_SET_BAUD_RATE, divisor, 0, NULL, 0, 1000, NULL) != ERROR_OK) {    //  LOG_ERROR("cannot set baud rate");    //  return ERROR_JTAG_DEVICE_ERROR;    //}
    return ERROR_OK;}
COMMAND_HANDLER(xxlink_handle_vid_pid_command){    if (CMD_ARGC > 2) {        LOG_WARNING("ignoring extra IDs in ft232r_vid_pid "                    "(maximum is 1 pair)");        CMD_ARGC = 2;    }    if (CMD_ARGC == 2) {        COMMAND_PARSE_NUMBER(u16, CMD_ARGV[0], xxlink_vid);        COMMAND_PARSE_NUMBER(u16, CMD_ARGV[1], xxlink_pid);        LOG_DEBUG("xxlink_vid:%x,xxlink_pid:%x",xxlink_vid,xxlink_pid);    } else        LOG_WARNING("incomplete ft232r_vid_pid configuration");
    return ERROR_OK;}
static const struct command_registration xxlink_subcommand_handlers[] = {    {        .name = "vid_pid",        .handler = xxlink_handle_vid_pid_command,        .mode = COMMAND_CONFIG,        .help = "USB VID and PID of the adapter",        .usage = "vid pid",    },    COMMAND_REGISTRATION_DONE};
static const struct command_registration xxlink_command_handlers[] = {    {        .name = "xxlink",        .mode = COMMAND_ANY,        .help = "perform xxlink management",        .chain = xxlink_subcommand_handlers,        .usage = "",    },    COMMAND_REGISTRATION_DONE};
static struct jtag_interface xxlink_interface = {    .supported = DEBUG_CAP_TMS_SEQ,    //.execute_queue = syncbb_execute_queue,};
struct adapter_driver xxlink_adapter_driver = {    .name = "xxlink",    .transports = jtag_only,    .commands = xxlink_command_handlers,
    .init = xxlink_init,    .quit = xxlink_quit,    .speed = xxlink_speed,    .khz = xxlink_khz,    .speed_div = xxlink_speed_div,
    .jtag_ops = &xxlink_interface,};

对应的打印如下

Debug: 25 137 xxlink.c:107 xxlink_handle_vid_pid_command(): xxlink_vid:1122,xxlink_pid:3344

五. 总结

以上我们分享了如何给openocd添加一个驱动实现,了解了openocd是如何匹配我们的驱动,以及如何给驱动传递参数的。为后续驱动的实现做好了准备。






评论 (0)
  •   基于 2025 年行业权威性与时效性,以下梳理国内知名软件定制开发企业,涵盖综合型、垂直领域及特色技术服务商:   华盛恒辉科技有限公司:是一家专注于高端软件定制开发服务和高端建设的服务机构,致力于为企业提供全面、系统的开发制作方案。在部队政企开发、建设到运营推广领域拥有丰富经验,在教育,工业,医疗,APP,管理,商城,人工智能,部队软件、工业软件、数字化转型、新能源软件、光伏软件、汽车软件,ERP,系统二次开发,CRM等领域有很多成功案例。   五木恒润科技有限公司:是一家专业的部队信
    华盛恒辉l58ll334744 2025-05-12 16:13 72浏览
  • 蓝牙耳机是长这个样子,如下图。背部图,如下图。拆开L耳的一侧,有NFC和电池包(501230 3.7V 150mAh)如下图。电池包(501230 3.7V 150mAh)如下图。NFC正面,如下图。NFC背面,如下图。如何理解NFC的工作原理呢,搜集一下相关的资料,如下图。拆开R耳的一侧,PCB正面,如下图。PCB背面,如下图。有两组红黑的线,一组连接到了喇叭,另一组连接到了MIC头上,MIC头参数如下图。蓝牙模块(CSR 8635),有蛇形PCB走线做成天线,节约了天线成本,如下图。该IC介
    liweicheng 2025-05-10 00:45 39浏览
  • 【拆解】+自动喷香机拆解 家里之前买了从PDD买了一个小型自动喷香机放在厕所里。来增加家里的温馨感,这东西看着确实小巧,精致。可是这东西吧,耗电就是快,没过几天就没电了。今个就让我拆开看看什么在捣鬼。如下是产品的实物和宣传图: 由于螺丝孔太小和限位很深。对于我的螺丝刀套装没用。只能使用那种螺丝刀细头,同时又长的小螺丝刀进行拆解 拧下三颗螺丝钉,用一字螺丝刀撬开外壳,内部结构就呈现在眼前。 内部构造相当简单,部件没多少。就是锂电池供电,通过MCU实现按键控制,段码屏控制,LE
    zhusx123 2025-05-10 19:55 56浏览
  •   定制软件开发公司推荐清单   在企业数字化转型加速的2025年,定制软件开发需求愈发多元复杂。不同行业、技术偏好与服务模式的企业,对开发公司的要求大相径庭。以下从技术赛道、服务模式及行业场景出发,为您提供适配的定制软件开发公司推荐及选择建议。   华盛恒辉科技有限公司:是一家专注于高端软件定制开发服务和高端建设的服务机构,致力于为企业提供全面、系统的开发制作方案。在部队政企开发、建设到运营推广领域拥有丰富经验,在教育,工业,医疗,APP,管理,商城,人工智能,部队软件、工业软件、数字化转
    华盛恒辉l58ll334744 2025-05-12 15:55 106浏览
  • 在 AI 浪潮席卷下,厨电行业正经历着深刻变革。AWE 2025期间,万得厨对外首次发布了wan AiOS 1.0组织体超智能系统——通过AI技术能够帮助全球家庭实现从健康检测、膳食推荐,到食材即时配送,再到一步烹饪、营养总结的个性化健康膳食管理。这一创新之举并非偶然的个案,而是整个厨电行业大步迈向智能化、数字化转型浪潮的一个关键注脚,折射出全行业对 AI 赋能的热切渴求。前有标兵后有追兵,万得厨面临着高昂的研发成本与技术迭代压力,稍有懈怠便可能被后来者赶
    用户1742991715177 2025-05-11 22:44 73浏览
  •         信创产业含义的“信息技术应用创新”一词,最早公开信息见于2019年3月26日,在江苏南京召开的信息技术应用创新研讨会。本次大会主办单位为江苏省工业和信息化厅和中国电子工业标准化技术协会安全可靠工作委员会。        2019年5月16日,美国将华为列入实体清单,在未获得美国商务部许可的情况下,美国企业将无法向华为供应产品。       2019年6
    天涯书生 2025-05-11 10:41 128浏览
  • ‌磁光克尔效应(Magneto-Optic Kerr Effect, MOKE)‌ 是指当线偏振光入射到磁性材料表面并反射后,其偏振状态(偏振面旋转角度和椭偏率)因材料的磁化强度或方向发生改变的现象。具体表现为:1、‌偏振面旋转‌:反射光的偏振方向相对于入射光发生偏转(克尔旋转角 θK)。2、‌椭偏率变化‌:反射光由线偏振变为椭圆偏振(克尔椭偏率 εK)。这一效应直接关联材料的磁化状态,是表征磁性材料(如铁磁体、反铁磁体)磁学性质的重要非接触式光学探测手段,广泛用于
    锦正茂科技 2025-05-12 11:02 95浏览
  • 体积大小:14*11*2.6CM,电气参数:输入100V-240V/10A,输出16V24A。PCB 正面如下图。PCB 背面如下图。根据实际功能可以将PCB分成几部分:EMI滤波,PFC电路,LLC电路。EMI滤波区域,两级共模电感,LN各用了保险丝加压敏电阻,继电器(HF32FV-G)用来切除NTC的,为了提高效率点,如下图。PFC电路区域,如下图。LLC电路区域,如下图。详细分析一下该电源用的主要IC还有功率器件。AC侧采用了两颗整流桥进行并联,器件增加电流应力,如下图。共模电感都有放电针
    liweicheng 2025-05-10 20:03 42浏览
  • 【拆解】+CamFi卡菲单反无线传输器拆解 对于单反爱好者,想要通过远程控制自拍怎么办呢。一个远程连接,远程控制相机拍摄的工具再合适不过了。今天给大伙介绍的是CamFi卡菲单反无线传输器。 CamFi 是专为数码单反相机打造的无线传输控制器,自带的 WiFi 功能(无需手机流量),不但可通过手机、平板、电脑等设备远程连接操作单反相机进行拍摄,而且还可实时传输相机拍摄的照片到 iPad 和电视等大屏设备进行查看和分享。 CamFi 支持大部分佳能和尼康单反相机,内置可充电锂离子电池,无需相机供电。
    zhusx123 2025-05-11 14:14 92浏览
  • 递交招股书近一年后,曹操出行 IPO 进程终于迎来关键节点。从 2024 年 4 月首次递表,到 2025 年 4 月顺利通过中国证监会境外发行上市备案,并迅速更新招股书。而通过上市备案也标志着其赴港IPO进程进入实质性推进阶段,曹操出行最快有望于2025年内完成港股上市,成为李书福商业版图中又一关键落子。行路至此,曹操出行面临的挑战依然不容忽视。当下的网约车赛道,早已不是当年群雄逐鹿的草莽时代,市场渐趋饱和,竞争近乎白热化。曹操出行此时冲刺上市,既是背水一战,也是谋篇布局。其招股书中披露的资金
    用户1742991715177 2025-05-10 21:18 57浏览
  • 在印度与巴基斯坦的军事对峙情境下,歼10C的出色表现如同一颗投入平静湖面的巨石,激起层层涟漪,深刻印证了“质量大于数量”这一铁律。军事领域,技术优势就是决定胜负的关键钥匙。歼10C凭借先进的航电系统、强大的武器挂载能力以及卓越的机动性能,在战场上大放异彩。它能够精准捕捉目标,迅速发动攻击,以一敌多却毫不逊色。与之形成鲜明对比的是,单纯依靠数量堆砌的军事力量,在面对先进技术装备时,往往显得力不从心。这一现象绝非局限于军事范畴,在当今社会的各个领域,“质量大于数量”都已成为不可逆转的趋势。在科技行业
    curton 2025-05-11 19:09 179浏览
我要评论
0
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦