Project
unilink
TCP, UDP, Serial, UDS를 단일 C++ 비동기 인터페이스로 다루기 위한 통신 라이브러리와 설계 문서 모음입니다.
최신 업데이트: 2026.07.02
Series
- 2026.05.31
unilink 설계 노트 1
설계 배경
- 2026.05.31
unilink 설계 노트 2
Unified API 설계
- 2026.05.31
unilink 설계 노트 3
Builder API 설계
- 2026.06.02
unilink 설계 노트 4
Wrapper 계층 설계
- 2026.06.02
unilink 설계 노트 5
Transport 계층 설계
- 2026.06.02
unilink 설계 노트 6
ChannelFactory 설계
- 2026.06.02
unilink 설계 노트 7
Channel 추상화 설계
- 2026.06.03
unilink 설계 노트 8
RuntimeStats와 Diagnostics 설계
- 2026.06.03
unilink 설계 노트 9
Memory / buffer 설계
- 2026.06.03
unilink 설계 노트 10
Framer 계층 설계
- 2026.06.03
unilink 설계 노트 11
Backpressure 설계
- 2026.06.03
unilink 설계 노트 12
설계 회고
Related Writing
- 2026.07.02unilinkDevlog
TCP_NODELAY 트러블슈팅
TCP 44ms latency spike와 tcp_no_delay 기본값 개선
- 2026.07.02unilinkDevlog
UDP backpressure 데드락 트러블슈팅
UDP backpressure 데드락 재현과 lost wakeup 원인 분석
- 2026.06.03unilinkDesign
Backpressure 설계
Reliable / BestEffort 채널에서 send(), queue pressure, drop 정책, backpressure 처리 기준을 정리합니다.
- 2026.06.03unilinkDesign
Framer 계층 설계
TCP와 Serial의 raw byte stream을 애플리케이션이 처리할 message 단위로 나누는 Framer 계층의 경계를 정리했다.
- 2026.06.03unilinkDesign
Memory / buffer 설계
비동기 통신에서 buffer lifetime, ownership, zero-copy 선택이 안전성과 성능에 미치는 영향을 기준으로 정리했다.
- 2026.06.03unilinkDesign
RuntimeStats와 Diagnostics 설계
연결 상태, 송수신량, drop, queue pressure를 RuntimeStats와 Diagnostics로 관측 가능하게 만드는 설계를 정리했다.
- 2026.06.03unilinkRetrospective
설계 회고
unilink를 기능 구현에서 테스트, 패키징, 문서화, 릴리즈 준비까지 사용할 수 있는 라이브러리로 다듬은 과정을 회고했다.
- 2026.06.02unilinkDesign
Channel 추상화 설계
TCP, UDP, Serial, UDS의 차이를 숨기고 애플리케이션이 의존할 공통 Channel 계약을 설계한 기준을 정리했다.
- 2026.06.02unilinkDesign
ChannelFactory 설계
Config를 기반으로 concrete Channel 구현체를 생성하고 Wrapper가 transport 선택을 직접 알지 않도록 분리한 구조를 정리했다.
- 2026.06.02unilinkDesign
Transport 계층 설계
Channel 추상화를 실제 socket, serial port, event loop 기반 비동기 I/O 구현으로 연결하는 transport 계층을 정리했다.
- 2026.06.02unilinkDesign
Wrapper 계층 설계
Public API와 transport 구현 사이에서 수명, callback, 실행 상태를 조율하는 Wrapper 계층의 역할과 책임을 정리했다.
- 2026.05.31unilinkDesign
Builder API 설계
CRTP, Concepts, Fluent API를 활용해 복잡한 통신 객체 설정을 안전하고 읽기 쉬운 생성 흐름으로 구성한 과정을 정리했다.
- 2026.05.31unilinkDesign
Unified API 설계
Facade, Builder, Wrapper를 조합해 여러 transport를 일관된 public API로 다루는 설계 방향을 정리했다.
- 2026.05.31unilinkDesign
설계 배경
TCP, UDP, Serial, UDS를 하나의 개발 경험으로 묶기 위해 unilink가 선택한 설계 배경과 목표를 정리했다.