有時候路過一間旅館時，覺得其外觀、環境、… 都很吸引人，讓人很想進去住一晚，便心想，這旅館條件很棒，生意應該很好吧？！

然而，旅館的生意好壞，是取決於當下街道路人經過所看到的外觀嗎？

很少人是到當地，看到門面，才決定直接入住的，而是在出發前，就已透過訂房網頁、Google Maps、旅遊情報就決定要住那一家的。

因此，決勝的關鍵，並不在當地旅館的外觀，而是在千里之外的訂房網站、旅遊情報網頁的曝光處。

幾日前(2024-09-30)，我意外在論壇上發現 Obsidian 支援一個小語法：

![some_note](some_note.md#section_name)

其作用是，將 some_note.md 的指定 section_name 段落，embed 到眼前的 Markdown 文件裡直接顯示。

這個 embed 的需求不是什麼新概念，從最早的 HTML 的 iframe 跟 embed 到後來 Jekyll 的 include ，都有類似的用法。

但 Obsidian 所支援的這語法，方便而直覺，因為跟原本 embed 圖檔、PDF的語法相近，例如：

![some_picture](some_picture.jpg)
![some_document](some_document.pdf)

而其後的 # 後綴，也跟 URL 的標準用法一致，例如：

https://url.spec.whatwg.org/#dom-url-hash

（註：上述直接指向目標網頁的 “dom-url-hash” 的段落）

可說是最接近自然預期的理想語法了。

筆記需求

那，這有什麼影響？

以近日看到 Fourdollars 於 TOSSUG 的臉書分享了一篇文章 🤫 Unlocking secret ThinkPad functionality for emulating USB devices | Andrey Konovalov 為例。

若我想整理心得到筆記裡的話，要編輯到的地方可能有好幾處：

• Fourdollars, 李世元, Shih-Yuan Lee.md
  • 此處留個標記。因為日後可能會以：“…印象中 Fourdollars 好像曾分享過一篇文章…”像這樣的方式回憶起來。
• Andrey Konovalov.md
  • 於原作者的條目下，記錄主要內容。
• ACPI.md
  • 標記用到 acpixtract, iasl 的實際案例。
• FT2232H.md
  • 提到用 flashrom 跟 FT2232H 刷 Flash 記憶體的方式。
• SPI.md
  • 提到刷主機板上 SPI 晶片 的問題。
• USB.md
  • 關聯到 USB OTG, USB Raw Gadget 的知識。
• ThinkPad.md
  • 文中 提到 ThinkPad X1 Carbon 機型。
• XPS 13.md
  • 文尾提到 XPS 13 也能開啟同樣功能。

算起來至少有 8 個地方。

那麼，該怎麼編輯？

複本法

若採“複本法”，即在一處寫下來，然後複製到其他 7 處。

雖能留下內容，但會遇到困境如下：

• 有 8 處重複的文本內容
• 若其中一處修改，必須同步更新其他 7 處
• 若無法同步更新，則會產生資料不一致，而折損對資料的信任感

連結法

若採“連結法”，即在一處寫下來，再以 URL 捷徑、內部連結、等傳送門機制，轉連接到其他 7 處。

此法雖能避免重複內容，但缺點也很明顯。就是只看 URL 跟連結，不易回想起相關的心得內容 ，以致於搜尋瀏覽時，容易跳過。而若要一一點擊進去看，則效率低落，而且容易分神。

分拆法

而介於“複本法”與“連結法”的之一作法，是將心得的內文依主題分拆，而分別存放到對應的筆記條目去。例如，分拆部分內容，而記到 ACPI 、 USB、 等等的條目下，再附連結回原始心得文本。

這樣作雖可避開內容重複的問題，卻無可避免的造成筆記內容的支離破碎，而不易吸收跟重用。更要命的是，要分拆、分類、編修多處文件，才能記好一份心得。這成本太高，難以持續。

Embed 法

綜上所述， embed 法，也就是最開頭提到的功能，其實就是（就我所知的）最好的解答。

一行簡單的語法就能重複引用並顯示到多個地方，同時變更編輯只在原始條目一處，從根本上就滿足資料的一致性。

案例： TODO 用法

每個專案有各自的 TODO list ， 自己也有個人的總 TODO list 清單，該如何組織？

假設個人總清單為 TODO.md ，並有其他專案 Project01.md, Project02.md，例舉測試內容如下：

• TODO.md:

  ## My TODOs
  
  - [ ] task01
  - [ ] task02
  - [x] task03
  
  
  ## Project01
  
  ![Project01](Project01.md#TODO)
  
  
  ## Project02
  
  ![Project02](Project02.md#TODO)
  

• Project01.md:

  ## TODO
  
  - [x] task01
  - [ ] task02
  - [ ] task03
  
  ## Notes
  
  ... blahblah ...
  

• Project02:

  ## TODO
  
  - [ ] task01
  - [x] task02
  - [ ] task03
  
  ## Notes
  
  ... blahblah ...
  

在 Obsidian 下， TODO.md 總清單的瀏覽效果如下：

如此安排的好處如下：

• 在個人 TODO.md 總清單，可一處集成顯示所有他處的 TODO list
  • 方便每日例行檢視，而不用再一一點開每個子項目
• 各個專案的文件專注顯示並維護自己局部的 TODO list
• 在 embed 的框頁面 裡，不能直接編輯內容。而是，注意到右邊有個連接圖示，點入進到對應的頁面再編輯。
• 另外，我意外發現，在 embed 的框頁面裡，checkbox 是可以直接 toggle 更新的。

小語法、大影響

從上述的討論可以瞭解到，此一 Embed 的語法，不僅僅只是方便顯示的功能而已，而是會聯動到知識內容的整體組織方法。

改變有多大，還不曉得。因為發現這才幾天的時間，目前還在摸索適應的重構中。

但至少最明顯的差異之一是，不用再糾結於某個段落要放分類 A ，還是放分類 B 。在新方法下，可以不用作選擇，直接全都要。

因作 Bluetooth thermometer + esp32 hacking 之故，加上 pepe2k 也推薦這個，便決定試試 Zephyr 。後來克服過程中一些障礙，也順利試出來了。在此整理分享一二。

首次接觸的人，推薦先從官方提供的 Getting Started Guide 文件入手。依文件一一操作完成編譯並運作 sample demo 的流程，而對 Zephyr 的運作有了具體的感覺之後，再進入編寫應用程式的階段即可。Zephyr 附有許多結構良好的範例程式(見 zephyr/samples )，在撰寫應用程式時，有許多可以參考對照的地方，幫助很大。

在 Linux 的部份，Zephyr 文件是以 Ubuntu 為準。對於非 Ubuntu/Debian 的 Linux 用戶，若沒把握自行搞定中間差異的話，建議直接使用 docker 另開一個 Ubuntu container 來操作。

不過，開 container 雖然方便，但也會面臨幾個基本問題：

• Ubuntu container 內的 UID 和 Host OS 的 UID 不一致
• 於 Ubuntu container 內能否存取 Host OS 的 /dev/ttyUSB0 並刷 firmware

所幸摸索後，都一一找到方法解決了。後面會逐一解說。這過程我於下方整理成一份 script ，提供一個直達車的捷徑，方便有需要的人更容易獲取使用。

Step-by-step hello world

需要預先準備的事項有：

• Linux 系統
• docker
• 17 GB 的硬碟空間
• 預留 30~40 分鐘的時間，主要等 Zephyr git repos 跟 SDK tarball 的下載
• 目標硬體，例如: ESP32-C3

初入門就先從建立環境並編譯試跑 samples/hello_world 開始。

Step 1.

先建一個專案目錄，例如 ~/my_zephyr_test/

mkdir -p ~/my_zephyr_test/

Step 2.

於該目錄內，建立一 script 檔案 run_zephyr_docker 並 chmod +x 給予執行權限。script 檔案內容如下:

#!/usr/bin/env bash

function run_as_root() {
	cd /home/ubuntu/zephyrproject || exit

	# Guest OS' UID might be different with Host OS' UID
	# Here we update the UID(default is 1000) to the Host OS' UID first before setup
	username="ubuntu"
	UID_OLD=$(id --user $username)
	UID_NEW=$(stat -c %u .)
	if [ -n "$UID_NEW" -a "$UID_OLD" != "$UID_NEW" ]; then
		groupmod -g $UID_NEW $username
		usermod -u $UID_NEW $username
		find / \( -path "/proc" -o -path "/dev" \) -prune -group $UID_OLD -exec chgrp -v -h $UID_NEW {} \;
		find / \( -path "/proc" -o -path "/dev" \) -prune -user $UID_OLD -exec chown -v -h $UID_NEW {} \;
	fi

	# Modify Guest OS' uucp GID and add default user to uucp group
	# for permission of accessing /dev/ttyUSB0
	UUCP_GID=$(getent group uucp | cut -d: -f3)
	HOSTOS_UUCP_GID=$(stat -c %g /dev/ttyS0)
	if [ -n "$UUCP_GID" -a "$UUCP_GID" != "$HOSTOS_UUCP_GID" ]; then
		groupmod -g $HOSTOS_UUCP_GID uucp
	fi
	usermod -aG uucp $username

	# Install and configure tzdata first to bypass the waiting prompt
	apt update
	echo "tzdata tzdata/Areas select Asia" | debconf-set-selections
	echo "tzdata tzdata/Zones/Asia select Taipei" | debconf-set-selections
	DEBIAN_FRONTEND=noninteractive apt install -y tzdata

	# Preinstall required tools
	apt install -y sudo picocom expect
	echo "$username ALL=(ALL) NOPASSWD:ALL" >/etc/sudoers.d/$username
	sudo -i -u $username run_zephyr_docker user
}

# Ref: https://docs.zephyrproject.org/latest/develop/getting_started/index.html#get-zephyr-and-install-python-dependencies
function get_zephyr_and_install_python_dependencies() {
	sudo env DEBIAN_FRONTEND=noninteractive apt install -y python3-venv
	python3 -m venv ~/zephyrproject/.venv
	source ~/zephyrproject/.venv/bin/activate

	sudo apt install -y --no-install-recommends git cmake ninja-build gperf \
		ccache dfu-util device-tree-compiler wget \
		python3-dev python3-pip python3-setuptools python3-tk python3-wheel xz-utils file \
		make gcc gcc-multilib g++-multilib libsdl2-dev libmagic1

	pip install west
	west init ~/zephyrproject
	cd ~/zephyrproject
	west update || west update || west update # retry 3 times
	west zephyr-export
	pip install -r ~/zephyrproject/zephyr/scripts/requirements.txt
}

# Ref: https://docs.zephyrproject.org/latest/develop/getting_started/index.html#install-the-zephyr-sdk
function install_the_zephyr_sdk() {
	(
		cd ~/zephyrproject
		wget --continue https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.16.8/zephyr-sdk-0.16.8_linux-x86_64.tar.xz
		tar xf zephyr-sdk-0.16.8_linux-x86_64.tar.xz
		cd zephyr-sdk-0.16.8
		expect -c "spawn ./setup.sh; expect -re \".*Install host tools.*\"; send \"y\r\n\"; expect -re \".*Register Zephyr SDK CMake package.*\"; send \"y\r\n\"; interact;"
	)
}

function install_esp32_dependencies() {
	west blobs fetch hal_espressif || west blobs fetch hal_espressif || west blobs fetch hal_espressif
}

function setup_shortcut() {
	cat >>~/.bash_aliases <<EOD
alias lls='ls --time-style=full-iso -l'
EOD
}

function run_as_user() {
	get_zephyr_and_install_python_dependencies
	install_the_zephyr_sdk
	install_esp32_dependencies
	setup_shortcut

	printf "Entering shell...\n"
	bash
}

case "$1" in
root)
	run_as_root
	;;
user)
	run_as_user
	;;
*)
	[ -e /.dockerenv ] && {
		echo "Already in docker, skip."
		break
	}
	docker run -it --rm \
		--privileged -v /dev:/dev \
		-v $(pwd):/home/ubuntu/zephyrproject/ \
		-v $(readlink -f $0):/usr/local/bin/run_zephyr_docker \
		ubuntu:24.04 \
		run_zephyr_docker root
	;;
esac

備註:

• docker 的選項說明:
  • --rm , 於終止後刪除該 container ，避免佔空間
  • --priviledge -v /dev:/dev , 用於 flash firmware 時存取 Host OS 的 /dev/ttyUSB0

Step 3.

之後進到該目錄，並執行指令如下:

cd ~/my_zephyr_test/
./run_zephyr_docker

執行完成後，預計會得到畫面如下：

此時，Zephyr 的編譯環境已經安裝好了。

Step 4.

於 container 環境內，進一步下指令:

cd ~/zephyrproject/zephyr/
west build -p always -b esp32c3_devkitm samples/hello_world/

預期會得到結果如下:

而 build 出來的 image 檔案，預計會在 ~/zephyrproject/zephyr/build/zephyr/zephyr.bin 的位置。

Step 5.

之後再刷到目標硬體上，指令如下：

cd ~/zephyrproject/zephyr/build/
west flash -d . --skip-rebuild

預期結果如下：

之後再透過 picocom 工具觀看目標硬體的 console logs 即可，例如:

picocom -b 115200 /dev/ttyUSB0

參考 demo 如下：

至此，就完成整個流程了。

後續的應用程式開發，只要將 samples/hello_world 代換成要開發的目標程式即可。

Reinstall

若要重來一次的話，要留意前一次執行留下的檔案，會影響後一次的執行。因此需要先清理目錄如下：

（注意！若 zephyr/ 有修改的部分，記得要先備份。）

rm -rf bootloader/ modules/ tools/ .venv/ .west/ zephyr-sdk-0.16.8/
rm -rf zephyr/ 

何不用 zephyr-build docker image？

在弄完 script 之後，我才發現到 zephyr-build 的存在。

實際試用後，觀察如下：

• 主要文件為: zephyrproject-rtos/docker-image
  • 官方文件網站 Zephyr Project Documentation 似乎沒有對應的文件
• 內建預裝需要的 Python 套件以及 SDK
• 沒有初始化 zephyr workplace , 要自行 init
• 有 VNC server
• 一樣有 Host OS 的 UID/GID 不一致問題，以及 /dev/ttyUSB0 存取問題
• 由 CI/CD 的 container image 延伸而來
• 其 container image 約佔 14GB 上下

因 zephyr-build 未在官方文件網站中提及，未來也可能會隨 CI/CD 而需求而變化。比較適合已經熟悉 Zephyr 用法的開發者，對於初學者可能還是建議以 Getting Started Guide 為主。

為方便一鍵執行使用，也比照整理了一份 script 如下。

於 ~/my_zephyr_test/ 目錄裡建立一個 run_zephyr-build 的 script 檔案如下:

#!/usr/bin/env bash

TMPF=$(mktemp)

cat >$TMPF <<'EOD'
# Generate executable file to run as root
cat > /tmp/run_cmd_root <<EODD
#!/usr/bin/env bash

USERNAME=$(whoami)
UID_OLD=$(id -u)
UID_NEW=$(stat -c %u $(readlink -f $0))
usermod -u \$UID_NEW \$USERNAME
groupmod -g \$UID_NEW \$USERNAME
find / \( -path "/proc" -o -path "/dev" \) -prune -group \$UID_OLD -exec chgrp -v -h \$UID_NEW {} \;
find / \( -path "/proc" -o -path "/dev" \) -prune -user \$UID_OLD -exec chown -v -h \$UID_NEW {} \;

# Modify Guest OS' uucp GID and add default user to uucp group
# for permission of accessing /dev/ttyUSB0
GID_UUCP=$(stat -c %g /dev/ttyS0)
groupmod -g \$GID_UUCP uucp
usermod -aG uucp \$USERNAME

PWD=/workdir sudo --preserve-env=PWD -u \$USERNAME bash
EODD

chmod +x /tmp/run_cmd_root
sudo -u root /tmp/run_cmd_root
EOD
chmod a+rxx $TMPF

docker run -ti --rm -v $(pwd):/workdir \
	--privileged -v /dev:/dev \
	-v $TMPF:/usr/local/bin/run_cmd \
	ghcr.io/zephyrproject-rtos/zephyr-build:main \
	run_cmd

rm $TMPF

並於 ~/my_zephyr_test/ 的目錄中執行即可。

問題解說

與 Host OS 的 UID 不同

在 Ubuntu container 裡，預設的使用者 ubuntu 的 UID 是 1000。可能和 Host OS 的 Linux 的 UID 不一致，那掛載進去的檔案就會遇到讀寫權限的問題。

解決辦法是在 container 啟動之初, 就先變更 ubuntu 的 UID/GID 到和 Host OS 一致。具體指令如下:

UID_NEW=$(stat -c %u .)
groupmod -g $UID_NEW ubuntu
usermod -u $UID_NEW ubuntu
find / \( -path "/proc" -o -path "/dev" \) -prune -group 1000 -exec chgrp -v -h $UID_NEW {} \;
find / \( -path "/proc" -o -path "/dev" \) -prune -user 1000 -exec chown -v -h $UID_NEW {} \;

存取 /dev/ttyUSB0 刷 firmware

在 Ubuntu ccontainer 裡要順利用 west flash 刷 firmware。大致需要兩項設定。

其一, docker run 指令需要加上一些選項允許 container 存取 Host OS 的裝置。例如 --device=/dev/ttyUSB0 或 --privileged -v /dev:/dev 。

註： --privileged -v /dev:/dev 的用法比較不安全，但卻是成功率比較高的作法。因為此處是單人本機使用，所以故採用之。進一步的探討，可參考 Stack Overflow 上的討論串: Docker - a way to give access to a host USB or serial device?

其二, 需要將使用者 ubuntu 加到 uucp 的群組裡。具體指令如下:

usermod -aG uucp ubuntu

另外，要注意的是， Host OS 的 uucp GID 跟 container 裡的 uucp GID 可能不同。若不同時，會需要將 container 裡的 GID 修改和 Host OS 一致。

groupmod -g $HostOS_GID_UUCP uucp

apt install 的 timezone 設定 prompt

在 Ubuntu container 第一次執行 apt install 時, 程序會停下來等使用者輸入選擇時區，而阻礙了全自動進行。

解法之一是利用 debconf-set-selections 的機制，先餵指定時區供 apt 取用，參考指令如下：

echo "tzdata tzdata/Areas select Asia" | debconf-set-selections
echo "tzdata tzdata/Zones/Asia select Taipei" | debconf-set-selections
DEBIAN_FRONTEND=noninteractive apt install -y tzdata

安裝 SDK 時的 prompt

會遇到 prompt 而停下來等待用戶 yes/no 的輸入，而阻礙自動執行。

解法是用 expect 來自動應答，指令如下：

expect -c "spawn ./setup.sh; expect -re \".*Install host tools.*\"; send \"y\r\n\"; expect -re \".*Register Zephyr SDK CMake package.*\"; send \"y\r\n\"; interact;"

為了分析 LCD 七段顯示器的訊號，而購置邏輯分析儀。我買的是 Lcsoft Mini Board(Geeetech) , 最終實物如下:

邏輯分析儀有多種等級規格。 因為是初學者，沒有實際經驗下，憑空比較規格沒有感覺。 於是打算先買初階入門級使用，待有了使用體驗後，未來有機緣需要再進行擴充。

Linux 下可以用嗎?

身為 Linux 使用者，買硬體前一定會問個問題：在 Linux 下可以用嗎？

這通常會分成兩道關卡:

• Linux 下的驅動程式
• 配套的應用軟體，及其支援硬體

以上兩者都可以，可以放心買沒問題。

驅動程式

這個裝置的主晶片是 CY7C68013A，USB 的 VID:PID 是 04b4:8613 。在 Linux Hardware Database 可查得支援資訊如下:

• Cypress Semiconductor CY7C68013 EZ-USB FX2 USB 2.0 Development Kit

於 Linux kernel 內建支援，不用另裝驅動程式。

Sigrok, PulseView

在 Linux 下有 sigrok 軟體專案支援邏輯分析儀、示波器、數位三用電錶的設備，其 GUI 則是 PulseView 。

網頁上有列目前支援的硬體相容性清單:

• Supported hardware - sigrok

我的需求大致上有:

• 需要 16 channel (因為要分析到 13~14 pinout)
• 有 Linux driver 支援
• 容易負擔取得

以此篩選後，大致上鎖定以 CY7C68013A based 的數個型號。

3D列印外殼

在多個 CY7C68013A based 的型號選擇下，最終選擇了:

• Lcsoft Mini Board - sigrok

其中一個關鍵的因素是，它有數個 3DP 社群製作的貼心配件。 例如，蒐集到的有(依創作時間排序):

• 2012-06-02 , Case for LCsoft CY7C68013A logic analyser clone by jamesglanville - Thingiverse
• 2017-03-05 , CY7C68013A box for logic analyzer by bobtidey - Thingiverse
• 2018-10-23 , Case for Cypress Logic Analyzer LCSOFT by goddisignz - Thingiverse
• 2019-01-22 , EZ-USB FX2LP CY7C68013A USB logic analyzer core board housing by decoder - Thingiverse
• 2019-05-27 , CY7C68013A box for logic analyzer by reibuehl - Thingiverse
• 2021-08-22 , Lcsoft CY7C68013A Mini Board Dev Kit Logic Analyzer Probe Case by firepower9966 - Thingiverse
• 2022-06-29 , CY7C68013A Logic analyzer box by FelinoMaker - Thingiverse

在目前列表中，我最中意 FelinoMaker 的作品 CY7C68013A Logic analyzer box by FelinoMaker - Thingiverse 。除了其外殼完整外，更重要的是特別為 D0~D15 的針腳開孔並有面板標示。這貼心設計在使用上帶來很大的便利。

面板標示的部分，作者有提供 SVG 檔案，可自行編輯。編輯時，要留意該檔案的紙張尺寸是 US letter (216mm x 279mm)，而非常用的 A4 尺寸。

同時電腦上看到的，跟實際列印出來的會有落差，要稍作校正才能一致。自己也是來回調整好幾次，才完全吻合。

LCSOFT 和 Geeetech 版本差異

就 Lcsoft Mini Board - sigrok 記錄，有分 LCSOFT(lctech-inc,艾尔赛科技) 原版跟 Geeetech 版。目前查得兩個版本的官方資訊如下：

LCSOFT (艾尔赛科技, lctech-inc):

• EZ-USB FX2LP CY7C68013A USB 核心板 开发板 逻辑分析仪_深圳市艾尔赛科技有限公司
• Shenzhen LC Technology Co.,Ltd.(Wayback Machine)

Geeetech:

• CY7C68013 - Geeetech Wiki

就 Lcsoft Mini Board - sigrok 的說明:

Differences from the LCSoft board:

• two LEDs, on pins PA0 and PA1
• two jumpers: J1 connects/disconnects the LEDs from Vcc, J2 sets the EEPROM address bit A0
• construction quality is higher

The Geeetech board’s J2 is logically opposite to the LCSoft board’s jumper: pin A0 is tied HIGH via a 10kOhm resistor, inserting J2 pulls it LOW. i.e. inserting J2 on the Geeetech is functionally the same as removing the jumper on the LCSoft board.

兩者的差異不大。

不過要注意，兩者的 Reset 鍵位置不同。若是搭配 3D 列印外殼的話，要注意開孔的位置是否一致。

實測

在 Arch Linux 上，安裝相關的套件:

pulseview sigrok-firmware-fx2lafw sigrok-cli

在接上硬體後，打開 pluseview 就能直接使用，完全不用苦惱驅動程式或是支援問題來回折騰。

實際使用 pulseview 取得訊號的運作如下:

注意事項

這個裝置的接腳電壓上限只到 5V ，所以超過很可能會壞掉，因此使用前要留意電壓的問題。網路上有人注意到這個問題，並嘗試討論與製作保護電路等工具。這裡將參考連接列出如下，供參考：

• Circuits for barebone boards - sigrok
• 2020-03-23 , Adding Buffering to LCSoft CY7C68013A Mini Board | Hackaday.io
• 2021-08-22 , Lcsoft CY7C68013A Mini Board Dev Kit Logic Analyzer Probe Case by firepower9966 - Thingiverse
• 2021-10-07, Sigrok逻辑分析仪软件(基于CY7C68013A) - Milton - 博客园

哪裡買?

參考連接如下:

• EZ-USB FX2LP CY7C68013A USB 核心板 開發板 邏輯分析儀 | 蝦皮購物
  • 目前正在使用中的是於此處購買
  • 買了兩片。但發現其中一片有兩處焊接有誤（按鈕與被動元件），但不影響使用。
  • 屬於 Geeetech 版本
• 新款 EZ-USB FX2LP CY7C68013A USB 核心板 開發板 邏輯分析儀 | 蝦皮購物
  • 原本打算於此購買 LCSOFT 原版。但後來實際拿到的是 Geeetech 的版本，與預期不符，就換了購買管道。

序

近日在整理 $HOME 下的 dotfiles 時，遇到 .screenrc 的部分，覺得束之高閣可惜。決定稍作記錄與分享。

設定檔

分享設定檔 ~/.screenrc 如下:

caption always "%{= wk} %{= KY} [%n]%t @ %H %{-} %= %{= KR} %l %{-} | %{= KG} %Y-%m-%d %{-} "
hardstatus alwayslastline " %-Lw%{= Bw}%n%f %t%{-}%+Lw %=| %0c:%s "
termcapinfo xterm* ti@:te@

效果如下:

說明：

• 最下面一行是由 hardstatus alwayslastline 設定的
  • 具備多分頁 tab 的效果
• 倒數第二行則是 caption always 的設定
• % 開頭的設定變數，可參考官方文件: Screen User’s Manual: String Escapes
• termcapinfo 的那一行設定，則是應付滑鼠捲動。

總之，用了就會眼睛一亮。

因時日久遠，已忘了是從哪裏發掘這款設定的。原本印象是從 yungyuc 那裏學來的。但考古了一下，yungyuc 的 新生的 screenrc - Everyday Work 一文卻說是從我這裏學去的。這下我自己也懵了。

不過，看截圖應該是出自我的版本沒錯。記憶中，我先從某處得知了有 hardstatus, caption 的參數跟用法，但當時多是置底一行。因當時重度在 virtual console 的環境下作業，一時靈感之下拼湊出置底二行這樣的用法。

感謝有 yungyuc 當時的記錄與分享。

attach/detach

• Ctrl-a + d, detach 目前所在的 session
• screen -list , 列出目前的 sessions
• screen -r <session> , resume 先前的 session
  • 若只有一個 session ，只要打 screen -r 即可

當 Terminal 掛掉時，該 Terminal 所在的程式也就跟着中斷了。用 screen 的好處就是，讓程式主體保持在背景執行，而允許前端的 Terminal session 隨時 attach/detach 。如此一來，即使不小心關掉了 Terminal (不論是 XWindow 當掉重啓)，或是登出再登入，都能快速接續先前的狀態。

共用 session

• screen -x <session>

這個功能在幾個情境下非常好用。我用過的情境如下：

其一， 在 XWindow 跟 Linux virtual console 頻繁切換使用。

我可能先在 XWindow 下編寫 window manager 的設定檔，同時在 console 下開好 ssh 連線預留後路。若是在調整 XWindow 設定有誤，則可退到 console 查看 log 、改設定跟重啓。萬一鍵盤鎖死無反應時，也還可從他處以 ssh 連回挽救。

其二， pair programming。

在緊湊討論 Linux 的 CLI, vim, debug 參數之時，最快的就是湊到對方的電腦前去看。但遇到要輸入時，就得共用鍵盤，不甚方便。加上每人各有自己偏好的熱鍵設定，實際操作往往卡卡的不甚流利。後來發現一技巧，就是開 ssh 連線到對方的電腦上，用 screen 的共用 session 功能。如此一來，雙方都能快速看到對方的 CLI ，也能直接改參數，起執行的 log 訊息也都無時差的同時 review ，整個效率提升很多。

此技法是從 HackingThursday 參加 2009 Yahoo Hacking Day 活動 時學來的，印象中是 Rex, Tsung, hychen 那一組發掘出來的。

順帶一提，後來出現有 tmate ，能節省開頭的 ssh 設定折騰，也非常推薦。不過，該工具的連線資料會過外部雲端，使用前需留意。

serial 工具

示例如下：

screen /dev/ttyUSB0 115200

screen -c /dev/null telnet -8 ptt.cc
Ctrl-a :encoding big5 utf-8

(註：參數說明可參閱 Screen User’s Manual: Window Types)

若說到現在還在用 screen 這工具，這絕對是最關鍵的理由。

這祕技其實是從 Thinker 那裏學來的。印象中好像是在請教他有無推薦的 serial 連線工具，例如: minicom, kermit, …之類的？ 然後他就回說：

可以用 screen 啊！

這回答太出乎我的意料，因為 screen 在我心中的定位一直都是分割終端機畫面的工具，從沒想過用於 serial port 的操作，因而特別印象深刻。 長期使用後，發覺有諸多優點：

• 十分穩定。之前用 minicom, 或其他工具，可能受 terminal 字元影響，而有閃退、中斷的問題。但印象中，screen 從以前用到現在，還沒有不正當當掉過。
• 內建支援轉碼，例如： Ctrl-a :encoding big5 utf8
• 畫面紀錄與紀錄檔功能。Ctrl-a h , Ctrl-a H
• 不依賴 ncurses 或 prompt, 可和 expect/pexpect 搭配使用於automation scripts

唯一的缺點大概是要送出 Ctrl-a (screen的特殊鍵)時，要多跳脫一層。

解 lock

用 Terminal 久了，偶爾會遇到輸入被鎖住的情況，主要原因是Software flow control ，如下：

• Ctrl-s, Ctrl-q, 是 Terminal 的 flow control on/off 熱鍵。
• Ctrl-a + s, Ctrl-a + q 是 screen 的 flow control on/off 熱鍵。

當 screen 被鎖住時，可以就 Ctrl-a + q 和 Ctrl-q 反覆交叉按個數次，就可以解開了。

複製貼上

操作流程如下：

• Ctrl-a + [ 進入 copy mode
• 用方向鍵移動到開頭的位置，按下 ENTER 或 SPACE
• 用方向鍵移動到結尾的位置，再按下 ENTER 或 SPACE，完成標定範圍的內容複製
• 之後到要輸入的地方，按下 Ctrl-a + ] 進行貼上

因爲 XWindow terminal 一般的滑鼠複製貼上，遇有特殊字元或斷行偶爾會有問題，加上歷史記錄不一定夠長。相較之下， screen 的資料完整一些。所以，即使 Terminal 已經很方便了，遇到比較刁鑽的地方，還是不時會搭配 screen 來使用。

screen 裏的 screen

有時候會遇到一些情況是，在筆電裏開了 screen ，然後連到遠端主機，而遠端主機也開了 screen 。就成了 screen 裏的 screen 的情況。這時候按 Ctrl-a , Ctrl-a 的組合鍵，就會被本地端的 screen 先攔截，變成是切換本地端的 screen ，而不是切換遠端的 screen 。解法是改爲 Ctrl-a + a。 條列如下:

• Ctrl-a + a , Ctrl-a ，切換遠端的 screen
• Ctrl-a , Ctrl-a ，切換本地端的 screen

滑鼠 scroll

一般在 XWindow terminal 下開 screen 後， 畫面就框定住了，而沒能像一般 terminal 那樣 scroll up/down 。若是習慣用滑鼠 scroll 去看先前的畫面記錄。可以考慮在設定檔 ~/.screenrc 加上：

termcapinfo xterm* ti@:te@

重置邊框

若開 screen 時，是 80x24 的大小。而後在另一處改用 120x30 的 Terminal 連回時，會發現多了邊框。示意如下：

那如何改善呢？使用下述指令即可：

Ctrl-a :fit