移植 on Void Fox

交叉编译 OpenOCD 到 Windows 使用

Mon, 02 Sep 2024 18:20:00 +0800

1. 准备工作

本文基于 openocd (commit: cbc32c3) 进行撰写，在 Linux 中使用 mingw32 将 OpenOCD 编译成 Win32 应用。

OpenOCD 依赖以下项目：

libusb
本文使用版本：1.0.26
hidapi
本文使用版本：0.13.1
libftdi1
本文使用版本：1.5
capstone
本文使用版本：4.0.2
libjaylink
本文使用版本：0.3.1
jimtcl
本文使用版本：0.83

上述依赖下载源码后解压备用。

2. 编译

使用下方脚本进行编辑。
该脚本参考了 xpack 的编译方式。
OpenOCD 的编译选项可参考该项目下的 configure 的 help 。

#!/bin/bash

BUILD_DIR=/path/to/openocd/build/dir

# set source env
export OPENOCD_SRC=/path/to/openocd
export LIBUSB1_SRC=/path/to/libusb-1.0.26
export HIDAPI_SRC=/path/to/hidapi-0.13.1
export LIBFTDI_SRC=/path/to/libftdi1-1.5
export CAPSTONE_SRC=/path/to/capstone-4.0.2
export LIBJAYLINK_SRC=/path/to/libjaylink-0.3.1
export JIMTCL_SRC=/path/to/jimtcl-0.83

# configure openocd
cd /path/to/openocd
./bootstrap

config_opts=()

config_opts+=("--disable-wextra")
config_opts+=("--disable-werror")
config_opts+=("--disable-gccwarnings")
config_opts+=("--disable-doxygen-html")
config_opts+=("--disable-doxygen-pdf")

config_opts+=("--enable-amtjtagaccel")
config_opts+=("--enable-angie")
config_opts+=("--enable-armjtagew")
config_opts+=("--enable-cmsis-dap")
config_opts+=("--enable-cmsis-dap-v2")
config_opts+=("--enable-dummy")
config_opts+=("--enable-esp-usb-jtag")
config_opts+=("--enable-ft232r")
config_opts+=("--enable-ftdi")
config_opts+=("--enable-gw16012")
config_opts+=("--enable-jlink")
config_opts+=("--enable-jtag_dpi")
config_opts+=("--enable-jtag_vpi")
config_opts+=("--enable-kitprog")
config_opts+=("--enable-nulink")
config_opts+=("--enable-opendous")
config_opts+=("--enable-openjtag")
config_opts+=("--enable-osbdm")
config_opts+=("--enable-parport")
config_opts+=("--enable-parport-giveio")
config_opts+=("--enable-presto")
config_opts+=("--enable-remote-bitbang")
config_opts+=("--enable-rlink")
config_opts+=("--enable-stlink")
config_opts+=("--enable-ti-icdi")
config_opts+=("--enable-ulink")
config_opts+=("--enable-usb-blaster")
config_opts+=("--enable-usb-blaster-2")
config_opts+=("--enable-usbprog")
config_opts+=("--enable-vdebug")
config_opts+=("--enable-vsllink")
config_opts+=("--enable-xds110")

config_opts+=("--disable-am335xgpio")          # only available on linux
config_opts+=("--disable-at91rm9200")          # only available on linux
config_opts+=("--disable-bcm2835gpio")         # only available on linux
config_opts+=("--disable-imx_gpio")            # only available on linux
config_opts+=("--disable-buspirate")           # not support by MinGW
config_opts+=("--disable-dmem")                # only available on linux
config_opts+=("--disable-parport-ppdev")       # only available on linux or freebsd
config_opts+=("--disable-rshim")               # only available on linux or freebsd
config_opts+=("--disable-sysfsgpio")           # only available on linux
config_opts+=("--disable-xlnx-pcie-xvc")       # only available on linux

# configure hidapi
cd $HIDAPI_SRC
./bootstrap

# configure libjaylink
cd $LIBJAYLINK_SRC
./autogen

# setup env
export MAKE_JOBS=16
export HOST=i686-w64-mingw32
export LIBUSB1_CONFIG="--enable-shared --disable-static"
export HIDAPI_CONFIG="--enable-shared --disable-static --disable-testgui"
export LIBFTDI_CONFIG="-DSTATICLIBS=OFF -DEXAMPLES=OFF -DFTDI_EEPROM=OFF"
export CAPSTONE_CONFIG="CAPSTONE_BUILD_CORE_ONLY=yes CAPSTONE_STATIC=yes CAPSTONE_SHARED=no"
export LIBJAYLINK_CONFIG="--enable-shared --disable-static"
export JIMTCL_CONFIG="--with-ext=json --minimal --disable-ssl"
export OPENOCD_CONFIG=${config_opts[@]}

cd $OPENOCD_SRC

# check if there is tag pointing at HEAD, otherwise take the HEAD SHA-1 as OPENOCD_TAG
OPENOCD_TAG="`git tag --points-at HEAD`"
[ -z $OPENOCD_TAG ] && OPENOCD_TAG="`git rev-parse --short HEAD`"
# check if there is tag pointing at HEAD, if so the release will have the same name as the tag,
# otherwise it will be named 'latest'
RELEASE_NAME="`git tag --points-at HEAD`"
[ -z $RELEASE_NAME ] && RELEASE_NAME="latest"
[[ $RELEASE_NAME = "latest" ]] && IS_PRE_RELEASE="true" || IS_PRE_RELEASE="false"

# set env and call cross-build.sh
export OPENOCD_TAG=$OPENOCD_TAG
mkdir -p $BUILD_DIR && cd $BUILD_DIR
bash $OPENOCD_SRC/contrib/cross-build.sh $HOST

[ $? -eq 0 ] || exit

# add missing dlls
cd $HOST-root/usr
cp `$HOST-gcc --print-file-name=libwinpthread-1.dll` ./bin/
# required by libftdi1.dll. For the gcc-mingw-10.3.x or later "libgcc_s_dw2-1.dll" will need to be copied.
cp `$HOST-gcc --print-file-name=libgcc_s_dw2-1.dll` ./bin/

# prepare the artifact
ARTIFACT="openocd-${OPENOCD_TAG}-${HOST}.tar.gz"
tar -czf $ARTIFACT *
echo "RELEASE_NAME=$RELEASE_NAME"
echo "IS_PRE_RELEASE=$IS_PRE_RELEASE"
echo "ARTIFACT_PATH=$PWD/$ARTIFACT

3. 使用

将 /path/to/openocd/build/dir/i686-w64-mingw32-root/usr/ 目录下的文件，拷贝至 Windows 中即可使用。

附1. 文章修订记录

2024-09-02
- 初次发表
2025-07-18
- 根据最新的 openocd 源码更新编译流程

移植 OpenSSH

Fri, 30 Jul 2021 19:08:55 +0800

1. 准备工作

OpenSSH 依赖 zlib、OpenSSL。

源码下载：

zlib
zlib.net
OpenSSL
openssl.org
OpenSSH
mirrors.aliyun.com

本文基于 zlib-1.2.11、openssl-1.1.1k、openssh-8.6p1 撰写。

2. 交叉编译

2.1. zlib

2.1.1. 配置 Makefile

1
2
3

CHOST=arm-linux \
./configure \
--prefix=/path/to/install

CHOST
zlib 的 configure 使用此变量自动配置交叉编译工具的前缀，按上述配置，即自动将交叉编译工具名称设为 arm-linux-gcc、arm-linux-ld 等。

2.1.2. 编译与安装

`1`	`make && make install`

将安装在 --prefix 所指定的目录。

2.2. OpenSSL

参考之前的文章移植 OpenSSL。

2.3. OpenSSH

2.3.1. 配置 Makefile

CC=arm-linux-gcc \
./configure \
--host=arm-linux \
--with-libs \
--with-zlib=/path/to/zlib/install \
--with-ssl-dir=/path/to/openssl/install \
--disable-etc-default-login

CC
指定交叉编译工具。
--host
目标平台，交叉编译时需指定。
--with-zlib
指定 zlib 的安装位置。
--with-ssl-dir
指定 openssl 的安装位置，如果 openssl 下有共享库，则编译时自动使用 openssl 的共享库（按照上述配置情况下），否则使用静态库。

此处使用默认路径，不设置 –prefix。

2.3.2. 编译

make

注意：这里不要安装。

3. 在目标板上使用

3.1. 安装至目标板

3.1.1. 准备工作

确保目标板上有以下目录，没有则创建
- /usr/libexec
- /usr/local/bin
- /usr/local/etc

在目标板 /etc/passwd 文件中添加一行

`1`	`sshd:x:74:74:Privilege-separated SSH:/var/empty/sshd:/sbin/nologin`

设置 root 用户密码（已设置则忽略）
1

passwd -a md5 root

3.1.2. 拷贝程序至目标板

将 OpenSSH 交叉编译后的文件（在 openssh-8.6p1 根目录）拷贝至目标板相应目录

文件名	目标板目录
sftp-server	/usr/libexec
ssh-keysign	/usr/libexec
sshd	/usr/local/bin
ssh	/usr/local/bin
scp	/usr/local/bin
sftp	/usr/local/bin
ssh-add	/usr/local/bin
ssh-agent	/usr/local/bin
ssh-keygen	/usr/local/bin
ssh-keyscan	/usr/local/bin
sshd_config	/usr/local/etc
ssh_config	/usr/local/etc

此为默认路径，若在配置时设定了相关目录，则按设定修改。

在目标板建立软链

cd /usr/bin
ln -s ../local/bin/sshd && \
ln -s ../local/bin/ssh && \
ln -s ../local/bin/scp && \
ln -s ../local/bin/sftp && \
ln -s ../local/bin/ssh-add && \
ln -s ../local/bin/ssh-agent && \
ln -s ../local/bin/ssh-keygen && \
ln -s ../local/bin/ssh-keyscan

修改目标板上的 sshd_config 文件
原内容：

...
#Port 22
...
#PermitRootLogin prohibit-password
...

修改为：

...
Port 22
...
PermitRootLogin yes
...

3.2. 建立工作目录

在目标板上建立工作目录

1
2

mkdir /var/run
mkdir -p /var/empty/sshd

确保目标板 /var/empty/sshd 的权限为 755
1

chmod -R 755 /var/empty

在目标板上挂载 devpts

1
2

mkdir /dev/pts
mount devpts -t devpts /dev/pts

3.3. 生成密钥

1
2
3

cd /usr/local/etc
ssh-keygen -t ed25519 -f ssh_host_ed25519_key -N ""
ssh-keygen -t ed25519 -f ssh_host_key -N ""

3.4. 开启 sshd

`1`	`/usr/sbin/sshd`

移植 Paho MQTT

Tue, 13 Jul 2021 14:24:40 +0800

1. 准备工作

1.1. 下载源码

两种方式下载源码:

git clone
直接下载指定 tag 源码

对于第 1 种方式，会把历史 commit 都 clone 下来，对于立项久远、社区活跃的项目来说，体积较大，加之 github 在国内访问不稳定，而且只是使用不是开发，所以这里选择第 2 种方式。

在其项目 Release 页找到最新的 Release Tag，下载 Source code。

1.2. 安装依赖

`1`	`apt install build-essential gcc make cmake cmake-gui cmake-curses-gui`

如果需要使用 SSL 功能，则还需要预先交叉编译 OpenSSL，可参考之前的文章移植 OpenSSL。

如果需要生成文档，还需要安装 doxygen 和 graphhviz：

`1`	`apt install doxygen graphviz`

2. 配置 Makefile

2.1. 修改交叉编译工具链

新建一个目录作为编译用目录，拷贝 paho.mqtt 源码目录下 cmake 目录内的 toolchain.linux-arm11.cmake 至编译用目录，修改以下内容为自己的交叉编译工具链：

`1`	`SET(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)`

2.2. 生成 Makefile

cmake \
-DPAHO_WITH_SSL=TRUE \
-DPAHO_BUILD_SAMPLES=TRUE \
-DPAHO_BUILD_DOCUMENTATION=TRUE \
-DPAHO_HIGH_PERFORMANCE=TRUE \
-DOPENSSL_ROOT_DIR=/path/to/openssl/install/root \
-DCMAKE_TOOLCHAIN_FILE=/path/to/toolchain.linux-arm11.cmake \
/path/to/paho.mqtt.c/source

参数	默认值	描述
PAHO_BUILD_SHARED	TRUE	编译成共享库
PAHO_BUILD_STATIC	FALSE	编译成静态库
PAHO_HIGH_PERFORMANCE	FALSE	高性能模式，如果设为 TRUE 则编译时 debug 追踪等功能将会被排除
PAHO_WITH_SSL	FALSE	开启 SSL 功能
OPENSSL_ROOT_DIR	“”	OpenSSL 安装目录
PAHO_BUILD_DOCUMENTATION	FALSE	生成文档
PAHO_BUILD_SAMPLES	FALSE	编译示例

如果 OPENSSL_ROOT_DIR 目录内含有共享库，那么编译完成的 paho.mqtt 共享库需要依赖 OpenSSL 的共享库。

3. 编译

make

如果遇到 ld: cannot find -lanl 的错误，则需要在源码目录下，找到 src/CMakeLists.txt，将其中的以下内容注释（使用 # 注释）：

FIND_LIBRARY(LIB_ANL anl)
IF(LIB_ANL)
    SET(LIBS_SYSTEM "${LIBS_SYSTEM}" anl)
ENDIF()

然后重新生成一次 Makefile。原因是 libanl 只支持 glibc。

3.1. 打包（可选）

`1`	`make package`

移植 OpenSSL

Tue, 13 Jul 2021 10:11:05 +0800

1. 源码

官网：https://www.openssl.org/source/

2. 配置 Makefile

./Configure linux-armv4 \
--cross-compile-prefix=arm-linux- \
--prefix=/path/to/install \
no-asm shared no-async

linux-armv4
从 config 文件来看，armv[1-3] 使用 linux-generic32，armv[7-9] 使用 linux-armv4。
no-asm
不使用汇编代码；从 INSTALL 文件得知，建议 debug 期间使用，生产环境不使用。
shared
生成共享库。
no-async
uclibc/musll-ibc 等库不提供 ucontext 库，所以无法使用异步操作。

此配置是基于 openssl-1.1.1k 所写，不同版本可能会有差异，具体查看源码目录下的 INSTALL 文件。

3. 编译与安装

`1`	`make && make install`

最终程序将安装在 --prefix 所指定的目录中。