uFR Shell, birden fazla işletim sisteminde μFR Serisi donanım komutlarının yürütülmesi için kullanılan bir komut satırı yazılım arabirimidir. Yazılım başlığından da anlaşılacağı gibi, bu μFR okuyucu kütüphaneleri tarafından tanımlanan bir dizi değişkene sahip bir kabuk ortamıdır.
Docs & Software Download
Yazılıma Genel Bakış
Yazılım fonksiyonları:
- μFR Serisi kütüphaneler ve API (Uygulama Programlama Arabirimi) tarafından tanımlanan bir dizi işlev.
Mevcut programlama dilleri:
- Yürütülebilir yazılım
Desteklenen işletim sistemleri, platformlar ve ortamlar:
- Windows işletim sistemi
- Linux işletim sistemi
- MAC İşletim Sistemi
- Ahududu Pi
Desteklenen etiketler, etiketler, kartlar:
- MIFARE Mini®
- MIFARE Klasik® (1K, 4K, EV1)
- MIFARE Ultra Hafif®
- MIFARE Ultra Hafif C®
- MIFARE Plus® (2K, 4K)
- MIFARE DESFire® (Işık, 2K, 4K, 8K, EV1, EV2)
- NXP NTAG® 21x (210, 213, 215, 216, Etiket Kurcalama)
- NXP NTAG® 4xx DNA (413, 424)
Önerilen donanım:
- μFR Nano
- μFR Nano Çevrimiçi
- μFR Klasik
- μFR Klasik CS
- μFR İlerlemesi
- μFR XL
- Temel HD (μFR uyumluluk modu)
Yazılım indirme
Açıklama
uFR Shell yürütülebilir yazılımı, konsol modunda μFR Serisi aygıtlar için komut satırı yürütmeyi etkinleştirir.
Yazılım El Kitabı
1. uFR Kabuğu – Yükleme ve yürütme
İndir: ufr-shell
Yazılım dosyasını indirin ve paketini açın.
Ayıklanan dosya kök klasörü, desteklenen işletim sistemleri için uFR Shell yazılım yürütme dosyalarını içeren alt klasörleri içerir.
Kök klasör ayrıca yazılım işlevleri listesini ve ek talimatları içerir.
Donanımınızı ve ilgili sürücülerinizi doğru şekilde yüklediyseniz, artık geçerli işletim sisteminiz için yürütülebilir dosyayı seçip çalıştırabilirsiniz.
2. uFR Kabuğu – Komut satırı arayüzü
İşletim sisteminden bağımsız olarak, uFR Shell yazılımı komut terminali olarak çalışır. Yazılım sürümü ekranın ilk satırında görüntülenir.
3. uFR Shell – Yazılım fonksiyonları
uFR Shell yazılımını uFR cihazınızda komutların yürütülmesi amacıyla kullanmak için, mevcut tüm işlevler hakkında bilgi sahibi olmanız gerekir. İşlev listesini yazılım kök klasöründe, UFR Shell_list dosyasında.txt bulabilirsiniz.
API Dokümanlar'da işlevlerin uygulanması ve uygulanmasına ilişkin talimatların yanı sıra daha fazla ayrıntı bulabilirsiniz.
3.1 – uFR Kabuğu – Komut satırı yürütme
Komut satırınız için doğru işlevi seçmek üzere, önce tüm işlev açıklamasıyla İşlev yardımını incelemenizi öneririz.
3.2 – uFR Kabuğu – Komut satırı yürütme örnekleri
Şimdi, nasıl çalıştığını görelim.
İlk olarak, bağlı μFR okuyucu ile iletişim kurmamız gerekir. Yani, ilk komutumuz ReaderOpen olacak.
Komutu yazın:
- OkuyucuAç
Okuyucu durumu Tamam ise, devam edebiliriz. Aksi takdirde, lütfen donanımınızı doğru şekilde takıp takmadığınızı kontrol edin.
EXAMPLE 1
Donanımın seri numarasını almak için şu komutu kullanın:
- GetReaderSerialNumber
Komutta tanımlanmış ek parametre yoksa, varsayılan çıktının HEX biçimi vardır.
EXAMPLE 2
Veri çıktısını başka bir biçimde almak için, kullanılabilir olanlar arasından çıktı biçimi modunu belirtmeniz gerekir:
- Onaltılık (h parametresi),
- Dize (parametre s)
- Ondalık (parametre d).
Belirtilen çıktı biçimi için komut satırı artık iki öğeye sahip olacaktır:
- 'İşlev' ' parametre modu.'
EXAMPLE 3
Reader seri numarasında olduğu gibi, Kart Kimliği varsayılan çıktısını almak için şu komutu kullanmanız yeterlidir:
- GetCardIdEx
Bu komut satırı için konsol, Kart türünü, UID'yi ve UID çıktısını varsayılan HEX biçiminde görüntüler.
EXAMPLE 4
Kart Kimliği çıktısının ağaç çıkış değerleri vardır. Önceki örnek, komut satırında
tanımlanmış parametre modu olmadan Kart Kimliği çıktısını gösterirBu örnek, karma çıktı biçiminin nasıl alınacağını açıklar. uFR Kabuğu, her çıktı değeri için belirli parametre modunu tanımlamanıza olanak tanır.
Komut satırı şöyle görünmelidir:
-
- 'İşlev' '1. parametre modu' '2. parametre modu' '3. parametre modu'
EXAMPLE 5
Komut satırınızdaki tüm parametreleri tanımlamazsanız, atanan parametre modu olmadan çıktı birimi biçimi HEX biçimini (varsayılan) korur.
Beklenen ağaç değerleri ve önceden tanımlanmış iki parametreli modlar için komut satırı aşağıdaki yapıya sahiptir:
- 'İşlev' '1. parametre modu' '2. parametre modu'
Bölüm 3.2, belirtilen bir parametre için çıktı değeri biçiminin nasıl tanımlanacağını açıklar. Ancak, çıktıyı sık sık onaltılık olmayan bir biçimde almanız gerekiyorsa, her parametreyi ayrı ayrı tanımlamak yerine tüm çıktı değerleri için varsayılan biçimi değiştirebilirsiniz.
Kalıcı çıktı biçimi değişikliği için (geçerli konsol kapatılana kadar) komut satırını çalıştırın:
- Çıktıyı ayarla ' yeni parametreler modu'
Yukarıdaki ekran görüntüsü, varsayılan giriş değeri biçimi hazır ayarını String (parametreler s) olarak gösterir.
EXAMPLE 1
Şimdi testi basit komut satırı ile çalıştıralım:
- GetCardIdEx
Artık komut satırında tanımlanmış ek parametre modu olmamasına rağmen çıktı sonuçları dize değerleridir.
Gördüğünüz gibi, tüm çıktı değerleri ilk karakterlerinin yerine Ters eğik çizgi karakteri () olan dize değerleridir. Yazılım, yazdırılamayan karakterleri içeren çıktı değerlerine bu karakteri otomatik olarak ekler.
EXAMPLE 2
Sonraki örnek, değer yazdırılabilir olduğunda dize çıktısını sunar.
İçeriği karta yalnızca yazdırılabilir karakterlerle yazalım.
Örnek komut satırı şöyledir:
- WriteUserData "Örnek-Test"
Not: Kaydedilecek dize içeriği komut satırında tırnak işaretleri içinde yazılır.
Şimdi, içerik çıktısını okuyun. Komut satırı şöyledir:
-
- ReadUserData
Bu durumda, çıktının başında Ters Eğik Çizgi karakteri yoktur. Çıktı içeriğinin geri kalanı (önceden kaydedilmiş içeriği izleyen) varsayılan değerlerdir – xFF değerleri olarak görüntülenen kullanılmayan baytlar.
4. uFR Kabuğu – Desteklenen işletim sistemi ortamlarındaki uygulama farklılıkları
- Windows İşletim Sistemi – Windows sisteminde uygulama, uFR Kabuğu işlevleriyle çalışmak için ek izinler gerektirmez. ufr okuyucuyu ve kütüphanelerini düzgün bir şekilde kurmak yeterlidir.
- Linux işletim sistemi – Linux sisteminde her zamanki gibi, cihazla iletişimde uFR Shell yazılımının tam işlevselliği uygun kullanıcı izni gerektirir.
- MacOS – Bu işletim sisteminde anında yazılım işlevselliğini sağlamak için libuRCoder.dylib kitaplığını sistem kitaplıkları klasörüne kopyalayın.
Bu kılavuz, birkaç temel işlevi olan yazılım örnekleri sunmaktadır. Desteklenen tüm işlevlerin bir listesi yazılım indirme paketine dahil edilmiştir.