Conlux(コナラックス)
Conlux 製自動入金機(例: NBX-M400)を制御するライブラリです。シリアル通信で紙幣・硬貨の入金や払い出しなどの操作を行います。
概要
- NbxM400: 自動入金機(ATM / セルフ入金機)向けの端末クラス。
Terminal を継承し、シリアルで制御基板と通信します。
- 名前空間:
Net.Monotas.Terminals.Conlux.NbxM400
- Monoterminal(シリアル端末基盤)に依存
インストール
dotnet add package Conlux
内部 NuGet フィード利用時は、事前にソースを追加してください。
dotnet nuget add source https://nuget.monotas.net/v3/index.json --name monotas-internal
依存パッケージ(Monoterminal)は自動で復元されます。
クイックスタート
参照の追加
using Net.Monotas.Terminals.Conlux.NbxM400;
インスタンス作成とオープン
var device = new NbxM400
{
PortName = "COM1", // 実際の COM ポート名に合わせる
BaudRate = 9600 // 機種に合わせて設定
};
device.Open();
基本的な利用フロー
try
{
// 初期化
var init = await device.ExecuteInitialize();
var initConfirm = await device.ConfirmInitialize();
// ステータス確認(紙幣検知ユニット状態など)
var status = await device.ConfirmStatus();
// 入金可能にし、入金枚数問い合わせ
await device.MakePaymentAvailable();
var payments = await device.RequestPaymentAmount();
Console.WriteLine($"入金総額: {payments.Amount} 円");
// 払い出し(1000円2枚・100円3枚の例)
var refund = await device.RefundBill(thousandYen: 2, hundredYen: 3);
await device.ConfirmRefundBill();
// 入金不可に戻す
await device.MakePaymentDisable();
}
finally
{
device.Close();
}
API 一覧(NbxM400)
初期化・ステータス
| メソッド |
戻り値 |
説明 |
ExecuteInitialize() |
Initialize |
初期化実行 |
ConfirmInitialize() |
Initialize |
初期化確認 |
ConfirmStatus() |
BillValidator |
ステータス確認(紙幣検知ユニット・ホッパー等) |
入金制御
| メソッド |
戻り値 |
説明 |
MakePaymentAvailable() |
Payments |
入金可能状態にする |
RequestPaymentAmount() |
Payments |
入金枚数問い合わせ |
MakePaymentDisable() |
Payments |
入金不可状態にする |
払い出し(紙幣)
| メソッド |
戻り値 |
説明 |
RefundBill(int thousandYen, int hundredYen) |
RefundBills |
払い出し指示(1000円・100円の枚数指定) |
ConfirmRefundBill() |
RefundBills |
払い出し完了確認 |
PauseRefundBill() |
RefundBills |
払い出し中断 |
払い出し(硬貨)
| メソッド |
戻り値 |
説明 |
RefundAllCoins() |
RefundCoins |
全硬貨払い出し |
ConfirmRefundCoins() |
RefundCoins |
出金枚数確認 |
StopRefundCoins() |
RefundCoins |
硬貨全回収強制終了 |
その他
| メソッド |
戻り値 |
説明 |
RequestVersion() |
ControlBoardVersion |
バージョン問い合わせ |
SetParameters() |
bool |
パラメータ設定 |
ClearHopper() |
bool |
ホッパークリア |
プロパティ(Terminal 継承)
| プロパティ |
説明 |
PortName |
シリアルポート名 |
BaudRate |
ボーレート |
DataBits / Parity / StopBits |
通信パラメータ |
Timeout |
送受信タイムアウト(ミリ秒) |
主なレスポンス型
- BillValidator: 制御基盤状態、ビルバリ状態1/2、エラーコード、ホッパー100円状態、現在処理など
- Payments: 入金枚数(10円~10000円)、総額(
Amount)
- RefundBills / RefundCoins: 払い出し結果
- Initialize: 初期化結果
- ControlBoardVersion: 制御基盤バージョン
注意事項
- 通信前に
Open()、利用後は Close() を呼び出してください。
- 別ソリューションで DLL のみ参照する場合は Monoterminal も参照・配置してください。詳細はリポジトリの docs/NUGET.md を参照してください。
ライセンス
MIT © Monotas Inc.