nnm-t / m5stack-sokubai-pos

M5Stack FACES 即売会用レジもどき

M5Stack FACES 即売会用レジもどき

M5Stack で同人誌即売会用の簡易レジを開発するプロジェクト.

M5Stack Arduino (C++14) で記述しています. PlatformIOへ移行しました.

機能

• 商品データの JSON ファイルからの読み込み
  • サムネイル画像の表示
• 商品に対応させた RFID カードをタッチして計数 (FACES Gameboy Panel Aボタン押下中スキャン)
• 金額入力での売上登録
• 時刻表示
• 売上の集計, 表示
  • JSON ファイルへの記録
  • CSV ファイルへの記録 (時刻記録つき)
• バッテリ残量表示 - m5stickc-pos-viewer への金額表示 (Bluetooth LE 通信)

必要なハードウェア

• M5Stack FACES (EOL)
  • Gameboy Unit を使用します.
  • 操作系自体は, ソースを改造すれば通常の M5Stack + Joystick Unit でも対応できると思います.
• RFID Unit 2 (必須ではなくなりました)
  • RFID カードの読み込みに使用します. 本体とは Grove ケーブルで接続します.
  • FACES II Bottom 使用時は, スキャン中に側面のNeoPixelが点灯します.
• Proto Module
  • Adafruit PCF8523 RTCモジュール を取り付けて GPIO26 (SDA), GPIO13 (SCL) へ配線します.
• Micro SD カード
  • 商品データの JSON ファイル, サムネイル画像, フォントファイルを保存します.

環境構築

Arduino IDE で M5Stack 開発ができる環境を組んで下さい.

ライブラリ

リポジトリには含まれていないので, 下記 URL から収集します.

• ArduinoJson 6.21.2
• M5Stack Arduino Library 0.4.3
• LovyanGFX 1.1.5

ESP32 の I2C1 用に自前で組んだものを含んでいるので, RTC (PCF8523) のライブラリは不要.

フォント

描画ライブラリを LovyanGFX へ置き換えてからフォント作成は不要になりました.

商品データ

JSON ファイル

下記の JSON ファイルを編集し, SD カードのルートディレクトリに goods.json という名前で保存します. リポジトリからは外しています.

{
    "goods" : 
    [
        { 
            "name" : "商品1",
            "price" : 400,
            "image_path" : "/image_1.bmp",
            "uuid" : [ 0, 0, 0, 0 ]
        },
        {
            "name" : "商品2",
            "price" : 300,
            "image_path" : "/image_2.bmp",
            "uuid" : [ 0, 0, 0, 0 ]
        }
    ]
}

これとは別に, 次の内容で sales.json という名前の JSON ファイルも SD カード上に保存しておきます. goods の要素数は goods.json の商品の種類数と同一にします.

{
  "goods": [
    0,
    0
  ],
  "amounts": [
  ]
}

データ構造

goods.json

• goods: 商品データのオブジェクト
  • name: 商品名. 日本語表示が可能.
  • price: 商品の単価.
  • image_path: サムネイル画像の Micro SD カードでのパス.
  • uuid: RFID カード の UUID をバイト配列 (ビッグエンディアン, 10進数) で記述する.

sales.json

• goods: 商品の売上点数が数値で記録される. データ作成時は商品の種類数と同じ要素数 0 で埋める.
• amounts: 金額入力の売上記録が数値で入る. データ作成時は空配列でよい.

サムネイル画像

120 x 120 の Windows Bitmap 画像を用意し, 商品データの image_path で指定した Micro SD カード上の場所に保存します.