MSR605 カードリーダー/ライター - ユーザーガイド
MSR605カードリーダー/ライターのユーザーガイドへようこそ!このドキュメントでは、磁気ストライプカードの読み取りと書き込みを行うためのアプリケーションの使い方について説明します。
目次
- インストール
- はじめに
- カードの読み取り
- カードへの書き込み
- 設定
- トラブルシューティング
インストール
Windows
- リリースページから最新のインストーラーをダウンロード
- インストーラーを実行し、画面の指示に従う
- MSR605デバイスを利用可能なUSBポートに接続
- スタートメニューまたはデスクトップのショートカットからアプリケーションを起動
Linux/macOS
- Python 3.8以上がインストールされていることを確認
- 必要な依存関係をインストール:
pip install -r requirements.txt
- アプリケーションを実行:
はじめに
デバイスの接続
- MSR605デバイスをUSBケーブルでコンピュータに接続
- アプリケーションが自動的にデバイスを検出するはずです
- 接続が成功するとステータスバーに「デバイス接続済み」と表示されます
メインインターフェース
- カードデータ表示: カードから読み取ったデータを表示
- トラック選択: 読み取り/書き込みするトラックを選択(1、2、3)
- 操作ボタン: 読み取り、書き込み、クリア機能
- ステータスバー: 接続状態と操作結果を表示
カードの読み取り
- 磁気ストライプカードをリーダーに挿入
- 「読み取り」ボタンをクリック
- カードデータがメインウィンドウに表示されます
- データを保存するには、「ファイル」>「名前を付けて保存…」をクリック
カードへの書き込み
- 書き込み可能な磁気ストライプカードをライターに挿入
- 書き込むデータを適切なトラックフィールドに入力または貼り付け
- 書き込むトラックを選択
- 「書き込み」ボタンをクリック
- ステータスバーに操作結果が表示されます
カードフォーマットのサポート
このアプリケーションは、ISO 7811とISO 7813の2つの主要な磁気カード規格をサポートしています。適切なカードの読み取りと書き込みを行うためには、これらのフォーマットを理解することが重要です。
ISO 7811
ISO 7811は、磁気ストライプ付き識別カードの国際規格です。以下を定義しています:
- トラック1: 英数字データ(最大79文字)
- フォーマット:
%[フォーマットコード][プライマリアカウント番号]^[名前]^[有効期限][サービスコード][任意データ]?
- 例:
%B1234567890123456^カードホルダー/名前^24011234567890123456789?
- トラック2: 数字データ(最大40文字)
- フォーマット:
;[プライマリアカウント番号]=[有効期限][サービスコード][任意データ]?
- 例:
;1234567890123456=24011234567890123456?
- トラック3: 読み書き可能(あまり使用されない)
ISO 7813
ISO 7813は、金融取引カード向けのISO 7811のサブセットです。主な違い:
- トラック1: より厳格なフォーマット
- フォーマットコードは’B’(銀行用)でなければならない
- 特定のデータ要素に対して固定長
- 例:
%B1234567890123456^カードホルダー/名前^24011234567890123456789?
- トラック2: ISO 7811と同様だが、特定の検証ルールあり
- 例:
;1234567890123456=24011234567890123456?
正しいフォーマットの選択
- 設定 > カードフォーマットに移動
- 以下から選択:
- 自動検出(デフォルト): カードフォーマットを自動検出
- ISO 7811: 汎用カード用
- ISO 7813: 金融取引カード用
- 適用をクリックして設定を保存
カードへの書き込み
- 書き込むトラックを選択
- 適切なカードフォーマット(ISO 7811またはISO 7813)を選択
- 選択したフォーマットに従って適切なトラックフィールドにデータを入力
- 「書き込み」ボタンをクリック
- アプリケーションがデータを検証し、書き込み操作を実行
- 操作ステータスがステータスバーに表示されます
設定
デバイス設定
- ボーレート: 通信速度を調整(デフォルト: 9600)
- パリティ: パリティを設定(なし、偶数、奇数、マーク、スペース)
- データビット: データビット数を設定(デフォルト: 8)
- ストップビット: ストップビット数を設定(デフォルト: 1)
アプリケーション設定
- デバイスの自動検出: 自動検出の有効/無効
- 最小化して起動: システムトレイに最小化して起動
- ログの保存: 操作のログをファイルに記録
トラブルシューティング
よくある問題
デバイスが検出されない
- デバイスがUSBポートに正しく接続されていることを確認
- 別のUSBポートを試す
- デバイスマネージャーでデバイスが認識されているか確認
- アプリケーションを再起動
読み取り/書き込みが失敗する
- カードが正しく挿入されていることを確認
- カードの磁気ストライプを清掃
- カードが書き込み禁止になっていないか確認
- トラック構成がカードフォーマットと一致しているか確認
アプリケーションがクラッシュする
- 最新バージョンを使用していることを確認
- ログファイルでエラーの詳細を確認
- アプリケーションを再インストール
MSR605 カードリーダー/ライター - APIドキュメント
このドキュメントでは、アプリケーションの拡張や統合を希望する開発者向けに、MSR605カードリーダー/ライターのAPIに関する詳細な情報を提供します。
目次
- 概要
- コアモジュール
- デバイス通信
- カード操作
- データ形式
- エラーハンドリング
- 例
概要
MSR605 APIは、磁気ストライプカードリーダー/ライターと対話するためのPythonインターフェースを提供します。このAPIは、すべてのデバイス機能にアクセスしながらも使いやすいように設計されています。
コアモジュール
msr605
主要な機能を含むメインモジュールです。
MSR605
クラス
class MSR605:
def __init__(self, port=None, baudrate=9600, timeout=1):
"""MSR605デバイス接続を初期化します。
引数:
port (str, オプション): シリアルポート名。Noneの場合は自動検出を試みます。
baudrate (int, オプション): 通信ボーレート。デフォルトは9600。
timeout (int, オプション): 読み取りタイムアウト(秒)。デフォルトは1。
"""
pass
def connect(self):
"""デバイスへの接続を確立します。"""
pass
def disconnect(self):
"""デバイスとの接続を閉じます。"""
pass
def is_connected(self):
"""デバイスが接続されているかどうかを確認します。
戻り値:
bool: 接続されている場合はTrue、それ以外はFalse。
"""
pass
カードフォーマットの詳細
サポートされている規格
- ISO/IEC 7811: 汎用磁気ストライプカード
- ISO/IEC 7813: 金融取引カード(7811のサブセット)
トラック仕様
トラブルシューティング
エラーが発生しました
- エラーメッセージを確認してください
- ログファイルを確認してください
- デバイスを再接続してください
- エラーの詳細を添えてサポートに連絡してください
「デバイスが見つかりません」エラーが表示される
- デバイスを切断して再接続してください
- 別のUSBポートをお試しください
高度な機能
データの視覚化
- カードを読み取ります
- 高度な機能ウィンドウで「視覚化」タブをクリック
- 各トラックの生成された視覚化を表示
カスタマイズ