.TH pn53x-tamashell 1 "September 15, 2010"
.SH "نام (NAME)"
pn53x-tamashell \- پوسته نمایشی ارتباطات TAMA برای تراشه‌های PN53x
.SH "خلاصه دستور (SYNOPSIS)"
.B pn53x-tamashell
.IR [script]
.SH "توضیحات (DESCRIPTION)"
.B pn53x-tamashell
یک ابزار تعاملی ساده برای ارسال دستورات موسوم به TAMA و دریافت پاسخ‌های آن‌ها است.
منظور از TAMA، مجموعه دستورات پشتیبانی‌شده توسط خانواده تراشه‌های PN53x است.
پیام‌ها باینری هستند و این پوسته انتظار نمادگذاری هگزادسیمال (شانزده‌شانزدهی) را دارد.
پیشوندهای دستورات و پاسخ‌های TAMA (شامل 0xD4/0xD5)، بررسی افزونگی چرخه‌ای (CRC) و هرگونه فریم‌بندی بالاتر به‌صورت خودکار و شفاف مدیریت می‌شوند.
.PP
می‌توانید از این پوسته به‌صورت تعاملی (همراه با پشتیبانی از readline) استفاده کنید یا اسکریپت خود را بنویسید که شامل دستورات و توضیحات (هر چیزی که با «;»، «#» یا «//» شروع شود) باشد.
فاصله‌ها نادیده گرفته می‌شوند و می‌توان از آن‌ها برای خوانایی بهتر استفاده کرد.
.PP
از شی‌بنگ (Shebang) پشتیبانی می‌شود؛ کافی است اسکریپت خود را با خط زیر آغاز کنید:
.PP
.nf
 #!/usr/bin/env \fBpn53x-tamashell\fP
.fi
.SH "دستورات (COMMANDS)"
.TP
\fIp N\fP
ایجاد وقفه و مکث به مدت N میلی‌ثانیه.
.TP
\fIq\fP یا \fICtrl-d\fP
خروج از برنامه.
.SH "مثال‌ها (EXAMPLES)"
دستور GetFirmware برابر با D4 02 است، بنابراین فقط کافی است دستور «02» ارسال شود:
.PP
.nf
 $ \fBpn53x-tamashell\fP
 Connected to NFC reader: SCM Micro/SCL3711-NFC&RW - PN533 v2.7 (0x07)
 > 02
 Tx: 02
 Rx: 33  02  07  07
 > 40
 Tx: 40
 Rx: Command Not Acceptable
 > q
 Bye!
.fi
.PP
همین کار با یک اسکریپت:
.PP
.nf
 $ \fBpn53x-tamashell\fP << EOF
 // This is a comment
 02 // GetFirmware
 40 // Command with missing arguments
 EOF

 Connected to NFC reader: SCM Micro/SCL3711-NFC&RW - PN533 v2.7 (0x07)
 > // This is a comment
 > 02 // GetFirmware
 Tx: 02
 Rx: 33  02  07  07
 > 40 // Command with missing arguments
 Tx: 40
 Rx: Command Not Acceptable
 > Bye!
.fi
.SH "گزینه‌ها (OPTIONS)"
.TP
.IR script
فایل اسکریپت حاوی دستورات tama.
.SH "اشکالات (BUGS)"
لطفاً هرگونه اشکال را در سامانه پیگیری اشکالات
.B libnfc
گزارش دهید:
.br
.BR https://github.com/nfc-tools/libnfc/issues
.SH "مجوز (LICENCE)"
.B libnfc
تحت مجوز عمومی کمتر گنو (LGPL) نسخه ۳ منتشر شده است.
.br
.B libnfc-utils
و
.B libnfc-examples
تحت پوشش مجوز ۲-بندی BSD هستند.
.PP
این صفحه راهنما تحت شرایط مجوز GNU GPL (نسخه ۲ یا بالاتر) منتشر شده است.