# nxpnfcproject/nfc_ncihal_nfc architecture

> Architecture diagram of the GitHub repository nxpnfcproject/nfc_ncihal_nfc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nxpnfcproject/nfc_ncihal_nfc
- Repository: https://github.com/nxpnfcproject/nfc_ncihal_nfc

## Overview

This repository provides Android’s NFC service stack with NXP-specific native support. The principal workflow is NFC service control through a device-host abstraction to the native controller, with discovery events handled as tag, peer-to-peer, or card-emulation activity. Separate branches implement NDEF/Beam sharing, card routing and host emulation, and secure-element access. Edges reflect excerpted calls or the SOURCE INDEX’s explicit references; unsampled implementation details and external wiring are not inferred.

Main entry points: [`src/com/android/nfc/cardemulation/CardEmulationManager.java`](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/CardEmulationManager.java) (Card manager), [`src/com/android/nfc/NfcService.java`](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/NfcService.java) (NFC service), [`nci/jni/NativeNfcManager.cpp`](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/NativeNfcManager.cpp) (NFC JNI manager), [`src/com/android/nfc/P2pLinkManager.java`](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/P2pLinkManager.java) (P2P link manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_service["NFC Service"]
  node_service["NFC service<br/>[NfcService.java]"]
  node_host["Device host API<br/>[DeviceHost.java]"]
end

subgraph group_native["Native Device Layer"]
  node_nativejava["Native manager"]
  node_nativejni["NFC JNI manager"]
  node_tag["Tag operations<br/>[NativeNfcTag.cpp]"]
end

subgraph group_peer["Peer Sharing"]
  node_p2plink["P2P link manager"]
  node_ndefpush["NDEF push"]
  node_snep["SNEP protocol<br/>[SnepServer.java]"]
  node_handover["Handover parser"]
  node_beam["Beam transfer"]
  node_beamrecord["Transfer record"]
end

subgraph group_emulation["Card Emulation"]
  node_cardmanager["Card manager"]
  node_servicecache[("Service registry")]
  node_aidcache[("AID registry")]
  node_aidrouting["AID routing"]
  node_hostemulation["Host emulation"]
  node_nfcid2routing["NFCID2 routing"]
end

subgraph group_secure["Secure Elements"]
  node_secureelement["Secure element<br/>[SecureElement.h]"]
  node_routing["Listen routing<br/>[RoutingManager.cpp]"]
  node_nxpcontroller["NXP controller API"]
end

node_apps(("Android clients"))
node_controller["NFC controller"]
node_externalservices(("External NFC services"))

node_apps -.->|"request NFC"| node_service
node_service -->|"controls device"| node_host
node_host -->|"implemented by"| node_nativejava
node_nativejava -->|"calls native"| node_nativejni
node_nativejni -->|"initializes NFA"| node_controller
node_nativejni -.->|"dispatches tag"| node_tag
node_service -->|"manages peer links"| node_p2plink
node_p2plink -->|"creates server"| node_ndefpush
node_p2plink -->|"creates server"| node_snep
node_p2plink -->|"parses handover"| node_handover
node_p2plink -->|"starts transfer"| node_beam
node_beam -->|"uses record"| node_beamrecord
node_service -->|"coordinates emulation"| node_cardmanager
node_cardmanager -->|"initializes cache"| node_servicecache
node_cardmanager -->|"maintains AIDs"| node_aidcache
node_cardmanager -->|"manages routing"| node_aidrouting
node_cardmanager -.->|"manages host"| node_hostemulation
node_cardmanager -->|"manages NFCID2"| node_nfcid2routing
node_nativejni -->|"uses routing"| node_routing
node_nativejni -->|"uses secure element"| node_secureelement
node_service -->|"exposes NXP APIs"| node_nxpcontroller
node_nxpcontroller -->|"checks certificates"| node_externalservices

click node_service "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/NfcService.java"
click node_host "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/DeviceHost.java"
click node_nativejava "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/src/com/android/nfc/dhimpl/NativeNfcManager.java"
click node_nativejni "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/NativeNfcManager.cpp"
click node_tag "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/NativeNfcTag.cpp"
click node_p2plink "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/P2pLinkManager.java"
click node_ndefpush "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/ndefpush/NdefPushServer.java"
click node_snep "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/snep/SnepServer.java"
click node_handover "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/handover/HandoverDataParser.java"
click node_beam "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/beam/BeamTransferManager.java"
click node_beamrecord "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/beam/BeamTransferRecord.java"
click node_cardmanager "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/CardEmulationManager.java"
click node_servicecache "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/RegisteredServicesCache.java"
click node_aidcache "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/RegisteredAidCache.java"
click node_aidrouting "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/AidRoutingManager.java"
click node_hostemulation "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/HostEmulationManager.java"
click node_nfcid2routing "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/Nfcid2RoutingManager.java"
click node_secureelement "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/SecureElement.h"
click node_routing "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/RoutingManager.cpp"
click node_nxpcontroller "https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/src/com/gsma/nfc/internal/NxpNfcController.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_service,node_host,node_apps toneBlue
class node_nativejava,node_nativejni,node_tag toneAmber
class node_p2plink,node_ndefpush,node_snep,node_handover,node_beam,node_beamrecord toneMint
class node_cardmanager,node_servicecache,node_aidcache,node_aidrouting,node_hostemulation,node_nfcid2routing toneRose
class node_secureelement,node_routing,node_nxpcontroller,node_controller,node_externalservices toneIndigo
```

## Components

### NFC Service

- [NFC service](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/NfcService.java): `src/com/android/nfc/NfcService.java`
- [Device host API](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/DeviceHost.java): `src/com/android/nfc/DeviceHost.java`

### Native Device Layer

- [Native manager](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/src/com/android/nfc/dhimpl/NativeNfcManager.java): `nci/src/com/android/nfc/dhimpl/NativeNfcManager.java`
- [NFC JNI manager](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/NativeNfcManager.cpp): `nci/jni/NativeNfcManager.cpp`
- [Tag operations](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/NativeNfcTag.cpp): `nci/jni/NativeNfcTag.cpp`

### Peer Sharing

- [P2P link manager](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/P2pLinkManager.java): `src/com/android/nfc/P2pLinkManager.java`
- [NDEF push](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/ndefpush/NdefPushServer.java): `src/com/android/nfc/ndefpush/NdefPushServer.java`
- [SNEP protocol](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/snep/SnepServer.java): `src/com/android/nfc/snep/SnepServer.java`
- [Handover parser](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/handover/HandoverDataParser.java): `src/com/android/nfc/handover/HandoverDataParser.java`
- [Beam transfer](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/beam/BeamTransferManager.java): `src/com/android/nfc/beam/BeamTransferManager.java`
- [Transfer record](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/beam/BeamTransferRecord.java): `src/com/android/nfc/beam/BeamTransferRecord.java`

### Card Emulation

- [Card manager](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/CardEmulationManager.java): `src/com/android/nfc/cardemulation/CardEmulationManager.java`
- [Service registry](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/RegisteredServicesCache.java): `src/com/android/nfc/cardemulation/RegisteredServicesCache.java`
- [AID registry](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/RegisteredAidCache.java): `src/com/android/nfc/cardemulation/RegisteredAidCache.java`
- [AID routing](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/AidRoutingManager.java): `src/com/android/nfc/cardemulation/AidRoutingManager.java`
- [Host emulation](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/HostEmulationManager.java): `src/com/android/nfc/cardemulation/HostEmulationManager.java`
- [NFCID2 routing](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/src/com/android/nfc/cardemulation/Nfcid2RoutingManager.java): `src/com/android/nfc/cardemulation/Nfcid2RoutingManager.java`

### Secure Elements

- [Secure element](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/SecureElement.h): `nci/jni/SecureElement.h`
- [Listen routing](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/jni/RoutingManager.cpp): `nci/jni/RoutingManager.cpp`
- [NXP controller API](https://github.com/nxpnfcproject/nfc_ncihal_nfc/blob/master/nci/src/com/gsma/nfc/internal/NxpNfcController.java): `nci/src/com/gsma/nfc/internal/NxpNfcController.java`

### Other components

- **Android clients**
- **NFC controller**
- **External NFC services**

## Connections

- Android clients → NFC service: request NFC
- NFC service → Device host API: controls device (evidence: `src/com/android/nfc/NfcService.java`)
- Device host API → Native manager: implemented by (evidence: `nci/src/com/android/nfc/dhimpl/NativeNfcManager.java`)
- Native manager → NFC JNI manager: calls native (evidence: `nci/src/com/android/nfc/dhimpl/NativeNfcManager.java`)
- NFC JNI manager → NFC controller: initializes NFA (evidence: `nci/jni/NativeNfcManager.cpp`)
- NFC JNI manager → Tag operations: dispatches tag
- NFC service → P2P link manager: manages peer links (evidence: `src/com/android/nfc/NfcService.java`)
- P2P link manager → NDEF push: creates server (evidence: `src/com/android/nfc/P2pLinkManager.java`)
- P2P link manager → SNEP protocol: creates server (evidence: `src/com/android/nfc/P2pLinkManager.java`)
- P2P link manager → Handover parser: parses handover (evidence: `src/com/android/nfc/P2pLinkManager.java`)
- P2P link manager → Beam transfer: starts transfer (evidence: `src/com/android/nfc/P2pLinkManager.java`)
- Beam transfer → Transfer record: uses record (evidence: `src/com/android/nfc/beam/BeamTransferManager.java`)
- NFC service → Card manager: coordinates emulation (evidence: `src/com/android/nfc/NfcService.java`)
- Card manager → Service registry: initializes cache (evidence: `src/com/android/nfc/cardemulation/CardEmulationManager.java`)
- Card manager → AID registry: maintains AIDs (evidence: `src/com/android/nfc/cardemulation/CardEmulationManager.java`)
- Card manager → AID routing: manages routing (evidence: `src/com/android/nfc/cardemulation/CardEmulationManager.java`)
- Card manager → Host emulation: manages host (evidence: `src/com/android/nfc/cardemulation/CardEmulationManager.java`)
- Card manager → NFCID2 routing: manages NFCID2 (evidence: `src/com/android/nfc/cardemulation/CardEmulationManager.java`)
- NFC JNI manager → Listen routing: uses routing (evidence: `nci/jni/NativeNfcManager.cpp`)
- NFC JNI manager → Secure element: uses secure element (evidence: `nci/jni/NativeNfcManager.cpp`)
- NFC service → NXP controller API: exposes NXP APIs (evidence: `src/com/android/nfc/NfcService.java`)
- NXP controller API → External NFC services: checks certificates (evidence: `nci/src/com/gsma/nfc/internal/NxpNfcController.java`)
