Lite-On Custom PiP User Manual

IDP-05-L1 Dispositivo NFC Standalone OEM PiP Personalizatu Lite-On

Copyright © 2022 International Technologies and Systems Corporation. Tutti i diritti riservati.
ID TECH
10721 Walker Street
Cypress, CA 90630 USA
Stu documentu, cum'è u hardware è u software chì descrive, hè furnitu sottu licenza è pò esse usatu solu in cunfurmità cù i termini di tale licenza. U cuntenutu di stu documentu hè furnitu per usu informativu, sottumessu à cambià senza avvisu, è ùn deve esse interpretatu cum'è un impegnu da ID TECH. ID TECH ùn assume alcuna rispunsabilità o responsabilità per eventuali errori o imprecisioni chì ponu appare in stu documentu.
Eccettu cum'è permessu da una tale licenza, nisuna parte di sta publicazione pò esse riprodotta o trasmessa per mezu elettronicu, meccanicu, registratu, o qualsiasi altru mètudu, o traduttu in un'altra lingua o forma di lingua senza l'accunsentu scrittu espresso di ID TECH. ID TECH hè una marca registrata di International
Tecnulugia è Sistemi Corporation. ViVOpay è Value through Innovation sò marchi di International Technologies and Systems Corporation. L'altri marchi sò a pruprietà di u rispettivu pruprietariu.
Disclaimer di Garanzia: I servizii è u hardware sò furniti "cum'è" è "cum'è dispunibile", è l'usu di sti servizii è hardware sò à u risicu di l'utilizatori. ID TECH ùn face micca, è declina quì, qualsiasi è tutte e altre garanzie espresse o implicite, cumprese, ma senza limitazione, garanzie di cummerciabilità, titulu, idoneità per un scopu particulare, è qualsiasi garanzie derivanti da qualsiasi cursu di trattu, usu, o. pratica di cummerciu. ID TECH ùn garantisce micca chì i servizii o hardware seranu ininterrotti, senza errore, o cumpletamente sicuri.

Dichjarazione di Interferenza di a Cummissione Federale di Comunicazione
Stu dispusitivu hè conforme à a Parte 15 di e regule FCC. U funziunamentu hè sottumessu à i seguenti dui cundizioni:

1. Stu dispusitivu ùn pò causari interferenza dannusu, è
2. stu dispusitivu deve accettà ogni interferenza ricevuta, cumpresi interferenza chì pò causà operazione indesiderata.

Stu equipamentu hè statu pruvatu è truvatu cum'è i limiti per un dispositivu digitale di Classe B, in cunfurmità cù a Parte 15 di e Regule FCC. Questi limiti sò pensati per furnisce una prutezzione raghjone contr'à l'interferenza dannosa in una stallazione residenziale. Stu equipamentu genera, usa è pò irradià energia di freccia radio è, s'ellu ùn hè micca stallatu è utilizatu in cunfurmità cù l'istruzzioni, pò causà interferenza dannosa à e cumunicazioni radio. Tuttavia, ùn ci hè micca guaranzia chì l'interferenza ùn accade micca in una installazione particulare. Se stu equipamentu provoca interferenze dannusu à a ricezione di a radiu o di a televisione, chì pò esse determinata spegnendu è accendendu l'equipaggiu, l'utilizatore hè incuraghjitu à pruvà à corregge l'interferenza cù una di e seguenti misure:

• Riorientate o rilocate l'antenna di ricezione.
• Aumente a separazione trà l'equipaggiu è u ricevitore.
• Cunnette l'equipaggiu in una presa in un circuitu diversu da quellu à quale hè cunnessu u ricevitore.
• Cunsultate u rivenditore o un tecnicu espertu di radio/TV per aiutu.

Attenzione FCC: Ogni cambiamentu o mudificazione chì ùn hè micca espressamente appruvatu da a parte rispunsevuli di u cumplimentu puderia annullà l'autorità di l'utilizatori à operà stu equipamentu.
Stu trasmettitore ùn deve micca esse situatu o operatu in cunghjunzione cù qualsiasi altra antenna o trasmettitore.
Dichjarazione di l'esposizione à a radiazione:
U pruduttu hè conforme à u limitu di esposizione RF portatile FCC stabilitu per un ambiente micca cuntrullatu è hè sicuru per u funziunamentu previstu cum'è descrittu in stu manuale. L'ulteriore riduzione di l'esposizione RF pò esse ottenuta se u pruduttu pò esse tenutu u più luntanu pussibule da u corpu di l'utilizatore o stabilisce u dispusitivu per abbassà a putenza di output se tale funzione hè dispunibule.
Stu modulu hè destinatu solu à l'integratori OEM. Per FCC KDB 996369 D03 OEM Manual v01 guida, e seguenti cundizioni devenu esse strettamente seguite quandu si usa stu modulu certificatu:
KDB 996369 D03 Manuale OEM v01 sezioni di regula:
2.2 Lista di e regule FCC applicabili
Stu modulu hè statu pruvatu per a conformità à a parte 15 di a FCC
2.3 Riassuntu i cundizioni specifichi di usu upirativu
U modulu hè pruvatu per a cundizione d'usu di l'esposizione mobile RF standalone. Ogni altra cundizione d'usu cum'è a co-location cù altri trasmettitori o esse aduprate in una cundizione portatile necessitarà una rivalutazione separata per mezu di una applicazione di cambiamentu permissivu di classe II o una nova certificazione.
2.4 Prucedure di modulu limitatu Ùn hè micca applicabile.
2.5 Disegni di l'antenna di traccia Non applicabile.
2.6 Considerazioni di l'esposizione RF
Stu equipamentu hè in cunfurmità cù i limiti di l'esposizione à a radiazione mobile FCC stabiliti per un ambiente incontrolatu. Stu equipamentu deve esse stallatu è operatu cù una distanza minima di 20 cm trà u radiatore è u vostru corpu. Se u modulu hè stallatu in un host portable, una valutazione SAR separata hè necessaria per cunfirmà a conformità cù e regule pertinenti di l'esposizione RF portatile FCC.
2.7 antenne
I seguenti antenni sò stati certificati per l'usu cù stu modulu; antenne di u listessu tipu cù guadagnu uguali o più bassu pò ancu esse aduprate cù stu modulu. L'antenna deve esse stallata cusì chì 20 cm pò esse mantinutu trà l'antenna è l'utilizatori.

Tipu d'antenna	Antenna Loop
Connettore d'antenna	N/A

2.8 Etichetta è infurmazione di cunfurmità
U pruduttu finale finale deve esse etichettatu in una zona visibile cù u seguente: "Contene FCC ID: WQJ-PIPOEM". L'ID FCC di u beneficiariu pò esse usatu solu quandu tutti i requisiti di conformità FCC sò soddisfatti.
2.9 Informazioni nantu à i modi di prova è i requisiti di prova supplementari
Stu trasmettitore hè testatu in una cundizione d'esposizione RF mobile autonoma è qualsiasi trasmissione simultanea o co-localizzata cù altri trasmettitori o usu portatili richiederà una rivalutazione di u cambiamentu permissivu di classa II separata o una nova certificazione.
2.10 Test addiziunali, Parte 15 Subpart B disclaimer
Stu modulu trasmettitore hè pruvatu cum'è un sottosistema è a so certificazione ùn copre micca u requisitu di regula FCC Part 15 Subpart B (radiatore involontariu) applicabile à l'ospite finale. L'ospite finale averà sempre bisognu di rivalutà per a conformità à sta parte di i requisiti di regula, se applicabile.
Sempre chì tutte e cundizioni sopra sò soddisfatte, ùn sarà micca necessariu più teste di trasmettitore.
Tuttavia, l'integratore OEM hè sempre rispunsevuli di pruvà u so pruduttu finale per qualsiasi requisitu di cumplimentu supplementu necessariu cù stu modulu installatu.
NOTA IMPORTANTE: In l'eventu chì sti cundizioni ùn ponu micca esse cumpletu (per esample certe cunfigurazioni di laptop o co-location cù un altru trasmettitore), allura l'autorizazione FCC ùn hè più cunsiderata valida è l'ID FCC ùn pò esse usata nantu à u pruduttu finali. In queste circustanze, l'integratore OEM serà rispunsevule per rivalutà u pruduttu finale (cumpresu u trasmettitore) è ottene una autorizazione FCC separata.
Informazione manuale à l'utilizatori finali
L'integratore OEM deve esse cuscenti di ùn furnisce micca infurmazioni à l'utilizatori finali in quantu à stallà o sguassate stu modulu RF in u manuale di l'utilizatori di u pruduttu finale chì integra stu modulu.
U manuale di l'utilizatore finale include tutte l'infurmazioni regulatori / avvisi necessarii cum'è mostra in stu manuale.
Responsabilità di u fabricatore OEM / Host
I fabbricanti OEM / Host sò in ultimamente rispunsevuli di u rispettu di l'Ospitu è ​​u Modulu. U pruduttu finali deve esse rivalutatu contru à tutti i requisiti essenziali di a regula FCC cum'è FCC Part 15 Subpart B prima di pudè esse piazzatu in u mercatu di i Stati Uniti. Questu include a rivalutazione di u modulu di trasmettitore per u rispettu di i requisiti essenziali Radio è EMF di e regule FCC. Stu modulu ùn deve esse incorporatu in alcun altru dispositivu o sistema senza riprova per a conformità cum'è equipamentu multi-radio è cumminatu.

Dichjarazione di Industry Canada:

Stu dispusitivu hè conforme à i RSS esenti da licenza di ISED. U funziunamentu hè sottumessu à e duie cundizioni seguenti:

1. Stu dispusitivu ùn pò causari interferenza dannusu, è
2. stu dispusitivu deve accettà ogni interferenza ricevuta, cumpresi interferenza chì pò causà operazione indesiderata.

Dichjarazione di l'esposizione à a radiazione:
U pruduttu hè conforme à u limitu di esposizione RF portatile Canada stabilitu per un ambiente senza cuntrollu è hè sicuru per u funziunamentu previstu cum'è descrittu in stu manuale. L'ulteriore riduzione di l'esposizione RF pò esse ottenuta se u pruduttu pò esse tenutu u più luntanu pussibule da u corpu di l'utilizatore o stabilisce u dispusitivu per abbassà a putenza di output se tale funzione hè dispunibule.
Stu dispusitivu hè pensatu solu per l'integratori OEM in e seguenti cundizioni: (Per l'usu di u dispositivu modulu)

1. U modulu trasmettitore ùn pò micca esse situatu in un altru trasmettitore o antenna.
   Finu chì a cundizione sopra hè cumpleta, ùn sarà micca necessariu più teste di trasmettitore. Tuttavia, l'integratore OEM hè sempre rispunsevule per a prova di u so pruduttu finale per qualsiasi requisitu di cumplimentu supplementu necessariu cù stu modulu installatu.

NOTA IMPORTANTE:
In l'eventu chì sti cundizioni ùn ponu micca esse cumpletu (per esample certe cunfigurazioni di laptop o co-locazione cù un altru trasmettitore), allora l'autorizazione di u Canada ùn hè più cunsiderata valida è l'ID IC ùn pò micca esse usatu in u pruduttu finali. In queste circustanze, l'integratore OEM serà rispunsevuli di rivalutà u pruduttu finitu (cumpresu u trasmettitore) è di ottene una autorizazione Canada separata.
Etichettatura di u pruduttu finali
U pruduttu pò esse guardatu quant'è pussibule da u corpu di l'utilizatore o stabilisce u dispusitivu per sminuì a putenza di output se tale funzione hè dispunibule. U pruduttu finale finale deve esse etichettatu in una zona visibile cù u seguente: "Contene IC: 9847A-PIPOEM".
Informazione manuale à l'utilizatori finali
L'integratore OEM deve esse cuscenti di ùn furnisce micca infurmazioni à l'utilizatori finali in quantu à stallà o sguassate stu modulu RF in u manuale di l'utilizatori di u pruduttu finale chì integra stu modulu.
U manuale di l'utilizatore finale include tutte l'infurmazioni regulatori / avvisi necessarii cum'è mostra in stu manuale.
Attenzione è Avvertimenti
Attenzione: U PIP LITE-ON CUSTOM deve esse muntatu à 1-2 piedi di distanza da altri PiP. Pò esse aghjustatu basatu nantu à a cunfigurazione di a corsia.
Attenzione: Evite a vicinanza di trasmettitori radio chì ponu riduce a capacità di u lettore.

Storia di rivisione

Data	Rev	Cambiamenti	By
12/26/2022	A	Liberazione iniziale	EC

Overview

L'ID TECH PIP OEM hè un dispositivu NFC compactu, autonomu, pensatu per sustene i prugrammi di fidelizazione chì si registranu via telefoni NFC. Hè ancu grande cum'è un dispositivu di cuntrollu d'accessu postu chì sustene Apple VAS è Google Smart Tap, è ancu Mifare è altri protokolli chjusi.
1.1. SDK universale
Un SDK universale basatu in Windows riccu di funzioni hè dispunibule per aiutà u sviluppu rapidu di l'applicazioni chì parlanu cù PIP OEM. U SDK hè dispunibule per a lingua C# in Windows è vene cun sampu codice per l'applicazioni demo. Per uttene u SDK è altre utilità utili, demo è scaricamentu, assicuratevi di verificà u ligame Scaricamenti nantu à a ID TECH Knowledge Base (senza registrazione necessaria).
1.2. Encryption
LITE-ON CUSTOM PIP supporta ECC.
1.3. Features
LITE-ON CUSTOM PIP supporta i seguenti:

• Apple VAS
• Google Pay Smart Tap
• Mifare 1K/4K, Plus, DesFire, Ultralight
• UART
• Adatta per vendita, divertimentu è altri lochi chì utilizanu servizii di fidelizazione à valore aghjuntu, ma ùn necessitanu micca pagamentu
• Intuitivu di u Consumatore: Dotatu di un LED è di sonu per furnisce segnali visuali è audibili per attivà una sperienza liscia è perfetta.
• Notificazione di u sonu di buzzer

Stu documentu assume chì l'utilizatori sò familiarizati cù i so sistemi d'ospiti è tutte e funzioni cunnesse.
1.4. Approvazioni

• Apple VAS è Google SmartTap

1.5. Regulatori

• FCC Part 15
• Marcu CE
• Certificatu UL (materiale PCB per esse appruvatu UL è cù marcatura UL)
• REACH
• PMN: PIPOEM

1.6. Numeru di mudellu

• IDP-05-L1

Specificazioni PiP persunalizate Lite-On

Hardware
MTBF	50,000 POH (minimu)
Frequenza di u Trasmettitore	13.56 MHz +/- 0.01%
Modulazione di trasmettitore	ISO 14443-2 Tipu A Temps d'ascension/descente : 2-3 µs. Aumento, < 1 µsec caduta ISO14443-2 Type B Temps de montée/descente : < 2 µs. ognunu; 8% - 14% ASK
Subcarrier di ricevitore Frequency	847.5 kHz
Dati Subcarrier di u Receiver	ISO 14443-2 Tipu A: Manchester Modificatu ISO 14443-2 Tipu B: NRZ-L, BPSK ISO 18092 ISO 21481 (PCD & NFC) ISO 15693 (in valutazione / Hardware Ready)
Gamma di lettura tipica	0-4cm, dipende da u tipu di carta, l'ambienti di installazione
Fisica
Lunghezza	78 mm
Larghezza	53 mm
Prufundità	4.8 mm
Ambientale
Temperature di funziunamentu	-40 °C à 85 °C (-40 °F à 185 °F) [sans condensation]
Temperature di almacenamiento	-40 °C à 85 °C (-40 °F à 185 °F) [sans condensation]
Umidità operativa	Massimu 95% (senza condensazione)
Umidità di almacenamiento	Massimu 95% (senza condensazione)
Umidità di transitu	Massimu 95% (senza condensazione)
Ambiente operativu	Outdoor
Valutazione IK	N/A
Classificazione IP	N/A
Elettricu
Reader Input Voltage	+ 5V (alimentatu da u portu UART)
Cunsumu d'energia	Modu inattivu: <1W Modu di polling: <2.5 W

Installazione di LITE-ON CUSTOM PIP

Questa sezione furnisce infurmazioni nantu à l'installazione di un Lite-On Custom PiP.
3.1. Lista di parti
Verificate chì avete u seguente hardware per installà u Lite-On Custom PiP:

• PIP OEM
• Cavo UART persunalizatu

3.2. Muntà u Lite-On Custom PiP
Attenzione: U campu RF di u LITE-ON CUSTOM PIP hè sensibile à a vicinanza di u metale. Ci hè trè opzioni per a stallazione di u LITE-ON CUSTOM PIP à una superficia metallica:

• Lite-On Custom PiP ùn deve esse stallatu daretu à qualsiasi superfici metalliche o materiali chì anu cuntenutu metallicu, chì blucca u campu RF.
• Munta Lite-On Custom PiP à un minimu di 2 cm da ogni superficia metallica.
• Mantene a superficia di emissione di RF di Lite-On Custom PiP almenu 2 cm da ogni metallo.

3.2.1. Viti di muntatura
A parte posteriore di u LITE-ON CUSTOM PIP hà quarti fori per viti di muntatura (4X Փ2.80). Assicuratevi chì a prufundità di i viti utilizati per a muntagna ùn supera micca 4 mm.

3.3. Cunnessione à u putere
U Lite-On Custom PiP hè alimentatu da u connettore di u Sistema.
3.4. Cunnessione à u portu di dati
U Lite-On Custom PiP trasferisce dati via u connettore di u sistema da u signale UART.
3.5. Utilizà u LITE-ON CUSTOM PIP per i servizii di valore aghjuntu
Questu prova a capacità di Lite-On Custom PiP di leghje un telefunu NFC o una carta di tap in circuitu chjusu.
3.6. Fà una transazzione VAS
U LITE-ON CUSTOM PIP permette à i servizii di u prugramma di fidelizazione di i clienti chì utilizanu a tecnulugia Contactless (NFC). Per fà una transazzione VAS:

1. Presentate u telefunu in prossimità di a parte frontale di u PiP.
2. Orientate u telefunu in modu chì a superficia massima hè parallela à u PiP.
3. U telefunu utilizatu per a prova deve visualizà una schermu di ricumpensa (i passi per aduprà quella schermu dipendenu da a piattaforma telefunale).
4. U Lite-On Custom PiP emette una volta per indicà una transazzione VAS successu.

3.7. Notes nantu à i Lochi di Installazione

• U LITE-ON CUSTOM PIP hè cuncepitu per esse muntatu nantu à una superficia è in prossimità di qualsiasi mutori interni è dispositivi elettrici chì ponu esse operati in una zona di u puntu di vendita. Tuttavia, u LITE-ON CUSTOM PIP hè suscettibile à l'interferenza RF è elettromagnetica. Hè impurtante chì l'unità ùn sia micca muntata vicinu (in 3 o 4 piedi) grandi mutori elettrici, sistemi UPS di computer, trasmettitori di microonde (router Wi-Fi), dispositi antifurtu, trasmettitori radio, equipaghji di cumunicazione è cusì.
• Attaccà tutti i cavi pulitamente cù fascette di nylon è instrateli in modu chì sò inaccessibili è invisibili à i clienti.
• Pruvate l'installazione LITE-ON CUSTOM PIP utilizendu una carta di prova per fà una transazzione VAS end-to-end. Ancu s'è a transazzione hè declinata (cum'è deve esse cù una carta di prova), pruvarà a cunnessione in tuttu u sistema. Sè pussibule, un manager o un altru rispunsevuli deve pruvà ogni LITE-ON CUSTOM PIP in una basa regulare (forse à l'iniziu di ogni ghjornu o almenu una volta à settimana) cù una carta di prova per assicurà u funziunamentu cuntinuatu è a funziunalità. Se u LITE-ON CUSTOM PIP hè riavviatu in modu regulare (cum'è ogni notte), hè impurtante di pruvà u lettore senza cuntattu u più prestu pussibule dopu per assicurà a cumunicazione cuntinuata à l'ospite LITE-ON CUSTOM PIP.

LITE-ON CUSTOM PIP LED Indicatore di Status

U LITE-ON CUSTOM PIP hà un indicatore LED in fronte di u dispusitivu per indicà u statu di lettore.

	LEM (blu)	1E02 (Rossu)	Beeper
Pronta per a transazzione	• lampeggia 5s	off	Off
A transazzione hà iniziatu	• accende	off	Off
Transazzione successu	• lampatu	nantu à i bip	Una volta
A transazzione falluta	Off Bip	• lampatu	Duie volte

Interferenza RF

Q. Perchè aghju bisognu di sapè di l'interferenza RF?
A. A cumunicazione senza contactu usa a tecnulugia di freccia radiu per mandà dati di u telefuninu à un lettore di terminal senza contact.
Q. Cumu l'interferenza RF pò influenzà a cumunicazione senza contactu?
A. Interferenza RF pò causà errori di dati. Se l'interferenza RF hè presente, i dispositi di cumunicazione senza cuntattu ponu operare intermittenti o inconsistenti.
Q. Da induve vene l'interferenza RF?
A. L'interferenza di freccia radio (RFI) pò urigginari da una larga quantità di fonti in i lochi VAS-related. Certi exampI fonti di energia RF è interferenze RF includenu:

• Radio AM / FM è trasmettitori TV
• Radio bidirezionale è pager
• Telefoni mobile
• Linee elettriche è trasformatori
• Equipamentu medicale
• Microonde
• Interruttori elettromeccanici

Q. Chì duverebbe fà se suspettu chì l'interferenza RF esiste in u mo ambiente?
A. Cumincià da inspeccionà u vostru ambiente per e pussibuli fonti di interferenza RF.
Q. I pruduttori di l'equipaggiu testanu i so dispositi per l'interferenza RF?
A. L'equipaggiu elettronicu hè pruvatu per a sensibilità RFI da i fabricatori. Sti testi sò realizati in un ambiente di laboratoriu cuntrullatu è spessu ùn riplicanu micca i tipi di dispusitivi chì si trovanu in u vostru ambiente di u puntu di vendita (POS).
Q. Chì livelli di RF impacteranu l'operazioni RF?
A. I fattori chì ponu causà interferenza RF varianu casu per casu. Ùn ci sò micca regule stabilite chì definiscenu un unicu livellu RF chì pruvucarà RFI. RFI dipende da a sensibilità di l'equipaggiu in cunsiderà, o quantu bassu un signalu di interpretazione pò esse in presenza di l'equipaggiu è causanu prublemi. L'equipaggiu pò esse particularmente sensibile à livelli di signali assai bassu di una frequenza è ancu esse abbastanza immune à livelli di signali elevati di una altra frequenza - cusì a frequenza hè un fattore impurtante. Certi cumpunenti di u sistema elettronicu sò schermati internamente è anu una immunità assai alta à l'interferenza; ma in generale, a maiò parte di l'equipaggiu ùn hè micca stata cusì ingegneria.

Firmware Commands

I seguenti cumandamenti di firmware si applicanu à a cunfigurazione di u lettore LITE-ON CUSTOM PIP. Vede a Guida per sviluppatori di l'interfaccia NEO per i dettagli completi.
6.1. Gestione di chjave ECC
A sezione sottu descrive a gestione ECC Key per i dispositi LITE-ON CUSTOM PIP.
6.1.1. Coppia di chjave ECC
I cummercianti o altri amministratori chì volenu aduprà SmartTap devenu creà è gestisce a coppia di chjave di Criptografia di Curva Ellittica (ECC) utilizata per assicurà a cumunicazione trà u lettore è a billetera.

• Chjave publica: l'amministratori devenu cumunicà a chjave publica à Google. Hè publicu è pò esse visibile à tutti.
• Chjave privata: a chjave privata deve esse guardata privata è injected in u dispusitivu ViVOpay, induve serà guardatu in modu sicuru.

6.1.2. Cumu creà una coppia di chjave ECC Utilizendu Open-SSL
L'utilizatori anu parechje opzioni per generà a coppia di chjave ECC (o a coppia di chjave di firma digitale ECDSA). L'example sottu usa u pacchettu OpenSSL liberamente dispunibule per generà una coppia di chjave prime256v1 Elliptical Curve Cipher (è per firmà missaghji).
Per generà a chjave privata EC:
openssl> ecparam -out PRIVATE.key.pem -name prime256v1 -genkey
Per generà a chjave publica EC da a chjave privata:
openssl> ec -in PRIVATE.key.pem -pubout -out PUBLIC.key.pem -conv_form cumpressu
Firmà u messagiu:
openssl> dgst -sha256 -sign LONG_TERM_PRIVATE.pem message.txt> signature.bin
Verificate u messagiu:
openssl> dgst -sha256 -verify LONG_TERM_PUBLIC.pem - firma signature.bin message.txt
Generate sicretu spartutu ECDH:
openssl> pkeyutl -derive -inkey TERMINAL_EPHEMERAL_PRIVATE.pem - peerkey HANDSET_EPHEMERAL_PUBLIC.pem - fora sicretu.bin
6.1.3. Cumu Estrattà Dati Chjave Per Caricà in u PiP Personalizatu Lite-On
Dopu avè generatu l'ECC Key Pair, u Lite-On Custom PiP richiede chì i dati di a Chjave Privata sò caricati in modu chì pò decifrare l'infurmazioni di u passatu mandatu da u dispositivu mobile. Per caccià i Dati Chjavi richiesti, utilizate a seguente linea di cumanda OpenSSL: >openssl.exe ec -noout -text -in private_key.pem Questu hà da eseguisce l'infurmazioni à u screnu. Duvete vede u minimu quì sottu: Private-Key: (256 bit) priv: 00:f5:36:87:08:93:39:20:55:3b:7b:9f:fb:16:ae: ed:9c:77:d5:bf:d9:66:2a:f1:b:49:6 9f:9c:ca Copia i byte di dati è editàli per sguassà i caratteri di i punti. Sì, cum'è in l'example sopra, ci sò 33 bytes di dati, caccià u 00 di punta à lascià 32 bytes di dati chjave. Quessi sò usati in i cumandamenti C7-65 è C7-66 detallati più tardi in stu documentu.
6.2. Google Pay Smart Tap 2.1 Comandi
I seguenti cumandamenti si applicanu à Google Pay Smart Tap 2.1.
6.2.1. Set Gruppu Configurable (04-03)
U cumandamentu Set Configurable Group crea o modifica un Gruppu TLV. Configurate un Gruppu TLV specificu passendu i TLV cù a funziunalità desiderata è un Numero di Gruppu TLV unicu à u lettore. A funzione Google Pay Smart Tap hè cuntrullata cù u Gruppu di Cunfigurazione 142 (0x8E). Cumanda Cumanda

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14 ... Byte 14 + n-1	Byte 14 + n	Byte 15 + n
Intestazione Tag & Version di Protocol	Cumanda	Sub-Cumandamentu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	Dati	CRC (LSB)	CRC (MSB)
ViVOtech2\0	04 ore	03 ore			TLV Data Objects

Frame di risposta

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14	Byte 15
Intestazione Tag & Version di Protocol	Cumanda	Codice di Statu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	CRC (MSB)	CRC (LSB)
ViVOtech2\0	04 ore	Vede u Status Code Table	00 ore	00 ore

6.2.1.1. Esample Usage
Ulteriori infurmazioni nantu à l'Oggetti di Dati TLV chì ponu esse stabiliti in u quadru di cumanda sò descritti in detail in u documentu Google Pay Smart Tap 2.1 In ViVOpay Devices. I paràmetri utilizati cù u Pass Demo di ID TECH sò mostrati quì sottu:
FFE4018E…………………………… .. Numero di gruppu 142 (0x8E)
DFEE3B0405318C74…… ID di u cullettore (87133300)
DFEE3C00 ……………………………. ID di locu di u magazinu (viu)
DFEE3D00 …………………………… ID di Terminal (Viotu)
DFEF2500 ……………………………. Nome di u Merchant (Viotu)
DFED0100 …………………………… Categoria di cummercianti (viota)
DFED02050000000001 …………. Capacità PoS Bitmap
DFED030101 …………… .. Tempi di prova (01)
DFED040101 ……………………….. Selezziunà u Supportu OSE (01)
DFED050101 …………….. Salta a seconda scelta di supportu (01)
DFED060100 …………….. Stop u pagamentu se SmartTap 2.1 falliu (00)
DFED070100 ……………………….. Supportu pre-firmatu (00)
DFED27010D …………… .. Delimitatore per l'ughjetti di serviziu (0x0D)
DFED3F0100 ………………………… Bandiera di crittografia VAS (00)
DFED490100 ……………………….. Override globale solu per VAS (00)
DFEF770100 ………………………… Oggetti di serviziu multipli attivati ​​/ disattivati ​​(00)
Per stabilisce questi valori predeterminati in u vostru Lite-On Custom PiP, utilizate l'App Demo USDK è selezziunate l'opzione "Send NEO Command. Definite i campi di cumandamentu cum'è quì sottu, presse Execute Command per stabilisce i valori:

• Cmd: 04
• sottu: 03
• Dati Hex:

FFE4018EDFEE3B0405318C74DFEE3C00DFEE3D00DFEF2500DFED0100DFED02 050000000001DFED030101DFED040101DFED050101DFED060100DFED070100 DFED27010DDFED3F0100DFED490100DFEF770100
6.2.2. Set SmartTap LTPK (C7-65)
Per l'iniezione diretta di l'LTPK, mandate u cumandamentu di firmware C7-65 via una cunnessione seriale à u dispositivu (offline). I sviluppori duveranu osservà e boni pratiche criptografiche, per esempiuample, i dispusitivi injecting in un setup sicuru.
Cumanda Cumanda

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14	Byte 15	Byte 16
Intestazione Tag & Protocollo Versione	Cumanda	Sub-Cumandamentu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	Dati	CRC (LSB)	CRC (MSB)
ViVOtech2\0	C 7 h	65 ore	0x00 0x24		Vede Table di Dati di Command

Dati di cumandamentu

Elementu di dati	Lunghezza (byte)
Versione	4
Chjave privata à longu andà	32

Frame di risposta

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14	Byte 15
Intestazione Tag & Version di Protocol	Cumanda	Codice di Statu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	CRC (MSB)	CRC (LSB)
ViVOtech2\0	C 7 h	Vede u Status Code Table	00 ore	00 ore

6.2.2.1. Esample Usage
Per carricà a Chjave Privata à Long Term Google Pay in u vostru Lite-On Custom Lite-On Custom PiP per l'usu cù l'ID TECH Demo Pass, i valori utilizati sò mostrati quì sottu:
Versione: 0000000A
Dati: F5368708933920553B7B9FFB16AEED9C77D5BFD9662AF149A6B9F965B73F0C CA
I Dati mostrati sò stati ottenuti in a Sezione 6.1.3.
Per stabilisce questi valori predeterminati in u vostru Lite-On Custom PiP, utilizate l'App Demo USDK è selezziunate l'opzione Send NEO Command. Definite i campi di cumandamentu cum'è quì sottu, dopu appughjà Execute Command per stabilisce i valori:

• Cmd: C7
• sottu: 65
• Dati Hex:
  F5368708933920553B7B9FFB16AEED9C77D5BFD9662AF149A6B9F965B73F0CCA

6.3. Cumandamenti di u firmware Apple VAS
I seguenti cumandamenti s'applicanu à Apple VAS.
6.3.1. Set Merchant Record (04-11)
U cumandamentu Set Merchant Record stabilisce u cummerciante chì u PIP OEMreader usa per i punti di fideltà.
Cumanda Cumanda

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14 ... Byte 14 + n-1	Byte 14 + n	Byte 15 + n
Intestazione Tag & Version di Protocol	Cumanda	Sub-Cumandamentu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	Dati	CRC (MSB)	CRC (LSB)
ViVOtech2\0	04	11 ore

Campu di Dati per Frame Command

Campu di dati	Lunghezza (byte)	Descrizzione
Indice di u Merchant Record	1	U valore validu hè 1-6. Finu à 6 record ponu esse stabiliti.
ID Presente	1	1: L'ID Merchant hè validu. 0: L'ID Merchant ùn hè micca validu.
ID di u cummerciante	32	U valore di tag 9F25. SHA256 di pass name.
Lunghezza di Merchant URL	1	Pò esse zero, se no URL hè utilizatu (veru Merchant URL lunghezza).
Merchant URL	64	U valore di tag 9F29, imbottitu cù zeri finali à 64 bytes.
Lunghezza di u numeru di versione di l'applicazione terminal	1	Opcional. Pò esse zero, se ùn hè micca utilizatu un numeru di versione di l'applicazione terminale (u buffer di u numeru di versione di l'applicazione terminal hè 2 byte).
ApplePay Terminal Application Number Version	var	Opcional. U valore di tag 9F22.

Frame di risposta

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14	Byte 15
Intestazione Tag & Version di Protocol	Cumanda	Status	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	CRC (MSB)	CRC (LSB)
ViVOtech2\0	04 ore	Vede u Status CodeTable	00	00

6.3.1.1. Esample Usage
Ulteriori infurmazioni nantu à l'Oggetti di Dati TLV chì ponu esse stallati in u quadru di cumanda sò descritti in detail in u documentu Apple VAS In ViVOpay Devices. I paràmetri utilizati cù u Pass Demo di ID TECH sò mostrati quì sottu:

• ID di registrazione di u cummerciale: 01
• ID Presente: 01
• ID di u cummerciante:
  AD9887C78E412F835E89D0A4F71E423320C7BB53B6FAACD8D1D1EED9E1E38D39
• Lunghezza di Merchant URL: 00
• MerchantURL: 00000000000000000000000000000000000000000000000000000000000000000 000000000000000000000000000000000000000000000000000000000000000
  Per stabilisce questi valori predeterminati in u vostru Lite-On Custom Lite-On Custom PiP, utilizate l'App Demo SDK è selezziunate l'opzione Send NEO Command. Definite i campi di cumandamentu cum'è quì sottu, dopu appughjà Execute Command per stabilisce i valori:
• Cmd: 04
• sottu: 11
• Hex Data: 0101AD9887C78E412F835E89D0A4F71E423320C7BB53B6FAACD8D1D1EED9E1E38 D3900000000000000000000000000000000000000000000000000000000000000 00000000000000000000000000000000000000000000000000000000000000000 000

6.3.2. Set Chjave Privata (C7-66)
U cumandamentu Set Private Key carica a chjave privata assuciata à u passaghju VAS di Apple di u Merchant in u dispusitivu ViVOpay. Questu permette à u lettore di decifrare i dati di passaghju.
Nota: U cumandamentu Set Private Key (C7-66) funziona solu in lettori non-SRED; Lite-On Custom PiP ùn sò micca SRED.
Cumanda Cumanda

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14 ... Byte 14 + n-1	Byte 14 + n	Byte 15 + n
Intestazione Tag & Version di Protocol	Cumanda	Sub-Cumandamentu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	Dati	CRC (MSB)	CRC (LSB)
ViVOtech2\0	C7	66 ore	0020h o 0021h		Dati

Campu di Dati di Frame Command

Campu di dati	Lunghezza (byte)	Descrizzione
Indice di u Merchant Record	1 o 0 (OTP)	Se u Merchant Record Index ùn esiste micca, sta Chjave Privata hè aduprata da tutti i Merchant IDs. If the Merchant Record Index esiste, sta Chjave Privata hè usata per l'ID Merchant specificata. U valore validu hè 1-6. Pò esse stabilitu per 6 records.
Chjave privata	32	Chjave privata Apple VAS.

Frame di risposta

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14 ... Byte 14 + n-1	Byte 14 + n	Byte 15 + n
Intestazione Tag & Protocollo Versione	Cumanda	Status	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	Dati	CRC (MSB)	CRC (LSB)
ViVOtech2\0	C7	Vede u Status Code Table, NEO 2 IDG	00 ore	00 ore

Nota 1: A chjave privata deve esse 32 bytes longu. Sè a chjave privata hè injected è tag DFED3F bit 2 impostato su 1, u lettore decifrarà i dati VAS (tag 9F27).
6.3.2.1. Esample Usage
Per carica l'Apple VAS Private Key in u vostru Lite-On Custom PiP per l'usu cù u ID TECH Demo Pass, i valori utilizati sò mostrati quì sottu:

• Dati:
  F5368708933920553B7B9FFB16AEED9C77D5BFD9662AF149A6B9F965B73F0C CA
  I Dati mostrati sò stati ottenuti in a Sezione 6.1.3.
  Per stabilisce questi valori predeterminati in u vostru Lite-On Custom PiP, utilizate l'App Demo USDK è selezziunate l'opzione Send NEO Command. Definite i campi di cumandamentu cum'è quì sottu, dopu appughjà Execute Command per stabilisce i valori:
• Cmd: C7
• sottu: 66
• Hex Data: 0000000AF5368708933920553B7B9FFB16AEED9C77D5BFD9662AF149A6B9F965B 73F0CCA

6.3.3. Set Configuration (04-00)
Aduprate stu cumandamentu per stabilisce o cambià i valori di u specificatu Tag Valore di lunghezza (TLV) oggetti di dati in u lettore. Pò esse usatu per stabilisce i paràmetri per l'Auto Poll è u Modu Poll on Demand. Quandu u lettore riceve stu cumandamentu, estrae i paràmetri codificati TLV da a parte di dati di u cumandamentu è li salva in u Gruppu TLV predeterminatu in memoria non volatile. Se un oggettu di dati TLV hè furmatu in forma incorrecta, u lettore cessà di trasfurmà l'ughjettu. Un cumandamentu unicu pò cuntene più di un oggettu di dati TLV. Stu cumandamentu pò esse usatu per stabilisce ogni ughjettu EMV TLV in u lettore.
Nota: U cumandamentu Set Configuration hè l'unicu mecanismu per stabilisce i valori di parametri di cunfigurazione globale.
Cumanda Cumanda

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14 ... Byte 14 + n-1	Byte 14 + n	Byte 15 + n
Intestazione Tag & Version di Protocol	Cumanda	Sub-Cumandamentu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	Dati	CRC (LSB)	CRC (MSB)
ViVOtech2\0	04 ore	00 ore			TLV Data Objects

Frame di risposta

Byte 0-9	Byte 10	Byte 11	Byte 12	Byte 13	Byte 14	Byte 15
Intestazione Tag & ProtocolVersion	Cumanda	Codice di Statu	Lunghezza di dati (MSB)	Lunghezza di dati (LSB)	CRC (MSB)	CRC (LSB)

ViVOtech2\0

04 ore

Vede u Status Code Table

00 ore

00 ore

4.1.1.1.  Tag DFED3F: Encryption VAS
Tag DFED3F cuntrolla l'opzioni di crittografia VAS. U Tag hè pusatu à u gruppu 0.

DFED3F

Opcional

Bandiera di attivazione/disattivazione di crittografia VAS Bit 0: Cifra i dati VAS cù a chjave di crittografia di dati di u dispositivu Bit 1: Decripta i dati Apple VAS cù a chjave privata Apple VAS Bit 2 à 7: RFU

Per esampLe:

• 56 69 56 4F 74 65 63 68 32 00 ViVOtech2\0
•  04 00 Set cunfigurazione
• 00 05 Lunghezza di dati
• DF ED 3F 01 01 Abilita a criptografia di Smart Tap è Apple VAS
• BF 00 CRC16

6.4. Lite-On Custom PiP Firmware Commands per entrambe e piattaforme
I seguenti s'applicanu à Google Pay Smart Tap 2.1 è Apple VAS. Vede u documentu "NEO IDG (NEO Interface Developers Guide)_Rev 165.4".

NEO IDG_Rev 165.4.pdf
6.5. Poll On Demand è Impostazioni Auto Poll
Per Poll On Demand, u containeru Apple VAS è Google Pay Smart Tap 2.1 tags deve esse inclusu in i paràmetri per u cumandimu Attivà a transazzione senza cuntattu. Quandu si usa Auto Poll, u cuntinuu tags deve esse stabilitu in u gruppu di cunfigurazione 0.
Apple VAS: FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 02 9F 2B 05 01 00 00 00 00 DF 01 01 03
Google Pay Smart Tap 2.1: FF EE 08 0A DF EF 1A 01 0A DF ED 28 01 00
6.6. Supportu di cambiamentu di carta senza pagamentu
Lite-On Custom PiP pò leghje parechji formati di carta senza avè bisognu di cambià manualmente.
U cumandamentu ACT è u mudellu in u FFEE0E Tag gestisce a lettura di carte EMV è carte Mifare cù un solu cumandamentu.
Nota: U containeru FFEE0E tag hè utilizatu in u listessu modu cum'è FFEE06 è FFEE08 per Apple VAS è Google Pay Smart Tap 2.1 in relazione à u cumpurtamentu Poll On Demand / Auto Poll.
Tags usatu:

• FFEE0E furnisce u mudellu, chì include DFED3A, DFED3B è DFED3C.
  o DFED3A definisce quale blocchi à leghje. Un bloccu hè un byte. Per esample, DFED3A 04 02 12 18 22 leghje i blocchi 02, 12, 18 è 22.
  o DFED3C definisce u bloccu è i dati currispundenti per scrive. Per esample,
  DFED3C 11 06 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10 significa scrive dati "01 02 03 04 05 06 07 08 09 0A 0F 0B 0E" in 0 0F 10B 06E.
  o 0801FFFFFFFFFFFF significa da u bloccu 08, chjave-A, utilizate "FFFFFFFFFFFF". Modu 01 hè KEY-A, 02 hè KEY-B.

ExampLe:
ACT(02 40): 0A 9C 01 00 9F 02 06 00 00 00 00 15 00 FF EE 06 18 9F 22 02 01 00 9F 26 04 00 00 00 01 9 2 05 01 00 00 00 00 01 01 01 08 02 81 DF 00 0 41 FF EE 3 08 01 01 FF EE 3E 08 DF ED 04B 01 3 08 FF FF FF FF FF FF DF ED 08B 01 3 11 FF FF FF FF 06 FF 01 02 03 FF FF FF FF FF FF 04B FF DF ED 05C 06 07 08 09 0 0 0 0 0 0 10 3A 04B 01C 03D 07E 09F XNUMX DF ED XNUMXA XNUMX XNUMX XNUMX XNUMX XNUMX
Stu paràmetru ACT definisce e seguenti operazioni:

• Leghjite i blocchi 01, 03, 07 è 09
• Scrivite à u bloccu 06 cù "01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F 10" cum'è i dati
• A chjave da u bloccu 01 hè KEY-A "FFFFFFFFFFFF"
• A chjave da u bloccu 04 hè KEY-A "FFFFFFFFFFFF"
• A chjave da u bloccu 08 hè KEY-A "FFFFFFFFFFFF"

Dati di ritornu: FFEE0E lunghezza Error_Code Card_Type TLV_UID Card_Data
Induve a lunghezza hè a durata di [Error_Code Card_Type Card_Data].
Error_Code hè definitu cum'è:

OxEO	#define ERRORE NO ERRORE
OxEl	#define ERROR TIMEOUT ERROR
OxE2	#define ERRORE AUTHENTICATE ERROR
OxE3	#define ERRORE READ ERROR
OxE4	#define ERRORE WRITE ERROR

Card_Type hè definitu cum'è:

0x03	Mifare classicu
0x04	MifareUltraLight
0x05	Mifare Plus (supportu PiP è leghje UID solu)
Ox06	Mifare Desfire (supportu PiP è leghje UID solu)

TLV_UID: DFED44
Card_Data hè a dati lettu da a carta designata da DFED3A. U delimitatore hè [0D 0A].
Per u cumandimu ACT, se una chjave ùn hè micca necessariu o a chjave hè KEY-A "FF FF FF FF FF FF", Tag DFED3B pò esse omessi.

Actualizazione di u firmware

I passi sottu descrizanu u prucessu per aghjurnà u firmware LITE-ON CUSTOM PIP via u Universal SDK Demo.
Nota: Prima di principià, cuntattate u vostru rappresentante ID TECH per riceve u più recente firmware Lite-On Custom PiP. Scaricate u ZIP file è estrae lu à u vostru urdinatore.

1. Cunnette u LITE-ON CUSTOM PIP à u vostru PC via u portu seriale.
2. Scaricate è installate l'ultima app Demo USDK da a ID TECH Knowledge Base (se ùn pudete micca accede à u ligame, cuntattate l'assistenza).
3. Aprite a demo USDK da u menu Start di Windows.
4. Sottu Dispositivu, selezziunate Update Device Firmware, dopu cliccate Execute Command.
5. Navigate è selezziunate u firmware LITE-ON CUSTOM PIP chì avete scaricatu prima è cliccate Apri.
6. U LITE-ON CUSTOM PIP riavviarà è entre in u bootloader, à quale puntu a demo USDK cumencia à aghjurnà u dispusitivu.
7. Quandu l'aghjurnamentu di u firmware hè cumpletu, u LITE-ON CUSTOM PIP riavviarà di novu è a demo USDK hà da dumandà l'aghjurnamentu di u firmware successu.

Assistenza Clienti

Se ùn pudete micca risolve qualsiasi prublemi tecnichi, cuntattate per piacè support@idtechproducts.com (Mandendu un e-mail à questu indirizzu apre automaticamente un bigliettu di supportu).

ID TECH
10721 Walker Street, Cypress, CA 90630-4720
Tel: 714-761-6368
Fax 714-761-8880
www.idtechproducts.com

Documenti / Risorse

IDTECH IDP-05-L1 Lite-On Custom PiP OEM Dispositivu NFC Standalone [pdfManuale d'usu WQJ-PIPOEM, WQJPIPOEM, IDP-05-L1 Lite-On PiP OEM Dispositivo NFC Standalone, Dispositivo Lite-On Custom PiP OEM Dispositivo NFC Standalone, PiP OEM Dispositivo NFC Standalone, Dispositivo NFC Standalone, Dispositivo NFC

Referenze

• Manuale d'usu