ART ELEKTRONİK

Transkript

1 RDR Mifare USB Okuyucu Programcı Klavuzu ART ELEKTRONİK

2 İçindekiler Döküman Bilgisi 4 I. Giriş 5 II. Okuyucular 5 1. Blok diyagramlar 5 2. Özellikler 6 III. Mifare Kartlar - yapıları, prensipleri, konfigürasyonları 7 1. Mifare Kart: Giriş 7 2. Mifare Kart: Bellek örgütleşimi 7 3. Mifare Kart: Haberleşme esasları 8 4. Mifare Kart: Önerilen konfigürasyonlar 8 IV. Haberleşme Protokolü 9 V. Reader Commands Mifare Komutları Select Card Extended Select Card Sector Login Configure Sector Read Sector Form Read Block Block Write Write Value Read Value Copy Value Increment Value Decrement Value Write Master Key I/O Ayarlama Komutları Set Digital Input/Outputs On/Off Simple Digital Input/Outputs On/Off Cihaz Ayarlama Komutları Read Device Ayarları Write Device Ayarları 31 Tablo Listesi 33 Uygulama Notları

3 Döküman bilgisi Anahtar Kelimeler Usb12M, Mifare, Kart, Okuyucu, RFID, Usb Özet Bu döküman RDR cihazının blok diyagramlarını, özelliklerini, mifare yapısını, iletişim protokolünü ve uygulama komutlarını örneklerle barındırmaktadır. 4

4 I. Giriş NXP MFRC522 chip temelli, ISO14443A okuyucu ile entegre olan OEM Mifare okuyucu terminal online cihazı Usb12M Mifare Classic ve Ultra-light kartlı sistem uygulamaları için idealdir. Çünkü uygun fiyata, ufak boyuta, uygun binary haberleşme protokolüne ve zengin komut setine sahiptir. Bazı ana uygulama alanları aşağıda listelenmiştir: Erişim kontrol sistemleri PDKS sistemleri Anahtarsız kapı kontrol Veri toplama/depolama/işleme sistemleri Ön ödemeli sistemler Toplu taşımada akıllı bilet sistemleri Karışık uygulamalar. II. Okuyucular 1. Blok Diyagramlar Usb12M blok diyagramı 5

5 2. Özellikler Usb12M Haberleşme Haberleşme Protokolü Okuyucu Okuma Mesafesi Gerilim & Tüketim Göstergeler Firmware Güncellemesi Boyut & Ağırlık USB 2.0 virtual seri port Kolay kullanımlı seri iletişim binary protokolü Dahili Mifare 13.56Mhz (ISO14443A) okuyucu 5 cm DC +4V +6V ( USB nin 5V kullanılır), Max. 50 ma / 5V Piezoelectric buzzer, yeşil ve kırmızı LEDler USB 2.0 ile 88 x 48 x 20 mm, 0.2 kg Tablo 02: Usb12M özellikleri Usb arayüzlü mifare kart okuyucu 6

6 III. Mifare kartlar - yapıları, prensipleri, konfigürasyonları 1. Mifare kart: Giriş 2. Mifare kart: Bellek organizasyonu 3. Mifare kart: Haberleşme esasları 4. Mifare kart: Önerilen konfigürasyonlar 1. Mifare kart: Giriş Mifare kartlar Philips patentli, yüksek güvenlikli akıllı bellek çipi ve bobininden oluşur. Philips, ISO/IEC A ya göre ve 13.56Mhz de çalışacak şekilde mifare kart sistemleri geliştirdi. Sistem optimum kullanım kolaylığı sunmaktadır. Bu kartlar mifare okuyucunun elektromanyetik etki alanına sokulduğunda, bobindeki endüklenmiş gerilimle beraber veriyi 106kbit/s ile verir ve alır. Böylesi yüksek haberleşme hızı yüksek hızlı işlem idaresini sağlar. Böylece mifare kart kullanıcıları okuyucunun önünde durup işlemin bitmesini beklemek zorunda kalmazlar. Kart cüzdan içinden dahi okutulabilir. Dolandırıcılığa karşı da özel bir güvenlik önlemi alınmıştır. Haberleşme katmanı ISO/IEC 14443A standardının 2. Ve 3. Bölümüyle uyumludur. Güvenlik katmanı mifare ailesinde güvenli data alışverişini sağlamak için field-proven CRYPTO1 stream şifresini destekler. Karşılıklı Sorgulama ve yanıt kimlik doğrulama, veri şifreleme ve ileti kimlik kontrolleri kontrolü sistemi her türlü kurcalamaya karşı korur ve böylece elektronik cüzdan uygulamaları için cazip olmaktadır. Değiştirilemez seri numaraları, her kartın benzersizliğini garanti altına alır. Bağımsız bellek sektörleri ve her sektör için iki farklı anahtar aynı kart ile birden fazla hiyerarşik uygulamalara olanak verir. Bazı yaygın mifare uygulamaları şunlardır: ön ödemeli sistemler, toplu taşıma bilet sistemleri, erişim kontrol sistemleri, PDKS sistemleri, veri toplama, işleme, kontrol sistemleri vb. 2. Mifare kart: bellek organizasyonu Tipine göre mifare kartlar belirli sayıda sektör içerir. (Mifare Standard 1kB 16 sector, Mifare Classic 4kB 40 sector). İlk 32 sektörün her biri 4 blok içerir, kalan 8 sektörün her biri ise 16 blok içerir. Sektör trailer adlı sektörün son bloğunda 6 bytelık A ve B erişim anahtarları (Key A ve Key B) ve 4 bytelık Erişim datası (Access data) bulunur. Sektör ve blok düzeni 0 dan başlar yani 1kB Mifare Standard kartı 16 sektör (0 15) ve 64 blok (0...63) barındırır. 0 bloğu Read Only bloğudur 4 bytelık başlangıç değerine sahip olup her kart için unique değer taşır ve kartın seri numarasıdır. Kalan 12 byte üretici datasını temsil eder. Yukarda bahsedildiği gibi her sektörün son bloğu key A, key B ve erişim datası bloğudur. Bundan sonra erişim bloğu olarak isimlendirilecektir. Buna bağlı olarak 3., 7., 11. ve 15. Bloklar ilgili sektörlerin erişim bloklarıdır. (Erişim Blok No = 3 + Sektör No x 4). 16 bytelık memory bloğu erişim bloğundan ayrı olarak 16 bytelık data domaini ya da 4 bytelık value domaini olarak ayarlanabilir. 7

7 Data domaini olarak ayarlandığında bloğun 16 byteı rahatlıkla okunabilir ve block read ve block write komutlarıyla değiştirilebilir. Value domain olarak ayarlandığında, ilgili değer özel bir tarzda tüm blokta depolanır. Bu konfigürasyon ön ödemeli sistemlerde kullanılabilir. Aşağıdaki komutlar value domain için uygundur: block read, block write, write value (initialization), read value, increment value, decrement value, copy value (data kaybını önlemek için bir değeri diğer bloğa kopyalar). Özel değer formatına zarar verme ihtimali olduğundan dolayı block write komutunun kullanılması önerilmemektedir. 3. Mifare kart: haberleşme esasları Bir mifare kart, kart okuyucunun etki alanına girdiğinde gerekli olan enerjiyi depolamaya başlar. Bu işlem sonrası kart artık okuyucu ile iletişim için hazır durumdadır ve komutları bekler. Select card komutu belirlenen kart ile bir dizi operasyon (transaction) paketini başlatır. Bu komut kartın ID sini (seri numarası) döndürür. Başarılı select card komutu sonrası, kart okuyucu key A veya key B ile beraber sector login komutunun işletilmesi ile belirli sektöre erişim sağlamalıdır. Aynı zamanda sadece bir sektöre ulaşılabilir. Erişim datasına bağlı olarak, bir sektörün bir bloğuna uygulanacak komutların bazıları sadece key A ile login olma gereksinimi duyarlarken bazıları için key B gerekir ve bazıları için de herhangi bir key yeterlidir. Bir key ile başarılı bir sector login sonrası sektörün ilgili blokları için uygun key ile tüm operasyonları - bad acknowledgement olmadıkça- işlenir. Bir kart, okuyucunun etki alanına ilk defa olarak girdiğinde ya da bir sektörün blok veya bloklarına yapılan komut dizisi sonrasında bad acknowledgement dönüşü yaşandığında, o sektörün bloklarıyla yapılan operasyonlara devam etmek için bir select card komutu tekrarlanmalı ve başarılı olması halinde, operasyona bağlı olarak doğru keyle bir sector login komutu gönderilmeli. Bir diğer sektörün bloğuyla çalışırken bir select card komutu ve daha sonra doğru key operasyonları ile login sector komutu gereklidir. Eğer bir bloğa ait olan sektöre uygun şekilde log in yapılamamışsa okuyucu bu bloğa yapılan data talebine karşılık operation failed cevabı verir ya da gelen bilgi bloğun gerçek içeriğini yansıtamaz. Okuyucu ve ana bilgisayar kablo bağlantısı üzerinde ağ trafiği algılama girişimlerini engellemek için 32 key mifare okuyucu IC EEPROM üzerinde saklanır. Master key olarak adlandırılan bu keyler kartlar üzerindeki ilgili keylerle birlikte güvenli ortamlarda yazılmalıdır. Olası algılama durumlarında, login sector gerekli olduğunda, okuyucuya sector login with master key komutu gönderilir. Komut, sektör nosu ile beraber sadece master key no.su (0 31) ve key tipini (A veya B) içerir. Keyin kendisi dahil edilmez. IC, keyi onun dahili hafızasından okur, daha sonra otomatik şekilde karta sector login komutunu gönderir ve böylece kablo üzerinden gönderilmemiş olur. Eğer doğru key ile sector login komutu yürütülmüşse, her sektör için erişim datasının ayarlanması oldukça pratiktir. Bununla beraber bazı durumlarda ilgili sektör kısmen ya da tamamen ulaşılmaz durumdadır. Bu durum 4 byte erişim dataları için özel bir durumdur ve bu yüzden herhangi bir değişiklik öncesi kullanıcının mifare kartlarla ilgili çok detaylı bilgiye sahip olması gerekir. Böylesi bir bilgi ancak PHILIPS ile yapılan karşılıklı özel bir anlaşmanın imzalanması ile güvenilir olarak elde edilebilir. Bu dökümanda varsayılan fabrika keyleri ve erişim datalarının yanında yüksek güvenlikli düzey 8 erişim data formatları da anlatılmıştır. 4. Mifare kart: önerilen konfigürasyonlar Üreticisine bağlı olarak mifare kartlar fabrika aşamasında ayarlanmış fabrika erişim datası ve key içerir. Örnekler: Philips: key A = FFH, FFH, FFH, FFH, FFH, FFH, B = FFH, FFH, FFH, FFH, FFH, FFH; Infineon: key A = A0H, A1H, A2H, A3H, A4H, A5H, B = B0H, B1H, B2H, B3H, B4H, B5H. Tüm bloklar (sektör trailerları haricinde) data blokları olarak ayarlanır. Uygun key A veya key B nin yürütülmesiyle login operasyonu sonrası block read and block write yürütülebilir. Sektör trailerlarda key B ve erişim datası key A ile okunup yazılabilir (bloğun sektörüne sector login yapıldıktan sonra), key A hiçbir durumda erişilebilir değildir, key A ile yazma operasyonu yapılabilir. Yüksek güvenlik gerektiren uygulamalarda fabrika erişim datasının değiştirilmesi önerilir. 8

8 Yukarda belirtildiği gibi uygulamaya bağlı olarak, okuyuculardan gönderilerek desteklenen ve ayarlanabilen sektörlerin 8 çok güvenli değişik erişim datalarından birisi ile ayarlanması önerilir. Aşağıdaki tabloda her sektör formu için blok tipleri, key kullanımı ve izin verilen operasyonlar detaylı şekilde açıklanmıştır. Form Block 0 Block 1 Block 2 Ty Operation Ty Operation Ty Operation Pe r w + - = vw vr pe r w + - = vw vr pe r w + - = vw vr 0 V A B B B A B B B A B v A B B B A B B B A B v A B B B A B B B A B 1 V A B B B A B B B A B v A B B B A B B B A B d A B B x x x x x 2 V A B B B A B B B A B d A B B x x x x x v A B B B A B B B A B 3 V A B B B A B B B A B d A B B x x x x x d A B B x x x x x 4 D A B B x X x x x v A B B B A B B B A B v A B B B A B B B A B 5 D A B B x X x x x v A B B B A B B B A B d A B B x x x X x 6 D A B B x X x x x d A B B x x x x x v A B B B A B B B A B 7 D A B B x X x x x d A B B x x x x x d A B B x x x X x F V A A A A A A A v A A A A A A A v A A A A A A A Tablo 05: Önerilen sektör formları 0 7 ve 0F (factory form): Blok 0, 1, 2 için tip, key ve operasyonlar. Access Data Block: Block 3 Form No Key A: operations Access Data: operations Key B: operations r w + - = vf vr r w + - = vf vr r w + - = vf vr 0..7 x B x x x x x A B B x x x x x x B x x x x x 0F (factory) x A x x x x x A A x x x x x A A x x x x x Tablo 06: Önerilen sektör formları 0 7 ve 0F (factory form): erişim blok operasyonları için gerekli keyler. Kısaltmalar: v - value, d data; r read block, w write block, + - artım değeri, - - azalım değeri, = kopya değeri, vw write(format) value, vr read value; A key A, B key B, A B key A or key B (ikisi de kullanılabilir), x geçersiz operasyon. Tablolardan da görüldüğü gibi, önerilen 8 sektör formu (0 7) ve tüm olası 0, 1, 2 blok değerini ve veri bileşimleri gösterilmektedir. Örneğin eğer belli bir uygulama 52. Bloğun value domain, 53. Bloğun data domain, 54. Bloğun value domain olması gereksinimi duyarsa sektör 13ün erişim datası Form 2 gibi ayarlanmalıdır. Erişim bloğunda keye hiçbir durumda erişilemez. 4 byte erişim datası her iki key ile de okunabilir, yani, herhangi bir key ile bir sector login yürütüldüğünde ve 55. Blok okutulduğunda key A ve key B nin her ikisi için 6 byte data 0 olarak okutulur, 4 byte erişim datası son ayarlandığı gibi okutulacaktır. Bunun yanında bu sektörü ayarlamak için key B ile bir sector login yürütülmelidir. Tüm değer bloklarında value increment, value format, ve value copy operasyonları sadece key B ile yürütülebilir. value decrement ve value read operasyonları sadece key A veya key B ile yürütülebilir. Tüm data blokları için value operasyonlarına izin verilmez (denenirse geçersiz operasyon cevabı alınır), block read operasyonu key A ve key B ile yürütülür; block write ise sadece key B ile yürütülür. IV. Haberleşme Protokolü Bazı küçük istisnalarla beraber haberleşme sorgu formundadır. Tüm değerler Little-Endian byte sıralamasındadır. Sunucu komut ve istek datalarını uygun adresi kullanarak okuyucuya gönderir ve sonuç olarak hedef okuyucu bilgisayara bir geri dönüş yapar. İstek iki amaçla yapılır: Amaç 1: Ana bilgisayar (sunucu) okuyucuya bir komut gönderir ve okuyucu istenilen eylemi yaptıktan sonra yürütülen komutun sonucunu döndürür. Veya; Amaç 2: Sunucu okuyucudan bilgi (data, kayıt ) talep eder. İlgili okuyucu istenilen datayı göndererek talebe cevap verir. 9

9 Sunucu tarafından okuyucuya gönderilen data dizisi RPkt (istek paketi) olarak ve okuyucu tarafından sunucuya gönderilen alındı bildirimi APkt (kabul paketi) olarak isimlendirilecektir. Alındı sonrası hedeflenen okuyucu (hedef okuyucu RPkt nin adres alanındaki değere eşit fiziksel adrese sahip okuyucudur) RPtk yi hesaba katar ve uygun eylem gerçekleştirildikten sonra APkt ile beraber cevap gönderir. Bu kural aşağıdakiler için geçerli değildir: Bu dökümanda bahsedilen okuyucu, uygun şekilde formatlanmış kartın okuyucunun aktif okuma alanına girdiğinde otomatik şekilde data paketleri gönderecek şekilde ayarlanabilir. Böylesi data paketleri APktA - Automatic Answer Packets olarak isimlendirilecektir. Bu konfigürasyonlar ve durumlar ilgili başlıkta detaylıca tanımlanacaktır. RPkt, RPktC, APkt, APktA binary paketlerdir ve yapıları benzerdir. Alan Stx Adres Uzunluk = N Data CSum Etx Uzunluk (byte) N 1 1 Tablo 07: Binary paket yapısı Aşağıdaki tabloda paket yapısı detaylı olarak açıklanmıştır: Alan Uzunluk Değer Açıklama 1 1veya2 paket başlangıç gösterici (text başı). 1 ise, CSum hesaplanmaz Stx calculating. Eğer 2 ise, Csum hesaplanır. paket (text başı). Adres Hedef okuyucu adresi. anlamı değer cihaz ile değiştirilebilir demektir. Her zaman = 0, çünkü slave cevabı hep sunucuyu hedefler. Uzunluk gönderilen komuta göre değişir. anlamı değer komutla değiştirilebilir demektir. cevapla değişir. anlamı değer komutla değiştirilebilir demektir. Data N komut veya data isteği içerikleri (komutla değişir). cevap içeriği (cevapla değişir) RPkt, data doğrulama işareti. İstemci gelen paketin Csum unu Csum hesaplar ve hesaplanan Csum ın farklı olması durumunda alınan paket geçersiz olarak değerlendirilir. CSum hesaplaması: CSum=Address xor Length xor Data1 xor... xor DataN. Checksum geliştirici işlemes amaçlıdır. Etx 1 3 paket sonu indeksi (Text sonu). paket sonu indeksi (Text sonu). Tablo 08: Detaylı binary paket yapısı Bazı kaza eseri durumlarda istenmeyen davranışları önlemek için okuyucular data bufferlarını boşaltır ve başlangıç moduna (Stx wait) dönerler. Bu durumlar aşağıdaki gibidir: 1. Hatalı Stx alımı (paket başlangıç indeksi); 2. İki byte arasındaki süre 20ms yi aşmaktadır; 3. Beklenen data byte miktarından fazlasını almak; 4. Hesaplanan ve alınan sağlama toplamında uyumsuzluk; 5. Hatalı Etx alımı (paket bitiş indeksi); 6. Hatalı veya saçma komut veya datanın data alanında bulunması. 10

10 V. Okuyucu Komutları Select Card Extended Select Card Sector Login Configure Sector Read Sector Form Read Block Block Write Write Value Read Value Copy Value Increment Value Decrement Value Write Master Key Set Digital Input / Output Simple Digital Input / Output Read Device Settings Write Device Settings Usb12M Tablo 09: Okuyucuda kullanılabilen komutlar ( : uygun, : uygun değil ) 11

11 1. Mifare Komutları 1. Select Card: Kartın seri numarasını okur. Stx 02H Adres... Uzunluk 01H Data s (73H) CSum... Etx 03H 1. Select Card successful: s1,...,s4 seçili kartın seri numarası. 02H 00H 04H s1, s2, s3, s H 2. No card: 02H 00H 01H N (4EH) 4FH 03H Tx Rx C 2C Açıklamalı Değer(Hex) Alan Açıklama 01 Uzunluk Data Uzunluğu (komuta göre değişir) 73 Command No Komut numarası Açıklamalı 04 Uzunluk Data Uzunluğu (komuta göre değişir) 02 5C 2C 62 Data Unique ID 14 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 2. Extended Select Card: Kartın tipini ve seri numarasını okur. Stx Adres Uzunlu Data CSum Etx 02H... k 02H s, x (73H,78H )... 03H 1. Select Card successful: t seçili kartın tipi, s1,...,s4 serial No. 02H 00H 05H t, s1, s2, s3, s H 12

12 2. No card: 02H 00H 01H N (4EH) 4FH 03H Tx Rx C 2C Açıklamalı 02 Uzunluk Data Uzunluğu (komuta göre değişir) Command No Komut numarası Açıklamalı 05 Uzunluk Data Uzunluğu (komuta göre değişir) 02 Card Type Kartın tipini gösterir. 02 nin anlamı, kart 1Kblık kart demektir. 02 5C 2C 62 UID Card Unique ID 17 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 3. Sector Login: a. Philips fabrika key A ile 02H... 04H l (6CH), Sector N, FFH, 0DH... 03H b. Infineon fabrika key A ile 02H... 04H l (6CH), Sector N, AAH, 0DH... 03H c. Infineon fabrika key B ile 02H... 04H l (6CH),Sector N, BBH, 0DH... 03H d. Direkt olarak key A ile 02H... 09H l, S.No, AAH, a1, a2, a3, a4, a5, a H e. Direkt olarak key B ile 02H... 09H l, S.No, BBH, a1, a2, a3, a4, a5, a H f. Master key ile, key tipi A 02H... 03H l, S.No, 10H+Key No (0..31)... 03H 13

13 g. Master key ile, key tipi B 02H... 03H l, S.No, 30H+Key No (0..31)... 03H 02H 00H 01H L (4CH) Sector Login Successful 4DH 03H N (4EH) No Card 4FH F (46H) Fail : Faulty Key 47H E (45H) Erroneous Command form 44H Tx C 0A AA FF FF FF FF FF FF 03 Rx C 4D 03 Açıklamalı 09 Uzunluk Data Uzunluğu (komuta göre değişir) 6C Command No Komut numarası 0A Sector No Sektör numarası AA Key Direkt olarak key AA ile FF FF FF FF FF FF Key A a1, a2, a3, a4, a5, a6 Açıklamalı Değer(Hex) Alan Açıklama 01 Uzunluk Data Uzunluğu (komuta göre değişir) 4C Command No Komut numarası 4D Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı Diğer Login Tipi Örnekleri: Sector Login RPkt Örnekleri. Tüm komutlar 1. Okuyucuyu adres gösterir. Sector Login RPkt Login tipi C 0A FF 0D 03 Philips factory key A C 0A AA 0D 03 Infineon factory key A C 0A BB 0D 03 Infineon factory key B C 0A AA FF FF FF FF FF FF 03 Direct key A=53, 62, B2, 4D, 8E, 9C C 0A BB FF FF FF FF FF FF 03 Direct key B=53, 62, B2, 4D, 8E, 9C C 0A 1E 03 Master key No: 1E(30), key A C 0A 3B 03 Master key No: 3B(59), key B 14

14 4. Configure Sector: Stx Adres Uzunlu Data CSum Etx 02H... k 0FH f (66H), Sector No, Form No, a1,.., a6, b1,.., b H 02H 00H 01H B (42H) Sector Configure Successful 43H 03H N (4EH) No Card 4FH F (46H) Fail 47H E (45H) Erroneous Command form 44H Tx F 66 0A 0F FF FF FF FF FF FF FF FF FF FF FF FF 03 Rx Açıklamalı 0F Uzunluk Data Uzunluğu (komuta göre değişir) 66 Command No Komut numarası 0A Sector No Sektör numarası 0F Form No Form number FF FF FF FF FF Key A Key A (6 Byte) FF FF FF FF FF FF Key B Key B (6 Byte) FF Açıklamalı Değer(Hex) Alan Açıklama 01 Uzunluk Data Uzunluğu (komuta göre değişir) 42 Command No Komut numarası 43 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 5. Read Sector Form: Stx Adres Uzunlu Data CSum Etx 02H... k 03H rf (72H, 66H), Sector No (00H..0FH)... 03H 15

15 02H 00H 01H 00H..0FH Form No 03H U (55h) Unknown Form No 54H N (4EH) No Card 4FH F (46H) Fail 47H E (45H) Erroneous command form 44H Tx A 03 Rx F 0E 03 Açıklamalı 03 Uzunluk Data Uzunluğu (komuta göre değişir) 72, 66 Command No Komut numarası 0A Sector No Sektör numarası Açıklamalı 01 Uzunluk Data Uzunluğu (komuta göre değişir) 0F Form No Form numarası 0E Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 6. Read Block: Stx Adres Uzunlu Data CSum Etx 02H... k 02H r (72H), Block No... 03H 02H 00H 10H or 01H B1, B2,...,B H 16

16 ByteNo Data Açıklama 1 B1 or read failure sign Eğer uzunluk 10H : Block No N Byte 1 Eğer uzunluk 01H : F (46H) read fail N (4EH) no card 2 B2 Block No N Byte 2 3 B3 Block No N Byte B16 Block No N Byte 16 Tablo 10: Read Block ACK tablosu Tx Rx FF FF FF FF FF FF FF FF FF FF Açıklamalı 02 Uzunluk Data Uzunluğu (komuta göre değişir) 72 Command No Komut numarası 28 Block No Blok numarası Açıklamalı 10 Uzunluk Data Uzunluğu (komuta göre değişir) FF FF FF FF FF Data Blok datası FF FF FF FF FF Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 7. Block Write: Stx Adres Uzunlu Data CSum Etx 02H... k 12H w (77H), Block No, B1, B2,...,B H 02H 00H 10H or 01H B1, B2,...,B H 17

17 ByteNo Data Açıklama 1 B1 or write failure sign Eğer uzunluk 10H: Block No N Byte 1 Eğer uzunluk 01H: F (46H) write failure N (4EH) no card present 2 B2 Blok No N Byte 2 3 B3 Blok No N Byte B16 Blok No N Byte 16 Tablo 11: Block Write ACK tablosu Tx FF 00 FF 00 FF 00 FF 00 FF 00 FF 00 FF 00 FF Rx FF 00 FF 00 FF 00 FF 00 FF 00 FF 00 FF 00 FF Açıklamalı 12 Uzunluk Data Uzunluğu (komuta göre değişir) 77 Command No Komut numarası 01 Block No Blok numarası FF 00 FF 00 Data Blok datası FF 00 FF 00 FF 00 FF 00 FF 00 FF 00 Açıklamalı 10 Uzunluk Data Uzunluğu (komuta göre değişir) FF 00 FF 00 Data Blok datası FF 00 FF 00 FF 00 FF 00 FF 00 FF Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 18

18 8. Write Value: Stx Adres Uzunlu Data CSum Etx 02H... k 07H wv (77H,76H), Value Block No, B1, B2, B3, B H 02H 00H 04H or 01H B1, B2, B3, B H ByteNo Data Açıklama 1 B1 or write failure sign Eğer uzunluk 04H: Value Block No N - Byte 1 Eğer uzunluk 01H: F (46H) write failure N (4EH) no card 2 B2 Value Block No N - Byte 2 3 B3 Value Block No N - Byte 3 4 B4 Value Block No N - Byte 4 Tablo 12: Write Value ACK tablosu Tx D Rx D FC 03 Açıklamalı 07 Uzunluk Data Uzunluğu (komuta göre değişir) Command No Komut numarası(2 Bytes) 29 Block No Değer blok numarası D Değer B1, B2, B3, B4 Açıklamalı 04 Uzunluk Data Uzunluğu (komuta göre değişir) D Değer B1, B2, B3, B4 FC Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 19

19 9. Read Value: Stx Address Length Data CSum Etx 02H... 03H rv (72H,76H), Value Block No... 03H 02H 00H 04H or 01H B1, B2, B3, B H ByteNo Data Açıklama 1 B1 or read failure sign Eğer uzunluk 04H : Value Block No N - Byte 1 Eğer uzunluk 01H : F (46H) read failure N (4EH) no card 2 B2 Value Block No N - Byte 2 3 B3 Value Block No N - Byte 3 4 B4 Value Block No N - Byte 4 Tablo 13: Read Value ACK tablosu Tx Rx D D6 03 Açıklamalı 03 Uzunluk Data Uzunluğu (komuta göre değişir) Command No Komut numarası(2 Bytes) 29 Block No Değer blok numarası Açıklamalı 04 Uzunluk Data Uzunluğu (komuta göre değişir) D5, 07, 00, 00 Değer D5 = 2005 decimal olarak D6 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 20

20 10. Copy Value: kaynak değer bloğunu hedef değer bloğuna kopyalar Stx Adres Uzunlu Data CSum Etx 02H... k 03H = (3DH), Source Value Block No, Target Value Block No... 03H 02H 00H 04H veya 01H B1, B2, B3,... 03H B4 ByteNo Data Açıklama Eğer uzunluk 04H: Target Value Block No N new value- Byte 1 1 B1 or read failure sign Eğer uzunluk 01H : F (46H) copy failure N (4EH) no card 2 B2 Target Value Block No N new value - Byte 2 3 B3 Target Value Block No N new value - Byte 3 4 B4 Target Value Block No N new value - Byte 4 Tablo 14: Copy Value ACK tablosu Tx D Rx D Açıklamalı 03 Uzunluk Data Uzunluğu (komuta göre değişir) 3D Command No Komut numarası 29 Block No Kaynak değer bloğu numarası 28 Block No Hedef değer bloğu numarası Açıklamalı 04 Uzunluk Data Uzunluğu (komuta göre değişir) D5, 07, 00, 00 Değer D5 = 2005 decimal olarak D6 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 21

21 11. Increment Value: Value Block un değerini artırır. Stx Adres Uzunlu Data Csum Etx 02H... k 06H + (2BH), Block No, B1,B2,B3,B4 (B1..B4-inc. value)... 03H 02H 00H 04H or 01H B1, B2, B3, B H ByteNo Data Açıklama 1 B1 or read failure sign Eğer uzunluk 04H: Value Block No N new value- Byte 1 Eğer uzunluk 01H: F (46H) increment failure N (4EH) no card 2 B2 Value Block No N new value - Byte 2 3 B3 Value Block No N new value - Byte 3 4 B4 Value Block No N new value - Byte 4 Tablo 15: Increment Value ACK tablosu Tx B 28 D Rx AA 0F A1 03 Açıklamalı 06 Uzunluk Data Uzunluğu (komuta göre değişir) 2B Command No Komut numarası 28 Block No Değer blok numarası D Değer B1, B2, B3, B4 Açıklamalı 04 Uzunluk Data Uzunluğu (komuta göre değişir) AA 0F Değer AA 0F = 4010 decimal olarak A1 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 22

22 12. Decrement Value: Value Block un değerini azaltır. 02H. 06H - (2DH), Block No, B1,B2,B3,B4 (B1..B4-dec. Value)... 03H.. 02H 00H 04H veya 01H B1, B2, B3, B H ByteNo Data Açıklama 1 B1 or read failure sign Eğer uzunluk 04H: Value Block No N new value- Byte 1 Eğer uzunluk 01H: F (46H) decrement failure N (4EH) no card 2 B2 Value Block No N new value - Byte 2 3 B3 Value Block No N new value - Byte 3 4 B4 Value Block No N new value - Byte 4 Tablo 16: Decrement Value ACK tablosu Tx D 28 D Rx Açıklamalı 06 Uzunluk Data Uzunluğu (komuta göre değişir) 2D Command No Komut numarası 28 Block No Değer blok numarası D Değer B1, B2, B3, B4 Açıklamalı 04 Uzunluk Data Uzunluğu (komuta göre değişir) Değer Azaltılan B1, B2, B3, B4 04 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 23

23 13. Write Master Key: Stx Adres Uzunlu Data CSum Etx 02H... k 09H wm (77H, 6DH), Key No, B1, B2,..., B H 02H 00H 01H B (42H) Reader key write successful 43H 03H F (46H) Reader key write failure 47H E (45H) Erroneous command form 44H Tx D 00 FF FF FF FF FF FF 03 Rx Açıklamalı 09 Uzunluk Data Uzunluğu (komuta göre değişir) 77 6D Command No Komut numarası 00 Key No Key numarası FF FF FF FF FF FF Key Master key Açıklamalı 01 Uzunluk Data Uzunluğu (komuta göre değişir) 42 Ack no Reader key write successful B (ASCII) 43 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 24

24 2. I/O Ayarlama Komutları 14. Set Digital I/O s On/Off + Read Input/Output + Select Card: Bu komutu uygulamak için Digital I/O nun On/Off açıklama tablosuna (Tablo 17) bakın. 02H.. 0AH p (70H), w (77H), K1, K2, S1, S2, S3, S4, S5, S H. ByteNo Data Açıklama / Atanan Değerler Bit Değer Tanım 00 IO4: Değiştirme 7,6 01 IO4: On 10 IO4: Blink (100 ms on, 100 ms off) 11 IO4: Off 00 IO3: Değiştirme 5,4 01 IO3: On 10 IO3: Blink (100 ms on, 100 ms off) 3 K1 (Komutlar) 11 IO3: Off 00 IO2: Değiştirme 3,2 01 IO2: On 10 IO2: Blink (100 ms on, 100 ms off) 11 IO2: Off 00 IO1: Değiştirme 1,0 01 IO1: On 10 IO1: Blink (100 ms on, 100 ms off) 11 IO1: Off Bit Değer Tanım 00 Disable Select Card 7,6 01 Enable Select Card 10 Enable Extended Select Card 11 Disable Select Card 5,4 4 K2 (Komutlar) 00 IO6: Değiştirme 3,2 01 IO6: On 10 IO6: Blink (100 ms on, 100 ms off) 11 IO6: Off 00 IO5: Değiştirme 1,0 01 IO5: On 10 IO5: Blink (100 ms on, 100 ms off) 11 IO5: Off 5 S1 IO1 on (or blink) time x 100ms. =0 means permanently on 6 S2 IO2 on (or blink) time x 100ms. =0 means permanently on 7 S3 IO3 on (or blink) time x 100ms. =0 means permanently on 8 S4 IO4 on (or blink) time x 100ms. =0 means permanently on 9 S5 IO5 on (or blink) time x 100ms. =0 means permanently on A S6 IO6 on (or blink) time x 100ms. =0 means permanently on Tablo 17: Digital I/O nun On/Off tanım tablosu 1. Uzunluk=1 Stx Adres Uzunlu Data CSum Etx 02H 00H k 01H DIO... 03H 2. Uzunluk=2: Kart mevcut değil 02H 00H 02H DIO, N (4EH)... 03H 25

25 3. Uzunluk=5: Select Card Successful: s1,...,s4 serial No 02H 00H 05H DIO, s1, s2, s3, s H 4. Uzunluk=6: Select Card Successful: t selected card type; s1,...,s4 serial No 02H 00H 06H DIO, t, s1, s2, s3, s H Tx A A A 0A Rx C C 2C Açıklamalı 0A Uzunluk Data Uzunluğu (komuta göre değişir) Command No Komut numarası 61 K1 IO4:On, IO3:Blink(100ms on 100ms off), IO2:Değiştirme, IO1:On 81 K2 Genişletilmiş seçim kartını etkinleştirin, IO6:Değiştirme, IO5:On 0A S1 IO1 on(veya blink) 10 x 100ms 73 S2 IO2 on(veya blink) 115 x 100ms 05 S3 IO3 on(veya blink) 5 x 100ms 0A S4 IO4 on(veya blink) 10 x 100ms 0A S5 IO5 on(veya blink) 10 x 100ms 01 S6 IO6 on(veya blink) 1 x 100ms Açıklamalı 06 Uzunluk Data Uzunluğu (komuta göre değişir) 1C Data IO1:Off, IO2:Off, IO3:On, IO4:On, IO5:On, IO6:Off 02 CardType Seçili kart tipi 02 5C 2C 62 UID Kart Unique ID (Seri numarası) 08 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 26

26 15. Set Simple Digital IO: Cihaz istenilen dijital çıkışı aktive eder (çalıştırmak ya da yanıp söndürmek). RPktC: Stx Adres 02H. Uzunluk 03h Data o (6FH), IONo, OnT CSum... Etx 03H.. ByteNo Data Açıklama / Atanan değerler Bit Değer Tanım Sürekli açık IONo 7,6,5, Blink (100 ms açık, 100 ms kapalı) 3,2,1,0 0H..5H Digital I/O # 3 OnT On (veya blink) time x 100ms. =0 demek sürekli açık Tablo 18: Basit DIO tablosu Tx F Rx Açıklamalı 03 Uzunluk Byte uzunluğu (komuta göre değişir) 6F Command No Komut numarası 12 IONo Input/Output numarası.set Digital I/O,Blink 14 OnT Set on(veya blink) 20 x 100ms = 2.0 sec Açıklamalı 01 Uzunluk Data Uzunluğu (komuta göre değişir) 04 I/O bits Sürekli On digital I/O 05 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 27

27 3. Cihaz Ayarlama Komutları 16. Read Device Settings: Stx Adres 02H. Uzunluk 01H Data d (64H) CSum... Etx 03H.. Stx 02H Adres 00H Uzunluk 40H Data B00, B01,, B63 CSum... Etx 03H 02H 00H 01H E (45H) Unknown Command Form 44H 03H # Pos Parameter Values Default Code 01 0 TermStpIntl 85 -initialize 55H 02 1 TermAddr H 03 2 CommSpeed 99H, 88H, 77H, 66H, 55H 00H 04 3 CommParity 99H, 88H, 77H, 66H, 55H 00H 05 4 CommType 99H, 88H, 77H, 66H 00H 06 5 CardReadMode 99H, 88H, 77H, 66H, 55H, 44H 99H 07 6 KeyNoAndType A (0..31), B( ) 01H 08 7 BuzzerBeepTime in 100 miliseconds 00H 09 8 BlockNo H 10 9 SectorNo H HWType H HWModel H HWIssue H FWRevision H FWIssue H RFU StartBlinkPosLCD 1..32, if disabled = 0 00H EndBlinkPosLCD 1..32, if disabled = 0 00H LCDTextWhenIdle Tablo 19: Cihaz Ayarları setup tablosu Parametre Açıklamaları Par # 01: TermStpIntl terminal setup tablosu başlatılır. Eğer 85 olarak ayarlanmamışsa varsayılanlar dikkate alınacaktır. Par # 02 Par # 05: TermAddr, CommSpeed, CommParity, CommType Haberleşme parametreleri. Bu parametrelerin herhangi birini değiştirmek bir etkide bulunmayacaktır. Bunlar varsayılan ayarlardır. Bu parametreler komutla gönderilmelidir fakat değerlendirmeye alınmazlar. CommSpeed 99H bps, 88H bps, 77H bps, 66H bps, 55H bps olabilir, CommParity 99H - No, 88H - Odd, 77H - Even, 66H - Mark, 55H Space olabilir. CommType 99H Rs485 4 wires, 88H Rs485 2 wires, 77H Rs422, 66H Rs232 olabilir. 28

28 Par # 06: CardReadMode Card read modu 99H Standard mode, 88H Send UID, 77H Send block, 66H Send sector, 55H Send UID ASCII, 44H Send block ASCII. Send UID, Send Block, Send Sector, Send UID ASCII ve Send Block ASCII modları APktA ( Automatic Answer Packets) ile cevaplar. Standard mode Send UID Send block Send sector Send UID ASCII Okuyucu sadece virtual seri port ile alınan komutları yürütür. Okuyucu select card komutunu sürekli olarak uygulamaz. Seri komutların yürütülmesiyle birlikte, okuyucu boştayken (seri kanalda 1 saniyeden uzun sürede bir aktivite yok iken) sürekli şekilde select card komutunu yürütür ve geçerli bir kartın okutulmasıyla sunucuya bir data paketi gönderilir. Boştayken okuyucu geçerli bir kart için tarama yapar. Bir tespit durumunda sektöre login olmaya çalışır. Login parametre # 7deki gibi key # kullanılarak Login Sector with Master Key komutuyla yapılır. Eğer login başarılıysa yukarda bahsedilen bloğu okur ve doğru tamamlama halinde cevap oluşturulur ve sanki bir Read Block komutu yürütülmüş gibi seri kanala alınır. Okuyucu send block modu tarzında çalışır. Farklı olarak parametre #10da belirtildiği gibi sektörün ilk 3 bloğunu okur. Yeni oluşturulan paketin data uzunluğu 30H dir. (16 bytelık 3 blok). Seri komutların yürütülmesiyle birlikte, okuyucu boştayken (seri kanalda 1 saniyeden uzun sürede bir aktivite yok iken) sürekli şekilde select card komutunu yürütür ve geçerli bir kart okutulmasında bir paket 2 byte uzunluğunda okuyucu adresi + 8 byte uzunluğunda kart unique tanımlayıcı (UID) + taşıyıcı dönüş karakteri + satır besleme karakteri içerir. Eğer okuyucu # 1, kartı UID = 02 5C 2C 62 olacak şekilde okursa, aşağıdaki paket gönderilecektir.: D 0A. Rx(Hex) ASCII Açıklama 30 0 Okuyucu Adresi C Card UID C D CR Carriage return 0A LF Yeni Satır (Line feed) Send block ASCII Okuyucu send block modunda olduğu zamanki gibi aynı operasyonları uygular. Bu modda cevap paketi Send UID ASCII paketine benzemektedir. Fakat 8 byte yerine 32 byte data gönderilir: 2 byte uzunluğunda okuyucu adresi + 32 byte uzunluğunda blok data+ taşıyıcı dönüş karakteri + satır besleme karakteri. 29

29 Par # 07: KeyNoAndType En önemsiz 7 bit (b0 b6) = master key #, okuyucu send block, send sector veya send block ASCII modlarından birisindeyken login amaçlı kullanılır. Eğer en önemli bit (b7) ayarlanırsa, login key B ile yapılacaktır. Kullanım öncesinde, belirtilen master key uygun değerlerle yazılmalıdır. Par # 08: BuzzerBeepTime Başarılı kart okuma sonrası zil sesi süresi. Değerler 100 milisaniyedir. Par # 09: BlockNo Bir blok okuma modu seçildiği durumda okutulacak blok numarası değerleri arasındadır. Par # 10: SectorNo Bir sektör okuma modu seçildiği durumda okutulacak sektör numarası değerleri arasındadır. Par # 10: HWType, HWModel, HWIssue, FWRevision, FWIssue HWType cihazın tipini gösterir. HWModel cihazın modelini gösterir. HWIssue cihazın ürün yayım bilgisini gösterir. FWRevision cihazın firmware revizyon bilgisini gösterir. FWIssue cihazın firmware yayım bilgisini gösterir. Bu parametreler her zaman 0 dır ve değerlendirilmezler. Par # 17 Par # 19: StartBlinkPosLCD, EndBlinkPosLCD, LCDTextWhenIdle StartBlinkPosLCD ilk yanıp/sönme karakterinin pozisyonunu gösterir. Bu değer 1 ve 32 arasındadır ve devre dışı bırakılırsa 0 olabilir. EndBlinkPosLCD ilk yanıp/sönme karakterinin pozisyonunu gösterir. Bu değer 1 ve 32 arasındadır ve devre dışı bırakılırsa 0 olabilir. LCDTextWhenIdle terminal boştayken LCDde görünen varsayılan yazıyı gösterir. Bu değer 32 ve 255 arasında olabilir. Tx Rx FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 4B E 49 5A F 4B E 4B A E E5 03 Açıklamalı 01 Uzunluk Data Uzunluğu (komuta göre değişir) 64 Command No Komut numarası 30

30 Açıklamalı 40 Uzunluk Data Uzunluğu (komuta göre değişir) 55 Initiliaze Terminal setup initiliazed 01 TermAddress Terminal Adres 00 CommSpeed Haberleşme hızı. 00 CommParity Haberleşme paritesi. 00 CommType Haberleşme tipi. 88 CardReadMode Kart okuma modu 88H = Send UID 01 KeyNoAndType Key no ve tipi. 01H = Key A ile login 37 BuzzerBeepTime Buzzer ötüş süresi 55 ms 00 BlockNo Blok numarası 10 SectorNo Sektör numarası 00 HWtype Terminal tipi 00 HWmodel Terminal modeli 00 HWissue Terminal ürün yayım bilgisi 00 FWrev Terminal firmware revizyon bilgisi 00 FWissue Terminal firmware yayım bilgisi FF FF FF FF FF FF FF FF FF RFU Gelecekte kullanım için rezerve FF FF FF FF FF FF FF FF 4B E 49 5A F 4B E 4B A E Screen Text Varsayılan text KARTINIZI OKUTUN KAPI: #n# (#n# kapı numarasını gösterir) E5 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 17. Write Device Settings: Cihaz ayar tablosu (Tablo 19) size bu komutun uygulanmasında yardımcı olacaktır. 02H... 41h c (63H), B00, B01,, B H 02H 00H 01H B (42H) Successful write 43H 03H F (46H) Fail 47H E (45H) Unknown Command Form 44H Tx B E 49 5A F 4B E 4B A E

31 Rx Açıklamalı 41 Uzunluk Data Uzunluğu (komuta göre değişir) 63 Command No Komut numarası 00 Initiliaze Terminal kurulumu başlatılır(değiştirmek bir etki yapmaz) 01 TermAddress Terminal Adres 00 CommSpeed Haberleşme hızı.77h = bps(değiştirmek bir etki yapmaz) 00 CommParity Haberleşme paritesi. 99H = No parity bit(değiştirmek bir etki yapmaz) 00 CommType Haberleşme tipi. 66H = Rs232(Değiştirmek bir etki yapmaz) 88 CardReadMode Kart okuma modu 88H = Send UID 01 KeyNoAndType Key no ve tipi. 01H = Key A ile login 37 BuzzerBeepTime Buzzer ötüş süresi 55 ms 00 BlockNo Blok numarası 10 SectorNo Sektör numarası 00 HWtype Terminal tipi 00 HWmodel Terminal modeli 00 HWissue Terminal ürün yayım bilgisi 00 FWrev Terminal firmware revizyon bilgisi 00 FWissue Terminal firmware yayım bilgisi RFU Gelecekte kullanım için rezerve B E 49 5A F 4B E 4B A E Screen Text Varsayılan text KARTINIZI OKUTUN KAPI: #n# (#n# kapı numarasını gösterir) Açıklamalı 01 Uzunluk Data Uzunluğu (komuta göre değişir) 42 Command No Komut numarası 43 Checksum Tablo 08 e bakın: Checksum hesaplanması için detaylı binary paket yapısı 32

32 Tablo Listesi Tablo 02: Usb12M özellikleri... 6 Tablo 04: Mifare kart bellek yapısı 7 structure... Tablo 05: Önerilen sektör formları ve 0F(factory form): 0, 1, 2 blokları için tipler, keyler ve operasyonlar... 8 Tablo 06: Önerilen sektör formları and 0F(factory form): Erişim bloğu operasyonları için gerekli keyler... 9 Tablo 07: Binary paket yapısı... 9 Tablo 08: Detaylı Binary paket yapısı Tablo 09: Uygun komutlar tablosu Tablo 10: Read Block ACK tablosu Tablo 11: Block Write ACK tablosu Tablo 12: Write Value ACK tablosu Tablo 13: Read Value ACK tablosu Tablo 14: Copy Value ACK tablosu Tablo 15: Increment Value ACK tablosu Tablo 16: Decrement Value ACK tablosu Tablo 17: Digital IO s On/Off açıklama tablosu Tablo 18: Basit DIO tablosu Tablo 19: Cihaz ayarları kurulum tablosu Tablo 20: Gelişmiş cihaz ayarları kurulum tablosu Tablo 21: RSIR (Device Last Reset Reason) tablosu Tablo 22: Key No ve Değerler tablosu

33 RDR Programmer s Manual Usb12M Uygulama Notları 1. Tüm komut örneklerinde RPkt ler checksum hesaplaması haricindedir (Stx = 1). Çünkü programcılar için uygulama kolaylığı vardır ve bu komutlar docklight proje dosyasındadır. 2. Kart operasyonlarını (Select Card, Sector Login, vb.), kullanmak için cihaz Standart Mode da olmalıdır. Device Setting Commandları ile cihazın modunu değiştirebilirsiniz. 34