igotit

Disk2vhd . 개요 . 설치. 가상머신 디스크 파일 변환툴

i.got.it — Tue, 23 Jun 2026 21:09:12 +0900

Disk2vhd

- 현재 가동 중인 물리 서버(Physical)의 하드디스크 체계를 가상 머신(Virtual)용 디스크 파일(.vhd 또는 .vhdx)로 변환해 주는 마이크로소프트 공식 P2V 툴.

- 핵심 기술 (무중단 복제): 윈도우의 VSS(Volume Shadow Copy) 기능을 활용하여, IIS 웹서버나 SQL Server가 켜져서 작동 중인 상태에서도 데이터 깨짐 없이 라이브 복제 가능

- 종속성 탈출: 생성된 .vhdx 파일은 기본 MS Hyper-V 에서 즉시 활용하여 가상머신 실행 가능하며 MS 사 솔루션이 아니어도 VMware, VirtualBox 등 타사 가상화 포맷으로도 손실 없이 상호 변환이 가능하여 MS 종속성 탈출 가능.

- 지원 운영체제 : 윈도우 7 이상 , 윈도우 서버 2008 R2 이상 . ( 윈도우 서버 2008 및 이전 버전 서버는 지원안됨)

Disk2vhd 개요 및 다운로드 주소

https://learn.microsoft.com/ko-kr/sysinternals/downloads/disk2vhd

위 페이지의 설명 중에 아래같은 문구가 있고 마치 128Gbyte 용량 제한이 있는 걸로 오해 하기 좋게 적혀있는데,

Virtual PC는 최대 127GB의 가상 디스크 크기를 지원합니다. 더 큰 디스크에서 VHD를 만들면 가상 PC VM에서 액세스할 수 없습니다.

걱정할것 전혀없다.

Disk2vhd 설명서에 나오는 "127GB 제한"은 과거 유물인 'Virtual PC' 프로그램을 쓸 때만 해당되는 이야기임.
최신 윈도우의 Hyper-V 환경을 사용하고 옵션에서 VHDX 포맷을 선택하면 최대 64TB까지 아무런 문제 없이 대용량 디스크를 복제하고 인식 가능.

Disk2vhd 설치 방법

별도의 인스톨 과정이 필요 없는 무설치(Portable) 단일 실행 파일
다운로드한 disk2vhd.zip 압축을 해제하면 시스템 아키텍처별 파일 존재
64비트 가동 서버 환경인 경우 disk2vhd64.exe 파일 이용

Disk2vhd 실행방법

관리자 권한 실행: disk2vhd64.exe 마우스 우클릭 ➡️ [관리자 권한으로 실행] (필수)
상단 필수 옵션 체크:
- [✓] Use VHDX: 구형 VHD 포맷보다 용량 관리와 데이터 안정성이 압도적인 최신 VHDX 포맷 선택
- [✓] Use Volume Shadow Copy: 서버 가동 중 실시간 락(Lock)을 풀고 무중단 복제를 가능케 하는 VSS 기능 필수 체크
VHD File Name (저장 경로 지정):
- 복제된 파일이 저장될 타깃 경로 지정 (예: USB 연결 외부 스토리지 )
- 주의: 복제 대상인 C, D, E 드라이브 내부에 저장 경로를 지정하면 용량 부족 에러가 발생하므로 반드시 외부 스토리지 경로 지정
Volumes to include (추출 대상 선택):
- 윈도우 부팅에 필수적인 System Reserved (시스템 예약 파티션) 및 C: 드라이브 무조건 포함 체크
- SQL 데이터베이스 및 IIS 소스코드가 위치한 D:, E: 드라이브 등 복제가 필요한 모든 볼륨 체크
생성 시작: 우측 상단의 [Create] 버튼 클릭 (1TB 미만 소규모 용량 기준 수십 분 ~ 1~2시간 소요)

기타 팁.

DB 데이터 무결성 확보: VSS 기능이 작동하더라도 안전을 위해 야간/주말 등 사용자가 없을 때 SQL Server 서비스를 잠시 [중지(Stop)]하고 추출하는 것이 가장 확실함

가상화 인프라 세팅 조건: Windows Server 2008 R2 등 구형 OS는 Legacy BIOS 부팅 방식을 사용하므로, 신규 PC의 Hyper-V에서 가상 머신 생성 시 반드시 [1세대(Generation 1)]로 세대를 지정해야 부팅 에러(디스크 인식 불가)를 막을 수 있음

연관

윈도우 11 프로 . Hyper-V 설치

작업표시줄 검색창에 "Windows 기능 켜기/끄기" 입력하고 실행 하여 "Hyper-V" 체크 한다. Hyper-V 플랫폼: 가상 머신이 실제로 신규 PC의 CPU, 메모리, SSD 등의 성능을 빌려와서 작동하게 만드는 실제 가

igotit.tistory.com

첫 등록 : 2026.06.23

최종 수정 :

단축 주소 : https://igotit.tistory.com/6647

윈도우 11 프로 . Hyper-V 설치 . 가상 컴퓨터 생성 방법

i.got.it — Tue, 23 Jun 2026 16:43:57 +0900

Hyper-V 설치

작업표시줄 검색창에 "Windows 기능 켜기/끄기" 입력하고 실행 하여 "Hyper-V" 체크 한다.

Hyper-V 플랫폼: 가상 머신이 실제로 신규 PC의 CPU, 메모리, SSD 등의 성능을 빌려와서 작동하게 만드는 실제 가상화 엔진.
Hyper-V 관리 도구: 사용자가 마우스로 클릭하며 가상 머신을 만들고, 켜고, 끄고, 세팅할 수 있게 해주는 눈에 보이는 관리 프로그램(Hyper-V 관리자).

위 선택하고 확인 클릭하면 1분이내에 설치완료되면 재시작 한다.

윈도우 시작 메뉴(검색창)에서 "Hyper-V 관리자"를 검색 실행하여 정상 실행확인.

가상스위치 만들기 예.

- 가상머신 실행하는 PC 에 랜포트가 2개 있는 경우 가상 머신에서 랜포트를 독점 활용 가능하게 하는 것.

위 관리자 화면의 오른쪽에 보이는 작업 . 가상 스위치 관리자 .. 클릭. 하여 보이는 아래 화면에서

외부 선택하고 가상스위치 만들기 버튼 클릭

이름 기록하고, 연결할 네트워크 선택 , 그 아래 공유 허용 부분을 체크 해제해야 가상머신이 독점적으로 활용가능하다.

가상 컴퓨터 만들기

관리자 화면 오른쪽 새로 만들기 > 가상 컴퓨터 클릭 하면 마법사 창이 뜬다.

사용자 지정 구성으로 할 것이므로 다음 클릭한다.

-가상 컴퓨터 이름과 가상 컴퓨터 셋팅 정보를 저장할 폴더 지정. 본 예에서는 USB 연결된 DAS 에 폴더 만든것을 지정했다.

가상화할 대상의 세대 선택창.

- 본 예에서는 윈도우 서버 2008 64bit + IIS + MS SQL Server 2008 로 운영중인것을 가상머신으로 만들것인데 윈도우 서버 2008 은 1세대 선택해야한다.

1세대 (Generation 1): 레거시 BIOS를 기반으로 하여 이전 버전의 운영 체제와 완벽하게 호환됩니다. Windows Server 2008(64bit)은 1세대에서만 정상적으로 설치 및 부팅이 지원됨
2세대 (Generation 2): 최신 UEFI 펌웨어를 사용. Windows 8, Windows Server 2012 이후의 운영 체제부터 지원되므로 Server 2008에서는 사용불가.

메모리 할당

- 기존 윈도우서버 2008에서 램 4Gbyte 로 10년이상 정상 작동한 것이라서 4GByte 지정함.

네트워크 구성.

- 가상 컴에서 사용할 네트웍크를 앞에서 만들어둔 가상스위치를 지정했다.

가상 하드 디스크 연결

- 본 예에서는 가상화 대상 PC 의 가상 하드 디스크를 아직 만들지 않았고, 대상 PC 에서 Disk2vhd 툴로 가상 디스크 생성할 것이므로 나중에 가상 하드디스크 연결 선택했다.

마침 클릭하면 아래처럼 가상 컴퓨터 만들어진다.

가상 컴퓨터의 MAC 주소 수동 지정 방법

가상 컴퓨터 대상인 실제 서버에서사용하던 네트워크 MAC 주소를 동일하게 유지해할때 해줘야 하는설정

설정 창의 왼쪽메뉴 네트워크 어댑터 > 고급기능 에서 보이는 MAC 주소를 정적 선택하고 MAC 주소를 기록한다.

Hyper-V 에서 가상머신으로 실행시킬 다른 컴퓨터의 가상 디스크 ( .vhdx 파일 ) 생성 툴

- 별도정리.

Disk2vhd . 개요 . 설치. 가상머신 디스크 파일 변환툴

Disk2vhd- 현재 가동 중인 물리 서버(Physical)의 하드디스크 체계를 가상 머신(Virtual)용 디스크 파일(.vhd 또는 .vhdx)로 변환해 주는 마이크로소프트 공식 P2V 툴. - 핵심 기술 (무중단 복제): 윈도우의 VSS

igotit.tistory.com

첫 등록 : 2026.06.23

최종 수정 :

단축 주소 : https://igotit.tistory.com/6646

윈도우 11 프로 . IIS 설치

i.got.it — Tue, 23 Jun 2026 11:45:21 +0900

윈도우 프로 버전 IIS 설치

작업표시줄 검색창에 Windows 기능 켜기/끄기 입력하고 실행 하여 인터넷 정보 서비스 항목 체크 하면 아래처럼 기본 선택모습 보인다.

과거 IIS 6 의 asp 호환성을 위해서는 아래처럼 추가 체크한다..

기능 선택하고 버튼 확인 클릭하면 변경 내용 적용 2분 이내 완료된다.

정상 설치 확인

다른 PC 웹브라우저 에서 IIS 설치된 PC 의 ip 주소로 접근하면 기본 페이지 보인다.

IIS 관리자 실행

작업표시줄 검색에서 IIS 입력하고 실행

과거 버전 IIS 6 과의 호환성 위한 설정

32비트 응용프로그램 허용

IIS 관리자에서 "애플리케이션 풀" 클릭.
해당 웹사이트가 사용하는 응용 프로그램 풀(예: DefaultAppPool)을 우클릭 후 고급 설정으로 이동.
32비트 응용 프로그램 허용 항목을 True로 변경

부모경로 허용 (Parent Paths)

과거 ASP 코드에서는 상위 폴더의 파일을 불러올 때 와 같이 ../ 표현(부모 경로)을 자주 썼으나, 현재 IIS의 기본 설정은 차단 되어있다 이를 허용해준다.

IIS 관리자에서 웹사이트를 선택한 후, 가운데 화면에서 ASP를 더블 클릭.
동작 > 부모 경로 허용(Enable Parent Paths) 항목을 True로 변경.
우측 상단의 적용 클릭.

첫 등록 : 2026.06.23

최종 수정 :

단축 주소 : https://igotit.tistory.com/6645

Technitium DNS Server

i.got.it — Mon, 22 Jun 2026 19:24:51 +0900

Technitium DNS Server

- 서버급 아닌 윈도우 운영체제(윈10/11등)에서도 실행 가능한 DNS 서버.

- 무료.

- 주로 로컬 DNS 서버 용으로 활용함.

- - 로컬 레코드 예시:

Zone : my.com

A 레코드 : hft-primary → 192.168.1.10 , db-server → 192.168.1.11 , feed-handler → 192.168.1.12

Technitium 설치 파일 다운로드

https://technitium.com/dns/

윈도우 설치 버전 선택

설치

- 기본 설치경로

첫 실행시 보이는 대화상자.

- 현재 이 PC 도 Technitium DNS Server 를 사용하도록 설정을 변경할거냐고 물어보는것. yes 클릭한다.

실행 상태에서는 트레이 아이콘이 활성화되고 , 마우스 우클릭 하면 메뉴 보인다.

위 메뉴에서 Dashboard 클릭하면 웹브라우저가 실행되며 설정및 모니터링 가능한 화면이 보인다.

도메인 영역 , 호스트 레코드 추가 방법

상단메뉴 Zones 클릭하여 버튼 Add Zones 클릭하여 my.com 부터 추가한다.

위 팝업창에서 버턴 Add 클릭하면 Zone 리트에 추가된다.

호스트 레코드 추가하기

방금 생성된 리스트에서 my.com 글자를 클릭하여 해당 영역 안으로 진입.
화면 우측 상단의 [Add Record] 버튼 클릭.
팝업창에 아래 항목 입력:
- Type: A (기본값 그대로 둠)
- Name: db-server
- IP Address: 192.168.1.11
- TTL: 3600 (기본값 그대로 둠)
아래 [Save] 버튼을 누르면 등록 완료.

위와 같이 하면 로컬 네트워크에서 db-server.my.com 이름으로 내부 아이피 주소인 192.168.1.11 로 연결됨.

윈도우의 서비스로 등록되어 실행됨

트레이 아이콘은 사용자 UI 를 위한 편의 기능이며, 트레이 아이콘이 실행되지 않아도 실제 DNS 서버는 서비스로 등록되어 윈도우 사용자 로그인 하지 않은 상태에서도 작동한다.

첫 등록 : 2026.06.22

최종 수정 :

단축 주소 : https://igotit.tistory.com/6644

CMR 방식 HDD . WD Red Plus . RAID 용

i.got.it — Mon, 22 Jun 2026 16:52:10 +0900

WD Red Plus HDD

Raid 환경에서 하드가 응답에러를 내지 않도록 제어하는 타임아웃 방지 기술 내장.

구입처

용량 : 4TByte

[공식판매점] WD RED Plus 5400/128M (4TB WD40EFZZ) - HDD | 쿠팡

쿠팡에서 [공식판매점] WD RED Plus 5400/128M (4TB WD40EFZZ) 구매하고 더 많은 혜택을 받으세요! 지금 할인중인 다른 HDD 제품도 바로 쿠팡에서 확인할 수 있습니다.

www.coupang.com

활용예

2베이 DAS 에 장착

연관

DAS . 테라마스터 D2-320 2베이 RAID

테라마스터 D2-320 2베이 RAID 스토리지 DAS RAID : 0 , 1, CLONE, JBOD USB 3.2 Gen2 (10Gbps)지능형 디스크 절전 : PC 측이 절전(혹은 전원오프)되면 DAS 도 절전모드로 진입. 수명연장 가능 D2-320 RAID 설정방법 하드

igotit.tistory.com

첫 등록 : 2026.06.22

최종 수정 :

단축 주소 : https://igotit.tistory.com/6643

DAS . 테라마스터 D2-320 2베이 RAID

i.got.it — Mon, 22 Jun 2026 16:39:18 +0900

테라마스터 D2-320 2베이 RAID 스토리지 DAS

RAID : 0 , 1, CLONE, JBOD

USB 3.2 Gen2 (10Gbps)

지능형 디스크 절전 : PC 측이 절전(혹은 전원오프)되면 DAS 도 절전모드로 진입. 수명연장 가능

구입처

테라마스터 D2-320 2베이 RAID 스토리지 DAS (하드미포함) - 외장 케이스 | 쿠팡

쿠팡에서 테라마스터 D2-320 2베이 RAID 스토리지 DAS (하드미포함) 구매하고 더 많은 혜택을 받으세요! 지금 할인중인 다른 외장 케이스 제품도 바로 쿠팡에서 확인할 수 있습니다.

www.coupang.com

구성품 전체

전면

후면

바닥면 스티커

- 2026.06.24 는 내가 부착한것.

측면 스티커

- raid 설정 방법 설명되어있다. 회전스위치를 원하는 raid 선택하고 reset 버튼 5초이상 누른다.

전원 어댑터

- 12V 5A .

디스크 장착

- 트레이의 측면 플라스틱이 분리된다.양쪽 모두 분리하고 HDD 장착하고 끼운다.

장착한 HDD : WD Red Plus 4TB

D2-320 RAID 설정방법

하드 장착 및 PC 연결:
본체 전원이 꺼진 상태에서 두 개의 하드를 장착하고 윈도우 서버 PC와 USB 케이블을 연결하고 PC 전원 온.
- 온 상태인 PC에 연결되지 않으면 자동절전 기능 때문에 raid 설정도 불가능하므로 필수 연결해야 함.

물리 스위치 조절:
제품 후면을 보면 SINGLE / JBOD / RAID 0 / RAID 1이 적힌 원형 다이얼(노브) 스위치를 원하는 것으로 선택. 예 RAID 1

하드웨어 레이드 물리 리셋:
- D2-320 전원 온 .
- 다이얼 바로 옆에 있는 [RESET] 홈을 동봉된 핀으로 약 5~10초간 길게 누른다.
- 본체의 전면 LED 표시등이 깜빡거리면서 raid 설정 진행하고 5초 이내 완료되고 led 표시등이 녹색으로 변경됨.
윈도우 포맷:
위 과정이 끝나면 연결된 PC 의 디스크 관리자에서 포맷(예 NTFS , 할당단위 기본 4096 byte 로 하면됨. 주 저장될 것이 수기가바이트 짜리의 큰 파일이 대부분이면 64kbyte 로 하나 기본설정 4096으로 하면 무난함 ) 하고 사용.
디스크 관리자 실행시 초기화 옵션은 GPT 선택한다.
- 참고 : MBR 은 2TB 까지만 인식되며 과거 윈도우 XP 시절 이전의 32비트 운영체나 구형 메인보드 에서 컴퓨터 부팅위해 사용하던 규격인데 현재는 부팅용으로도 사용안함.

디스크 장애 파악

전면 2개의 LED 가 있다.

정상 상태: HDD 1, HDD 2 모두 초록색(Green) 불이 켜져 있거나 데이터를 읽을 때 초록색으로 점멸.
1개 디스크 고장 시: 고장 난 슬롯(예: 2번 하드)의 LED만 붉은색(Red)으로 고정. 정상인 1번 슬롯은 여전히 초록색.
경고음(Beep): LED가 붉은색으로 바뀜과 동시에 비프음.

RAID 1 장애 디스크 교체 방법

- 고장 난 디스크를 동일용량 혹은 더 큰 용량의 새 하드로 교체하면 자동으로 복구 진행되며 LED 녹색 점멸. 수시간 소요될 수 있음.

- - 주의 : reset 버튼 누르지 않는다. 리셋버튼은 기존 기록된 데이터가 모두 날라 가므로 복구를 위해서는 교체만 하면 자동으로 진행됨.

연관

RAID 환경에서는 일반적인 PC HDD (SMR 방식) 사용하지 않고 CMR 방식 HDD 사용해야 한다.

CMR 방식 HDD . WD Red Plus . RAID 용

WD Red Plus HDD Raid 환경에서 하드가 응답에러를 내지 않도록 제어하는 타임아웃 방지 기술 내장. 구입처 용량 : 4TByte [공식판매점] WD RED Plus 5400/128M (4TB WD40EFZZ) - HDD | 쿠팡쿠팡에서 [공식판매점] WD RE

igotit.tistory.com

첫 등록 : 2026.06.22

최종 수정 :

단축 주소 : https://igotit.tistory.com/6642

KGM E-STANA (이스타나) . 카운티급 전기 버스

i.got.it — Tue, 16 Jun 2026 22:58:53 +0900

KGM E-STANA

- 2026년 출시.

- 1회 충전 328km 주행가능.

- 배터리 용량 : 155 kWh

- 외형 아웃라인의 심플함 굿~.

( 카운티 처럼 쓸데없이 곡면 처리되어 지저분함만 증가시킨 것보다는 심플 디자인이 훨씬 좋다. )

운전석

- 깔끔하다.

층고 높음

- 차량 개조한다면 2층 침대가 가능할 정도로 높고, 다락방, 복층 구조로 만들어도 될 정도.

- 직각 박스 타입이라 가구, 각종 기구물 배치시 극도로 유용.

이스타나 개조 상상도

이스타나 기반 복층구조 캠핑카 구성한다면 개략 아래 개념도 처럼 2층 다락방 에서는 지붕위로도 접근하기 용이하고 옥상테라스 까지 갖춘 흥미로운 공간 구성 가능.

컴퓨팅 환경도 완벽하게 구축 가능.

첫 등록 : 2026.06.16

최종 수정 :

단축 주소 : https://igotit.tistory.com/6614

Zephyr . COBS 라이브러리

i.got.it — Tue, 16 Jun 2026 16:44:06 +0900

Zephyr 내장 COBS 라이브러리

- COBS 기본개념 : https://igotit.tistory.com/6611

헤더 경로: #include <zephyr/data/cobs.h>
주요 함수: cobs_encode(), cobs_decode()
특징: Zephyr 전용 네트워크 버퍼 구조체인 struct net_buf를 기반으로 동작하며, 스트리밍 인코더/디코더(cobs_encoder_write)도 포함하고 있어 매우 안정적

zephyr cobs 상세 설명

Zephyr API Documentation: COBS (Consistent Overhead Byte Stuffing)

COBS encoding and decoding functions with custom delimiter support. Provides functions for COBS encoding/decoding with configurable delimiters. The implementation handles both standard zero-delimited COBS and custom delimiter variants.

docs.zephyrproject.org

연관

COBS . 바이트 시리즈 프레이밍

COBS . Consistent Overhead Byte Stuffing - 바이트 시리즈의 프레이밍 알고리듬 중의 하나 . - - 예 : 시리얼 통신 경로로 N 바이트 단위로 송신하려는 경우 COBS 인코딩하여 송신하고 이를 수신한 측에서 COBS

igotit.tistory.com

Zephyr (제퍼) . RTOS . 경량

Zephyr (제퍼)- 경량 RTOS . nRF52840 ( ARM Cortex M4F, 1MByte flash, 256kbyte ram. 64MHz )급에서도 활용 가능. - 라이센스 : 오픈소스- 관리주체 : 리눅스재단 하위 별도 프로젝트 팀. - - 제퍼운영체제는 리눅스 커

igotit.tistory.com

첫 등록 : 2026.06.16

최종 수정 :

단축 주소 : https://igotit.tistory.com/6612

COBS . 바이트 시리즈 프레이밍

i.got.it — Tue, 16 Jun 2026 15:35:39 +0900

COBS . Consistent Overhead Byte Stuffing

- 바이트 시리즈의 프레이밍 알고리듬 중의 하나 .

- - 예 : 시리얼 통신 경로로 N 바이트 단위로 송신하려는 경우 COBS 인코딩하여 송신하고 이를 수신한 측에서 COBS decoding 하면 송신측에서 의도한 N 바이트 구간을 추출가능하다.

- COBS encoding 된 데이터열에는 프레임들의 경계 지점에만 delimiter (통상 0 으로 함) 값이 등장하게되고 원본 데이터에 있던 0의 값들이 있던 자리에는 다음 0까지의 오프셋을 기록하므로 프레임의 경계 지점에만 0인 값이 단 1개 존재한다. 수신측에서는 프레임 경계지점을 값이 0인것만 탐색하면 알 수 있고 COBS decoding 하여 원본 데이터를 추출한다.

COBS encoding 규칙 및 예시

위 도식의 예에서는 원본데이터에 0이 1개 만 있는데 , 0이 1개 이상인 원본 데이터 예 1,2,0,3,4,0,5 라고 하고 아래 처럼 이해 하면 쉽다.

COBS encoding 끝자리에는 0을 기록한다. 첫 자리에는 원본데이터에서 처음 등장하는 0 의 오프셋( 본 예에서는 3 )을 기록하고 데이터 중의 0 이 있는 자리에는 다음 0이 나오는 오프셋으로 기록해둔다. 원본 데이터에서 마지막 0 자리에는 끝자리에 기록해둔 0까지의 오프셋(본 예에서는 2)을 기록한다.

최종 COBS 인코딩 바이트열 : 3,1,2,3,3,4,2,5,0

핵심 : COBS 인코딩된 바이열에서 0은 프레임 경계 지점에만 등장한다.

COBS encoding 최대 바이트 증가량

원본 데이터 N 바이트를 COBS 인코딩 후 델리미터까지 포함한 최종 크기는 최악의 경우 N + 1 + [N/254] 바이트가 된다.

[] 의미 : ceiling function . [1.25] 이면 2.

즉, 254바이트 이하일 때는 2바이트가 증가하며, 이후 254바이트를 초과할 때마다 1바이트씩 추가로 오버헤드가 누적된다.

크기별 실제 데이터 사이즈 예시

N = 254 일 때
- 254 + [254/254] + 1 = 254 + 1 + 1 = 256 바이트 (기본 2바이트만 증가)
N = 255 일 때 (254를 초과하는 첫 구간)
- 255 + [255/254] + 1 = 255 + 2 + 1 = 258 바이트 (총 3바이트 증가)
N = 508 일 때
- 508 + [508/254] + 1 = 508 + 2 + 1 = 511 바이트 (총 3바이트 증가)
N = 509 일 때
- 509 + [509/254] + 1 = 509 + 3 + 1 = 513 바이트 (총 4바이트 증가)

원본 데이터 수량제한 없음

COBS 알고리즘 자체로는 원본 데이터의 크기(수량) 제한이 없다.

오프셋 값을 1바이트(0x01~0xFF)로 표현하므로 다음 0까지의 거리가 최대 254칸으로 제한될 뿐이다. 연속된 데이터가 254바이트를 넘어가면 0이 없더라도 강제로 오프셋 '255'(0xFF)를 삽입하여 프레임을 쪼개기 때문에, 원본 데이터가 아무리 길어도 이론상 모두 인코딩할 수 있다.

COBS 라이브러리

C 소스

GitHub - cmcqueen/cobs-c: Consistent Overhead Byte Stuffing — C implementation

Consistent Overhead Byte Stuffing — C implementation - cmcqueen/cobs-c

github.com

Zephyr RTOS 내장 COBS

Zephyr . COBS 라이브러리

Zephyr 내장 COBS 라이브러리 - COBS 기본개념 : https://igotit.tistory.com/6611 헤더 경로: #include 주요 함수: cobs_encode(), cobs_decode() 특징: Zephyr 전용 네트워크 버퍼 구조체인 struct net_buf를 기반으로 동작하며,

igotit.tistory.com

첫 등록 : 2026.06.16

최종 수정 :

단축 주소 : https://igotit.tistory.com/6611

블루투스 핑거봇

i.got.it — Mon, 15 Jun 2026 19:08:45 +0900

블루투스 핑거봇

- 물리 버튼 무선 누르기 용도에 적합

구입처

Smart Bluetooth Finger Robot Switch Button Smart Life APP Fingerbot Wireless Switch Bot Pusher with Bluetooth Gateway Option - A

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

첫 등록 : 2026.06.15

최종 수정 :

단축 주소 : https://igotit.tistory.com/6610

의자 . 머리 받침대 . 높이 각도 조절

i.got.it — Mon, 15 Jun 2026 16:36:22 +0900

의자 머리 받침대

구입처

Upgraded Memory Foam Headrest Attachment For Office Chair Adjustable Height Angle Elastic Head Pillow Neck Support Rest Cushion

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

일반 의자 스타일의 머리 받침대 부속

Computer Chair Headrest Pillow Adjustable Headrest for Chair Office Neck Protection Headrest for Office Chair Accessories - AliE

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

Office Chair Headrest Breathable Detachable Attachment Desk Chair Head Rest - AliExpress 1503

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

첫 등록 : 2026.06.15

최종 수정 :

단축 주소 : https://igotit.tistory.com/6609

DIY . 스타리아 . 트렁크 테이블

i.got.it — Sat, 13 Jun 2026 18:38:36 +0900

스타리아 . 트렁크 테이블

- 트렁크 쪽에 넓게 활용 가능한 테이블.

- 2개의 원통이 지지 역할을 하고, 그 위에 경량 알루미늄 롤테이블 장착하는 방식.

- 최적 높이 셋팅 가능. 분리/장착 간단.

와이어 지지 방식

- 액자걸이 와이어로 테이블 앞부분의 봉을 잡는 구조

3열 의자 안전 벨트 탈거 하고 남겨둔 안전벨트 고정 장치(매우 튼튼함)에 와이어 걸었다.

봉의 끝단 처리

- 타이 2개를 이용하여 고리를 걸 수 있는 구조 만들어 둔다.

벨크로 타이로 테이블 뒷단 봉 고정

벨크로 타이 를 테이블에 리벳 고정하여 매우 튼튼하다.

노트북 , 마우스 올려도 여유있다.

참고 : 트렁크 식빵등 https://igotit.tistory.com/5722

DIY . 스타리아 . RGB 면발광 식빵등

RGB 식빵등 선정 - 쿠팡에서 판매되는 식빵등은 여러 색 표현 못하는 단색 조명만 판매되고 있다. 임의 색상 가능한 RGB 조명관련 제품을 알리에서 검색해 보면 여러 제품들이 있고(조사한 제품들

igotit.tistory.com

상위 정리

스타리아 . DIY 모음

휴즈박스에 시거 소켓 매립 - 2024.04.03 DIY . 스타리아 . 휴즈 박스에 시거 소켓 매립 .개요 차종 : 스타리아 차량 휴즈 박스 내에 시거 소켓 매립하여 기기 전원 공급선들 최대한 안 보이게 처리하

igotit.tistory.com

연관

리벳건 . 전동드릴 연결하여 사용가능

구입처 13.46US $ 46% OFF|Rivet Nut Gun Drill Adapter | Riveter Electric Drill | Nail Gun Adapter Drill - Electric - Aliexpress Smarter Shopping, Better Living! Aliexpress.com www.aliexpress.com 구성품 리벳 넣는 곳 - 리벳건 뒤 회전샤프트

igotit.tistory.com

벨크로 타이 . 프리미엄 찍찍이 , 3M 듀얼락 접착식

벨크로 타이 벨크로 타이 구입처 폭 : 1.5, 2, 4 cm 아담 고급 컴퓨터선정리 벨크로타이 멀티탭정리 전선정리 케이블타이 책상선정리COUPANGwww.coupang.com 제품 활용예 차량 전기계통 작업시 배선 정리

igotit.tistory.com

첫 등록 : 2026.06.13

최종 수정 :

단축 주소 : https://igotit.tistory.com/6607

32인치 . 4k 모니터 . 12V 전원 입력

i.got.it — Tue, 2 Jun 2026 17:22:20 +0900

크로스오버 32UAW9 UHD4K 비비드 화이트 32인치 모니터

모델명 : 32UAW9 (무결점)

해상도 : 4k UHD (3840x2160 픽셀)

내장 스피커 : 3W+3W

무게 : 스탠드 제외 5.5kg

전원공급 : 12V/5A 어댑터

소비전력 : 최대 51W , 평균 43W

사양

구입처

크로스오버 32UAW9 UHD4K 비비드 화이트 32인치 모니터 - 게이밍 모니터 | 쿠팡

쿠팡에서 크로스오버 32UAW9 UHD4K 비비드 화이트 32인치 모니터 구매하고 더 많은 혜택을 받으세요! 지금 할인중인 다른 게이밍 모니터 제품도 바로 쿠팡에서 확인할 수 있습니다.

www.coupang.com

구성품 전체

주활용

차량 내부 https://igotit.tistory.com/6600

DIY . 스타리아 . 듀얼 모니터 . 미니 PC

DIY . 스타리아 . 듀얼 모니터 . 미니 PC 모니터 거치대 모니터 거치대 구입처. 20° tiltable TV Wall Mount Bracket 360° Rotated Holder Universal TV Mounts for 14-24'' Computer Monitor Stand Monitor Flat PanSmarter Shopping, Better Li

igotit.tistory.com

첫 등록 : 2026.06.02

최종 수정 :

단축 주소 : https://igotit.tistory.com/6603

DIY . 스타리아 . 듀얼 모니터 . 미니 PC

i.got.it — Sun, 31 May 2026 11:50:07 +0900

DIY . 스타리아 . 듀얼 모니터 . 미니 PC

모니터 거치대

모니터 거치대 구입처.

20° tiltable TV Wall Mount Bracket 360° Rotated Holder Universal TV Mounts for 14-24'' Computer Monitor Stand Monitor Flat Pan

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

미니 PC 화면 출력을 빔프로젝터에도 연결하여 듀얼 모니터로 활용 가능.

미니 PC, 시거잭 멀티 충전기, LTE 라우터 모두 천장 철망위에 있음.

32인치 4k UHD 모니터 장착

- 앞의 27인치 모니터 해상도는 FHD (1920x1080 픽셀) 라서 고화질 영상 보는 경우 조금 아쉽다.

- 32인치 4k UHD(3840x2160 픽셀) 모니터 장착했다.

모니터 뒤에 스피커 배치

- 블루투스 스피커 미니 PC 와 무선 연결

ㄱ 자 꺽쇠이용 차량 흔들림에도 스피커 이탈되지 않도록 함.

트렁크 측 컴퓨팅 환경 셋팅.

DIY . 스타리아 . 트렁크 . 컴퓨팅 환경 셋팅

개요 - 스타리아 트렁크 테일게이트 밀착 배치된 컴퓨팅 환경. - 노트북에 모니터 확장 연결하여 듀얼 모니터 활용. - 테일게이트에 배치한 블루투스 스피커로 노트북 사운드 출력. - LTE 라우터로

igotit.tistory.com

상위정리

스타리아 . DIY 모음

igotit.tistory.com

연관

미니 PC

피코펄스 AX . 미니 PC . USB-C 전원공급

피코펄스 AX 미니 PC - 전원공급 : USB-C- 운영체제 : 윈도우 11 프로. - 모니터 출력 : 4k , 3개 가능. DP1.4 1개, HDMI 2.0 2개 - USB : USB3.1 Gen1 3개. - RAM : 12Gbyte- WiFi 5, Bluetooth 5- 무게 : 173g - 소음 : 25dB (매우 조

igotit.tistory.com

모니터 27인치

모니터 . 주연테크 27인치 . FHD LED 100Hz

모델명 : V27FX(ZERO) - 무결점 주연테크 모니터 27인치. FHD . LED 100Hz 사양 - 소비전력 : 30W - 무게 : 스탠드 제외 3.78kg 구입처 - 옵션에서 무결점 선택가능. 주연테크 68cm FHD LED 모니터 100HzC

igotit.tistory.com

모니터 32인치 . 4k UHD

32인치 . 4k 모니터 . 12V 전원 입력

크로스오버 32UAW9 UHD4K 비비드 화이트 32인치 모니터 모델명 : 32UAW9 (무결점)해상도 : 4k UHD (3840x2160 픽셀)내장 스피커 : 3W+3W무게 : 스탠드 제외 5.5kg 전원공급 : 12V/5A 어댑터 소비전력 : 최대 51W , 평

igotit.tistory.com

모니터 거치대

모니터 거치대 . 벽 고정 접이식

모니터 거치대 . 벽 고정 접이식 - 벽 고정식- 수평 방향 접이식으로 위치 조정 가능. 최대 펼치면 40cm. - 수직 방향 위치 조정 안됨. 구입처 색상 옵션 : 백색 / 검정 20° tiltable TV Wall Mount Bracket 360°

igotit.tistory.com

첫 등록 : 2026.05.31

최종 수정 : 2026.06.14

단축 주소 : https://igotit.tistory.com/6600

피코펄스 AX . 미니 PC . USB-C 전원공급

i.got.it — Thu, 28 May 2026 15:59:39 +0900

피코펄스 AX 미니 PC

- 전원공급 : USB-C

- 운영체제 : 윈도우 11 프로.

- 모니터 출력 : 4k , 3개 가능. DP1.4 1개, HDMI 2.0 2개

- USB : USB3.1 Gen1 3개.

- RAM : 12Gbyte

- WiFi 5, Bluetooth 5

- 무게 : 173g

- 소음 : 25dB (매우 조용)

구성품

사양

구입처

- 가격 : 434,000원 , SSD : 256G

피코펄스 미니PC 사무용 초소형 데스크탑 본체 - 미니PC | 쿠팡

쿠팡에서 피코펄스 미니PC 사무용 초소형 데스크탑 본체 구매하고 더 많은 혜택을 받으세요! 지금 할인중인 다른 미니PC 제품도 바로 쿠팡에서 확인할 수 있습니다.

www.coupang.com

전원스위치

3.5mm 오디오 출력, RJ45 2개, USB-C 전원공급

DP1.4 1개, HDMI 2.0 2개

USB3.1 Gen1 3개.

브라켓 연결

- 모니터 VESA 홀 에 거치할때 활용

차량에서 미니 PC 활용 가능성 확인

- USB-C 로 전원공급 가능하므로 차량의 시가잭 충전기 (PD 65W 이상 지원되는것)로 전원공급 가능하다.

위 사진의 시거잭 충전기 구입처

벤딕트 100W QC4.0+PD3.0 동시 초고속 차량용 시거잭 충전기 - 스마트폰/태블릿용 | 쿠팡

현재 별점 4.8점, 리뷰 305개를 가진 벤딕트 100W QC4.0+PD3.0 동시 초고속 차량용 시거잭 충전기! 지금 쿠팡에서 더 저렴하고 다양한 스마트폰/태블릿용 제품들을 확인해보세요.

www.coupang.com

기존 빔프로젝트 장착했던것 옆에 임시 배치하고 PC 와 빔프로젝트간 HDMI 연결

첫부팅 설정

설정 선택에서 개인용 설정으로 한다.

개인용 설정 (추천): 개인 마이크로소프트(MS) 계정이나 로컬 계정으로 로그인하여 PC의 전권을 가지는 방식. 이 PC 를 서버로 세팅할 때 방해되는 복잡한 보안 그룹 정책이나 기업용 원격 관리 제약이 없기 때문에, 오히려 사내 독립 서버를 세팅하기에는 이 방식이 훨씬 직관적이고 편함.
회사 또는 학교용 설정: 회사의 대형 Active Directory(AD) 서버나 엔터프라이즈 통합 클라우드 시스템(MS 365 비즈니스 등)에 이 PC를 종속시킬 때 쓰는 것인데 전혀 필요없다. MS 답게 지저분하게 만드는 주범임.

PC 가 인터넷 사용가능한 상태이면, 이후 진행시 MS 계정을 요구하는데 이 단계에서 인터넷선을 끊고 진행하면 MS 계정 필요없는 로컬계정으로 설정한다. - 이게 훨씬 유용하다.

이후 사용자 이름과 비번 기록하고 진행. - 이게 로컬계정임.

그리고 이후 잡다한것들 많이 물어본다. 운영체제가 자동으로 해주는 것 허용할래? 류의 설정인데 전부 아니오로 한다. 윈도우 운영체제가 쓸데없이 개입하는 것을 방지 하는게 훨씬 유용.

주요설정

윈도우 빠른 시작 켜기 해제

다시시작 기능이 정상 작동하지 않는 문제 해결

제어판 > 하드웨어 및 소리 > 전원 옵션 중 "전원 단추 동작 변경" 클릭
'현재 사용할 수 없는 설정 변경'을 클릭.
화면 하단의 종료 설정 중 '빠른 시작 켜기(권장)' 체크 해제

연관

차량에서 미니 PC 활용

DIY . 스타리아 . 듀얼 모니터 . 미니 PC

DIY . 스타리아 . 듀얼 모니터 . 미니 PC 미니 PC : 천정 철망 위 모니터 거치대 모니터 거치대 구입처. 20° tiltable TV Wall Mount Bracket 360° Rotated Holder Universal TV Mounts for 14-24'' Computer Monitor Stand Monitor Flat

igotit.tistory.com

기타

- 알리에 미니 PC 많은 제품들이 있음.가성비 좋다.

GMKtec G3S Mini PC Intel Alder Lake N95 Windows 11 Pro Mini PC 8GB DDR4 128/256GB PCIe M.2 SSD WiFi 5 BT5.0 Desktop Computer - A

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

Intel Core i9-10980HK Mini PC Intel N150 16GB 32GB RAM 1/2TB SSD Bluetooth 5.2 WiFi6 1000M Ethernet Windows 11 Gaming Office PC

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

Intel i9-10980HK Strong Performance Mini PC 32GB Large RAM 1TB Fast SSD Win11 Pro 4K Gaming Office Household Computer - AliExpre

Smarter Shopping, Better Living! Aliexpress.com

www.aliexpress.com

첫 등록 : 2026.05.28

최종 수정 :

단축 주소 : https://igotit.tistory.com/6599

SlimeVR . IMU 기반 Full Body Tracking (FBT)

i.got.it — Wed, 27 May 2026 16:31:04 +0900

SlimeVR

- IMU(관성센서) 기반 자세(quaternion) 정보 수집하여, 인체 스켈레톤에 대한 Forward Kinematics 연산 수행하고 이를 SteamVR/VRChat 등에 전달하여 캐릭터(아바타) 를 움직일수 있게 하는것 .

- 초기 SlimeVR 은 DIY 오픈 프로젝트로 진행하다가 완제품 형태의 센서도 판매 중. 펌웨어 소스까지 공개되어있다.

전체 구조


[IMU]
  ↓
[MCU 펌웨어]
  ↓
[무선 전송]
  ↓
[SlimeVR Server]
  ↓
[Skeleton Solver / Sensor Fusion]
  ↓
[SteamVR Driver]
  ↓
[VRChat / SteamVR App]

SlimeVR Server

역할:

tracker discovery
calibration
skeleton solving
SteamVR bridge
OSC/VMC export

다운로드 주소 : https://slimevr.dev/

첫 등록 : 2026.05.27

최종 수정 :

단축 주소 : https://igotit.tistory.com/6597

WebUSB . 시험 가능 웹

i.got.it — Wed, 6 May 2026 16:24:47 +0900

WebUSB

운영체제별 WebUSB의 하부 드라이버 매칭

운영체제	사용하는 드라이버	특징
Windows	WinUSB (winusb.sys)	윈도우 커널 보안 정책상, WebUSB가 기기에 접근하려면 반드시 하부에 WinUSB 드라이버가 매칭되어 있어야 함.
macOS	가상 드라이버 (커널 내장)	macOS는 유저 영역 USB 접근을 기본 지원하므로, 기기가 CDC(시리얼)나 HID 같은 전용 드라이버를 독점하지 않는 한 별도 드라이버 설치 없이 즉시 WebUSB 통신 가능.
Linux	usbfs / libusb	리눅스 역시 커널 드라이버가 독점하지 않는다면 즉시 접근 가능. (단, /etc/udev/rules.d에서 사용자 권한 허용 설정 필요)
Android	Android USB Host API	안드로이드 폰/태블릿에서도 크롬 브라우저를 통해 별도 드라이버 없이 WebUSB 동작

"WebUSB 기술 자체는 멀티 플랫폼"이지만, "윈도우 PC 환경에서는 반드시 WinUSB 드라이버를 거쳐야 통신 가능".

NCS(nRF Connect SDK) 내장 로컬 웹

경로: v3.2.3/zephyr/samples/subsys/usb/webusb/

위 경로에서 터미널(CMD/PowerShell 등)을 열고 아래 명령어로 내장 Python 웹 서버 실행.

python -m http.server 8001

크롬 브라우저를 열고 접속. http://localhost:8001/

브라우저 실행모습

- USB 기기 연결, 송신, 수신 기능 확인 가능.

노르딕사 제공 도움말

https://docs.nordicsemi.com/bundle/ncs-3.0.1/page/zephyr/samples/subsys/usb/webusb/README.html

Technical Documentation

docs.nordicsemi.com

기타 온라인 WebUSB 시험 가능

WebUSB Test Page

WebUSB Test Page Auto Connect Claim Interface Control Transfer Send/Receive Disconnect Status: Not Connected

intel.github.io

첫 등록 : 2026.05.06

최종 수정 :

단축 주소 : https://igotit.tistory.com/6580

윈도우 . 관리자 권한 실행앱은 네트워크 드라이브 모름

i.got.it — Fri, 1 May 2026 19:23:45 +0900

윈도우 . 관리자 권한 실행된 프로세스는 네트워크 드라이브 모름

사유 : 윈도우의 User Account Control (UAC) 때문에 로그온 세션이 분리된다.

일반 실행 → 표준 토큰 (Standard Token)
관리자 실행 → 상승 토큰 (Elevated Token)

- 네트워크 드라이브 매핑(net use)은 표준 토큰 쪽 세션에만 연결됨
- 그래서 관리자 권한 프로세스에서는 “드라이브가 없는 것처럼” 보임

실제 나타나는 증상예 .

일반 권한으로는 탐색기에 네크우워크 드라이브로 연결한 Z: 보이는데, 관리자 권한 커맨드 창 실행시 Z: 안보임

자동 업데이트 기능이 있는 앱을 네트워크 드라이브에 두고 실행하는데, 업데이트는 관리자 권한으로 실행하려고 하는데 네트워크 드라이브 인식 못하여 업데이트 실패 발생.

레지스트리 수정으로 관리자 권한 에서도 네트워크 드라이브 사용하기.

regedit 실행.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System 이동

새 DWORD(32비트) 값 생성: 이름을 EnableLinkedConnections로 지정하고 값을 1로 설정.

위 수정하고 재부팅하면 관리자 권한 실행 앱에서도 네트워크 드라이브 접근 가능.

첫 등록 : 2026.05.01

최종 수정 :

단축 주소 : https://igotit.tistory.com/6579

VSCode 확장. Foam . 마크다운 . 위키링크

i.got.it — Tue, 28 Apr 2026 16:42:29 +0900

Foam 의 위키링크 (Wikilinks) 사용 방법

1. md 문서에서 링크 걸고 싶은 위치에서 대괄호 2개 [[ 입력 ,

2. [[를 입력하면 현재 워크스페이스에 있는 파일 목록이 자동 완성으로 보이며, 연결하고 싶은 파일을 선택하면 끝.

- 파일 이름과 다르게 표시하고 싶다면 [[파일명|표시할 이름]] 형식으로 기록.

연관

마크다운 문법.

마크다운 파일확장자 md 표현요소. 마크다운 문법. Heading # 수량만큼 제목1수준,~ 6수준까지 표현. # 제목1 ## 제목2 ... ###### 제목6 개행 라인 끝에 2개이상의 공백 엔터쳐도 개행안됨. 문단나누기 한

igotit.tistory.com

Visual Studio Code . 포터블 (무설치) 활용

Visual Studio Code 무설치 - 외장하드에 설치해두고 아무 PC에 연결하여 실행 하기 위함. - 개발대상 별로 전용 VSCode 폴더 여럿 만들어서 활용 가능. 예 : 메타트레이더4 용 VSCode, 메타트레이더 5용 VSCod

igotit.tistory.com

첫 등록 : 2026.04.28

최종 수정 :

단축 주소 : https://igotit.tistory.com/6578

git . 커밋 메시지 , 태그 , 브랜치 규칙

i.got.it — Mon, 27 Apr 2026 12:33:14 +0900

git . 커밋 메시지 , tag , 브랜치 규칙

커밋 메시지 제목 부분

타입: 요점 형태로 작성.

형식: 타입(범위): 제목
주요 타입:
- feat: 새로운 기능 추가
- fix: 버그 수정 (가장 많이 쓰임)
- refactor: 코드 리팩토링 (기능 변화 없이 코드 구조만 개선)
- docs: 문서 수정 (README 등)
- style: 코드 포맷팅 (세미콜론 누락 등, 로직 변경 없음)
예시:
- feat: 64비트 전용 통신 모듈 추가
- fix: 1.0.4.5 배포 버전 로그인 크래시 수정
- refactor: 공통 함수 라이브러리 구조 개선

브랜치

VSCode 에서 브랜치 생성방법

master branch 우마우스 클릭 메뉴 에서 Create Branch.. 클릭 브랜치 이름 적고 엔터치면 브랜치 생성됨.

브랜치 명

1. 기본 구조: 타입/내용

브랜치 이름 앞에 슬래시(/)를 사용하여 접두어를 기록하면 Visual Studio나 Git 도구에서 폴더처럼 타입별 계층 구조로 보여주므로 관리 편해짐.

브랜치명 접두어	설명
master	배포가능한 가장 안정적인 소스가 있는 브랜치. 임시 파생 작업 요구될 때 main 에서는 절대 작업하지 않고 브랜치2 만들어서 완성 검증 되면 main 브랜치로 머지하고 브랜지2는 삭제한다.
feature/	기능상의 변경 feature/login-dialog
fix/	버그 수정 예 : fix/memory-leak , fix/issue-104
refactor/	기능 변경없이 코드 구조개선 위주의 작업 예 : refactor/common-library
maintenance/	IDE 변경 등 예 : maintenance/vs2022-migration

2. 버전 정보를 브랜치명에 포함하는 경우

여러 버전을 동시에 관리해야 한다면 브랜치 이름에 버전 번호를 명시하기도 한다.

release-1.0.4.5: 1.0.4.5 버전을 출시하기 위해 최종 점검 중인 브랜치
dev-1.0.5.0: 다음 대기 버전인 1.0.5.0을 목표로 작업 중인 브랜치

3. 작성 시 주의할 규칙 (에러 방지)

Git 브랜치 이름은 파일 경로로도 인식되기 때문에 몇 가지 금지 사항.

공백(Space) 금지: 공백 대신 하이픈(-)이나 언더바(_) 사용. (예: feat/new-task)
한글 사용 금지 : 최신 도구들은 지원하지만, 빌드 환경이나 서버 설정에 따라 소스가 꼬일 수 있다. 영어 안전.
소문자 구분: 윈도우 환경에서는 대소문자를 구분하지 않는 경우가 많아 혼란을 줄 수 있으므로, 소문자로 통일.

표준적인 브랜치 처리 과정

출발: main (예 : 1.0.4.5 버전 상태)
가지치기: feat/new-logic 브랜치 생성 후 여기서 변경될 사항들 구현 작업
완료: 브랜치에서 테스트해보니 완벽.
합치기: main으로 이동해서 feature/new-logic을 Merge.
박제: main에 Tag(v1.0.4.6)를 달기
정리: feature/new-logic 브랜치는 삭제

연관

Git . 깃 포터블 구축 . VSCode 셋팅

Git . 깃 포터블 구축 . 깃 다운로드 주소 : https://git-scm.com/install/windows Git for Windows/x64 Portable 클릭하여 다운로드 받은 파일 실행하여 압축해제가 전부임. 압축해체할 경로 지정하고 OK. 압축해제 파

igotit.tistory.com

첫 등록 : 2026. 04.27

최종 수정 :

단축 주소 : https://igotit.tistory.com/6576

VSCode . 깃허브 계정 2개 이상 사용 위한 설정

i.got.it — Sun, 26 Apr 2026 17:34:38 +0900

VSCode . 깃허브 계정 2개 이상 사용 위한 설정

설정 요점

각 계정별로 SSH 키를 VSCode 에서 생성하여 깃허브 해당 계정에 등록하고 로컬 git config 파일에 호스트와 계정 대응관계 기록한다.

1/3 . SSH 키 파일 생성

VSCode 터미널에서 각 계정별로 키 파일 만들기.

구문.

-C 다음 문자열은 단순 주석일뿐이라 아무거나 기록해됨. -f 뒤에 경로에 키 생성된다.

본인의 여러 계정별로 키 파일 생성한다.


ssh-keygen -t ed25519 -C "github-igotit" -f H:/Portable_Home/.ssh/key_rsa_igotit

위 구문 엔터치면 비밀번호 설정하거냐고 물어보는데 안해도됨 . 엔터쳐서 진행완료하면아래처럼 2개의 파일이 생긴다. .pub 로 된건 공개키이고, 확장자 없는건 개인키이다.

2/3 . SSH 키를 깃허브에 등록

앞의 1/3 에서 만든 공개키 .pub 파일 내용을 복사해서 GitHub 사이트에서 Settings -> SSH ans GPG keys 에 등록한다.

왼쪽 메뉴 "SSH and GPG keys" 클릭하여 버튼 New SSH key 클릭한다.

1. title 에는 식별 문자열. 3/3 에서 config 파일의 Host 이름과 동일한것 기록하면 됨.

2. Authentication Key 선택.

3. 앞에서 만든 공개키 파일 .pub 파일 열어서 복사하여 붙여넣기 한다.

3/3 . config 파일에 ssh 지정

- 로컬 git 에 설정하는 것.

- 각 계정별 호스트에 사용할 1/3 에서 만든 계정별 키 파일을 지정한다.

- 환경변수 HOME 경로에 파일명 : config 만들어서 아래 형식으로 기록한다.

# A 계정 설정
Host github-userA
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_user_a

# B 계정 설정 
Host github-userB
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_rsa_user_b

config 파일 작성법.

- Host github-userA : 별칭일뿐이므로 본인이 식별가능한 이름 기록하면됨.

- IdentityFile ~/.ssh/id_rsa_user_a : ~ 는 로컬 PC 에서 환경변수 HOME 경로를 의미한다. 보통은 C:\Users.. 이런식으로 되어있음. 환경변수 Home 하위에 .ssh 폴더 만들고 config 파일 작성한다.

# githiub 계정 igotit 설정
# Host 는 본인이 식별하기 편하게 작성.  
Host github.com-igotit 
    HostName github.com
    User git
    IdentityFile H:/Portable_Home/.ssh/key_rsa_igotit

# githiub 계정 cymetric 설정
Host github.com-cymetric
    HostName github.com
    User git
    IdentityFile H:/Portable_Home/.ssh/key_rsa_cymetric

나의 경우에는 환경변수 HOME 을 외장 SSD 의 Portable_Home 으로 설정했기에 아래 경로에 파일들 배치했다.

H:\
├── Portable_Git\
├── Portable_VScode\
└── Portable_Home\ (환경변수 HOME이 가리키는 곳)
    └── .ssh\
        ├── config
        ├── key_rsa_igotit
        └── key_rsa_cymetric

정상 설정되었는지 확인 방법

VScode 터미널에서 아래 구문 실행. config 파일에서 지정했던 Host 이름을 -T 뒤에 기록한다.

ssh -T github-igotit

처음 연결시 Are you sure you want to continue connecting (yes/no/[fingerprint])? 라고 물어본다. 이때 yes 입력한다.

계정 지정 깃허브 클론 방법

- 이제 나의 여러 계정의 깃허브 클론시 어떤 계정으로 할 것인지 정할 수 있다.


git clone git@config에설정한호스트이름:깃허브계정명/깃허브저장소명.git

예. 깃허브 계정 cymetric 으로 클론 하는예. 
git clone git@github-cymetric:cymetric/firsttest.git

위 구문의 마지막 .git 의 의미.

- SSH 방식 클론 문법. 해당 경로가 Git 저장소임을 나타내는 식별자.

위와 같이 클론하고 나서 이후 커밋 , 푸시 할때 usename 이 git global 설정의 것이 적용되지 않도록 해당 폴더의 깃에 user.name , user.email 지정해두면 이 폴더의 커밋 , 푸시는 항상 이 이름으로 이뤄진다.

git config user.name "cymetric"
git config user.email "cymetric.com@gmail.com"

로컬 에서 git init 이후 계정 지정 깃허브 푸시

특정 폴더(예 : firsttest)를 깃 관리 하는 것은 통상적인 git 구문 과 동일.

git init
git config user.name "cymetric"
git config user.email "cymetric.com@gmail.com"

이 폴더를 깃허브 푸시 하기전에 SSH 별칭이 포함된 아래 설정을 1회 해주면 된다.

git remote add origin git@github-cymetric:cymetric/firsttest.git

위 구문실행결과 error: remote origin already exists 등이 생기면 아래구문으로 주소를 새로 설정한다.

git remote set-url origin git@github-cymetric:cymetric/firsttest.git

연관

Git . 깃 포터블 구축 . VSCode 셋팅

igotit.tistory.com

Visual Studio Code . 포터블 (무설치) 활용

igotit.tistory.com

첫 등록 : 2026.04.26

최종 수정 :

단축 주소 : https://igotit.tistory.com/6575

VSCode 확장. Paste Image . 캡처 이미지 자동 저장 삽입

i.got.it — Sat, 25 Apr 2026 17:38:11 +0900

VSCode 확장. Paste Image

"클립보드에 이미 복사되어 있는 이미지 데이터"를 가로채서 자동으로 파일 저장하고 문서내 링크를 걸어주는 것

활용 시나리오

윈도우 내장 기능으로 이미지 캡처
붙여넣기 (VSCode 단축키):
- VSCode 마크다운 문서의 원하는 위치에서 Ctrl + Alt + V (Paste Image 기본 단축키)를 누른다.
결과 확인:
- 클립보드에 있던 이미지가 지정 폴더에 .png 파일로 저장.
- 본문에는 ![](이미지경로)가 자동으로 생기며 우측 미리보기 창에 바로 뜬다.

활용예

VSCode 에서 md 파일에 설명 기록하면서 이미지 표현하고 싶은 경우 간단하게 이미지 자동저장 및 문서내 삽입되고 이를 Preview 화면에서 즉시 볼 수 있다.

이미지 저장경로 지정

- Paste Image 의 기본 설정은 문서 와 동일 폴더에 저장하는데 이를 /images 로 지정하려면 Paste Image 셋팅에서 Path 부분에 /images 기록한다.

이미지 저장전 이름 변경 가능하게 하기

- 기본 저장되는 이미지 파일명은 년월일시분초.png 로 저장되어 중복없이 저장은 가능하다. 저장전 이름 수정하려면 아래옵션을 체크하면 저장전 이미 저장경로 및 파일이름 지정 가능하다.

연관

Visual Studio Code . 포터블 (무설치) 활용

igotit.tistory.com

마크다운 문법.

igotit.tistory.com

첫 등록 : 2026.04.25

최종 수정 : 2026.04.28

단축 주소 : https://igotit.tistory.com/6573

AppLife Update . VS2015 C# 프로젝트 VS2022 로 마이그레이션

i.got.it — Sat, 25 Apr 2026 16:04:54 +0900

AppLife Update . VS2015 에서 VS2022 로 마이그레이션

상황

VS 2015 에서 AppLife Update ( version 4.0 ) 적용한 C# 프로젝트를 VS2022 로 마이그레이션 하기.

VS 2015 로 작성된 C# 프로젝트를 VS2022 에서 읽어들이는건 문제없이 진행되나, 프로젝트에 적용한 .net framework 버전 관련으로 수정해야 할 사항이 있다.

문제 1

C# 프로젝트 Properties 의 Target framework .NET Framework 3.5 로 되어있는데 이 상태로는 ToolBox 에서 AppLife Update 컴포넌트가 보이지 않는다. 아래 화면 Toolbox 에 AppLife Update 에 컴포넌트가 4개가 보여야 정상임.

문제상황 : VS2022 에서 AppLife Update 컴포넌트 비정상. 4개가 있어야 정상임.

해결

C# 프로젝트의 Target framework 을 이전 3.5 에서 .NET Framework 4.8 로 변경하면 정상화된다.

문제 2

VS2022 의 C# Form 에 배치한 updateController 의 "Setup a new project" 클릭하면 아래와 같은 오류 생긴다. AppLife Update 버전4.0 은 오래전 버전이라 VS 2022 IDE 에서 비정상 동작한다.

해결

위 화면의 저 메뉴 클릭하지 않고 다른 방식으로 설정 가능하다.

AppLife Update 를 실행하여 New Project 로 aup 프로젝트 만들고 이 과정에서 생성된 application ID, RSA key, 서버 주소를 속성창에 직접 기록하면 된다. 혹은 AppLife Update 에서 설정을 클립보드로 복사하는 버튼 클릭하고 나서 아래 메뉴 중 Set project settings from the clipboard 클릭하면 C# 측 컴포넌트 updateController1 속성에 모두 적용된다.

문제 3 .

- .net 3.5 를 4.8 로 변경하여 빌드하면 아래 같은 에러 생길 수 있는데, 이 에러는 해당 소스파일을 네트워크 드라이브 같은 곳에 복사했다든지 하는 경우 파일이 블로킹 되어 생기는 net 4.8 에서 보안강화 한답시고 이런 에러 뿜어낸다.

 error MSB3821: Couldn't process file Form1.resx due to its being in the Internet or Restricted zone or having the mark of the web on the file. 
 Remove the mark of the web if you want to process these files.

해결

위 에러에 보이는 Form1.resx 를 윈도우 탐색기에서 차단해제하면 정상 빌드된다.

파일 차단해제 방법 상세보기 : https://igotit.tistory.com/552

인터넷 다운로드 받은 파일 차단해제 방법. 특히 압축파일 차단해제.

문제 상황. 웹에서 압축파일 다운로드 받고 압축해제하여 정상적으로 압축도 풀렸으나, 파일들이 비정상 동작을 보이는 경우 있다. 웹에서 exe 의 실행파일 다운로드 받았을때도 비정상 동작하

igotit.tistory.com

연관

AppLife Update . C# 기반 앱 자동 업데이트 배포 관리 솔루션

AppLife Update - C# 기반 앱 자동 업데이트 배포 관리 솔루션 주요 특징 UAC 권한 대행: 관리자 권한이 필요한 폴더(Program Files 등)에 대한 파일 교체.비주얼 관리 : GUI 환경에서 업데이트 로직(프로세스

igotit.tistory.com

첫 등록 : 2026.04.25

최종 수정 : 2026.04.26

단축 주소 : https://igotit.tistory.com/6571

AppLife Update . C# 기반 앱 자동 업데이트 배포 관리 솔루션

i.got.it — Sat, 25 Apr 2026 16:04:02 +0900

AppLife Update

- C# 기반 앱 자동 업데이트 배포 관리 솔루션

주요 특징

UAC 권한 대행: 관리자 권한이 필요한 폴더(Program Files 등)에 대한 파일 교체.

비주얼 관리 : GUI 환경에서 업데이트 로직(프로세스 종료, 레지스트리 수정 등) 지정.

델타 업데이트: 변경된 바이트만 추출하여 패키지 크기 최소화.

시험배포 가능 : 공개 배포전 시험배포 가능하며, 시험통과이후 공개 배포 설정 편리.

제조사 : Kinetic Jump Software

AppLife Update 적용된 VS2015 C# 프로젝트를 VS2022 로 마이그레이션 하기

별도정리 : https://igotit.tistory.com/6571

AppLife Update . VS2015 C# 프로젝트 VS2022 로 마이그레이션

AppLife Update . VS2015 에서 VS2022 로 마이그레이션 상황 VS 2015 에서 AppLife Update 적용한 C# 프로젝트를 VS2022 로 마이그레이션 하기. VS2015 로 작성된 C# 프로젝트를 VS2022 에서 읽어들이는건 문제없이 진

igotit.tistory.com

첫 등록 : 2026.04.25

최종 수정 :

단축 주소 : https://igotit.tistory.com/6570

USB . BOS 디스크립터 . Binary Device Object Store

i.got.it — Fri, 24 Apr 2026 10:25:47 +0900

USB . BOS . Binary Device Object Store

USB 장치의 확장된 기능(Capability)을 호스트에 알리기 위해 사용되는 디스크립터

기존 USB 2.0의 표준 디스크립터(Device, Configuration 등)만으로는 표현하기 어려운 최신 기능들을 정의하기 위해 USB 3.0 사양에서 처음 도입되었으며, 현재는 USB 2.1 이상의 기기에서도 널리 사용

기기 USB 버전이 2.0이면 윈도우에서 BOS 디스크립터 요청안하므로 적용안되며 USB 2.01 (버전 기록시 0x0201 ) 이상이면 BOS 유효.

주요 특징 및 역할

기능 확장 프레임워크: 장치가 지원하는 특정 기술(예: USB 2.0 Extension, SuperSpeed 등)에 대한 정보를 담는 일종의 "바구니" 역할.
LPM(Low Power Mode) 지원: STM32 예제 코드에서 가장 흔히 볼 수 있는 용도로, 장치가 저전력 상태로 전환될 수 있는 능력이 있음을 호스트에 보고.
WebUSB/Microsoft OS Descriptors: 웹 브라우저에서 직접 USB 기기에 접근하거나, 드라이버 설치 없이 윈도우에서 특정 기능을 인식하게 할 때 필요한 정보를 이 BOS 디스크립터에 포함.

BOS를 통한 Microsoft OS 2.0 Descriptor 활용

윈도우는 장치가 연결될 때 BOS 디스크립터를 확인하여 Microsoft OS Descriptor가 있는지 체크. 이를 통해 드라이버가 로드될 때 특정 레지스트리 값을 생성하도록 유도할 수 있다.

방법: BOS 디스크립터 내부에 MS_OS_20_FEATURE_REG_PROPERTY를 정의하여, 장치가 설치될 때 레지스트리에 특정 값을 쓰도록 명시. 예 : USB 기기의 레지스트리 항목중 EnhancedPowerManagementEnabled 를 0으로 설정.
한계: 이미 HID 표준 드라이버로 잡혀있는 경우, 윈도우는 표준 HID 가이드라인에 따라 전력 관리 옵션을 강제로 켜버리는 경우 많음.

코드 구조 예시

- BOS 내부에 Microsoft OS 2.0 Platform Capability Descriptor를 추가

- 레지스트리 프로퍼티 정의: 이 디스크립터 안에 DeviceParameters에 EnhancedPowerManagementEnabled 값을 0으로 하면 USB 인식시 적용된다.

// BOS 디스크립터 내부에 MS OS 2.0 기능을 선언
0x1C, 0x10, 0x05, // Descriptor Set Information
0x00, 0x00, 0x03, 0x06, // Windows version (Blue)
// ... 중략 ...
// Registry Property Descriptor
0x00, 0x04, // MS_OS_20_FEATURE_REG_PROPERTY
0x00, 0x07, // Property DataType (REG_DWORD)
0x00, 0x2A, // Name length
'E','n','h','a','n','c','e','d','P','o','w','e','r','M','a','n','a','g','e','m','e','n','t','E','n','a','b','l','e','d',
0x00, 0x04, // Data length (4 bytes)
0x00, 0x00, 0x00, 0x00 // Value (0 = Disable)

비고. 윈도우 운영체제 업데이트시 레지스트리 값을 초기화 시켜버리는 경우가 허다하나, USB 를 다시 연결하면 기기가 의도한대로 레지스트리값이 다시 설정되어 윈도우 운영체제의 불안정성에 대응 가능한 지속가능한 서비스 가능하다. 즉 장치 자체가 설정기 역할을 한다.

BOS 디스크립터 예



#define USB_SIZ_BOS_DESC            0x0C
__ALIGN_BEGIN uint8_t USBD_FS_BOSDesc[USB_SIZ_BOS_DESC] __ALIGN_END =
{
  0x05,                   // bLength. BOS Header 사이즈. 
  USB_DESC_TYPE_BOS,      // bDescriptorType = 0x0F
  0x0C,0x00,              // 이 배열의 전체 사이즈. 
  0x01,                   // bNumDeviceCaps = 1

  // Link Power Management . 
  0x07,
  0x10,
  0x02,      // USB 2.0 Extension
  0x00,0x00,0x00,0x00 // 첫바이트 값 설정 0x02(비트1 set) :  Link Power Management 지원한다는 의미. 
  
 };

위와 같이 설정된 USB 연결하여 Usb Tree Viewer 로 보면 아래처럼 보이며 정상 작동했음을 알 수 있다.

첫 등록 : 2026.04.24

최종 수정 :

단축 주소 : https://igotit.tistory.com/6569

윈도우 .배치파일 .bat . 윈도우 cmd 에서 실행되는 스크립트 파일

i.got.it — Thu, 23 Apr 2026 14:56:51 +0900

.bat 배치파일

- 윈도우 명령 프롬프트(cmd.exe) 에서 실행되는 스크립트 파일

.bat 작성방법

- 문서편집기 아무거나 열고 저장시 확장자를 bat 으로 한다.

구문	설명
@echo off	배치파일의 첫줄에 기록. 실행되는 코드라인들이 화면에 보이지 않게한다. 다보이면 지저분해져서 산만하고 실행결과만 볼 수 있다.
echo	화면에 메시지 표시. echo 실행1
pause	명령 실행후 cmd 창이 닫히지 않게하는것. "계속하려면 아무 키나 누르십시오..." 라는 문구보임 이 문구 안보이게 하려면 pause >nul
rem	주석 . :: 로 해도 됨. rem 이건 주석입니다. :: 이건 주석 입니다.
:	라벨지정 을 : 로 하고 :start 처럼 기록하고 goto start
set	변수 정의 , set count=0
set /a	산술연산 . set /a count=%count%+1
color	글자 색상 지정. color 0A : 배경 검정 글자 연한녹색. color 4F : 배경 빨강 글자 흰색. 아래 색상코드 상세.

color [배경][글자] 형식으로 사용하며, 각 색상은 16진수(0~F)로 지정

0	검정색	8	회색
1	파랑색	9	연한 파랑
2	초록색	A	연한 초록 (성공 추천)
3	청록색	B	연한 청록
4	빨강색	C	연한 빨강 (에러 추천)
5	자주색	D	연한 자주
6	노랑색	E	연한 노랑
7	흰색	F	밝은 흰색

bat 작성 예.

@echo off
rem 이것은 주석입니다. 화면에 안보임
echo Hello, Windows!
echo dir 커맨드로 현재 폴더의 파일 목록 보이기.
dir
pause

한글표현이 커맨드 창에서 정상으로 보이게 하기

위 작성예 bat 파일 더블클릭하여 실행해보면 아래처럼 한글이 깨져보인다.

해결책1. 파일 포맷은 UTF-8 인 경우 bat 파일 내에 아래처럼 chcp 65001 >nul 추가한다.

해결책 2. 한글윈도우의 cmd 창은 기본 MS949(ANSI) 방식을 사용한다. UTF-8 과 궁합 안좋기에 아예 파일 인코딩 형식을 변경 저장한다. VSCode 에서는 EUC-KR 로 저장하면됨. 본 해결책이 cmd 명령어 정상 실행에 도움되므로 이 방식 적용한다.

이제 한글 정상적으로 보인다.

반복 가능하게 하기.

bat 실행시 1회만 실행되고 종료되지 않고 계속 반복 실행 가능하게 하는 방법.

실행결과

- 반복회수 표시된다.

첫 등록 : 2026.04.23

최종 수정 :

단축 주소 : https://igotit.tistory.com/6567

STM32 Programmer CLI

i.got.it — Wed, 22 Apr 2026 21:07:48 +0900

STM32 Programmer CLI

- STM32CubeProgrammer 설치하면 CLI 실행파일 STM32_Programmer_CLI.exe 도 같이 설치 된다.

STM32 플래시 메모리 특정 주소에 1바이트 기록 명령


STM32_Programmer_CLI.exe -c port=usb1 -w8 0x0807E000 0x01

-c port=usb1: USB DFU 모드로 연결된 기기 선택
-w8: 8비트(1바이트) 데이터를 쓰겠다는 설정
0x0807E000: 대상 메모리 주소
0x01: 기록할 값 (1~254 사이의 16진수 또는 10진수)

-C : connect 의미

구문 옵션

항목	설명
port	port=SWD - ST-Link 이용하여 SWD 기록하는 경우 port=usb1 - STM32 부트로더 모드에서 노출된 USB 경로로 기록하는 경우.
mode	mode=UR - Under Rest 모드 . 기기가 동작중이거나 락걸려있어도 강제로 연결시도.
reset	reset=HWrst -기록완료 후 하드웨어 리셋하여 칩 재시작시킨다.
sn	sn=시리얼 - 여러 ST-Link 가 연결되어있는 경우 사용할 ST-Link 의 시리얼 지정.
freq	freq=4000 - SWD 통신속도 4MHz 지정.

bat 파일로 원클릭 처리하기.

- 아래 내용을 bat 파일로 만들어 더블클릭하면 기록 성공시 cmd 창은 닫히고 기록 실패시 cmd 창 안닫힘.

@echo off

:: CMD 창 인코딩을 UTF-8로 변경.한글출력정상화. 
chcp 65001 >nul   

:: 1. 배치 파일이 있는 폴더로 작업 위치 강제 이동
pushd "%~dp0"

 :: 2. 지금부터 만드는 변수는 이 파일 안에서만 쓰고 버림   
setlocal       

:: bat 파일있는곳기준 cli.exe 위치 지정.
set PROGRAMMER=".\FlashTool_STM32\STM32_Programmer_CLI.exe" 
:: 값 기록할 STM32 플래시 메모리 주소.
set ADDRESS=0x0807E000  
:: 기록할 값 
set VALUE=0x01 


echo [PROCESS] 하드웨어 리비전(%VALUE%) 기록 중...

:: CLI 실행 (SWD 연결, 리셋 후 강제 연결, 1바이트 쓰기, -v 검증)
%PROGRAMMER% -c port=SWD mode=UR freq=4000 reset=HWrst -w8 %ADDRESS% %VALUE% -v

:: 3. 결과 판별 (%ERRORLEVEL%이 0이면 성공)
if %ERRORLEVEL% EQU 0 (
    echo [SUCCESS] 기록 완료. 창을 닫습니다.
    :: 성공 시엔 사용자 개입 없이 즉시 종료
    exit /b 0
) else (
    echo.
    echo ##########################################
    echo [ERROR] 기록 실패! 아래 내용을 확인하세요.
    echo 1. ST-Link 연결 상태
    echo 2. 타겟 보드 전원
    echo ##########################################
    :: 실패 시엔 원인을 읽어야 하므로 멈춤
    pause
    exit /b 1
)

STM32 플래시 메모리 특정 주소 읽기 명령

:: 0x0807E000 주소부터 1바이트를 읽어서 화면에 출력
STM32_Programmer_CLI.exe -c port=SWD mode=UR -read 0x0807E000 1

연관

STM32CubeProgrammer.개요.설치. STM32 programming tools. all in one

STM32CubeProgrammer 개요 - STM32 메모리(Flash, RAM, OTP, external memory) 읽기 쓰기 - 연결수단 - - ST-LINK/V2 ( JTAG, SWD ) - - bootloader (UART, USB DFU, I2C, SPI , CAN )- STM32WB 시리즈 칩 의 OTA programming - STM32 모든 칩에서 사

igotit.tistory.com

첫 등록 : 2026.04.22

최종 수정 :

단축 주소 : https://igotit.tistory.com/6566

Qt . install build . 지정 폴더에 exe 에 필요한 dll 복사 자동화

i.got.it — Mon, 20 Apr 2026 22:48:59 +0900

Qt 로 빌드한 exe 실행에 필요한 dll (Qt 관련 dll 및 기타 dll )들을 1개의 폴더에 몰기 자동화

CMakeLists.txt


# 1. install 폴더 경로를 프로젝트 폴더 하위로 강제 지정
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT)
    set(CMAKE_INSTALL_PREFIX "${CMAKE_SOURCE_DIR}/install" CACHE PATH "Installation Prefix" FORCE)
endif()

Qt 에서 자동생성된 CMakeLists.txt 에서의 install 관련 설정 그대로 적용하면 내 exe 가 사용하지도 않는 오만 잡다한 dll 들을 전부 복사해오고 exe 파일도 bin 폴더 하위에 배치시킨다. 지저분할뿐만 아니라 이후 install 폴더 내부만 배포하면 완전한 실행이 가능한 exe 가 보이게 하는게 더 좋다.

내가 지정한 것만 install 폴더에 복사하는 방식이 훨씬 좋다. CMakeLists.txt 에 자동생성된 install 관련 내용은 삭제하고 아래처럼 기록한다.



########## install 처리 명시적으로 필요한것만 복사하기. 

# 1. Qt 바이너리 경로 정의 (내 환경에 맞춰 한 번만 설정)
set(QT_BIN_DIR "H:/Portable_Qt/6.10.1/msvc2022_64/bin") # Qt 설치경로 

# 2. 필수 Qt DLL들만 명시적으로 설치 목록에 추가
set(QT_REQUIRED_DLLS
    "${QT_BIN_DIR}/Qt6Core.dll"
    "${QT_BIN_DIR}/Qt6Gui.dll"
    "${QT_BIN_DIR}/Qt6Widgets.dll"
)

install(FILES ${QT_REQUIRED_DLLS} DESTINATION .)

# 3. [중요] 플랫폼 플러그인 (이게 없으면 실행 안 됨)
# platforms 폴더 구조를 유지하며 qwindows.dll만 가져옴
install(FILES "${QT_BIN_DIR}/../plugins/platforms/qwindows.dll" 
        DESTINATION platforms)

# 4.기타 dll (내가만든것, 외부dll 등) 
install(FILES "${CY_SDK_ROOT}/bin/LXFinAPI.dll" DESTINATION .)

# 5. 실행 파일 복사 (루트에 바로 생성)
install(TARGETS CyAnyQ RUNTIME DESTINATION .)

# Clean 명령 실행 시 'install' 폴더도 삭제 목록에 추가
set_directory_properties(PROPERTIES ADDITIONAL_CLEAN_FILES "${CMAKE_INSTALL_PREFIX}")

Qt Creator 에서 build install 설정하기

Qc Creator 왼쪽메뉴 Projects 클릭하여 보이는 Build Steps 의 오른쪽 끝 Details 클릭하여 보면 기본설정은 all 로 되어있는데 이것을 install 로 선택한다. 이것 선택하면 컴파일 후 install 처리까지 하면서 내가 지정한 폴더에 exe 및 dll 들 모두 몰아준다.

클린이후 빌드하면 install 폴더 자동생성되고 아래처럼 exe 실행에 필수인 dll 들만 복사된다.

연관

Qt . 개요 . 포터블 개발환경 구축 .

Qt 개요 Qt는 C++ 기반의 크로스플랫폼 애플리케이션 개발 프레임워크GUI 뿐만 아니라, 네트워킹, 스레딩, 데이터베이스, XML/JSON 처리, OpenGL, 3D, 멀티미디어 등 애플리케이션 개발에 필요한 거의 모

igotit.tistory.com

첫 등록 : 2026.04.20

최종 수정 :

단축 주소 : https://igotit.tistory.com/6565

Qt . VSCode 에서 개발하기

i.got.it — Mon, 20 Apr 2026 19:01:14 +0900

VSCode Qt 확장 설치

- 확장 검색에서 여러 개 보이나 Qt C++ EXtension Pack 설치하면 됨.

Qt Widgets / Qt Quick 둘 다 가능
CMake 기반 빌드
Qt Designer 연동
디버깅 지원
필요한 것들(CMake Tools 등) 자동 설치됨

C/C++ Extension Pack 도 설치한다.

컴파일러 연결 - VC++2022 의 MSVC 로 함.

Qt 확장시 같이 설치된 CMake Tools 에 컴파일러 연결 시킨다.

settings.json 에 아래 추가한다. CMake Qt 를 찾게하는 설정 도 해준다. Qt 설치된 경로에서 msvc 폴더 연결.


    },    


    "cmake.generator": "Visual Studio 17 2022", // MSVC 2022 툴체인 이용한다는것. 내부적으로 cl.exe, link.exe 자동 연결처리됨. 
    "cmake.platform": "x64", // 64비트 타겟. 

	//CMake 가 Qt 를 찾게 하는 설정. 
    "cmake.configureSettings": {
        "CMAKE_PREFIX_PATH": "H:/Portable_Qt/6.10.1/msvc2022_64"
    },
}

VSCode 에서 Qt 작업성 평가

Qt Creator 에서 작업하는것 대비 더 좋은 점은 없음. 산만한 설정처리 작업만 증가됨. 생산성 향상에 도움 될 요소 체감 못함.

연관

Qt . 개요 . 포터블 개발환경 구축 .

igotit.tistory.com

첫 등록 : 2026.04.20

최종 수정 :

단축 주소 : https://igotit.tistory.com/6564

git . 네트워크 드라이브(NAS)에 깃 저장소

i.got.it — Sun, 19 Apr 2026 21:53:54 +0900

NAS 깃 저장소 .gitconfig

git . 네트워크 드라이브 에 깃저장소 있는 경우 아래 같은 명령어 안먹힌다.

Git이 소유권 불일치로 접근 거부함.


git config --local user.name "igotit"

파일 .gitconfig 에 아래 처럼 네트워크 드라이브를 안전한 곳임을 명시해줘야 위와 같은 명령어 정상작동함.



[safe]
	directory = %(prefix)///192.168.11.5/y/*

첫 등록 : 2026.04.19

최종 수정 :

단축 주소 : https://igotit.tistory.com/6561

GitHub . 페이지 . 커스텀 도메인 설정

i.got.it — Sun, 19 Apr 2026 13:59:44 +0900

GitHub . 페이지 . 커스텀 도메인 설정

깃허브 에서 1. 저장소 > 2.Settings > 3. Pages 클릭하여 아래 부분에 4. Custom Domain 설정부 있음

여기에 a.mydomain.com 으로 설정 하면 https://a.mydomain.com 주소로 깃허브 페이지에 접속가능.

동시에 mydomain.com 의 DNS 설정의 "별칭(CNAME) 관리" 에서 a.mydomain.com 을 깃허브 페이지의 도메인 명으로 설정해야 함. DNS 설정이후 5분~1시간은 지나야 적용됨.

첫 등록 : 2026.04.19

최종 수정 :

단축 주소 : https://igotit.tistory.com/6560

nRF54L20B . Axon NPU 지원 . Neuton . Edge AI

i.got.it — Mon, 13 Apr 2026 19:58:53 +0900

nRF54L20B

- 노르딕사에서 Axon NPU 탑재한 첫 SoC

- 출시일 : 2026.3.20

- nRF54L20A 에 Axon NPU 추가된 것이 B 의 유일한 차이점.

- 플래시 2Mbyte, 램 512kbyte.

- 개발킷

nRF54LM20 DK (PCA10184)

nRF54LM20 DK (PCA10184) - 장착 칩 : nRF54LM20B nRF54LM20B SoC in CSP98 packageSupport for the following wireless protocols:Bluetooth® Low Energy802.15.4Thread®Zigbee®2.4 GHz proprietaryNFC2.4 GHz and NFC antennasMicrowave coaxial connector with switc

igotit.tistory.com

Axon NPU

- 행렬연산 전문으로 하는 전용 하드웨어 블럭이며 여기서 실행가능한 모델 솔루션은 여러 종 가능. 현재의 노르딕은 Neuton 선호하고 있음.

Neuton

- 미국 캘리포니아에 본사를 둔 AI 플랫폼기업. 핵심 "신경망 구조자체를 스스로 설계하는 알고리듬"

Unique Neural Network Structure: 고정된 층(Layer) 구조가 아닌, 데이터에 최적화된 비선형 구조.
One-Click Learning: 데이터 전처리부터 모델 생성까지 웹 GUI에서 클릭 몇 번으로 완료.
Inference Library: 생성된 결과물은 라이브러리 의존성 없는 순수 C 코드.

TensorFlow Lite for Microcontrollers (TFLM)

지원: 구글의 TensorFlow Lite 모델(int8 양자화된 .tflite 파일)
동작: 노르딕이 제공하는 'Axon Optimizer'라는 도구가 이 TFLM 모델을 분석하여, NPU가 이해할 수 있는 전용 가속 명령어로 변환(Compile)

Edge Impulse

임베디드 AI 분야에서 가장 유명한 플랫폼.

지원: Edge Impulse에서 학습시킨 모델을 Axon NPU 전용 라이브러리 형태로 출력 가능.
특징: 다양한 신호처리 알고리즘을 NPU에 최적화하여 구현해 줍니다.

CMSIS-NN 및 직접적인 벡터 연산

Arm에서 제공하는 신경망 라이브러리인 CMSIS-NN도 활용 가능.

지원: Cortex-M33 CPU의 FPU/DSP 명령어와 Axon NPU를 혼합하여 연산 가능.
장점: 특정 브랜드의 플랫폼에 종속되지 않고, 직접 C 코드로 짠 행렬 연산 로직을 가속화 가능.

기타 파트너사 (SensiML 등)

SensiML 같은 산업용 상태 모니터링 AI 전문 업체들도 nRF54 시리즈를 지원.

연관

VSCode 에서 nRF5 개발 기초. Zephyr OS 기반

VSCode 에서 nRF5 개발 VSCode 에서 nRF5 (예 : nRF52840, nRF54L15) 칩에서 작동하는 코드를 VSCode 에서 작성하고 칩에 기록하여 실행하고 VSCode 의 터미널에 출력 까지 하는 전체 작업 플로우 핵심 정리. -본

igotit.tistory.com

첫 등록 : 2026.04.13

최종 수정 :

단축 주소 : https://igotit.tistory.com/6555

nRF54LM20 DK (PCA10184)

i.got.it — Mon, 13 Apr 2026 19:40:41 +0900

nRF54LM20 DK (PCA10184)

- 장착 칩 : nRF54LM20B

nRF54LM20B SoC in CSP98 package
Support for the following wireless protocols:
- Bluetooth® Low Energy
- 802.15.4
- Thread®
- Zigbee®
- 2.4 GHz proprietary
- NFC
2.4 GHz and NFC antennas
Microwave coaxial connector with switch (SWF) RF connector for direct RF measurements
Four user-programmable LEDs
Four user-programmable buttons
SEGGER J-Link OB programmer/debugger
Two Universal Asynchronous Receiver/Transmitter (UART) interfaces through virtual serial ports
USB connection for powering and interfacing with the nRF54LM20B SoC
USB connection to debugger for debugging, programming, and power
Pins for measuring power consumption of the nRF54LM20B SoC
nPM1300 Power Management Integrated Circuit (PMIC) providing a 1.8 V to 3.3 V user-programmable power supply from USB

상세정보

Technical Documentation

docs.nordicsemi.com

연관

VSCode 에서 nRF5 개발 기초. Zephyr OS 기반

igotit.tistory.com

첫 등록 : 2026.04.13

최종 수정 :

단축 주소 : https://igotit.tistory.com/6556

NCS VSCode . 커스텀 보드 추가하기

i.got.it — Sat, 11 Apr 2026 10:46:35 +0900

VSCode . NCS (nRF Connect SDK) 에서 커스텀 보드 추가하기

왼쪽메뉴 Create a new board 클릭하여, 보드이름, Vendor Name, 보드에 장착된 Soc 선택하고 보드 관련 파일들 생성할 Board Root (프로젝트 폴더 하위 아니어도 됨) 지정한다.

위 상태에서 Create Board 클릭하면 루트 폴더 하위에 -> boards / Vendor name / Board name 폴더 만들어지고 아래처럼 관련 파일들이 자동 생성된다.

확장자 .dts 파일 열어보면, 해당칩의 플래시 메모리 기본적인 정보만 있는 상태다. 여기에 필요한 것들을 추가하게 된다.

추가 예

- dts 파일하단에 usb 관련 설정을 추가한것.

NCS 에 보드 루트 추가하기

위 경로를 NCS 가 알지 못하는 상태이므로 이 루트를 추가해야 한다.

VSCode 에서 ctrl , 클릭하여 board roots 검색하여 내가 새롭게 생성한 보드 루트를 추가한다.

기존 프로젝트에 신규 보드 적용하기

기존 프로젝트에 신규보드 적용하려면 Build Configuration 을 새로 추가해야한다.

빌드 설정창에서 내가 추가한 신규 보드 선택한다.

연관

VSCode 에서 nRF5 개발 기초. Zephyr OS 기반

igotit.tistory.com

첫 등록 : 2026.04.11

최종 수정 :

단축 주소 : https://igotit.tistory.com/6551

Zephyr . Workque (워크큐) .

i.got.it — Tue, 7 Apr 2026 11:10:08 +0900

Zephyr . Workque

Zephyr OS 커널이 제공하는 간단하게 사용가능한 스레드 작업단위.

커널의 스레드 에서 Workque 쌓인 항목들을 하나씩 꺼내서 실행. 인터럽트처리루틴(ISR) 에서도 안전하게 호출가능.


// k_work 핸들러 함수 정의
static void kw_start_adv_con_handler(struct k_work *work)
{
    // 워크큐로 실행할 것. 
}

// 매크로를 이용한 정적 선언 및 초기화 (변수명, 핸들러명)
K_WORK_DEFINE(kw_start_adv_con, kw_start_adv_con_handler);


///////// 매크로 이용하지 않는 경우 
static struct k_work kw_start_adv_con; 
static void kw_start_adv_con_handler(struct k_work *work)
{
}
k_work_init(&kw_start_adv_con, kw_start_adv_con_handler); // init() 등에서 초기화 해줘야함. 


////////// 워크큐 실행. 
k_work_submit(&kw_start_adv_con); // 시스템 기본 워크큐에 넣기. (가장 일반적)

연관

Zephyr (제퍼) . RTOS . 경량

igotit.tistory.com

첫 등록 : 2026.04.07

최종 수정 :

단축 주소 : https://igotit.tistory.com/6550

BLE . 페어링 . 본딩 . RPA . IRK

i.got.it — Mon, 6 Apr 2026 13:08:07 +0900

BLE 암호화 연결 관련

RPA (Resolvable Private Address)

- BLE 고정 주소인 BD Address 를 노출시키지 않고, RP Address 를 IRK 로 생성하여 런타임 중에도 계속 변경된다.

- RPA = hash(IRK, prand) + prand .

- prand : 24비트 랜덤 숫자. 이 숫자가 생성시마다 매번 변경되므로 RP 주소가 변경됨.

- 보통 기본설정 15분 단위로 변경되며 설정 변경가능.

IRK (Identity Resolving Key)

- RPA 생성시 사용되는 128비트 키, 블루투스 스택이 생성하는 암호.

- 칩내부의 TRNG (True Randon Number Generator, 난수 생성기) 로 128비트 랜덤값 생성하고 칩의 플래시메모리에 저장됨.

- 한 번 생성하면 이후 변경하지 않고 유지함.

Bonding

- 연결기기간의 IRK 를 저장하여 이후 자동 연결됨.

Pairing

- 연결 시기간의 IRK 를 교환하기위한 임시 키 방식의 교환 절차.

- 임시 비번 등을 키보드로 타이핑하든지 , NFC 근접 , 기기에 있는 버튼 클릭(Just Work)등 다양한 방식으로 구현됨.

Pairing	프로세스	일회성 암호 통신 채널 구축	통신용 임시 비밀번호 설정
Bonding	상태/저장	생성된 키를 Flash에 저장	주소록에 상대방 등록
IRK	128-bit 키	RPA(가짜 주소) 를 생성/해독하는 열쇠	진짜 신분증 (변하지 않음)
RPA	48-bit 주소	외부 노출 주소	가짜 주소 (15분마다 바뀜)

Bonding 완료이후 동작.

1 .기기에서 수신한 RPA 에서 prand 와 저장해두고 있던 IRK 로 ah(IRK, prand) 계산 수행.

2. 상기 계산결과 RPA 의 hash 와 일치하면 본딩된 기기, 즉 기기도 동일한 IRK 를 갖고 있다. 일치하지 않는다면 다른 IRK 가진 기기 이므로 본딩 된 기기가 아닌 것으로 판정.

Bonding 제거

- 양쪽 기기 모두 본딩 제거 가능해야 한다.

예.

Central(스마트폰): 블루투스 설정 메뉴에서 "이 기기 지우기(Forget Device)" 클릭.
Peripheral(기기): 특정 버튼을 길게 누르는 등의 동작을 통해 Flash(NVS)에 저장된 본딩 데이터를 삭제하는 코드를 실행.

화이트리스트

- 본딩 과정으로 서로 IRK 를 교환하지 않은 기기간에 통신은 불가하지만, 연결시도 자체를 방지하지는 못한다.

- 연결시도를 허용된 기기하고만 가능하게 할려는 경우 화이트리스트에 등록한다.

동작:
- Peripheral: 리스트에 없는 기기가 연결을 시도하면 스택/하드웨어 차원에서 즉시 거절. (응답 자체를 안 함)
- Central: 리스트에 없는 기기의 광고 패킷은 아예 무시.

코드예.

- central, peripheral 모두 동일 함수.

nRF Connect SDK 

CENTRAL 측 
bt_le_filter_accept_list_add(&remote_addr); // BD Address 추가
// 스캔 시 BT_LE_SCAN_OPT_FILTER_ACCEPT_LIST 옵션 사용

PERIPHERAL 측 
bt_le_filter_accept_list_add(&central_addr); // BD Address 추가
// 광고 시 BT_LE_ADV_OPT_FILTER_CONN 등의 옵션 사용

/////////////////////////////

// filter accept list 에서 1개 제거. 
int bt_le_filter_accept_list_remove(const bt_addr_le_t *addr);

// filter accept list 모두 제거. 
int bt_le_filter_accept_list_clear(void);


///// peripheral 측 bt_le_adv_param 멤버 oprions 설정. 
   BT_LE_ADV_OPT_FILTER_CONN | // FAL 에 있는 기기만 연결허용. 
   BT_LE_ADV_OPT_FILTER_SCAN_REQ; // FAL 에 있는 기기만 request scan response 허용.

첫 등록 : 2026.04.06

최종 수정 : 2026.04.12

단축 주소 : https://igotit.tistory.com/6549

Git . 깃 포터블 구축 . VSCode 셋팅

i.got.it — Fri, 27 Mar 2026 15:29:18 +0900

Git . 깃 포터블 구축 .

깃 다운로드 주소 : https://git-scm.com/install/windows

Git for Windows/x64 Portable 클릭하여 다운로드 받은 파일 실행하여 압축해제가 전부임. 압축해체할 경로 지정하고 OK.

압축해제 파일들.

VSCode 셋팅

VSCode (이것 역시 포터블 설치한것) 에서 사용할 git.exe 를 포터블 설치한 것으로 설정.

아래 옵션 중 git.qutoReposi.. : true 로 하는게 더 유용하다.

VSCode 가 포터블 깃을 사용하게 하는 확실한 설정모두



{
    // 핵심: VSCode Git 확장이 사용할 git.exe 명시
    "git.path": "h:\\Portable_Git\\bin\\git.exe",
    "git.enabled": true,
    "git.autoRepositoryDetection": true,
    "git.terminalAuthentication": false, // SSH 멀티계정에선 false 추천
    "github.gitAuthentication": false,   // SSH 멀티계정에선 false 추천
    

    // 터미널 환경변수 - PATH에 포터블 Git 최우선 등록
    "terminal.integrated.env.windows": {
        "HOME": "h:\\Portable_Home", // 환경변수 HOME 을 로컬 PC 것 사용하지 말고 Portable_Home 으로 지정. 
        "PATH": "h:\\Portable_Git\\bin;h:\\Portable_Git\\usr\\bin;${env:PATH}",
        "GIT_CONFIG_NOSYSTEM": "1",
        "GIT_EXEC_PATH": "h:\\Portable_Git\\mingw64\\libexec\\git-core"
    }
}

또한, Portable_Home 에 .gitconfig 파일 만들고 아래처럼 설정한다.

연관

nRF Connect for VS Code .개요 . 포터블 설치

nRF Connect for VS Code 개요 통합 개발 환경: Nordic Semiconductor의 nRF52, nRF53, nRF54 및 nRF91 시리즈를 위한 차세대 VS Code 기반 IDE 확장팩.강력한 확장성: 범용적인 VS Code 환경을 그대로 사용하면서, Nordic 전

igotit.tistory.com

첫 등록 : 2026.03.27

최종 수정 :

단축 주소 : https://igotit.tistory.com/6535

cpp 파일의 전역함수, 전역변수 . extern "C" 처리

i.got.it — Sun, 8 Mar 2026 10:25:08 +0900

cpp 파일의 전역함수 . extern "C" 처리

파일 확장자 .cpp 에서 클래스 멤버 외 전역함수 정의하면 C++ 방식 (Name Mangling) 으로 컴파일된다. cpp 내에서만 이함수 사용하는 경우에는 문제없지만 .c 파일에서 이 함수를 호출하려고 하는 경우 대응위하여 항상 extern "C" 로 가드처리한다.

// some_file.cpp

void my_c_style_func() //다른 C 파일에서는 호출 불가능함. 
{
    
}

myclass::member_func{
 my_c_style_func(); // 클래스 멤버함수 내에서 동일파일내의 전역함수 호출은 가능    
}

//////////////// extern "C" 로 가드처리하면 

// C 파일에서도 호출 가능해짐
extern "C" void my_c_style_func() {
    
}


myclass::member_func{
 my_c_style_func(); // 클래스 멤버함수 내에서 동일파일내의 전역함수 호출은 항상 가능    
}


/////// 결론. 

cpp 내의 전역함수는 항상 extern "C" 가드해두면 항상 안전.

cpp 파일의 전역변수 도 동일하게 . extern "C" 처리

////// CPP 파일에서 전역변수. extern "C"
// 변수선언된 동일 cpp 파일에서만 이 변수에 접근하면 필요없지만 
// C파일에서 에서도 이변수 접근하려면 필수. 
// extern "C" 부착하면, cpp, c 파일 어디에서 호출하든 문제없음.  

extern "C" my_st_t g_sensor_data;

첫 등록 : 2026.03.08

최종 수정 :

단축 주소 : https://igotit.tistory.com/6497

C/C++ . 구조체 typedef struct , struct 차이점

i.got.it — Sun, 8 Mar 2026 09:49:23 +0900

C++

C++ 에서는 구조체 이름 자체가 독립적인 타입. 내부나 외부 어디서든 struct 없이 my_st만 써도 된다.

struct my_st
{
	int i;
};

void func(my_st * p_myst); // 가능.

//// 구조체 멤버가 자기자신 참조 하는 경우 
struct my_st
{
	int i;
    my_st* p_my_st; // 가능. 
};

C

C 에서는 구조체 이름앞에 struct 명시필수. strruct 부착 안할려면 typedef struct .. 형식으로 선언한다.

struct my_st
{
	int i;
};

void func(struct my_st * p_myst); // 항상 struct 임을 명시해야함.


////////////////// typedef struct 

typedef struct _my_st //구조체 태그 
{
	int i;
} my_st; // 구조체 앨리어스 

void func(my_st * p_myst); // struct 명시없이 가능. 

////// typedef struct 정의하면서 구조체 태그 필요한 경우 . 멤버가 자기참조하는경우

typedef struct _my_st //구조체 태그 
{
	int i;
    struct _my_st * p_my_st; // 
} my_st; // 구조체 앨리어스


///////// 구조체 태그없이 정의해도됨.

typedef struct  
{
	int i;
} my_st;

C 스타일 구조체 정의 방식은 C++ 에서도 모두 지원되므로 C, C++ 혼재된 프로젝트라면 C 스타일로 구조체 정의하는게 유리함.

첫 등록 : 2026.03.08

최종 수정 :

단축 주소 : https://igotit.tistory.com/6496

STM32 . VSCode 포터블 개발 환경 구축

i.got.it — Sat, 7 Mar 2026 23:58:51 +0900

STM32 . VSCode 포터블 개발 환경 구축

외장 SSD 에 설치된 포터블 VSCode 기반 STM32 개발환경 구축하려면 아래 순서로 한다.

1. STM32 도구세트(CLT) 외장 SSD 에 먼저 설치

2. VSCode 에서 STM32 Extension 설치.

1. STM32CubeCLT (STM32 명령줄 도구) 세트 설치.

STM32CubeProgrammer (플래시 및 디버그용), GNU Tools for STM32 (GCC , CMake) , ST-LINK GDB Server (디버깅) 다 포함되어있음.

방법.

STM32CubeCLT를 다운로드해서 외장 SSD 폴더 F:\Portable_STM32_Tools\STM32CubeCLT..에 설치.

다운로드 주소 : https://www.st.com/en/development-tools/stm32cubeclt.html

다운받은 압축파일 풀어 exe 클릭 설치진행.

설치 첫화면.

설치 경로 지정 : 외장 F:\Portable_STM32_Tools\ 로 변경했다.

이후 next 만 클릭하면 설치완료. 설치된 폴더 보면 아래처럼 생겼다.

2. VSCode 실행하여 STM32 extension 설치

STM32 확장 설치 이후 왼쪽에 보이는 아이콘 클릭하여 Enter Path to build tools 클릭 해보면 앞의 1번 단계에서 설치한 STM32CubeCLT 경로가 들어와있다.

뭔가 더 설치 할게 있다고 하니 Install build tools 클릭하여 설치하고 나면 아래처럼 STM32 관련 작업 가능한 것들이 보인다.

첫 등록 : 2026.03.07

최종 수정 :

단축 주소 : https://igotit.tistory.com/6492

nRF Connect SDK VSCode . 모듈화 . Snippets 기반

i.got.it — Wed, 4 Mar 2026 18:17:17 +0900

Zephyr Snippets 체계 기반 모듈화 구축

Snippets 폴더 만들기

내가 모듈화 할 대상 소스가 있는 폴더에 Snippets (이 이름 그대로 해야함) 폴더 만들고 파일 snippet.yml 을 추가하여 아래 처럼 작성한다.

예 : CCyBleCentral.cpp 가 구현되어있는 ble_central 폴더에 Snippets 폴더 만들고 이속에 snippet.yml 을 만들어 아래 처럼 작성한다. EXTRA_CONF_FILE: 부분에 이 모듈 실행에 필요한 설정 기록된 파일명 기록한다.

주의사항 : 주석에 한글기록하면 빌드시 오류발생.

name: ble_central
append:
  EXTRA_CONF_FILE: ble_central.conf  # module specific config set

동일 Snippets 폴더에 ble_central.conf 파일 만들어서, 본 모듈에서 필요한 설정을 기록한다.


CONFIG_BT=y
CONFIG_BT_CENTRAL=y
CONFIG_BT_GATT_CLIENT=y

메인 프로젝트의 CMakeLists.txt 에서 Snippets 추가.

아래1번에서 경로를 추가한다. 이렇게 하면 해당 폴더 하위의 Snippets 폴더를 탐색한다. 2번에서는 스니펫 활성화한것. 1,2 설정은 3번 find_packge 앞에 설정해야 정상 반영된다.

4번은 스니펫활성화 된 경우 포함시킬 소스파일 설정한것.

상기 2번 활용 스니펫 설정에 여러 개의 스니펫 설정하려면 아래처럼 추가한다.

관리방식 전체 폴더 구조예

본 구조화 예는 1개의 기능모듈 폴더 1개당 snippet.yml 1개씩, 그리고 설정 파일도 개별적으로 1개씩 할당하는 방식으로 했다.



CySDK_nRF5_ZephyrSnippets/
├── ble_central/
│   ├── snippets/
│   │   ├── snippet.yml   # name: ble_central
│   │   └── ble_central.conf
│   └── CCyBleCentral_1.cpp
└── ble_peripheral/
    ├── snippets/
    │   ├── snippet.yml   # name: ble_peripheral
    │   └── ble_peripheral.conf
    └── CCyBlePeripheral_1.cpp

연관

VSCode 에서 nRF5 개발 기초. Zephyr OS 기반

igotit.tistory.com

첫 등록 : 2026.03.04

최종 수정 :

단축 주소 : https://igotit.tistory.com/6473

nRF Connect SDK VSCode . C++ 로 코딩하기

i.got.it — Wed, 4 Mar 2026 12:59:32 +0900

nRF Connect SDK VSCode . C++ 위한 필수 설정

nRF Connect SDK VSCode 컴파일 환경은 파일 확장자 C 로 된 것은 C 컴파일 되고, 파일확장자 cpp 로 된것은 C++ 컴파일 가능하나 필수 아래와 같은 설정을 해줘야 한다.

prj.conf 파일에 C++ 지원추가

- 프로젝트 파일에 있는 prj.conf 파일에 아래 구문 추가.

# prj.conf




############### for C++

CONFIG_CPP=y  # C++ 사용위한 필수. 

# CONFIG_NEWLIB_LIBC : Zephyr 기본 libc(minimal libc)보다는 Newlib이 C++과의 호환성이 좋음. 
CONFIG_NEWLIB_LIBC=y #Newlib는 임베디드 장치용으로 경량화된 표준 C 라이브러리(printf, malloc 등).

CONFIG_EXTERNAL_LIBCPP=n # 외부별도준비한 C++ 라이브러라 사용안함. 
CONFIG_GLIBCXX_LIBCPP=y # GNU 표준 libstdc++ 을 사용한다. 

################ end for C++

prj.conf 설정 의미.

CONFIG_CPP=y:

의미: C++ 위한 필수. C++ 기본 기능
- Class / Inheritance (상속): 클래스 구조화 가능.
- Access Modifiers: public, private, protected.
- Constructors / Destructors: 객체 생성/소멸 로직.
- Templates: 템플릿 문법 자체.

CONFIG_NEWLIB_LIBC=y (보통 C++에선 y 권장):

의미: Newlib은 임베디드 장치용으로 경량화된 표준 C 라이브러리(printf, malloc 등).
C++ 표준 라이브러리는 내부적으로 C 라이브러리의 기능들을 많이 빌려 쓰는데, Zephyr 기본 libc(minimal libc)보다는 Newlib이 C++과의 호환성이 훨씬 좋기 때문에 C++을 쓸 때는 보통 이 옵션을 켠다.

CONFIG_EXTERNAL_LIBCPP=n

의미: "외부(External)에서 별도로 준비한 C++ 라이브러리를 쓰지 않겠다."
상세: 이 옵션을 y로 켜면, 사용자가 직접 컴파일한 특수한 C++ 라이브러리 파일을 빌드 시스템에 수동으로 연결해줘야 한다. 일반적인 개발 환경에서는 n으로 두는 것이 정석.

CONFIG_GLIBCXX_LIBCPP=y

의미: "GNU 방식의 C++ 라이브러리(libstdc++)를 사용한다."
상세:
- C++ 표준 라이브러리는 크게 두 종류가 있음 : libstdc++ (GNU 방식)와 libc++ (LLVM/Clang 방식). libstdc++ 을 사용하겠다는 의미. std::vector , std::string 등도 사용가능.
- nRF Connect SDK(NCS)는 내부적으로 GNU 툴체인을 주로 사용하는데, 이 옵션을 n으로 두면 시스템이 알아서 현재 컴파일러와 가장 잘 맞는(주로 Newlib과 짝을 이루는) 기본 라이브러리를 선택한다.

CMakeLists.txt 에 C++ 표준 명시.

- 어떤 C++ 표준을 사용할지 지정하는것. 안해도 작동은 하나 명시적으로 설정함이 타당.

CMakeLists.txt 설정 의미

set(CMAKE_CXX_STANDARD 17):
- "나는 C++17 문법을 사용할 거야"라고 선언하는 것.
set(CMAKE_CXX_STANDARD_REQUIRED ON):
- 의미: "내가 지정한 C++17을 컴파일러가 지원하지 못한다면, 빌드를 중단(Error)시켜라"라는 의미.
- 만약 이 옵션이 OFF라면, 컴파일러는 C++17이 안 될 때 하위 버전(예: C++11)으로 대충 빌드해버릴 수 있는데, 이를 방지하는 안전장치.
set(CMAKE_CXX_EXTENSIONS OFF):
- 의미: "GCC 컴파일러 전용 확장 문법(GNU Extensions)을 쓰지 않고, 순수 표준 C++만 쓰겠다"는 선언.
- GNU 확장(Extension)이란?: 표준 C++에는 없지만 GCC 컴파일러가 편의상 제공하는 문법들입니다. (예: 배열 크기를 변수로 지정하는 가변 길이 배열 등)
- 왜 OFF로 하는가?: 코드가 특정 컴파일러에 종속되지 않고 표준을 지키게 하여, 나중에 다른 환경으로 옮기거나 배포할 때 문제가 없도록 하기 위함.

C++ 파일에서 C 로 작성된 헤더파일 include


///// cpp 파일에서, 


// Zephyr 헤더는 내부적으로 extern "C" 처리 되어있어 C++ 에서도 그냥 inlcude 하면 됨. 
#include <zephyr/kernel.h>
#include <zephyr/bluetooth/bluetooth.h>

// 만약 extern C 가드 없는 C로 작성된 다른 헤더를 가져온다면
extern "C" {
    #include "my_old_c_header.h"
}

내가 만든 C 헤더에도 가드 넣기

앞의 코드에서 extern "C" 로 감싸는 이유는 해당 헤더파일에 가드가 없는 경우이며 내가 작성하는 C 헤더라면 아래처럼 처리하면 사용하는 곳에서는 extern "C" 감싸기 없이 그냥 include 하면 된다.

// C++ 컴파일러에게 이건 C 임을 알리는 영역 시작. 
#ifdef __cplusplus
extern "C" {
#endif


void init_cy_ble_central(void);
... 
int func(uint8_t * pui8); 


// C++ 컴파일러에게 이건 C 임을 알리 영역 끝. 
#ifdef __cplusplus
}
#endif

상기 코드 동작 원리 요약

C++ 컴파일러가 읽을 때: __cplusplus라는 매크로가 정의되어 있기에 extern "C" { 구문이 활성화되고, 컴파일러에게 "이 함수들은 이름 꼬기(Name Mangling) 하지 않는다.
C 컴파일러가 읽을 때: __cplusplus가 정의되어 있지 않기에, #ifdef 안의 extern "C" 구문들은 통째로 무시(Skip)됩니다. C 컴파일러는 평범한 C 코드로 인식하여 에러 없이 통과.

연관

nRF Connect for VS Code .개요 . 포터블 설치

igotit.tistory.com

VSCode 에서 nRF5 개발 기초. Zephyr OS 기반

igotit.tistory.com

첫 등록 : 2026.03.04

최종 수정 :

단축 주소 : https://igotit.tistory.com/6471

VSCode 에서 nRF5 개발 기초. Zephyr OS 기반

i.got.it — Wed, 25 Feb 2026 23:22:22 +0900

VSCode 에서 nRF5 개발

VSCode 에서 nRF5 (예 : nRF52840, nRF54L15) 칩에서 작동하는 코드를 VSCode 에서 작성하고 칩에 기록하여 실행하고 VSCode 의 터미널에 출력 까지 하는 전체 작업 플로우 핵심 정리.

-본 개발환경은 RTOS 인 Zephyr (발음 : 제퍼) OS 기본 적용된다.

VSCode 에서 개발환경 셋팅

- nRF Connect for VSCode 개발환경 구축되어야 한다.

별도정리 : https://igotit.tistory.com/5652

nRF Connect for VS Code . 포터블 설치

nRF Connect for VS Code . 포터블 설치 - 외장 SSD 에 VS Code 를 Portable 설치(상세보기 : https://igotit.tistory.com/4313)하고 나서 - 포터블 VS Code 실행하여 아래 영상의 2분 40초 이후 의 설치 진행하면

igotit.tistory.com

VSCode 에서 작업 폴더 열기

나의 경우는 1개의 폴더 WORK_NRF5_VSCode 하위에 프로젝트 1개 단위로 폴더 만들 것이다. 이 폴더를 먼저 VSCode 에서 열어둔다. Open Folder 클릭하여 작업 루트 폴더 열어둔다.

nRF app 생성.

VSCode 왼쪽 메뉴 nRF Connect 아이콘 클릭 -> WELCOME -> Create a new application 클릭하여 생성시작한다. 생성옵션이 보인다. 본 예에서는 가장 간단한 blank application 선택했다.

app 용 폴더 이름을 지정한다. 이 폴더하위에 소스 및 빌드 결과 파일들이 만들어짐.

EXPLORE 에서 자동 생성된 파일들이 보인다. 소스는 main.c 1개 자동 생성되어있다. 또한 prj.conf 파일도 생성되어있고 비어있는데 개발과정중 자주 접근하여 설정 하게된다. 예. CONFIG_BT=y 식으로 기록하여 블루투스 관련 기능 활성화한다는 식으로 설정한다.

nRF Connect 의 APPLICATION 에서는 아래처럼 test_first 라는 app 이 추가된게 보인다.

Add build configuration

앞의 화면에서 test_first 하위에 보이는 Add build configuration 을 클릭하여 타겟보드가 무엇이며, 사용할 SDK 버전이 무엇인지 등을 지정해야한다(아래 화면). Board target 만 내가 nRF52840dk 를 이용할 것이므로 아래처럼 선택했고, 나머지는 모두 기본 값 상태에서 최하단 버튼 클릭하면 관련 파일 자동생성되고 빌드까지 진행된다.

첫 빌드 과정은 시간이 꽤 길다. 약 2분 소요되고 완료되고 나면 아래화면처럼 build 된 파일들 보여주고, ACTION 이라는 부분도 활성화된다. build 된 파일 중 merged.hex 가 칩에 기록되어야 하는 최종 펌웨어 파일이다.

ACTION 부분의 flash 클릭하면 타겟칩에 펌웨어 기록되고 실행상태로 된다.

prinfk 로 VSCode 에서 문자열 출력 보기.

기본 만들어진 main.c 상태로는 칩에 기록해도 칩의 작동상황을 VSCode 측에서 알 수단이 없다. 코드에 아래처럼 printk 함수 추가하여 문자열 출력을 VSCode 에서 볼 수 있도록한다. 디버깅시 매우 편리한 수단.

main.c

#include <zephyr/kernel.h>
#include <zephyr/sys/printk.h> // printk 사용을 위해 포함

int main(void)
{
printk("Hello! nRF52840 Start.\n");

    while (1) {
        printk("Running... 1 second passed\n");
       
        // 1000ms (1초) 지연
        k_msleep(1000);
    }

}

VSCode 에서 nRF Serial Terminal 활성화하기.

아래 화면처럼 1번 Open Terminal 클릭하여 VSCode 하단에 터미널 창이 보이게 하고 ,

위 화면의 터미널 창 상단 오른쪽의 + 표시 클릭하여 2번 nRF Serial Terminal 클릭하면 아래처럼 COM 포트 선택창에서 nRF52840 DK 를 선택한다.

아래 TERMINAL 에서 보이는 문자열이 칩에서 printk 실행 결과를 보여준다.

RTOS 스레드 생성해보기.

main.c 에서 아래처럼 제퍼 OS 에서의 스레드 생성 코드를 추가하자.

이렇게 하면 main while 실행과 동시에 스레드도 실행된다.

#include <zephyr/kernel.h>
#include <zephyr/sys/printk.h> // printk 사용을 위해 포함



/* 1. 스레드 설정 (스택 크기 및 우선순위) */
#define MY_STACK_SIZE 1024
#define MY_PRIORITY 7

/* 2. 스레드가 실행할 함수 정의 */
void my_thread_logic(void *dummy1, void *dummy2, void *dummy3)
{
    while (1) {
        printk("  [Thread] Hello Thread!\n");
        k_msleep(500); // 0.5초 대기
    }
}

/* 3. 스레드 정적 생성 */
K_THREAD_DEFINE(my_tid, MY_STACK_SIZE,
                my_thread_logic, NULL, NULL, NULL,
                MY_PRIORITY, 0, 0);


int main(void)
{
printk("Hello! nRF52840 Start.\n");

    while (1) {
        printk("Running... 1 second passed\n");
        
        // 1000ms (1초) 지연
        k_msleep(1000); 
    }

}

위 코드를 빌드하고 칩에 flash(에 펌웨어 기록) 하면 터미널에서 아래처럼 스레드 실행과 main while 문 내의 실행 상황을 확인가능하다.

printk 대신 LOG_INF 함수 사용하기.

앞의 코드에서 문자열 출력하는 함수 printk() 를 사용하여 개발했다가 나중에 이것 비활성 하는것 매우 번거로운 처리다. 제퍼 OS 에 제공되는 LOG_함수 이용하면 enable, disable 하기 편하기 때문에 개발 과정중 문자열 출력은 필수 이 함수를 이용하는게 좋다.

main.c 에 아래처럼 LOG_INF 함수로 문자열 출력하게 수정하고,

#include <zephyr/kernel.h>
#include <zephyr/logging/log.h>  // Zephyr의 로깅 시스템 헤더 포함

LOG_MODULE_REGISTER(test_first, LOG_LEVEL_INF); // 모듈 이름과 기본 레벨 설정
//LOG_ 함수예.
//LOG_INF("Hello! Main While "); // printk 대신 사용
//LOG_ERR("Something went wrong!");           // 에러 메시지
//LOG_DBG("Variable x = %d", x);              // 디버그용 (평소엔 안 보임)

/* 1. 스레드 설정 (스택 크기 및 우선순위) */
#define MY_STACK_SIZE 1024
#define MY_PRIORITY 7

/* 2. 스레드가 실행할 함수 정의 */
void my_thread_logic(void *dummy1, void *dummy2, void *dummy3)
{
    while (1) {
        LOG_INF("Hello! thread "); // printk 대신 사용
        k_msleep(500); // 0.5초 대기
    }
}

/* 3. 스레드 정적 생성 */
K_THREAD_DEFINE(my_tid, MY_STACK_SIZE,
                my_thread_logic, NULL, NULL, NULL,
                MY_PRIORITY, 0, 0);


int main(void)
{
    while (1) {
        
        LOG_INF("Hello! Main While "); // printk 대신 사용

        // 1000ms (1초) 지연
        k_msleep(1000); 
    }

}

prj.conf 파일에 아래처럼 CONFIG_LOG=y 를 추가한다.

위와같이 설정한 것을 빌드하여 칩에 기록하고 실행하면 터미널에서 아래처럼 보인다.

로그출력에 함수명 자동 포함

아래 define 문처럼 정의하고 코드상에서 MY_LOG_INF("test"); 처럼 기록하면 로그출력시 문자열 앞에 함수이름이 앞에 자동으로 부착된다.

// ANSI 색상 코드 정의
#define ANSI_COLOR_RESET  "\x1b[0m"
#define ANSI_COLOR_GREEN  "\x1b[32m"
#define ANSI_COLOR_BLUE  "\x1b[34m"
#define ANSI_COLOR_RED  "\x1b[31m"
#define ANSI_COLOR_PURPLE  "\x1b[35m"

// 함수명 자동 포함 
#define MY_LOG_INF(fmt, ...) LOG_INF("[%s] : " fmt, __func__, ##__VA_ARGS__) 
#define MY_LOG_ERR(fmt, ...) LOG_ERR("[%s] : " fmt, __func__, ##__VA_ARGS__) 
#define MY_LOG_WRN(fmt, ...) LOG_WRN("[%s] : " fmt, __func__, ##__VA_ARGS__) 
// 함수명 색상 지정. 
#define MY_LOG_INF_C(fmt, ...) LOG_INF(ANSI_COLOR_GREEN "[%s] : " ANSI_COLOR_RESET fmt, __func__, ##__VA_ARGS__)

로그 출력예.

[함수명] 이 자동 추가되어있고, MY_LOG_INF_C 로 출력한것은 함수명 색상이 녹색으로 표현된다.

이후 문자열 출력 필요없는 경우엔 CONFIG_LOG=n 으로 변경하여 빌드하면 문자열 출력관련은 빌드에서 모두 제외된다. VSCode 로 문자열 정상적으로 출력된 이유는 defconfig 파일에 CONFIG_SERIAL=y, CONFIG_UART_CONSOLE=y, CONFIG_PRINTK=y 로 설정 되어있기 때문이다. 양산 펌웨어에서는 필요없기에 prj.conf 파일에 CONFIG_LOG=n 외에도 아래처럼 추가로 비활성 설정한다.

# 양산 시 prj.conf에 추가하여 기본값을 덮어씌움
CONFIG_LOG=n # Zephyr의 로깅 시스템
CONFIG_SERIAL=n # UART 드라이버
CONFIG_UART_CONSOLE=n # 디버거 메시지를 UART 로 쏠지말지.
CONFIG_PRINTK=n # printk 사용 안 함 (로그 시스템이 UART를 사용하도록)

J-Link RTT 설정법.

앞의 설명에서의 로그출력용 하드웨어 수단으로 칩내장 UART 이용하는 경우이며, J-Link RTT 이용한 로그 출력도 가능하다. 이런 경우 설정은 아래와 같다. UART , RTT 중 1개만 선택해도 되고 모두 선택해도된다. 아래예는 RTT 만 선택한 것.

prj.conf 에 기록


### 시작. 로그관련 설정. 
CONFIG_LOG=y # 로그 시스템 활성화
# 로그 레벨 설정 (0: None, 1: Error, 2: Warning, 3: Info, 4: Debug) 예:2로 설정하면 0,1,2 만 출력.
CONFIG_LOG_DEFAULT_LEVEL=4 

# 로그출력위한 RTT 백엔드 
CONFIG_USE_SEGGER_RTT=y
CONFIG_LOG_BACKEND_RTT=y

# 로그출력위한 UART 백엔드
CONFIG_SERIAL=n
CONFIG_LOG_BACKEND_UART=n

# 콘솔 출력(printk)을 어디로 보낼지 결정 (보통 하나만 선택)
CONFIG_UART_CONSOLE=n 
CONFIG_RTT_CONSOLE=n
### 끝. 로그관련 설정.

기타.

조금 더 상세한 기본 사용법은 아래 영상 참조.

다른 폴더에 있는 소스 활용 방법 . CMakeLists.txt 에 추가해야함.

프로젝트 폴더에 모든 소스들이 있지 않고 별도의 폴더에 있는 소스를 프로젝트에 포함시키는 방법.

예. 아래 처럼 프로젝트 폴더 와 전혀 다른 폴더 CySDK_nRF5_Zephyr 에 하위 폴더들이 있고, 각 폴더마다 .c, .h 파일들이 있다고 하자.

현재 작업중인 프로젝트 소스에서 위 파일들을 포함시키기 위해서는 현재 프로젝트 폴더에 만들어져 있는 CMakeLists.txt 에서 정보를 기록해줘야 한다. 아래 처럼 주석 #1,#2,#3 형식으로 추가하고, 프로젝트 내의 소스에서 #inlcude <ble/cy_blenus_p.h> 이런 식으로 인클루드 하고, cy_blenus_p.c 의 함수 호출하면 된다.

cmake_minimum_required(VERSION 3.20.0)
find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
project(test_blenus_p1)

target_sources(app PRIVATE
        src/main.c
)



# 1. SDK 루트 경로 설정 (상대 경로 기준)
set(CySDK_nRF5_Zephyr_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../CySDK_nRF5_Zephyr)

# 2. 헤더 파일 검색 경로 한 번에 등록. 루트만 등록하고 인클루드시 활용예. #include <ble/cy_blenus_p.h>
target_include_directories(app PRIVATE 
    ${CySDK_nRF5_Zephyr_PATH}
)

# 3. 컴파일할 소스 파일들 등록. 프로젝트에서 사용하는것 모두 수동 등록해야함. 
target_sources(app PRIVATE
    ${CySDK_nRF5_Zephyr_PATH}/ble/cy_blenus_p.c
    #${CySDK_nRF5_Zephyr_PATH}/adc/cy_adc.c
    #${CySDK_nRF5_Zephyr_PATH}/gpio/cy_gpio.c
)

prj.conf , Kconfig 체계적으로 활용하는 방법

프로젝트 생성하면 기본 prj.conf 파일이 만들어지고 이곳에 프로젝트에서 사용하는 모듈들 활성화하는 구문을 아래예처럼 작성하는데, prj.conf 파일에서 내 프로젝트에서 사용되는 모든 요소들의 것이 기록되어야 한다.

CONFIG_BT=y
CONFIG_BT_PERIPHERAL=y
CONFIG_BT_ZEPHYR_NUS=y

그런데 앞의 내가 작성하는 모듈화된 함수들(cy_blenus_p.c ) 이 작동하기 위해서 필요한 요소를 프로젝트에 있는 prj.conf 에서 세부설정을 기록하게 하면 모듈화 되지 못하므로 매우 산만해진다. 모듈화된 함수 관련 된 설정을 모아두고 이를 prj.conf 에서 간단하게 활성화하는 체계가 요구된다.

아래 그 방법 정리.

프로젝트 폴더에 파일 Kconfg

프로젝트 폴더에 파일 Kconfig 만들어 추가하고 아래처럼 주석 #1 에 내가 사용하는 Kconfig 파일들 연결 시키고 주석 #2 에 있는 것은 제퍼기본 KConfig 를 기록한다. 앞에 기록된 설정이 우선 한다. 즉 여러 Kconfig 파일내에 동일 심볼의 설정들이 있는 경우 아래 리스트에서 뒤에 있는 것은 무시되고 앞에 있는 설정이 적용됨.

프로젝트 루트에 Kconfig 파일이 없다면 툴체인에 있는 Kconfig 를 참조하여 빌드하지만, 프로젝트 폴더에 Kconfig 파일이 있다면 이 파일을 참조하여 빌드 된다.

다른 폴더 (본 예에서는 CySDK_nRF5_Zephyr ) 에도 파일 Kconfig 추가

아래 예처럼 기록한다. 아래 예는 1개의 Kconfig 파일에 CySDK_nRF5_Zephyr 에서의 구현되어있는 모듈들 전체를 통합 제공하는 방식으로 했다. 굳이 통합하지 않아도 되며 필요에 따라 CySDK_nRF5_Zephyr 에 있는 하위 폴더 ble, spi , uart 하위에 KConfig 파일 만들어서 해당 모듈에 대한것만 기록해서 프로젝트폴더에 있는 Kconfig 파일에 각각을 기록해도 된다(위 그림에서 주석처리된 구문들처럼 기록하면 됨.) .


#  응용 프로젝트의 prj.conf 에서 구문작성예  
# CONFIG_CySDK_BLENUS_P=y
# CONFIG_CySDK_BLENUS_C=y

menu "CySDK Kconfig"

# for cy_blenus_p.c/h
config CySDK_BLENUS_P
    bool "Enable CySDK BLE NUS Peripheral"
    select BT
    select BT_PERIPHERAL
    #select BT_NUS #이것만 활성화 시켜도 NUS 서비스가 부착되고 BT_ZEPHYR_NUS 에 의한것도 부착됨.  
    select BT_ZEPHYR_NUS #BT_ZEPHYR_NUS 활성화 시켜야 NUS 서비스가 제대로 동작함. (예: ble_nus_init() 함수에서 BT_ZEPHYR_NUS의 초기화 함수가 호출됨)
    help
      BLE NUS Peripheral 위한 설정

# for cy_blenus_c.c/h
config CySDK_BLENUS_C
    bool "Enable CySDK BLE NUS Central"
    select BT
    select BT_CENTRAL
    #select BT_NUS
    select BT_ZEPHYR_NUS 
    help
      BLE NUS Central 위한 설정

# MTU가 247일 때 버퍼 크기도 함께 맞춤 (P/C 공통 혹은 개별)
config BT_BUF_ACL_TX_SIZE
    default 251 if CySDK_BLENUS_P || CySDK_BLENUS_C

config BT_BUF_ACL_RX_SIZE
    default 251 if CySDK_BLENUS_P || CySDK_BLENUS_C

config BT_L2CAP_TX_MTU
    default 247 if CySDK_BLENUS_P || CySDK_BLENUS_C

endmenu

프로젝트의 prj.conf

내 프로젝트에서 CySDK_nRF5_Zephyr 의 cy_blenus_p.c 를 활용하는 경우 내 프로젝트의 prj.conf 파일에 아래처럼 1개만 기록하면 cy_blenus_p.c 에서 필수 요구되는 설정들이 모두 달성된다.

CONFIG_CySDK_BLENUS_P=y

C++ 로 코딩하기.

별도정리. https://igotit.tistory.com/6471

nRF Connect SDK VSCode . C++ 로 코딩하기

nRF Connect SDK VSCode . C++ 위한 필수 설정 nRF Connect SDK VSCode 컴파일 환경은 파일 확장자 C 로 된 것은 C 컴파일 되고, 파일확장자 cpp 로 된것은 C++ 컴파일 가능하나 필수 아래와 같은 설정을 해줘야 한

igotit.tistory.com

연관

nRF Connect for VS Code .개요 . 포터블 설치

igotit.tistory.com

Zephyr (제퍼) . RTOS . 경량

Zephyr (제퍼)- 경량 RTOS . nRF52840 ( ARM Cortex M4F, 1MByte flash, 256kbyte ram. 64MHz )급에서도 활용 가능. - 라이센스 : 오픈소스- 관리주체 : 리눅스재단 - 커널 , 라이브러리, 장치드라이버, 프로토콜 스택, 파

igotit.tistory.com

J-LINK . 디버거

J-LINK - SEGGER 사의 JTAG/SWD 디버거 기기 브랜드 명. J-LINK 20핀 커넥터 JTAG 핀맵 J-LINK 20핀 커넥터 SWD 핀맵 - 20핀 중에 실제 기능 할당된 핀은 1,7,9,11,15,19, GND 총 7핀. - 실제 사용시 SWO와 5V-Supply 는 거의

igotit.tistory.com

칩. nRF52840. 블루투스 5.0

품번 : nRF52840 특징. - BT5.0 ( 및 ANT/802.154.4 Zigbee, Thread /Proprietary 용도로도 사용가능. Multi Protocol)- On Chip NFC Tag.- ARM Cortex M4F, 1MByte flash, 256kbyte ram. 64MHz.- SPI : 32MHz.- ADC : 12bit, 200ksps.- USB 2.0- 패키지 : 7x

igotit.tistory.com

nRF54L15 . BLE 5.4 SoC Cortex-M33 128MHz

nRF54L15 - NORDIC 사의 nRF54L 시리즈의 첫 출시 칩. - BLE 5.4 - RF Power : Max 8dBm - Arm Cortex-M33 128MHz (nRF52840 대비 2배 더 고속) - 1.5MByte 플래시 메모리. - 256KByte RAM 연관 칩. nRF52840. 블루투스 5.0 품번 : nRF52840

igotit.tistory.com

첫 등록 : 2026.02.25

최종 수정 : 2026.03.03

단축 주소 : https://igotit.tistory.com/6461

winapi . 100나노초 UTC 시각 . GetSystemTimePreciseAsFileTime .

i.got.it — Thu, 22 Jan 2026 20:52:33 +0900

GetSystemTimePreciseAsFileTime

로컬 시간 독립성: 로컬 시간대나 일광 절약 시간제(DST)의 영향을 받지 않는 절대적인 UTC 시간 반환.

고정밀: 일반적인 GetSystemTime이 10~15ms 단위로 업데이트되는 것과 달리, 이 함수는 하드웨어 카운터(QPC)와 연동되어 0.1μs(=100나노초) 의 정밀도.

단위: 1601년 1월 1일 UTC 0시부터의 경과 시간을 100나노초 단위로 반환. 마이크로초 단위로 받으려면 나누기 10.

지원운영체제 : windows 8 이후 Windows Server 2012 이후

C++ 코드예


#include <windows.h>
#include <iostream>

long long GetUtcNowMicroseconds() {
    FILETIME ft;
    // 1. 고정밀 UTC 시스템 시간 가져오기 (100나노초 단위). thread safe
    GetSystemTimePreciseAsFileTime(&ft);

    // 2. 64비트 정수로 변환
    ULARGE_INTEGER uli;
    uli.LowPart = ft.dwLowDateTime;
    uli.HighPart = ft.dwHighDateTime;

    // 3. 100나노초 단위를 마이크로초로 변환 (10으로 나눔)
    return uli.QuadPart / 10;
}

int main() {
    std::cout << "현재 UTC0 마이크로초: " << GetUtcNowMicroseconds() << std::endl;
    return 0;
}

C++ 실전 함수로 정리한것.

#include <windows.h>
#include <stdint.h>


namespace Cy::Time {

	inline static int64_t GetUTCMicroSec() // Windows 8 / Server 2012 이상 필수
	{
        FILETIME ft;
        GetSystemTimePreciseAsFileTime(&ft);// 고정밀 UTC 시스템 시각 가져오기
        // 1. FILETIME의 주소를 uint64_t 포인터로 캐스팅하여 한 번에 읽음.
        // FILETIME은 메모리상에 Low(4byte), High(4byte) 순으로 있어 64비트 정수와 호환됨
        uint64_t rawTicks = *reinterpret_cast<const uint64_t*>(&ft);
        return static_cast<int64_t>(rawTicks / 10);
	}
	

}//namespace Cy::Time

MT5 . mql5 코드예

- mt5 에서도 사용 가능.

// 1. Windows API 임포트
#import "kernel32.dll"
   void GetSystemTimePreciseAsFileTime(long &filetime);
#import

// 2. C++의 GetUTCMicroSec()과 동일한 기능을 하는 함수
long GetUTCMicroSec()
{
   long ft;
   GetSystemTimePreciseAsFileTime(ft); // 100ns 단위 64비트 정수 획득
   return ft / 10;                     // 마이크로초(μs) 단위로 변환
}

상위정리

Visual Studio , Visual C++ 활용 정리.

Visual Studio C++ 활용 Visual StudioVisual C++ / C#1.설치, 설정 주제 비고. Visual Studio 2010 설치. Visual Studio 2013 (Community)무료 설치. Visaul Studio 2015 (Community)무료 설치.- Visual Studio 2015 버전은 이전 버전대비 급

igotit.tistory.com

연관

UTC. 협정세계시. Coordinated Universal Time. Epoch. GMT

UTC 협정세계시. Coordinated Universal Time- 국제표준 시각 표현기준. - 약어표현 : UTC- 가장 혼선없이 사용가능한 일관성 있는 시각표현수단 - 금융데이터 처리 코드나 데이터 베이스 기록시 섬

igotit.tistory.com

첫 등록 : 2026.01.22

최종 수정 :

단축 주소 : https://igotit.tistory.com/6426

피어슨 상관 계수 . Pearson Correlation Coefficient

i.got.it — Thu, 22 Jan 2026 15:15:11 +0900

피어슨 상관 계수

- 아래 식에서 r : 값의 범위 -1 ~ 1

X,Y : 여러 값들 . 즉 X = {x1, x2, x3, .... } , Y = {y1, y2, y3, ...}

X,Y 는 시계열 데이터 일 수도 있고, 여러 사람의 키를 X, 몸무게를 Y 로 할 수도 있다. 두 개의 이미지 픽셀 데이터 일 수도 있다.

피어슨 상관 계수 의미

양수 : X와 Y 변화는 비례 관계 . 값이 1에 가까울수록 비례 정도 강함.

음수 : X 와 Y 변화는 반비례 관계 . 값이 -1에 가까울수록 반비례 정도 강함.

피어슨 상관계수 = 정규화된 공분산

피어슨 상관계수 구하는 식의 원형은 아래식.

분자는 공분산(Corvariance) 이며, 분모는 x, y 의 표준편차 곱으로 나누기하여 정규화 (값의 범위를 -1~1 사이 되도록 하는 것) 했다.

즉 피어슨 상관계수 구하는 식을 간단하게 표현하면 아래와 같고, 개념적으로는 공분산의 개념 그대로 반영된다. 공분산과의 차이점은 피어슨 상관계수는 값의 범위가 -1~ +1 이라는 점이 유일한 차이점.

연관

공분산. Covariance

공분산. Covariance 2개의 변수 X,Y 에 대한 Cov(X,Y) 정의식 Cov(X , Y) = E((X-u)(Y-v)) ------ (1) = E(X * Y) - uv -------(2) where, E : expectation value(평균치라 생각하면됨) 연산자. u = E(X), v = E(Y) - 2종의 값들의 상관정

igotit.tistory.com

첫 등록 : 2026.01.22

최종 수정 :

단축 주소 : https://igotit.tistory.com/6424

통화 표준 코드 . ISO 4217

i.got.it — Wed, 21 Jan 2026 16:20:52 +0900

ISO 4217 . Currency Code

- ISO (국제표준화기구) 에서 USD, EUR, KRW 등의 통화 코드 및 골드 등의 금속 코드 정의.

- 코드라 함은 유일 식별용으로 사용 가능한 고유 아이디(문자, 숫자 모두 발급되어있음 )를 의미하며 매우 중요한 정보이며, 금융 정보 관리 데이터 베이스, 코딩시 식별 아이디용으로 필수 활용할것. 이미 세계 표준이 만들어진 것은 필수 표준 준수할것.

- 3자리 알파벳 코드와 3자리 숫자 코드 정의되어있음.

- 보통 알파벳 코드의 앞 두 글자는 해당 국가의 ISO 3166 국가 코드 기반이며, 마지막 글자는 통화 이름의 첫 글자 등을 따름.

- 170개 이상의 통화코드 정의.

- ISO는 금속(현재는 4개 : 골드, 실버,팔라디움, 플라티늄 ) 을 통화 유닛처럼 코드 정의.

- 통화 예

USD — 미국 달러
EUR — 유로
JPY — 일본 엔
GBP — 영국 파운드 등

- ISO 4217에는 금·은 같은 귀금속 코드(XAU, XAG 등)나 IMF의 특별인출권(XDR) 같은 비전통 통화 단위 코드도 포함

ISO 4217이 정의하는 것

법정통화
- USD, EUR, JPY, KRW …
초국가 통화
- XDR (IMF SDR)
귀금속(화폐적 단위로 취급)
- XAU (Gold)
- XAG (Silver)
- XPT, XPD
테스트 / 비통용 코드
- XXX (No currency)

ISO 4217 공식 사이트

ISO 4217 법정통화 코드 일부

문자코드	숫자 코드	통화
USD	840	미국 달러
EUR	978	유로
JPY	392	일본 엔
GBP	826	영국 파운드
AUD	036	호주 달러
CAD	124	캐나다 달러
KRW	410	한국 원
CNY	156	중국 위안

전체 통화코드 pdf 파일.

ISO 4217 Currency Codes.pdf

0.17MB

ISO 4217 금속류 코드 전체

- 4개만 정의 되어있고 통화 코드 표준의 일부로 포함됨.

문자코드	숫자 코드
XAG	961	실버
XAU	959	골드
XPD	964	팔라디움
XPT	962	플라티늄

X로 시작하는 코드는 국가 통화가 아닌 자산을 나타냄
금속의 국제 표준 거래 단위 : 트로이 온스

첫 등록 : 2026.01.21

최종 수정 :

단축 주소 : https://igotit.tistory.com/6419

Cantor Pairing Function . 칸토어 페어링 함수 . 2개 수로 고유 수 만들기

i.got.it — Wed, 21 Jan 2026 12:59:41 +0900

Cantor Pairing Function . 칸토어 페어링 함수

자연수 ( 0이상의 정수 ) 2개 (a, b) 짝과 1:1 대응하는 유일한 정수 만드는 함수.

서로 다른 페어 는 반드서 서로 다른 숫자가 계산 됨.

숫자를 역변환 하여 a, b 값 복원 가능.

George Cantor .

1870 ~ 1890년대

집합론(Set Theory) 연구 중 “자연수의 쌍을 자연수 하나로 표현할 수 있는가?”라는 질문에서 등장

계산 예.

(1,2) 입력 . 출력 = 8

(2,1) 입력 . 출력 = 7

C++ 코드 예

#include <cstdint>
#include <cmath>

/*
수치 안정성 관련 
uint64_t 기준 a, b 가능한 값.
a,b ≤2^16 : 계산값 uint64_t 오버프로우 없이 절대 안전하게 사용 가능. 

주의점
sqrt는 double 사용 → floor 필수

*/

inline uint64_t CantorPair(uint64_t a, uint64_t b)
{
    return ((a + b) * (a + b + 1)) / 2 + b;
}

inline void CantorUnpair(uint64_t z, uint64_t& a, uint64_t& b)
{
    uint64_t w = static_cast<uint64_t>(
        std::floor((std::sqrt(8.0 * z + 1.0) - 1.0) / 2.0)
    );

    uint64_t t = (w * (w + 1)) / 2;
    b = z - t;
    a = w - b;
}

/// 참고 위 w 구하는 실수연산부 대신 정수로 아래처럼 연산 하는 것도 가능하나 속도느림. 
//uint64_t w = 0;
//while ((w+1)*(w+2)/2 <= z) ++w;




//////////////////// 사용예 /////////////////

uint64_t ventity1 = 300;  
uint64_t ventity2 = 1;    

uint64_t symbolID = CantorPair(ventity1, ventity2);

uint64_t ventity1, ventity2;
CantorUnpair(symbolID, ventity1, ventity2);

// ventity1 == 300
// ventity2 == 1

첫 등록 : 2026.01.21

최종 수정 :

단축 주소 : https://igotit.tistory.com/6418

C# . VC++ DLL 활용 . DllImport

i.got.it — Mon, 19 Jan 2026 21:34:41 +0900

C# 에서 DLL 활용

DLL 에서 정의된 무인자 함수

extern "C" __declspec(dllexport) void __stdcall OnActivated_CyNinjaX();
extern "C" __declspec(dllexport) void __stdcall OnTerminated_CyNinjaX();

extern "C" → C++ name mangling을 막아서 C-style 이름으로 export
__stdcall → 호출 규약 (C#에서는 CallingConvention.StdCall)
반환형 void → C#에서는 void로 매핑 가능

C# . DLL 임포팅 코드 예

- DLL 활용하는 기능을 C# 클래스로 캡슐화

- 본 DLL 은 여러 인스턴스 생성하면 안되는 것이어서 static 클래스로 하였음.

using System;
using System.Runtime.InteropServices;

namespace CyS91LE1_CyNinjaX
{

    /// CyS91LE1_CyNinjaX DLL 함수 래퍼 클래스 
    public static class CyNinjaX
    {
        private const string DllName = "CyS91LE1_CyNinjaX.dll";

        [DllImport(DllName, CallingConvention = CallingConvention.StdCall)]
        private static extern void OnActivated_CyNinjaX();

        [DllImport(DllName, CallingConvention = CallingConvention.StdCall)]
        private static extern void OnTerminated_CyNinjaX();

        public static void OnActivated()
        {
            OnActivated_CyNinjaX();
        }

        public static void OnTerminated()
        {
            OnTerminated_CyNinjaX();
        }
    }
}

호출 예

- static 클래스이므로 instance 생성 없이 바로 호출한다.

using CyS91LE1_CyNinjaX;

class Program
{
    static void Main()
    {
        // DLL 함수 호출
        CyNinjaX.Activate();
        Console.WriteLine("Main UI 생성 완료");

        Console.WriteLine("아무 키나 누르면 종료...");
        Console.ReadKey();

        CyNinjaX.Terminate();
        Console.WriteLine("Main UI 종료 완료");
    }
}

DLL 에서 정의된 함수 인자가 구조체 포인터

- 먼저 구조체 부터 C# 에서

C++ 측의 구조체

#pragma pack(push, 8)
namespace CyFinX::Raw {

struct Tick
{
    double  ask;
    double  bid;
    int64_t time_msec;
};

struct Tick_MultiSymbol
{
    int32_t CyFinXSymbolID;
    Tick    stTick;
};

}
#pragma pack(pop)

C# 측의 구조체


using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 8)]
public struct Tick
{
    public double ask;
    public double bid;
    public long   time_msec;
}

[StructLayout(LayoutKind.Sequential, Pack = 8)]
public struct Tick_MultiSymbol
{
    public int  CyFinXSymbolID;
    public Tick stTick;
}

C++ 함수

- 위 구조체의 포인터 인자

- __stdcall 아닌 경우


extern "C" __declspec(dllexport)
void func(const CyFinX::Raw::Tick_MultiSymbol* p);

C# 측

[DllImport("YourDll.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern void func(ref Tick_MultiSymbol p);

혹은 
public static extern void func(IntPtr p);

C# 에서 사용 가능한 DLL 함수 인자 일반

불가능한 것들 . C 에 없는 개념들.

C++ 전용타입 : std ::string 등 모든 std 류 ,MFC CString, ... C++ 객체, 레퍼런스 , 템플릿.

기본타입

C/C++	C#
char	sbyte / byte
int	int
float	float
double	double

C/C++	C# 키워드	CLR 타입	크기
int8_t	sbyte	System.SByte	1 byte
uint8_t	byte	System.Byte	1 byte
int16_t	short	System.Int16	2 byte
uint16_t	ushort	System.UInt16	2 byte
int32_t	int	System.Int32	4 byte
uint32_t	uint	System.UInt32	4 byte
int64_t	long	System.Int64	8 byte
uint64_t	ulong	System.UInt64	8 byte

포인터

void* - Intptr

고정길이 배열

char name[60];

[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 60)]
string name;

또는 

fixed byte name[60];

구조체

struct S { int a; double b; };

[StructLayout(LayoutKind.Sequential)]
struct S { public int a; public double b; }

상위정리

Visual Studio , Visual C++ 활용 정리.

igotit.tistory.com

첫 등록 : 2026.01.18

최종 수정 :

단축 주소 : https://igotit.tistory.com/6414

C++ . 네임스페이스

i.got.it — Sun, 18 Jan 2026 19:53:51 +0900

네임스페이스 . Namespace

- 코드의 이름 충돌 방지 및 논리적인 그룹화 위해 활용.

이름 충돌 방지 (가장 큰 목적)
서로 다른 라이브러리에서 같은 이름의 함수(init(), log())를 정의해도 네임스페이스가 다르면 공존 가능.

네임스페이스 기본문법

namespace 이름
{

....

} // ; 없음.

예.


#include <iostream>

namespace MyApp {
    int version = 10;
    void print() {
        std::cout << "MyApp Version: " << version << std::endl;
    }
}

int main() {
    // 1. 범위 지정 연산자(::) 직접 사용
    MyApp::print(); 

    // 2. using 지시어 사용 (블록 내 모든 요소 개방)
    using namespace MyApp;
    std::cout << version << std::endl;

    return 0;
}

네임스페이스 중첩 및 별칭


// C++17 이후 중첩은 간결하게 가능. 
namespace Company::Project::Module {
    void task() {}
}

// 별칭(Alias) - 긴 경로를 짧게 줄임
namespace CPM = Company::Project::Module;

int main() {
    CPM::task();
}

클래스 헤더 , cpp 네임스페이스 예.

헤더.

namespace MyApp::Tools {

    class Calculator {
    public:
        int Add(int a, int b); // 멤버 함수 선언
    };

}

cpp

#include "MyClass.h"

namespace MyApp::Tools {
    // 이미 MyApp::Tools 안에 들어와 있으므로 클래스 이름만 
    int Calculator::Add(int a, int b) {
        return a + b;
    }
}

헤더 파일(.h)에서 using namespace 사용 금지

헤더 파일은 다른 파일들에 의해 #include 되는데, 만약 A.h에서 using namespace std;를 사용하면, 이 헤더를 포함하는 모든 .cpp 파일에 원치 않더라도 std 네임스페이스의 모든 이름이 강제로 노출됨.

// [나쁜 예] MyHeader.h
using namespace std; // 절대 금지
void PrintName(string name); 

// [좋은 예] MyHeader.h
#include <string>
namespace MyLib {
    void PrintName(std::string name); // std::를 직접 붙임
}

CPP 파일에서는 using namespace 사용 자유로움.

권장 방법: .cpp 파일의 상단보다는 특정 함수 내부에서 사용하거나, 필요한 것만 선언.

// MyFile.cpp
#include "MyHeader.h"

// 방법 1: 필요한 것만 개별 선언 (가장 권장)
using std::string;
using std::cout;

// 방법 2: 함수 내부에서만 사용 (영향 범위 제한)
void MyFunc() {
    using namespace std;
    cout << "Hello" << endl;
}

첫 등록 : 2026.01.18

최종 수정 :

단축 주소 : https://igotit.tistory.com/6416

닌자트레이더 . C# 코딩 . 닌자스크립트 기초

i.got.it — Sat, 17 Jan 2026 18:01:50 +0900

닌자트레이더 스크립트 C# 코딩하기.

- 닌자트레이더에서 스크립트(C#) 작성 처음 접한 경우 전체 개념 파악 하기 좋은 정보 정리.

- 가장 기본적인 "hello ninja" 코딩하면서 전체적인 활용법 쉽게 파악 가능하게 정리.

사전준비

- 닌자트레이더 개요 이해 , 설치 : https://igotit.tistory.com/6408

닌자 트레이더 . 개요 . 설치 . 둘러보기

닌자 트레이더 개요 . 특징 - 선물(Futures) 중심의 전문 트레이딩 플랫폼.- 닌자 트레이더 는 프로그램 설치만으로 매매 가능한 구조 아니며 외부 선물브로커,데이터공급자 별도 연결해줘야 하고

igotit.tistory.com

스크립트 편집기

닌자트레이더 실행하여, control center 메뉴 : New -> NinjaScript Editor

스크립트 에디터 실행하면 아래 화면처럼 오른쪽에는 카테고리 별로 C# 소스들이 있고 C# 코드 작성 창이 보인다. 아래 화면은 기본 내장된 스크립트 중에서 지표 ADX 클릭해 본것. 화살표 아이콘 클릭하면 컴파일된다. 오른쪽 마지막 아이콘이 Visual Studio 실행하는 아이콘. VS 에서는 편집이나 디버깅 하는 용도로만 사용해야하고 빌드하면 안됨. 항상 닌자 스크립트 에디터에서만 컴파일 해야한다. 닌자트레이더 내장 편집기도 쓸만함.

위 화면의 오른쪽에 보이는 카테고리들은 스크립트 타입이라고 하며, 내가 C# 코드 작성 한다는 말은 이 타입 중 어느 하나에 새로 코드 파일 만들어서 작업한다.

스크립트 타입

스크립트 타입	베이스 클래스	핵심역할	실행위치
Indicators	Indicator	차트에 표시되는 계산 로직 -가격/틱/지표계산	Chart
Strategies	Strategy	자동매매 로직 - 주문, 포지션 관리	Chart
AddOns	AddOnBase	독립 UI + 기능 확장 - 별도의 창을 갖는 미니프로그램	닌자트레이더 실행 레벨.
DrawingTools	DrawingTool	차트 그리기 도구 - 선,박스, 마킹등 시각화	Chart
MarketAnalyzerColumns	MarketAnalyzerColumn	스캔용 컬럼 계산 - 여러 종목 동시 스캔	Market Analyzer
BarsTypes	BarsType	봉 생성 로직 봉자체를 정의하는로직	Chart
DataSeries (내부)	—	시계열 데이터	--

Chart 나 MarketAnalyzer 없이 닌자트레이더 켜두기만 하면 실행가능한 스크립트 형식은 AddOns,

단일 심볼/시세 기반 계산은 Chart 에서 Indicator

주문실행하고 포지션 관리하는 것은 Chart 에서 Strategy

여러 종목 동시 감시, 계산결과 표시용은 MarketAnalyzerColumns . 주의. 여기서의 시세 데이터는 chart 만큼 즉시성 처리 보장 안됨.

AddOn 특징 상세

멀티 심볼 틱 동시 처리용에서는 AddOns 가 유리.

UI 윈도우 + 독립 스레드 + 전역 시세 관리 가능
Connection / Instrument / MarketData 직접 구독
Chart / MA / Strategy와 완전히 분리 가능

[ MarketData ]
        ↓
[ AddOn Tick Engine ]  
        ↓
[ 공유 메모리 / 캐시 ]
   ↓            ↓
[ Chart ]   [ MarketAnalyzer ]

C# 소스 파일 폴더

C:\Users\본인계정\Documents\NinjaTrader 8\bin\Custom\

* 닌자트레이더 실행파일들 있는 설치 폴더에 만들어지는 것 아님.

이 폴더에 카테고리명들이 보이고 C# 파일들이 있다.

참고 : 처음 닌자 트레이더 설치하면 파일 없으며 메모리상에만 있는 것이 위 editor 창에서 보인다. editor 창에서 compile 버튼 클릭해야 파일들이 만들어짐.



Custom\
 ├─ Indicators\
 ├─ Strategies\
 ├─ AddOns\
 ├─ MarketAnalyzerColumns\
 ├─ DrawingTools\

내가 만든 C# 파일 역시 위 폴더 속에 만들어지고 그 외의 경로에 있는 것은 닌자트레이더에서 실행 못함.

한편, 내가 작업하는 C# 소스 파일 중에 닌자트레이더에서 직접 실행하는 게 아닌 내가 재료로 활용하는 파일들은 Custom 하위에 Include 폴더를 만들어서 여기에 배치해두면 된다. Include 외에 다른 이름의 폴더로 해도 되긴 하나 Inlcude 라는 이름으로 하는 게 안전함.

즉,

bin\Custom\Include\

여기에는:

base class
helper
enum
struct
util

같은 비-NinjaScript 클래스만 둠

소스파일 구성 구조 예시

bin\Custom\
 ├─ Strategies\
 │   └─ Cy_st.cs
 ├─ Indicators\
 │   └─ Cy_TickLead.cs
 └─ Include\
     └─ Cy\
         ├─ Core.cs
         ├─ Time.cs
         ├─ Math.cs
         └─ Fix.cs

닌자스크립트 . Hello Ninja 만들기

- 가장 간단한 코드 구성으로 닌자트레이더에서 스크립트 만드는 전체 과정을 파악가능하다.

- AddOns 타입으로 만들어본다.

스크립트 에디터 타입 AddOns 마우스 우클릭 메뉴에서 New Add On 클릭한다.

그럼 생성 위한 창이 뜨고

위 화면에서 Next 클릭하여 아래처럼 이름 지정 하고 Next 클릭.

윈도우 생성 종료 이벤트 처리기 추가 선택 가능하다. 일단 2개다 선택하고 Next 클릭.

여기서 말하는 window 란 닌자트레이더에서 생성된 모든 창을 의미한다.

입력 파라메타 추가하란다. 안하고 Next 클릭.

마지막 이다. Finjsh 클릭.

기본코드 자동 생성되었다.

앞에서 선택했던 윈도우 이벤트 핸들러가 추가되어 있다. 여기서 말하는 윈도우란 AddOn 의 윈도를 의미하는 게 아님. 베이스 클래스인 AddOnBase 는 UI 나 윈도우 없이 백그라운드에 로드되는 오브젝트임.

위 코드에서의 윈도우란 닌자트레이더 실행하여 보이는 아래 예시의 모든 윈도우들을 의미한다.

Control Center
Chart Window
Market Analyzer
Strategy Analyzer
Accounts 창
DOM
Options 창
내가 직접 만든 Window

상태변경 이벤트 핸들러 OnStateChange()

기본 생성된 코드에는 SetDefaults, Configure 만 만들어져 있는데 자주 활용되는 Active 등도 있고 이건 타이핑해서 추가 기록하면 된다. Active 는 실행초기 1회 , Terminated 는 닌자트레이더 종료시 1회 발생한다.

시험용으로 Active 시점에 윈도우 1개 만들고, Terminated 시점에 윈도우 제거하는 것을 구현해 보자.

전체 코드.

Hello Ninja 컴파일 하기

위 화면의 화살표 아이콘 클릭하여 컴파일 하면 아래처럼 새로운 Add on 이 있다고 창이 뜬다. Yes 클릭.

Hello Ninja 실행하기

- 앞의 컴파일 과정 완료해도 바로 실행되지 않는다.

- AddOn 실행하려면 닌자트레이더 재시작해야 한다. 닌자트레이더 실행하면 동시에 내가 만든 AddOn 도 실행되고 우리가 코드에 추가했던 윈도우 생성도 정상적으로 만들어진다.

- AddOn 에서 생성한 윈도우는 사용자가 x버튼 클릭하여 닫아도 AddOn 은 계속 실행상태이며 닌자트레이더 종료시 AddOn 도 종료된다.

이 과정까지 닌자스크립트 사용하는 기본 골격은 달성됨.

아래는 좀더 세부적인 작업들 진행해본다.

메뉴 클릭해야 윈도우 보이게 하기.

- 앞에서 제작된 것은 NT 실행 초기 항상 윈도우가 보이고 있는데 , 실행 초기 기본 보이지 않고 내가 추가한 메뉴 클릭하면 윈도우가 보이게 해본다.

앞에서 작성했던 Active 시 윈도우 생성하던 것을 주석처리하고,

else if (State == State.Active)
{
    //CreateWindow(); 
}

OnWindowCreated 와 OnWindowDestroyed 부분을 아래처럼 작성한다.

		protected override void OnWindowCreated(Window window)
		{
		    if (window is ControlCenter controlCenter)
		    {
		        MenuItem menuItem = new MenuItem
		        {
		            Header = "CyAddOn Window"
		        };
		        menuItem.Click += MenuItem_Click;//이벤드핸들러 등록 
		
		        controlCenter.MainMenu.Add(menuItem);
		    }
		}
		private void MenuItem_Click(object sender, RoutedEventArgs e)
		{
			if(window_myaddon == null) // 윈도우 중복 생성 방지. 
				CreateWindow();
			else window_myaddon.Activate(); 
				
		}
		
		protected override void OnWindowDestroyed(Window window)
		{
			if (window == window_myaddon)
			{
				window_myaddon = null; 	
			}
		}

컴파일하고, 실행해보면 실행초기에는 AddOn 윈도우는 생성되지 않는다. 대신 Control Center 상단라인에 내가 추가한 메뉴 보인다.

메뉴 클릭하면 윈도우 보인다.

실시간 시세 수신 하기

- 특정 종목 1개 지정하여 시세 수신하도록 해보자.

OnStateChange 에서 아래처럼 종목 구독, 구독해지 추가하고,

		protected override void OnStateChange()
		{
			if (State == State.SetDefaults)
			{
				Description	= @"시험용 AddOn";
				Name		= "CyAddOnHelloNinja";
			}
			else if (State == State.Configure)
			{
			}
			else if (State == State.Active)
			{
				Subscribe();// 구독 
			}
			else if(State == State.Terminated)
			{
				Unsubscribe(); // 구독해지 
				window_myaddon?.Close();
			}
		}

Subscibe (), Unscribe() 를 아래처럼 작성한다.

- 예로 BTCUSD 시세 수신 요청하는것.


		private Instrument instrument;
		
        private void Subscribe()
        {
            instrument = Instrument.GetInstrument("BTCUSD");

            if (instrument == null)
            {
                Print("BTCUSD instrument not found");
                return;
            }
			
			instrument.MarketDataUpdate += OnMarketDataUpdate;
			
            Print("BTCUSD MarketData subscribed");
        }		
		
        private void OnMarketDataUpdate(object sender, MarketDataEventArgs e)
        {
            if (e.MarketDataType != MarketDataType.Last)
                return;

            Print(
                $"BTC TICK | Price={e.Price} " +
                $"Volume={e.Volume} " +
                $"Time={e.Time:HH:mm:ss.fff}"
            );
        }
		
        private void Unsubscribe()
        {
            if (instrument != null)
            {
                instrument.MarketDataUpdate -= OnMarketDataUpdate;
                Print("BTCUSD MarketData unsubscribed");
            }
        }

위 코드에서 Print() 문에 의한 문자열 출력 위치는 NinjaScript Output 창 이며, 닌자트레이더 메뉴 : New -> NinjaScript Output 창에서 볼 수 있다.

실행하여 닌자스크립트 출력창에 실시간 시세 정상 출력 확인. 챠트에서 보이는 가격과 정확히 일치하는것 확인함.

여기 까지의 전체코드

여러 종목 요청하기

앞의 코드에서 종목 시세 요청하고 수신받는 부분의 코드는 아래가 핵심이다. Subscribe() 에서 종목 지정하고

instrument.MarketDataUpdate += OnMarketDataUpdate; 에서 이벤트핸들러를 등록. 그러면 시세수신 마다 OnMarketDataUpdate 가 호출되며 여기서 받은 데이터 처리한다.

        private void Subscribe()
        {
            instrument = Instrument.GetInstrument("GC FEB26");// BTCUSD 등. 

            if (instrument == null)
            {
                Print("Gold instrument not found");
                return;
            }
			
            instrument.MarketDataUpdate += OnMarketDataUpdate;
			
            Print("BTCUSD MarketData subscribed");
        }		
		
        private void OnMarketDataUpdate(object sender, MarketDataEventArgs e)
        {
            if (e.MarketDataType != MarketDataType.Last)
                return;

            Print(
                $"BTC TICK | Price={e.Price} " +
                $"Volume={e.Volume} " +
                $"Time={e.Time:HH:mm:ss.fff}"
            );
		

			CyNinjaX.OnTick(1,e.Ask,e.Bid,e.Time);
        }

아래는 여러 종목 요청하는 코드 예

먼저 여러 종목을 관리하기 위한 방법중 하나로 각 심볼들의 고유아이디를 1,2,3 같은 식으로 지정하기 위하여 dictionary 로 아래처럼 만든다.


namespace NinjaTrader.NinjaScript.AddOns
{
	public class CyAddOnHelloNinja : NinjaTrader.NinjaScript.AddOnBase
	{
		
		private Dictionary<Instrument, int> instrumentIdMap = new Dictionary<Instrument, int>();
		private readonly Dictionary<int, string> symbolMap = new()
		{
		    { 1, "GC FEB26" },
		    { 2, "BTCUSD" }
		    // 필요수량 만큼 추가 가능 
		};		
        
     ...

다중 심볼 Subscribe

private void Subscribe()
{
    foreach (var kv in symbolMap)
    {
        int id = kv.Key;
        string symbol = kv.Value;

        Instrument inst = Instrument.GetInstrument(symbol);
        if (inst == null)
        {
            Print($"{symbol} not found");
            continue;
        }

        instrumentIdMap[inst] = id;
        inst.MarketDataUpdate += OnMarketDataUpdate;

        Print($"{symbol} subscribed with ID={id}");
    }
}

OnMarketDataUpdate


private void OnMarketDataUpdate(object sender, MarketDataEventArgs e)
{
    if (e.MarketDataType != MarketDataType.Last)
        return;

    var inst = sender as Instrument;
    if (inst == null)
        return;

    if (!instrumentIdMap.TryGetValue(inst, out int id))
        return;

    CyNinjaX.OnTick(
        id,
        e.Ask,
        e.Bid,
        e.Time
    );
}

Unsubscribe

        private void Unsubscribe()
        {
			
			foreach (var kv in instrumentIdMap)
			{
			    Instrument inst = kv.Key;
			    int id = kv.Value;
			
			    inst.MarketDataUpdate -= OnMarketDataUpdate;
			
			    Print($"{inst.FullName} unsubscribed (ID={id})");
			}

        }

연결 상태 변경 검출

참고 . 닌자트레이더는 provider 와의 연결 끊긴경우 자동 재연결 처리 됨.




// 연결 상태 업데이트 이벤트 구독. Active 이벤트에서 등록. 
Connection.ConnectionStatusUpdate += OnConnectionStatusUpdate;

// 이벤트수신해지. Terminated 에서 
// 이벤트 해제
Connection.ConnectionStatusUpdate -= OnConnectionStatusUpdate;

    private void OnConnectionStatusUpdate(object sender, ConnectionEventArgs e)
    {
        // e.Status를 통해 현재 상태 확인 (Connected, Disconnected, Connecting 등)
        if (e.Status == ConnectionStatus.Disconnected)
        {
            // "Connection Closed" 상황 시 실행할 로직
            NinjaTrader.Code.Output.Process("연결 끊김: " + e.Connection.Options.Name, PrintTo.OutputTab);
        }
        else if (e.Status == ConnectionStatus.Connected)
        {
            NinjaTrader.Code.Output.Process("연결 성공: " + e.Connection.Options.Name, PrintTo.OutputTab);
        }
    }
    
주요 상태 값 (ConnectionStatus)
ConnectionStatus.Connected: 연결 완료
ConnectionStatus.Disconnected: 연결 종료 (음성 메시지가 나오는 시점)
ConnectionStatus.Connecting: 연결 시도 중
ConnectionStatus.Disconnecting: 연결 종료 중

Multi Provider 로 설정된 경우 어떤 공급자의 연결 상태 변경인지 확인 방법.

이벤트 핸들러의 인자 ConnectionEventArgs 객체 안에 포함된 Connection 인스턴스의 Options 속성 이용.

연결 이름 확인: e.Connection.Options.Name (예: "My Rithmic", "IB")
공급자 종류 확인: e.Connection.Options.Provider


private void OnConnectionStatusUpdate(object sender, ConnectionEventArgs e)
{
    // 1. 사용자가 설정한 연결 프로필 이름 확인
    string connectionName = e.Connection.Options.Name;

    // 2. 공급자 기술명 확인 (예: Rithmic, InteractiveBrokers 등)
    string providerName = e.Connection.Options.Provider.ToString();

    // 3. 로그 출력 예시
    NinjaTrader.Code.Output.Process(
        string.Format("공급자: {0} ({1}) - 상태: {2}", 
        connectionName, providerName, e.Status), 
        PrintTo.OutputTab
    );

    // 특정 공급자가 끊겼을 때만 로직 실행
    if (connectionName == "My Data Feed" && e.Status == ConnectionStatus.Disconnected)
    {
        // 해당 공급자 전용 처리 로직
    }
}

Status vs PriceStatus:

e.Connection 객체 내에는 주문 체결 엔진 상태인 Status와 시세 데이터 피드 상태인 PriceStatus가 별도로 있다.

멀티 공급자 모드 활성화:

이 코드가 의도대로 작동하려면 Tools > Settings 클릭하면 아래화면 처럼 보이고 2번 항목 Multi-provider가 체크되어 있어야 하며, 각 연결마다 고유한 이름을 지정해두는 것이 관리에 용이.

닌자스크립트 C# 코드에서 외부 DLL 임포팅해서 활용하는 경우

DLL 파일을 아래 경로에 둬야 한다.

C:\Users\본인계정\Documents\NinjaTrader 8\bin\Custom\

참고 : C# 에서 DLL 활용법 : https://igotit.tistory.com/6414

C# . VC++ DLL 활용 . DllImport

C# 에서 DLL 활용 DLL 에서 정의된 무인자 함수extern "C" __declspec(dllexport) void __stdcall OnActivated_CyNinjaX();extern "C" __declspec(dllexport) void __stdcall OnTerminated_CyNinjaX(); extern "C" → C++ name mangling을 막아서 C-style

igotit.tistory.com

연관

닌자 트레이더 . 개요 . 설치 . 둘러보기

닌자 트레이더 개요 . 특징 - 선물(Futures ,예 : CME 선물 ) 중심의 전문 트레이딩 플랫폼.- 닌자 트레이더 는 프로그램 설치만으로 매매 가능한 구조 아니며 외부 선물브로커,데이터공급자 별도 연

igotit.tistory.com

첫 등록 : 2026.01.17

최종 수정 : 2026.01.20

단축 주소 : https://igotit.tistory.com/6411