2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Android 독점 NCI 명령어
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

NFC 컨트롤러 인터페이스 (NCI)는 NFC 컨트롤러 (NFCC)와 상호작용하는 데 사용됩니다. 이 페이지에서는 Android 독점 NCI 명령어의 사양을 설명합니다.

NCI 정의

Android 독점 NCI 명령어는 독점 그룹 ID (GID) 0xF 및 Android opcode 식별자 (OID) 코드 스페이스 0xC를 사용합니다.

공통 패킷 형식

Android NCI 패킷 형식은 독점 Group_ID 0xF 및 Opcode_ID 0x0C를 사용하는 제어 패킷의 NCI 사양을 따릅니다. 각 Android 독점 메시지의 경우 패킷 페이로드의 첫 번째 바이트는 Android opcode (0x0C)로 설정해야 합니다. Android 제어 패킷은 표준 명령어와 마찬가지로 명령어, 응답, 알림을 식별하는 데 Message_Type 및 PBF를 사용합니다.

Android 패킷 형식은 다음 표에 나와 있습니다.

0	1	2	3	4	5	6	7
`Message_Type`			`PBF`	`Group_ID = 0xF (PROPRIETARY)`
나중에 사용하기 위해 예약됨 (RFU)		`Opcode_ID = 0x0C (ANDROID)`
`Payload_Length`
`Android_Opcode_ID`
`Android_Payload`

할당된 Android opcode 식별자는 다음 표에 나와 있습니다. 각 패킷의 사양은 다음 섹션에서 설명합니다.

Android OID	메시지 유형	메시지 이름
0x00	NCI_MT_CMD	`NCI_ANDROID_GET_CAPS_CMD`
0x00	NCI_MT_RSP	`NCI_ANDROID_GET_CAPS_RSP`
0x01	NCI_MT_CMD	`NCI_ANDROID_POWER_SAVING_CMD`
0x01	NCI_MT_RSP	`NCI_ANDROID_POWER_SAVING_RSP`
0x02	NCI_MT_CMD	`NCI_ANDROID_PASSIVE_OBSERVE_MODE_CMD`
0x02	NCI_MT_RSP	`NCI_ANDROID_PASSIVE_OBSERVE_MODE_RSP`
0x03	NCI_MT_NTF	`NCI_ANDROID_POLLING_FRAME_NTF`
0x04	NCI_MT_CMD	`NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_CMD`
0x04	NCI_MT_RSP	`NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_RSP`

기능 가져오기 명령어

호스트는 NCI_ANDROID_GET_CAPS_CMD를 사용하여 NFCC에서 지원하는 Android 독점 기능 목록을 쿼리합니다. NCI_ANDROID_GET_CAPS_CMD 명령어는 매개변수를 사용하지 않습니다.

NFCC는 STATUS_OK 상태와 지원되는 기능 및 기능 목록이 포함된 NCI_ANDROID_GET_CAPS_RSP 응답으로 응답해야 합니다.

NFCC가 NCI_ANDROID_GET_CAPS_CMD를 지원하지 않으면 호스트는 각 기능이 지정된 기본값을 사용한다고 가정해야 합니다. 지정된 기능이 NFCC에서 응답으로 반환되지 않으면 호스트는 기능에 지정된 기본값이 있다고 가정해야 합니다.

NCI_ANDROID_GET_CAPS_CMD

페이로드 필드	크기	값/설명
해당 사항 없음	0옥텟

NCI_ANDROID_GET_CAPS_RSP

페이로드 필드	크기	값/설명
상태	1옥텟	NCI 사양의 표 140에서 상태 코드를 확인하세요.
`Android_Version`	2옥텟	NFCC에서 구현한 Android 요구사항 버전을 식별합니다.
`Android_Version`	2옥텟	0x0000		Android 15
기능 수	1옥텟	지원되는 기능 수 (n)
Capabilities[0..n]	(m + 2) * n 옥텟	지원되는 기능
		유형	1옥텟		기능의 식별자
		렌	1옥텟		값의 길이 (m)
		값	m옥텟		기능의 값

Android 독점 기능

기능 이름	ID	크기	값/설명
관찰 모드	0x00	1옥텟	관찰 모드 지원 0x00 (기본값) - 이 기능을 지원하지 않습니다. 0x01 - 호스트의 RF 비활성화 기능을 지원합니다 (Android 15 이상 필요). 그 외 모든 값은 RFU입니다.
폴링 프레임 알림	0x01	1옥텟	폴링 프레임 알림 지원 지원되는 경우 0x01이고 지원되지 않는 경우 0x00 (기본값)입니다. 그 외 모든 값은 RFU입니다.
절전 모드	0x02	1옥텟	절전 모드 지원 지원되는 경우 0x01이고 지원되지 않는 경우 0x00 (기본값)입니다. 그 외 모든 값은 RFU입니다.
Auotransact 폴링 루프 필터	0x03	1옥텟	관찰 모드가 전역적으로 사용 설정된 경우 특정 패턴의 관찰 모드를 우회하는 펌웨어의 폴링 루프 필터를 지원합니다. 0x00 (기본값) - 이 기능을 지원하지 않음 0x01 - 폴링 루프 필터를 지원함 기타 모든 값은 RFU입니다.
	0x04..0xFF	0옥텟	나중에 사용하기 위해 예약됨

절전 명령어

NFCC를 절전 모드로 전환하려면 호스트가 NCI_ANDROID_POWER_SAVING_CMD 명령어를 사용할 수 있습니다. NFCC는 성공 또는 실패를 나타내는 상태 코드와 함께 NCI_ANDROID_POWER_SAVING_RSP로 응답해야 합니다.

절전 모드에서는 호스트가 NFCC에 명령을 전송해서는 안 되며 NFCC는 호스트에 알림이나 응답을 전송해서는 안 됩니다. NFCC 또는 삽입된 보안 칩 (eSE)은 절전 모드를 사용 설정하기 전에 설정된 라우팅 구성에 따라 수신되는 결제 요청을 자동으로 수락할 수 있습니다.

전체 전원 모드로 돌아가려면 호스트가 NFCC를 재설정하거나 다시 초기화할 수 있습니다.

NCI_ANDROID_POWER_SAVING_CMD

페이로드 필드	크기	값/설명
절전 모드	1옥텟	0x00	절전 모드 사용 중지
절전 모드	1옥텟	0x01	절전 모드 사용 설정

NCI_ANDROID_POWER_SAVING_RSP

페이로드 필드	크기	값/설명
상태	1옥텟	NCI 사양의 표 140에서 상태 코드를 참고하세요.

관찰 모드 설정 명령어

호스트는 관찰 모드를 활성화 또는 비활성화하기 위해 NCI_ANDROID_PASSIVE_OBSERVE_MODE_CMD 명령어를 사용할 수 있습니다. NFCC는 성공 또는 실패를 나타내는 상태 코드와 함께 NCI_ANDROID_PASSIVE_OBSERVE_MODE_RSP로 응답해야 합니다.

관찰 모드가 사용 중지되면 NFCC는 활동 기술 사양에 따라 표준 수신 모드 활동을 구현해야 합니다.

관찰 모드가 활성화된 경우 NFCC는 호스트가 명시적으로 승인할 때까지 리슨 모드의 폴링 루프 중에 폴링 요청에 응답해서는 안 됩니다. NFCC는 필드 활성화를 감지하면 RF_FIELD_INFO_NTF 알림 (NCI 사양 섹션 5.3에 정의됨)을 전송해야 합니다. 폴링 모드 검색이 활성화된 경우 NFCC는 활동 기술 사양에 따라 폴링 모드 활동을 구현해야 합니다. NFCC는 관찰 모드가 비활성화되는 즉시 기기 활성화를 즉시 진행할 수 있도록 폴 정보 캐시할 수 있습니다.

NFCC는 SE 트랜잭션을 진행할 수 있도록 어떤 이유로든(예: 배터리 부족 또는 사용자가 시작한 종료) 호스트가 종료되면 관찰 모드를 사용 중지해야 합니다.

NCI_ANDROID_PASSIVE_OBSERVE_MODE_CMD

페이로드 필드	크기	값/설명
관찰 모드	1옥텟	0x00	관찰 모드 사용 중지 (기본값)
관찰 모드	1옥텟	0x01	관찰 모드 사용 설정

NCI_ANDROID_PASSIVE_OBSERVE_MODE_RSP

페이로드 필드	크기	값/설명
상태	1옥텟	NCI 사양의 표 140에서 상태 코드를 확인하세요.

폴링 루프 알림

NFCC는 각 폴링 루프 프레임 후에 NCI_ANDROID_POLLING_FRAME_NTF 알림을 호스트에 전송해야 합니다. RF_FIELD_INFO_NTF 및 NCI_ANDROID_POLLING_FRAME_NTF 알림이 모두 생성되면 NFCC는 RF_FIELD_INFO_NTF 다음에 NCI_ANDROID_POLLING_FRAME_NTF를 전송해야 합니다.

NCI_ANDROID_POLLING_FRAME_NTF 알림은 관찰 모드가 활성 상태인지와 관계가 없습니다. 관찰 모드가 활성화된 경우 NFCC는 항상 거래를 진행하기 전에 NCI_ANDROID_POLLING_FRAME_NTF 알림을 전송해야 합니다.

NCI_ANDROID_POLLING_FRAME_NTF

페이로드 필드	크기	값/설명
Polling Data[0..n]	(m +3) * n 옥텟	마지막 알림 이후 수신된 폴링 요청 목록입니다. 각 결과는 수신된 요청의 유형 (기술)과 기술에 따라 요청에서 식별 가능한 데이터를 제공합니다.
		유형	1옥텟	프레임 유형을 참고하세요.
		플래그	1옥텟	플래그 바이트를 참고하세요.
		길이	1옥텟	타임스탬프 및 이득 필드를 포함한 폴링 데이터 보고서의 길이 (m)입니다.
		타임스탬프	4옥텟	폴링 요청 수신 시점부터 경과된 시간을 밀리초로 측정한 타임스탬프(빅엔디언)입니다.
		이득	1옥텟	폴링 요청의 강도입니다. 0xFF는 값을 사용할 수 없음을 나타냅니다.
		데이터	m - 5옥텟	폴링 요청에 있는 식별 가능한 데이터를 반환합니다.

프레임 유형

폴링 프레임	유형	크기	값/설명
원격 필드	0x00	1옥텟	0x00	필드 꺼짐
			0x01	필드 사용 설정
			0x02..0xFF	RFU
NFC-A	0x01	n옥텟	값에 ISO 14443-3 명령어 (예: REQ 또는 WUP)가 포함되어야 합니다.
NFC-B	0x02	n옥텟	값에는 AIF 바이트와 ISO 14443-3 명령어(예: REQ 또는 WUP)가 포함되어야 합니다.
NFC-F	0x03	n옥텟	값에 ISO 14443-3 명령어 (예: REQ 또는 WUP)가 포함되어야 합니다.
NFC-V	0x04	n옥텟	값에 ISO 14443-3 명령어 (예: REQ 또는 WUP)가 포함되어야 합니다.
알 수 없음	0x07	n옥텟	원시 프레임 데이터

플래그 바이트 정의

플래그
b0		b1	b2	b3	b4	b5	b6	b7
0	짧은 프레임	RFU	RFU	RFU	RFU	RFU	RFU	RFU
1	긴 프레임	RFU	RFU	RFU	RFU	RFU	RFU	RFU

관찰 모드 상태 쿼리 명령어

호스트는 수동 순서 모드의 현재 상태를 검색하기 위해 NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_CMD 명령어를 사용할 수 있습니다. NFCC는 성공 또는 실패를 나타내는 상태 코드와 함께 NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_RSP로 응답해야 합니다.

NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_CMD

페이로드 필드	크기	값/설명
해당 사항 없음	0옥텟

NCI_ANDROID_QUERY_PASSIVE_OBSERVER_STATUS_RSP

페이로드 필드	크기	값/설명
상태	1옥텟	NCI 사양의 표 140에서 상태 코드를 참고하세요.
관찰 모드	1옥텟	0x00	관찰 모드 사용 중지됨
관찰 모드	1옥텟	0x01	관찰 모드 사용 설정됨

Android 독점 NCI 명령어컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.