Iksung.Reader SDK > DOC / SDK | 익성전자

Iksung.Reader SDK

페이지 정보

작성자 admin
댓글 0건 조회 18회 작성일 26-05-13 22:06

본문

IKSUNG.READER .NET SDK · NuGet · MIT 라이선스 · async / await · 크로스 플랫폼

Iksung.Reader .NET SDK

익성전자 NFC/RFID 리더기용 공식 .NET SDK. .NET 8 + .NET Framework 4.7.2 듀얼 타겟, Serial · USB CCID (PC/SC) · TCP Socket 3 채널 통합, async/await 전체 지원, Windows · Linux · macOS 크로스 플랫폼.

NuGet
MIT 라이선스
.NET 8 + 4.7.2
Cross-Platform

NFC · RFID 리더기 응용 개발 SDK

Iksung.Reader 는 익성전자의 모든 NFC/RFID 리더기 라인업 (IS-200 / 240 / 270 / 3400 / 3500 / 4300A1 / ISM-3500 등) 을 단일 .NET API 로 다룰 수 있는 공식 SDK 입니다. ISO14443 A/B · Mifare 전 라인업 · ISO15693 · FeliCa · NFC HCE · DESFire · ISO-7816 USIM · Bluetooth 5.0 · LF 125 kHz · Wiegand · 릴레이 I/O 까지 단일 SDK 에서 처리합니다.

기존 D2xx 기반 동기/콜백 라이브러리(V3.2) 의 후속 SDK 로, async/await 전체 API · NuGet 패키지 · 채널 추상화 (Serial · PC/SC · Socket) · 자동 재연결 · Raw 패킷 로그 등 현대적 .NET 개발자 친화 기능을 제공합니다.

▍ HELLO WORLD


using Iksung.Reader;



await using var reader = await

    IksungReader.ConnectSerialAsync("COM3");



// 버전 읽기

string fw = await reader.ReadVersionAsync();



// 카드 UID

byte[] uid = await

    reader.ReadIso14443aUidAsync();

▲ Hello World — 3 줄로 카드 UID

▍ NuGet 패키지

dotnet add package Iksung.Reader

▶ GitHub 저장소 (소스)

Michael202301/ISReaderPro.Sdk

▼ 통합 매뉴얼 PDF

16 챕터 + API 레퍼런스 (3 MB)

한눈에 보는 Iksung.Reader SDK

NuGet

Iksung.Reader
패키지 1줄 설치

3 채널

Serial · PC/SC
· TCP Socket

async

전체 API
await 비동기

31 샘플

NET4x 16종
+ NET8 15종

▍ WHY Iksung.Reader SDK

▶ 크로스 플랫폼 — Windows · Linux · macOS · ARM 까지 .NET 8 단일 코드 베이스
▶ 채널 추상화 — Serial · PC/SC · TCP Socket 동일 API · 채널 교체 시 코드 무수정
▶ async/await 전체 — UI freeze 없음, CancellationToken 전체 지원
▶ .NET Framework 4.7.2 듀얼 타겟 — 레거시 WinForms / WPF 응용도 그대로 사용
▶ 자동 재연결 · Raw 패킷 로그 — AutoReconnect · RawPacketReceived 이벤트
▶ 통합 사용 설명서 + API 레퍼런스 — 16 챕터 · 6,700 줄 · A4 PDF · GitHub Markdown
▶ MIT 라이선스 — 상용 · 비상용 · 로열티 없이 자유 사용

핵심 특징

▸ 3 채널 통합 (Serial / PC/SC / Socket) ConnectSerialAsync / ConnectPcscAsync 두 팩토리 메서드. 채널이 달라도 카드 명령 API 는 동일 — Mifare · DESFire · ISO15693 · BLE · Wiegand 모두 같은 코드.	▸ AutoRead 이벤트 모드 `TagDetected` 이벤트로 카드 감지 시 자동 알림. UID · CardType · RawData 한 번에 — 폴링 루프 불필요.
▸ 다중 카드 표준 (12 종) ISO14443 A/B · Mifare Classic · Plus (SL1/SL3) · Ultralight · NTAG · DESFire EV1/EV2/EV3 · ISO15693 SLIX1/SLIX2 · FeliCa · NFC HCE · LF 125 kHz · ISO-7816 USIM	▸ 시스템 진단 / 안정성 `PingAsync` · `GetReaderInfoAsync` · AutoReconnect · RawPacketReceived 이벤트 — 운영 환경 디버깅과 안정성을 SDK 단에서 제공.

빠른 시작 — 30 초 안에 카드 읽기

#	단계
1	.NET 8 콘솔 프로젝트 생성 dotnet new console -n MyReader && cd MyReader
2	SDK 패키지 추가 dotnet add package Iksung.Reader
3	Program.cs 작성 using Iksung.Reader; await using var reader = await IksungReader.ConnectSerialAsync("COM3"); Console.WriteLine($"FW: {await reader.ReadVersionAsync()}"); byte[] uid = await reader.ReadIso14443aUidAsync(); Console.WriteLine($"UID: {BitConverter.ToString(uid).Replace("-", "")}");
4	실행 dotnet run → 리더기 위에 카드를 올리면 펌웨어 버전 + UID 가 출력됩니다.

실행 가능한 샘플 코드 — 31 종

모든 샘플은 실제로 빌드 · 실행 가능한 콘솔 프로젝트입니다. .NET 8 와 .NET Framework 4.7.2 두 버전을 동일 시나리오로 제공.

#	샘플	내용
01	ReadAnyUid	UID 폴링 (ISO14443A/B · ISO15693 · LF)
02	Iso14443a	ISO 14443-A Layer-3/4 + APDU 교환
03	MifareClassic	Key A/B 인증 + 블록 R/W
04	MifareUltralight	페이지 덤프 · 쓰기
05	Iso15693	멀티블록 읽기 · SLIX1/SLIX2
06	AutoRead	이벤트 기반 자동 인식 (`TagDetected`)
07	Desfire	EV1/EV2/EV3 앱·파일·AES 인증·트랜잭션
08	NTag213	버전 · ECC 서명 · 카운터
09	Lf125KhzAdvanced	EM410X · ISO11784 · SECOM · Temic
10	Iso7816	USIM ATR · TPDU · ICCID 읽기
11	Bluetooth	BLE 이름 · MAC · TX 파워 · GAP 설정
12	Relay	DIN 입력 · 릴레이 출력 · Auto-Off
13	CommandConsole	대화형 RAW 명령 콘솔
14	SystemFeatures	Ping · ReaderInfo · AutoReconnect · Raw 패킷
15	PcscChannel	PC/SC (CCID) 채널 — Windows · Linux
+1	WinFormsIntegration	.NET 4.x WinForms `Invoke()` 패턴

※ 모든 샘플은 GitHub 저장소의 NET4x-Samples/ · NET8-Samples/ 폴더에서 바로 클론 후 실행 가능합니다.

다운로드 / 소스 코드

방식	상세
NuGet 패키지	Visual Studio 패키지 관리자 또는 CLI 로 설치 (권장 — 자동 의존성 관리): dotnet add package Iksung.Reader
GitHub 저장소 (소스)	SDK 본체 + 31 종 샘플 + 통합 매뉴얼 — 자유롭게 클론·포크 가능 (MIT): git clone https://github.com/Michael202301/ISReaderPro.Sdk.git ▶ github.com/Michael202301/ISReaderPro.Sdk
NuGet.org 패키지	패키지 검색 — Visual Studio NuGet 관리자 또는 nuget.org 에서 Iksung.Reader 검색: dotnet add package Iksung.Reader 정식 게시 후 nuget.org 검색으로 바로 설치할 수 있습니다 (현재 게시 준비 중).
통합 매뉴얼 PDF	A4 PDF · 약 3 MB · 16 챕터 + API 레퍼런스 + .NET Framework 4.x 가이드 — 본 게시물 첨부파일 파일명: `Iksung_Reader_SDK_Manual.pdf`
소스 코드 zip	GitHub 의 Releases 페이지에서 태그된 버전별 zip 다운로드 가능. Git 사용을 원치 않는 환경에서는 zip 으로 받아 그대로 사용하세요. ▶ GitHub Releases

라이선스 / 지원

라이선스	MIT License — 상용 · 비상용 · 로열티 없이 자유 사용. 재배포 시 LICENSE.md 포함만 유지.
지원 플랫폼	Windows · Linux · macOS (.NET 8) / Windows (.NET Framework 4.7.2)
지원 채널	Serial (UART 115200) · USB CCID (PC/SC) · TCP Socket
지원 제품	IS-200 · IS-240 · IS-270 · IS-3400 V6 · IS-3400A · IS-3500 · IS-400 · IS-4300A1 · ISM-3500
이슈 / 기능 요청	GitHub Issues 사용 — ▶ github.com/Michael202301/ISReaderPro.Sdk/issues

SDK 도입 / 통합 개발 문의

.NET 응용 통합 · 커스텀 펌웨어 연동 · OEM 통합 / 라이선스 / 교육 등 SDK 관련 모든 문의를 환영합니다.

㈜익성전자 | TEL 070-8237-5078 | jch1002@iksung.co.kr

▶ github.com/Michael202301/ISReaderPro.Sdk |
[NuGet] dotnet add package Iksung.Reader |
[License] MIT

아래 첨부에서 Iksung_Reader_SDK_Manual.pdf (통합 사용 설명서 · 16 챕터 + API 레퍼런스) 를 받으실 수 있습니다.

SDK · 드라이버 · 도구 다운로드

항목 (클릭 시 다운로드)	파일명	크기	업로드
▼ Iksung_Reader_SDK_Manual.pdf	Iksung_Reader_SDK_Manual.pdf	3.0M	2026-05-13
▼ ISReaderPro.Sdk-V1.00.zip	ISReaderPro.Sdk-V1.00.zip	2.1M	2026-05-13
▼ SDK_TestConsole_Manual.pdf	SDK_TestConsole_Manual.pdf	2.4M	2026-05-13

항목명을 클릭하면 파일이 다운로드됩니다. 압축 파일은 별도 도구로 해제하시기 바랍니다.

다음글ISReaderPro 26.05.13