J-Link 도구 체인 분석 — JLinkExe·RTT·GDB Server 활용

J-Link는 상용 표준입니다. OpenOCD가 오픈·범용이라면 J-Link는 속도·안정성·완성도가 압도적. 특히 신호 무결성 안 좋은 보드, 큰 펌웨어, 시간 sensitive한 디버깅에서 OpenOCD가 자꾸 끊긴다면 J-Link로 전환하면 거의 모든 문제가 사라집니다.

이 장은 Segger의 도구 체인 전체 — J-Link GDB Server, JLinkExe(commander), J-Run, J-Trace, Ozone GUI, Unlimited Flash Breakpoints, RTT — 를 다룹니다.

#하드웨어 라인업

EDU 모델은 비상업·교육·취미용. 상업적 사용은 BASE 이상 필요. EDU mini가 원가 가까운 가격이라 입문에 추천.

#설치

1
# Linux
2
$ wget https://www.segger.com/downloads/jlink/JLink_Linux_V794_x86_64.deb
3
$ sudo dpkg -i JLink_Linux_V794_x86_64.deb
4

5
# macOS
6
$ brew install --cask segger-jlink
7

8
# 검증
9
$ JLinkExe -CommandFile <(echo exit)
10
SEGGER J-Link Commander V7.94 (Compiled May 17 2024 15:53:46)
11
DLL version V7.94, compiled May 17 2024 15:52:55
12

13
Connecting to J-Link via USB...O.K.
14
Firmware: J-Link EDU Mini V1 compiled Jul 26 2023 13:29:34
15
Hardware version: V1.00
16
S/N: 80...

JLinkExe가 J-Link Commander — TCL이 아닌 자체 셸. OpenOCD의 telnet 4444와 비슷한 역할.

#J-Link Commander

1
J-Link> ?           # 명령 도움말
2
J-Link> device STM32F407VG
3
J-Link> si SWD      # SWD 모드
4
J-Link> speed 4000  # kHz
5
J-Link> connect
6
J-Link> r           # reset + halt
7
J-Link> h           # halt
8
J-Link> g           # go (resume)
9
J-Link> mem 0x20000000 16    # 16 워드 dump
10
J-Link> w4 0x20000100 0xdead # 4바이트 쓰기
11
J-Link> regs        # 모든 레지스터
12
J-Link> reg pc      # PC만
13
J-Link> loadfile firmware.bin 0x08000000
14
J-Link> verifybin firmware.bin 0x08000000
15
J-Link> erase
16
J-Link> savebin /tmp/dump.bin 0x08000000 0x1000
17
J-Link> rtt setup    # RTT 시작
18
J-Link> rtt read 0   # 채널 0 읽기

JLinkExe -device STM32F407VG -if SWD -speed 4000 -autoconnect 1 -CommandFile script.jlink으로 배치.

1
$ cat script.jlink
2
r
3
loadfile firmware.bin 0x08000000
4
verifybin firmware.bin 0x08000000
5
g
6
qc          # quit + close

CI 굽기 자동화의 한 줄.

#J-Link GDB Server

GDB 연결용 데몬.

1
$ JLinkGDBServer -device STM32F407VG -if SWD -speed 4000 -port 2331
2
SEGGER J-Link GDB Server V7.94
3
Listening on TCP/IP port 2331
4
Connected to target
5
Waiting for GDB connection...

자주 쓰는 옵션.

#-device 이름

Segger의 Supported Device 데이터베이스에 등록된 정확한 부품 번호. 잘못 적으면.

• connect는 됨 (DAP·CPU는 표준이라 자동 검출).
• load는 됨 (메모리 쓰기는 일반).
• flash는 안 됨 (칩별 알고리즘이 잘못된 것을 골라 erase가 실패하거나 잘못된 sector를 건드림).

이 차이가 디버깅을 매우 어렵게 만듭니다 — connect만 보고 맞다고 착각.

1
# 데이터베이스 검색
2
$ JLinkExe -CommandFile <(echo "ShowSupportedDevices STM32F4") | head -20
3

4
# 일반적인 이름들
5
STM32F407VG, STM32F407VE, STM32F407IG, ...

Segger Supported Devices에서 검색.

#GDB 연결

1
$ arm-none-eabi-gdb firmware.elf
2
(gdb) target remote :2331
3
0x080001b8 in Reset_Handler () at startup_stm32f407xx.s:62
4
(gdb) monitor reset halt
5
(gdb) load
6
Loading section .isr_vector, size 0x1c0 lma 0x8000000
7
Loading section .text, size 0x9d20 lma 0x80001c0
8
Loading section .rodata, size 0x4c0 lma 0x8009ee0
9
Loading section .data, size 0x140 lma 0x800a3a0
10
Start address 0x080001b8, load size 41960
11
Transfer rate: 90 KB/sec, 4195 bytes/write.    ← 4 MHz SWD 기준
12
(gdb) monitor reset halt
13
(gdb) break main
14
(gdb) continue

monitor로 J-Link 명령을 직접 보낼 수 있습니다.

1
(gdb) monitor reset       # 그냥 reset
2
(gdb) monitor halt
3
(gdb) monitor go
4
(gdb) monitor regs
5
(gdb) monitor mem 0x20000000 64
6
(gdb) monitor flash device = STM32F407VG
7
(gdb) monitor SetMemAccessHWBP 0x20000000 0x1000
8
(gdb) monitor exec SetRTTAddr 0x20000000

exec 접두사는 J-Link Commander 명령을 그대로 실행. 도구 체인 전체를 GDB 안에서.

#속도 비교 — OpenOCD vs J-Link

대표적 차이.

J-Link의 우위 원인.

1. USB → SWD 변환 펌웨어가 효율적 — 한 USB 트랜잭션에 여러 SWD 패킷 묶음.
2. Adaptive Clocking — 신호 무결성에 따라 SWCLK 자동 조정.
3. Memory transfer optimization — DAP의 block transfer 적극 활용.

대형 펌웨어 또는 자주 굽는 환경에서 시간이 곧 돈. J-Link 가격이 충분히 회수됩니다.

#Unlimited Flash Breakpoints

J-Link만의 상용 기능. FPB의 HW BP 개수(6개) 제한을 flash patching으로 무한 흉내.

#동작 원리

1. BP 7번째 설정 → J-Link 펌웨어가 flash 페이지 전체를 SRAM 임시 영역에 복사.
2. SRAM 사본에서 해당 위치를 BKPT 명령으로 패치.
3. CPU의 메모리 매핑 (또는 aliasing)을 활용해 그 페이지만 SRAM 사본을 보도록.
4. CPU가 fetch → 패치된 BKPT → halt.
5. Resume 시 원래 flash로 복원.

마법처럼 보이지만 FPB의 flash patch 메커니즘을 잘 활용한 것. 일부 칩(Cortex-M의 FP_REMAP 지원)에만 동작.

큰 펌웨어에서 모든 함수에 BP 걸기 같은 작업이 가능해집니다. 매우 비싸지만 BP 부족이 일상인 환경에서 가치 있음.

1
# 활성화
2
J-Link> SetUnlimitedBP 1

GDB에서는 자동.

#RTT — Segger의 진짜 강점

[Ch 6 trace 장]에서 자세히 다루지만 J-Link의 RTT는 가장 빠르고 안정적. 100 KB/s 이상의 throughput.

1
# JLinkExe에서
2
J-Link> rtt setup
3
J-Link> rtt start
4
J-Link> rtt read 0           # 채널 0 일회 읽기

별도 RTT Viewer GUI.

1
$ JLinkRTTViewer    # GUI
2
$ JLinkRTTClient    # CLI

펌웨어 측은 SEGGER_RTT.c/SEGGER_RTT.h를 포함. 100 KB 미만.

1
#include "SEGGER_RTT.h"
2
SEGGER_RTT_printf(0, "tick=%u\n", HAL_GetTick());
3
SEGGER_RTT_Write(1, sensor_data, 256);   // 채널 1에 raw 데이터

채널 0를 텍스트, 1을 binary 센서 데이터로 분리하는 패턴이 일반적.

#RTT vs 기존 printf

기존 UART printf는 블로킹 — UART FIFO 빌 때까지 대기. 1초에 수십~수백 라인이 한계. RTT는 non-blocking — 링 버퍼에 워드만 쓰고 즉시 반환. ISR 안에서도 안전. 디버거 측이 백그라운드로 폴링해 가져갑니다.

ISR latency가 중요한 RT 시스템에서는 RTT가 사실상 필수.

#J-Run — 자동 펌웨어 실행

1
$ JRunExe -device STM32F407VG -if SWD -rtt firmware.elf
2
[Load + reset + run + RTT 자동 캡처]

펌웨어를 한 줄로 굽고 실행하면서 RTT를 캡처. CI에서 부트 로그 검증에 매우 유용.

1
$ JRunExe -device STM32F407VG -if SWD -rtt firmware.elf > /tmp/boot.log
2
$ grep "BOOT OK" /tmp/boot.log && echo PASS || echo FAIL

#J-Trace — ETM 명령 trace

J-Trace PRO는 ETM trace 핀을 받습니다. CPU의 모든 명령 실행을 기록.

1
$ JTraceExe -device STM32F767ZI -if SWD -tracesink SWO

쓰임:

• 인터럽트 latency 측정 — 인터럽트 발생 시각과 ISR 첫 명령 사이의 정확한 시간.
• Code coverage — 어떤 함수가 실제로 실행됐는지.
• 비결정적 버그의 완전 재구성.

큰 칩(Cortex-M7+ 옵션 ETM 탑재)이어야 하고 J-Trace 하드웨어 자체가 매우 비쌉니다.

#Ozone — GUI

Segger의 풀 GUI 디버거. VSCode + Cortex-Debug의 대안.

1
$ Ozone firmware.elf

특징:

• Live Variable Watch — CPU 정지 없이 백그라운드로 변수 갱신 (SWD 백그라운드 폴링).
• 메모리 hex 뷰.
• ETM trace 디스플레이.
• Code Profile — ETM 기반 함수별 시간 분포.

상용이지만 J-Link 사용자는 무료. 풀스택을 한 GUI에서 다루고 싶을 때.

#J-Link Configurator

여러 J-Link 프로브를 한 PC에 꽂으면 어느 게 어느 거인지 헷갈립니다. 시리얼 번호로 구분.

1
$ JLinkExe -SelectEmuBySN 80123456

CI에서 보드별로 다른 프로브에 동시 접근할 때 필수.

#Adaptive Clocking

신호 무결성이 안 좋을 때 J-Link가 자동으로 SWCLK를 낮춥니다.

1
J-Link> speed adaptive     # CPU가 보내는 RTCK 신호를 따라

OpenOCD에 없는 기능. 케이블이 길거나 잡음이 많은 환경에서 효과적.

#보안 — Lock 해제

1
J-Link> unlock         # nRF52 등의 APPROTECT 해제
2
J-Link> exec EnableEraseAllFlashBanks
3
J-Link> erase

칩별로 명령이 다릅니다. STM32는 OpenOCD와 비슷한 방식 (option_write).

#CI 패턴

1
#!/usr/bin/env bash
2
set -e
3
DEVICE=STM32F407VG
4
ELF=$1
5

6
# 1. 굽기 + reset
7
cat > /tmp/flash.jlink <<EOF
8
device $DEVICE
9
si SWD
10
speed 4000
11
connect
12
r
13
loadfile $ELF
14
verifybin $ELF 0x08000000
15
g
16
qc
17
EOF
18
JLinkExe -CommandFile /tmp/flash.jlink
19

20
# 2. RTT 캡처 30초
21
timeout 30 JLinkRTTClient > /tmp/rtt.log &
22
sleep 31
23

24
# 3. 검증
25
if grep -q "TEST PASS" /tmp/rtt.log; then
26
    echo "PASS"
27
    exit 0
28
else
29
    echo "FAIL"
30
    cat /tmp/rtt.log
31
    exit 1
32
fi

J-Link Commander가 non-interactive로 동작하므로 CI에 자연스럽게 끼워집니다.

#License 모델

EDU mini의 시리얼 번호가 EDU로 표시되므로, 그 프로브로 굽힌 펌웨어는 상업적 배포 불가. 회사에서 정식 BASE를 사야 합니다.

#OpenOCD vs J-Link 비교 정리

시작은 OpenOCD, 본격 작업은 J-Link가 일반적인 발전 경로. 첫 보드 bring-up에서는 OpenOCD가 소스 추적이 가능해 유리, 일상은 J-Link가 빠릅니다.

#정리

• J-Link = Segger의 상용 디버그 프로브 + 도구 일체.
• J-Link Commander가 직접 셸, JLinkGDBServer가 GDB 데몬.
• -device 이름이 정확해야 flash 굽기가 정상.
• Unlimited Flash BP가 flash patching으로 BP 무한 흉내.
• RTT가 최고 속도·안정성의 trace 채널.
• J-Run으로 한 줄 굽기 + 실행 + RTT 캡처.
• Ozone이 풀 GUI, Live Variable 등 OpenOCD에 없는 기능.
• EDU 모델은 교육·취미 한정 — 상업적 제품에는 BASE 이상.

#다음 장 예고

Ch 5 — 베어메탈 ELF / MAP. 굽는 단위인 ELF의 LMA/VMA, 링커 스크립트, MAP 파일로 메모리 진단.

#관련 항목

• Ch 3: OpenOCD 깊이
• Ch 5: ELF / MAP — 베어메탈 메모리
• Segger J-Link Wiki
• Segger Supported Devices
• Ozone 사용자 가이드