[프로그래밍 이야기 6] 포터블 라이터기의 재발견: 웹소켓과 스크립트가 만든 현장 대응 파이프라인

 임베디드 장비나 FPGA 칩이 탑재된 하드웨어를 현장에서 다룰 때, 가장 고민스러운 부분은 펌웨어 라이팅 환경을 구축하는 일입니다. 공장 PC나 현장 컴퓨터에 무겁고 거대한 벤더 전용 프로그램(IDE)을 일일이 설치하고 환경을 설정하는 것은 지극히 비효율적입니다.

이때 가장 똑똑하고 유연한 접근법은 공장 PC에 무언가를 설치하려 애쓰는 대신, 엔지니어의 노트북 한 대를 즉시 '포터블(Portable) 라이터기'로 탈바꿈시켜 현장에 투입하는 것입니다.

노트북을 포터블 라이터기로 만드는 전략과 웹소켓

노트북을 이동식 포터블 라이터기로 활용하기 위해 거창한 프로그램을 깔 필요는 전혀 없습니다. 핵심은 펌웨어를 입히는 CLI(명령줄 인터페이스) 툴과, 이를 원격에서 실행해 줄 지극히 단순하고 가벼운 웹소켓(WebSocket) 서버 하나만 준비하는 것입니다.

중요한 점은 여기서 사용하는 웹소켓 프로그램이라는 것이 결코 복잡하거나 무거운 시스템이 아니라는 사실입니다. 단 몇 킬로바이트 수준의 경량 훅(Hook) 역할만 수행하는 웹소켓 서버를 노트북에 띄워두면, 공장 PC 환경을 오염시키지 않고도 노트북 한 대가 완벽한 이동식 라이팅 단말기로 변신합니다.

가장 가벼운 웹소켓 훅과 Shell 스크립트의 결합

이 시스템의 실체는 놀라울 정도로 가볍고 명확합니다. 노트북 내부에서는 하드웨어(.sof)를 구운 뒤 MCU 펌웨어(.elf)를 연달아 다운로드하는 아래의 Shell 스크립트가 실행의 중심을 잡습니다.

// flasher.sh - FPGA 및 Nios II 펌웨어 연속 라이팅 스크립트 #!/bin/bash

1. FPGA Hardware (.sof) 구우기

#!/bin/bash
echo "Hello World"

echo "=== Programming FPGA Hardware ==="
quartus_pgm -c "USB-Blaster [1-4]" -m JTAG -o "p;mcu.sof"
if [ $? -ne 0 ]; then
echo "FPGA Programming Failed!"
exit 1
fi

echo  "=== Downloading Nios II Firmware ==="
nios2-download -g MCU.elf
if [ $? -eq 0 ]; then
echo "Nios II Firmware Download Successful!"
else
echo "Nios II Download Failed!"

그리고 노트북의 웹소켓 서버는 웹 브라우저나 외부 신호로부터 요청이 들어왔을 때 이 스크립트를 즉시 호출해 주는 역할만 수행합니다.

// a.json - 웹소켓 명령 수신 및 스크립트 실행 매핑 

[
{
"id": "test-success",
"execute-command": "/home/hyeok/bin/test_run.sh",
"command-working-directory": "/home/hyeok/bin",
"include-command-output-in-response": true,
"include-command-output-in-response-on-error": true,
"pass-arguments-to-command": [
{ "source": "string", "name": "success" },
{ "source": "url", "name": "msg" }
]
},
{
"id": "test-fail",
"execute-command": "/home/hyeok/bin/test_run.sh",
"command-working-directory": "/home/hyeok/bin",
"include-command-output-in-response": true,
"include-command-output-in-response-on-error": true,
"pass-arguments-to-command": [
{ "source": "string", "name": "fail" },
{ "source": "url", "name": "msg" }
]
}
]

웹 브라우저에서 버튼 하나를 누르거나 원격 명령을 보낼 때, 웹소켓은 불과 몇 밀리초 만에 신호를 받아 쉘 스크립트를 실행하고 그 결과를 실시간 텍스트로 되돌려줍니다. 복잡한 전용 솔루션 설치 없이도 노트북 한 대가 완벽한 포터블 라이팅 단말기 역할을 수행하는 것입니다.

마치며

현장 대응력을 높이는 정답은 '더 무거운 시스템'이 아니라 '더 가볍고 유연한 구조'에 있습니다.

웹소켓이라는 아주 기초적이고 가벼운 프로그램 하나를 매개체로 삼아 노트북을 포터블 라이터기로 활용하는 접근법은, 현장 대응 유연성을 극대화하면서도 깔끔한 파이프라인을 만들어내는 훌륭한 엔지니어링 사례입니다.