MSXシリアルターミナル

シリアル接続やTelnetを通じてMSXと通信するための高性能ターミナルプログラムです。リアルタイム文字表示、自動モード検出、日本語テキストサポートを特徴としています。

📖 ドキュメント一覧

🚀 クイックスタート - 基本的な使い方 (このページ)
📋 詳細ガイド - 高度な機能と設定
🔧 開発ガイド - 開発・貢献方法
🤖 AI貢献度 - AI開発の透明性
📈 更新履歴 - バージョン履歴

✨ 特徴

✨ リアルタイム通信: 文字単位での高速MSX通信に最適化
🔍 自動モード検出: BASICとMSX-DOSモードを自動検出
🌐 複数接続タイプ: シリアル、Telnet、ダミー接続に対応
📝 日本語テキストサポート: MSX文字エンコーディングの完全サポート
📁 ファイル転送: BASICプログラムアップロードとテキストファイル貼り付け機能
🎯 スマート補完: コンテキスト対応のコマンド補完
📖 MSX BASICヘルプ: 160+のMSX BASICコマンドリファレンス内蔵
📂 DOSファイル補完: DIRコマンド自動キャッシュによるファイル名補完
📄 BASICファイル補完: FILESコマンド自動キャッシュによる.BASファイル優先補完
⚡ 高いテストカバレッジ: 95%のコードカバレッジと749のテストケース
🤖 AI開発支援: 開発効率向上のためのAI貢献度管理

📦 インストール

pip install msx-serial

🚀 クイックスタート

基本接続

# シリアル接続
msx-serial COM1                                    # Windows
msx-serial /dev/ttyUSB0                           # Linux
msx-serial /dev/tty.usbserial-12345678901         # macOS

# Telnet接続
msx-serial 192.168.1.100:2223

# ダミー接続（テスト用）
msx-serial dummy://

基本的な特殊コマンド

@help                # 全コマンドのヘルプを表示
@help PRINT          # MSX BASICコマンドのヘルプ
@paste myfile.bas    # テキストファイルをMSXに貼り付け
@upload program.bas  # BASICプログラムをアップロード
@mode               # 現在のMSXモードを表示
@exit               # プログラム終了

MSX BASICヘルプ機能

160以上のMSX BASICコマンドの詳細なヘルプが利用可能：

@help ABS           # 絶対値関数
@help PRINT         # 出力コマンド  
@help CALL MUSIC    # MSX-MUSIC初期化
@help _MUSIC        # 短縮形（CALLコマンドと同等）

DOSファイル補完機能

MSX-DOSモードでファイル名の自動補完が利用可能：

# DIRコマンドを実行すると自動的にキャッシュが更新される
DIR

# ファイル名補完（Tabキー）
TYPE <Tab>          # ファイル名を補完
COPY <Tab>          # ファイル名を補完
DEL <Tab>           # ファイル名を補完

# A>プロンプトでの実行ファイル優先補完
A> <Tab>            # .COM/.EXE/.BATファイルとディレクトリを優先表示
A>SC<Tab>           # SCANDISK（コマンド）とSC2VIEW.COM（ファイル）を同時表示

BASICファイル補完機能

MSX BASICモードでファイル名の自動補完が利用可能：

# FILESコマンドを実行すると自動的にキャッシュが更新される
FILES

# ファイル名補完（Tabキー）
RUN <Tab>           # .BASファイルを優先して補完
LOAD <Tab>          # .BASファイルを優先して補完
SAVE <Tab>          # .BASファイルを優先して補完

# 引用符付きで自動補完される
RUN "TEST.BAS"      # 引用符は自動で追加される

📋 詳細情報

詳細な使用方法、開発方法、AI貢献度については以下のドキュメントをご覧ください：

📋 詳細ガイド - コマンド一覧、高度な機能、トラブルシューティング
🔧 開発ガイド - アーキテクチャ、品質管理、貢献方法
🤖 AI貢献度 - AI開発の透明性と貢献状況
📈 更新履歴 - バージョン別の変更点

📄 ライセンス

このプロジェクトはMITライセンスのもとで公開されています。

🙏 謝辞

このプロジェクトは以下の素晴らしいリソースから多大な恩恵を受けています：

MSX0からコンソール経由でのファイル転送技術: @enu7によるbase64を使ったファイル転送実装
MSX BASICコマンドリファレンス: fu-sen/MSX-BASICプロジェクト

関係者の皆様に深く感謝いたします。

Metadata

Release files for msx-serial 0.2.26

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for msx-serial 0.2.26
File	Size	Uploaded
msx_serial-0.2.26.tar.gz	206.3 kB	Jul 5, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for msx-serial 0.2.26
File	Interpreter	ABI	Platform	Reset
msx_serial-0.2.26-py3-none-any.whl 229.2 kB Jul 5, 2025	Python 3	none	any	Details

Total release size: 435.5 kB

Release files / msx_serial-0.2.26.tar.gz

Download URL	msx_serial-0.2.26.tar.gz
Size	206.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`00c213b3bb5d0c9b081305cc29dcd3618beaca0c54cac737f194cd79f28557f1`
BLAKE2b-256 checksum How to use checksums	`97c70d4671a30ea1a120102daa20f045df2223bf7be85ecc59babfdda0438290`
Upload date	Jul 5, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.13`

Release files / msx_serial-0.2.26-py3-none-any.whl

Download URL	msx_serial-0.2.26-py3-none-any.whl
Size	229.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a58ee99f3766306e9c759fe364054b94fc49fd0147adb41643ebc151bb2aeae7`
BLAKE2b-256 checksum How to use checksums	`9240ec53d46f0c4b5bf4ef330e4246c6ef5153f1ccbc523cd0cb1c0e50a70295`
Upload date	Jul 5, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.13`