HN 日本語サマリー

← 一覧へ戻る
プログラミング

Casio FX-870P エミュレータ

Casio FX-870P Emulator (github.com)

5 pointsby austinallegro0 コメント

要約

Casio FX-870P(VX-4としても販売)ポケットコンピュータ用のブラウザベースエミュレータがTypeScriptとVue 3で開発されました。このエミュレータは、1986年製のプログラマブル電卓の機能をウェブプラットフォームに移植したもので、CPU、メモリ、ディスプレイ、キーボード、シリアルポート、フロッピーディスクドライブなどのハードウェアコンポーネントをエミュレートします。また、BASICプログラムの編集やデバッグ機能も備えています。

全文翻訳

FX-870P エミュレータ

カシオ FX-870P(VX-4としても販売)ポケットコンピュータのブラウザベースエミュレータで、TypeScriptとVue 3で書かれています。

FX-870Pは、921 kHzで動作する日立 HD61700 CPU、96×64ピクセルのLCD、83キーボード、シリアルポート、オプションのMD-120フロッピーディスクドライブを備えた1986年のプログラマブル電卓でした。このエミュレータは、オリジナルのDelphiリファレンス実装をWebプラットフォームに完全に移植したものです。

[画像: screenshot.png]

クレジット

オリジナルのエミュレータはPISIで入手可能であり、このサイトで提供されている素晴らしいエミュレータスイートのオリジナルの作者に感謝します。この実装は、そのエミュレータの背後にあるコードを、より多くのインターネットユーザーに提供することを目的としています。

このバージョンはMark Wickensによって実装され、ソースコードはGitHubのこちらでホストされており、こちらで試すことができます。

エミュレートされるハードウェア

コンポーネント詳細
CPU日立 HD61700, 921 kHz
メモリ18ビットアドレス空間: ROM0 (6 KB, 16ビットワード), ROM1 (128 KB × 2バンク), RAM (64 KB)
ディスプレイHD44352A01 LCDコントローラ — 96×64ピクセル + 5つのステータスインジケータ
キーボード83キーマトリクス (9ブロック, 16 KO列)
シリアルXON/XOFFフロー制御付きUART
ストレージOrigin Private File System (OPFS) 経由のMD-120フロッピーディスク

機能

  • レスポンシブな電卓フェイス — 複数の解像度のフェイスプレート画像で、あらゆる画面サイズにフィットするようにスケーリングされます。
  • 完全なキーボードマッピング — 自動的な大文字とシフト記号の処理により、PCキーボードから直接入力できます。
  • プログラムライブラリ — ツールバーから直接ロードできる、サンプルBASICプログラムのキュレーションされたコレクションが組み込まれています。
  • RS-232Cシリアル — エミュレートされたCOM0経由でBASICプログラムをLOADおよびSAVEできます(XON/XOFFフロー制御付き)。
  • フロッピーディスク — Origin Private File System (OPFS) 経由のMD-120ディスクエミュレーション。
  • 文字セットテーブル — ROMフォントの全256文字ビットマップを表示する、インタラクティブな16×16の16進グリッド。
  • DEFCHR$ピクセルエディタ — いずれかの文字をクリックすると、ドラッグして描画できる5×8ピクセルエディタが開き、ワンクリックでコピーできるBASIC DEFCHR$ コマンドを生成します。
  • ターボモード — CPUを約50倍速で実行し、計算負荷の高いBASICプログラムに対応します。
  • フルスクリーンモード — ツールバーとパネルを非表示にして、電卓をフルスクリーンで使用できます(モバイルで便利)。
  • ファームウェア切り替え — FX-870P(日本語)とVX-4(英語)のROMモードを切り替えます。
  • CPUデバッガ — ライブレジスタ、フラグ、逆アセンブリビュー。
  • BASICリストパネル — RAMに保存されている全BASICプログラム(P0–P9)のデトークン化されたライブリスト表示。タブ付きナビゲーション、シンタックスハイライト、ライブ/フリーズ切り替え機能を備えています。
  • BASICエディタ — シンタックスハイライト、直接RAM書き込み、行の追加/削除/編集、リッチテキストクリップボードサポートによるプログラム全体のインポート/エクスポート機能を備えた、インプレース編集。
  • コミュニケーションパネル — UARTレジスタの状態、シリアルバイトストリーム、診断情報。

実行

前提条件
  • Node.js 22 LTS
  • ROMファイルが public/roms/ に配置されていること(含まれていません)
開発サーバー
npm install
./start.sh        # http://localhost:3007/fx870p-emulator/ で起動します
./stop.sh         # サーバーを停止します

またはnpmを直接使用します:

npm run dev       # フォアグラウンドで実行、Ctrl-Cで停止
本番ビルド
npm run build     # dist/ に出力します
npm run preview   # ビルドされたアプリをプレビューします

アプリは開発モードと本番モードの両方で /fx870p-emulator/ のベースパスで提供されます。

プロジェクト構造

src/
  emulator/
    cpu.ts            HD61700 CPUコア — リセット、フェッチ/デコード/実行ループ
    exec.ts           命令ハンドラ(約2100行)
    decoder.ts        256エントリの命令ディスパッチテーブル
    def.ts            CPU状態、メモリマップ、srcRead/dstWrite
    disassemble.ts    実行時逆アセンブラ(DebugPanelで使用)
    lcd.ts            HD44352A01 LCDコントローラ → Canvas ImageData
    keyboard.ts       83キーマトリクス — keydown + マウスイベント
    port.ts           I/OポートとUARTステートマシン
    comm.ts           RS-232C TX/RXキュー、XON/XOFF、SAVE受信
    basic-tokens.ts   共有キーワードテーブル(PREFIX4–7)とRAMレイアウト定数
    detokenize.ts     BASICプログラムデトークナイザー — RAMからトークン化されたプログラムを読み取ります
    tokenize.ts       BASICトークナイザー — ソーステキストをFX-870Pトークンバイトに変換します
    ram-edit.ts       RAMエディタ — ファイルテーブル管理でトークン化されたプログラムをRAMに書き込みます
    casio-ascii.ts    カシオASCII ↔ Unicode文字マッピング
    emulator.ts       メインrAFループ、ROMロード、状態永続化
    remote-log.ts     デバッグログ(開発専用)
    trace.ts          命令ごとのJSONLトレースレコーダー
  components/
    EmulatorView.vue    トップレベルオーケストレーター + パネルレイアウト
    LcdCanvas.vue       Canvas LCDレンダラー
    KeyboardOverlay.vue フェイス画像上のクリック可能なキーヒット領域
    CommPanel.vue       シリアル通信パネル + ツールバーボタン
    DebugPanel.vue      CPUデバッガ(レジスタ、フラグ、逆アセンブリ)
    BasicListPanel.vue  BASICプログラムリスト/エディタパネル(デトークン化ビュー、インプレース編集、インポート/エクスポート)
    CharsetPopup.vue    文字セットテーブル + DEFCHR$ピクセルエディタ
    LibraryPopup.vue    プログラムライブラリポップアップ(サンプルプログラムの閲覧とロード)
    AboutPopup.vue      情報ダイアログ(ABOUT.mdをレンダリング)
  editor/
    BasicEditor.vue     再利用可能なCodeMirror 6エディタコンポーネント(シングル/マルチラインモード)
    cm-basic-lang.ts    FX-870P BASIC用のCodeMirror StreamLanguage定義
    cm-basic-theme.ts   パネルUIに合わせたCodeMirrorダークテーマ
    basic-highlight.ts  リスト表示とリッチテキストクリップボードエクスポート用のシンタックスハイライター
public/
  ABOUT.md            ユーザー向けドキュメント(Aboutポップアップでレンダリング)
  basic/              サンプルBASICプログラム(.bas)
  images/
    face.png          電卓フェイスプレート(標準)
    face-large.png    電卓フェイスプレート(大)
    face-huge.png     電卓フェイスプレート(特大)
    keys.png          キーオーバーレイリファレンス
    casio-logo.svg    カシオロゴ(Aboutポップアップのウォーターマークとして使用)
  roms/               ROMおよび文字セットバイナリ(リポジトリに含まれていません)
tests/
  emu-harness.ts      ヘッドレスエミュレータブート + キー入力ヘルパー
  sin90.test.ts       SIN(90)回帰テスト
  tokenize.test.ts    BASICトークナイザテスト(キーワード、ラウンドトリップ、エッジケース)
tools/
  dis.ts              スタンドアロン逆アセンブラ(npm run dis)
  compare-traces.mjs  Delphi vs TypeScriptトレース比較
  charset-dump.ts     文字セットマークダウンを生成(docs/charset.md)
  charset-table.ts    文字セットHTMLテーブルを生成(docs/charset-table.html)
  compiler/           カシオJIS BASIC → HD61700マシンコードコンパイラ(README内)
  emu-debugger/       ヘッドレスデバッガライブラリ + CLI(README内)
  rs232/              fxsend/fxrecvシリアル転送ユーティリティ(C言語、README内)
reference/
  ドキュメントとDelphiソース
docs/
  実装ノート

開発者ツール

ブラウザエミュレータに加えて、このリポジトリには、カシオBASICおよびHD61700マシンコードのコンパイル、圧縮、デバッグ用の3つのNode.jsツールと、プログラムを実際のハードウェアに転送するためのPOSIX Cユーティリティのペアが含まれています。

BASICコンパイラ — tools/compiler/

カシオJIS標準BASICをHD61700マシンコードにコンパイルします。注釈付き132列アセンブリリスト、バイナリファイル、シンボルテーブル、および実際のハードウェア用の自己ロードBASICプログラムを生成します。生成されたコードは、ランタイムを再実装するのではなく、PRINT、INPUT、FP数学、文字列操作のために既存のROM(CosmicV4パターン)を呼び出します。

npx tsx tools/compiler/compile.ts program.bas
# → build/compiler/program.{bin,lst,sym,loader.bas}
ヘッドレスデバッガ — tools/emu-debugger/

エミュレータをプログラムで制御するためのライブラリおよびCLI。ブレークポイント、メモリウォッチポイント、命令トレース、スナップショット復元、シングルステップ実行。コンパイル済みバイナリのデバッグと自動回帰テスト用に設計されています。

npm run debug -- run <binary.bin>     # 実行 + LCD表示
npm run debug -- trace <binary.bin>   # 全命令をログ記録
npm run debug -- step <binary.bin>    # 対話的なシングルステップ
BASICクランチャー — tools/cruncher/

カシオJIS BASICプログラムの格納サイズを(バンドルされたライブラリでは通常8〜29%)リナンバリングせずに縮小します。参照を考慮したコメント削除、THEN GOTO/LET書き換え、スペース削除、DATAグループ化、行のマージ、およびオプションの変数リネーム(--level 2)。バイト数はエミュレータ自身のトークナイザから取得されるため、報告される節約量は正確です。BASICトークンがどのように格納されるかこちらを参照してください。クランチされた.min.BASファイルと、パスごとの統計情報を含む132列の変更前/変更後リストを生成します。

npm run crunch -- PROGRAM.BAS              # → PROGRAM.min.BAS + PROGRAM.crunch.lst
npm run crunch -- PROGRAM.BAS --level 2    # 変数リネーム/NEXT削除を追加
RS-232C転送ユーティリティ — tools/rs232/

実際のFX-870P/VX-4ハードウェア用のfxsend/fxrecv — POSIX Cコマンドラインユーティリティ。ROM自身のドライバからリバースエンジニアリングされたフロー制御とタイミングを使用して、RS-232Cシリアルリンク経由でBASICプログラムをLOAD/SAVEします。

./fxsend -c 6,N,8,1,N,N,N,B,N -f SORCERER.BAS
./fxrecv -c 6,N,8,1,N,N,N,B,N -f SAVED.BAS

参考資料

ドキュメント説明
reference/fx870p-rom-annotations.md注釈付きROMアドレスラベルとコールフローノート
reference/fx870p-roms.md完全なROM逆アセンブリ
[reference/FX-870P_VX-4 Manual.html](docs/FX-870P_VX-4 Manual.html)
オリジナルユーザーマニュアル(HTML)
docs/CasioVX-4-Manual-Peter-Rost.pdfPeter RostによるVX-4マニュアル(PDF)
docs/FX-870P emulator.pdfDelphiエミュレータドキュメント(PDF)
docs/basic-detokenizer.mdBASICデトークナイザーリファレンス — トークンテーブル、メモリレイアウト、行フォーマット
docs/basic-editor.mdBASICエディタユーザーガイド — 編集、インポート/エクスポート、制限事項
docs/plan.mdWebポート実装計画とコンポーネントマッピング
reference/fx870_es/オリジナルDelphi 5ソース(参考のみ)

テスト

エミュレータには、Node.jsでエミュレータを起動し、キー入力を注入し、CPUを実行し、LCD出力を検証する、vitest搭載のヘッドレステストスイートがあります。

全テストの実行
npm test
単一テストファイルの実行
npx vitest run tests/sin90.test.ts
名前パターンに一致するテストの実行
npx vitest run -t "SIN"
ウォッチモード(ファイル変更時に再実行)
npx vitest

テストには public/roms/ にROMファイルが必要です(開発サーバーと同じ)。

デバッグログ

開発サーバーは /fx870p-emulator/log エンドポイントを公開し、emulator-debug.log に書き込みます。ブラウザコンソールからログを有効にします。

window.ioDebug(true)   // 有効化
window.ioDebug(false)  // 無効化

テックスタック