CP/M-386 – 386保護モード向けのCP/M、CP/M-68Kから派生
CP/M-386 – CP/M for 386 protected mode, derived from CP/M‑68K (github.com)
要約
CP/M-386は、CP/M-68Kを基に開発された、386プロセッサの保護モードで動作するCP/Mオペレーティングシステムです。現在開発初期段階にあり、32ビット保護モード実装、フロッピーディスクまたはGRUBからのブート、VGAテキストモードとシリアルコンソールをサポートしています。コンパイルにはAWK、GCC、NASMなどのツールが必要で、NetBSD、FreeBSD、LinuxなどのOS上でビルド可能です。
全文翻訳
CP/M-386
CP/M‑386 は CP/M を386保護モードで動作させるもので、CP/M‑68K から派生しています。
- 概要
- ハードウェアサポート
- CP/M互換性
- ビルド要件
- オプションの依存関係
- ダウンロード
- コンパイル
- Dockerビルド
- ビルド出力
- QEMUでのテスト
- QEMUに関する注意点
- 含まれるユーティリティ
- コントリビューション
- 将来の計画
- コード統計
- ミラー
- ライセンス
概要
CP/M‑386 は現在、非常に** 初期開発段階にあります。**
- Ring‑3 TPA を備えた完全な32ビット保護モード実装。
- 3.5インチ1.44MBフロッピーディスクのブートセクタまたはMultibootカーネルからの起動が可能。
- VGAテキストモード (
0xB8000) および/または COM1シリアルポート (9600/N/8/1,0x3F8) コンソールをサポート。 - CD/USB/ネットワーク/サウンド/その他のドライバは(まだ)ありません。
ハードウェアサポート
- 2MB(以上)のメモリを搭載した386(以降のシステム)と互換性があります。
- PC BIOSまたはUEFI(CSM付き)を使用するシステムをサポートします。
- VGA、8042 PS/2、8250/16450/16550 UART、CMOS RTC、8253/8254 PITをサポートします。
CP/M互換性
CP/M‑386 は、他の実装と高いソース互換性を持つはずです。
| システム | BDOSカバレッジ |
|---|---|
| CP/M‑68K 1.3 | 100% |
| CP/M 2.2 | 100% |
| CP/M‑Plus | 74% |
| DOS‑Plus | 62% |
| MP/M 2.1 | 50% |
現在、アプリケーションには BDOS 2.2 として報告されます。
- CP/M‑386 のBDOSは、CP/M‑68K 1.3 および CP/M 2.2 と完全に同等です。
- CP/M‑Plus (CP/M 3) のBDOSの大部分もサポートされています。
- DOS‑Plus の追加機能の60%以上が実装されています。
- MP/M の拡張機能の約半分が完了しています。
- 不足している機能は、主にシングルユーザー CP/M 実装には適用されないマルチユーザー、マルチタスク、メッセージキュー、プロセス制御コールです。
- 新しい機能(直接ビデオアクセス、高解像度タイミング、PRNGなど)に対応するために、独自の CP/M‑386 固有のBDOS拡張が追加されています。
ビルド要件
CP/M‑386 をコンパイルするには、以下の依存関係が必要です。
† cpmtools バージョン 2.23 以降を使用してください。古いバージョンは動作するように見えても、いくつかの既知のバグがあります。
オプションの依存関係
- diff
- QEMU
- sed
- util-linux (
column用)
ダウンロード
- 現在のCP/M‑386ビルドをダウンロード。
- GitLab CI/CD ログを表示。
コンパイル
CP/M‑386 のビルドは、NetBSD および FreeBSD‡ の最新リリース、ならびに Red Hat Enterprise Linux 9(以降)、CentOS Stream 9(以降)、Fedora 36(以降)でサポートされています。
-
GCC ビルド(推奨):
make -Orecurse -j "$(nproc 2> /dev/null || printf '%s' 1)" -
Clang ビルド:
make -Orecurse -j "$(nproc 2> /dev/null || printf '%s' 1)" CC="clang" OPTFLAGS="-O1" -
GCC の使用を推奨します。Clang でコンパイルされた i386 コードはサイズが大きくなるためです。
- Clang でコンパイルされたビルドでは、RAMディスクに割り当てられた384KiBを超えるのを避けるため、またはカーネルサイズとRing‑0スタックが従来のメモリを超えるのを避けるために、
OPTFLAGS=-O1(または-Os、-Oz)を使用する必要があります。
- Clang でコンパイルされたビルドでは、RAMディスクに割り当てられた384KiBを超えるのを避けるため、またはカーネルサイズとRing‑0スタックが従来のメモリを超えるのを避けるために、
-
コンパイラを切り替えたり、コンパイラフラグを調整したりする場合は、必ず
make cleanを実行してください。 -
オペレーティングシステムによっては、
make -j引数を調整する必要がある場合があります(例:gnproc、sysctl -n hw.ncpu、getconf NPROCESSORS_ONLN、psrinfo -p)。 -
テストスイート(
make test)を実行するには、32ビットサポートライブラリが必要です。 -
‡執筆時点では、FreeBSD は機能しない
cpmtools2パッケージを出荷しており、mkfs.cpm機能が壊れています。FreeBSD で正常にビルドするには、cpmtoolsを再ビルドし、libdskとリンクされていないことを確認する必要があります。FreeBSD のmkfs.cpmでDisc rejected by driverまたはcan not make new file system: No such file or directoryエラーが発生した場合、ツールは壊れており、CP/M‑386 のビルドには使用できません。
Dockerビルド
システムで CP/M‑386 をネイティブにビルドできない場合は、Fedora を使用したDockerベースのビルドが利用可能です。
-
まず、
cpm386/cpm386-buildコンテナをビルドします。docker build --rm --progress plain -t cpm386/cpm386-build:latest -f Dockerfile . -
次に、このコンテナを使用して CP/M‑386 をビルドします。
docker run --rm -v "$(pwd -P)":/src -w /src cpm386/cpm386-build:latest \ make -Orecurse -j "$(nproc 2> /dev/null || printf '%s' 1)"
追加のターゲット(例: clean、test、lint、update-readme)や、Clangコンパイラ(CC="clang" OPTFLAGS="-O1")を使用したビルドもサポートされています。
ビルド出力
-
ビルドにより、4つの主要な成果物が生成されます。
ファイル 説明 cpm386.elfMultibootカーネルイメージ floppy.img起動可能な3.5インチ1.44MBフロッピーディスクイメージ blankfd.img空のCP/M 3.5インチ1.44MBフロッピーディスクイメージ blankhd.img空のCP/M 8MBハードディスクイメージ -
便利スクリプト
mboot.sh(GNU/LinuxシステムとGRUB2でテスト済み)を使用して、cpm386.elfファイルを使用して起動可能なMultibootメディア(USBドライブやSDカードなど)を作成できます。 -
floppy.imgファイルは、1.44MBのフロッピーディスクに直接書き込むことができます。- 注意: このディスクイメージにはCP/Mファイルシステムは含まれていません!システムが起動したら、ドライブから取り外すことができます。
-
空のイメージは、CP/M‑386 にまだ
FORMATユーティリティがないため役立ちます。
QEMUでのテスト
-
Multiboot カーネル(推奨):
qemu-system-i386 -m 2M -serial stdio -monitor none -kernel "cpm386.elf" -
フロッピーブートセクタローダー:
qemu-system-i386 -m 2M -serial stdio -monitor none -drive if=floppy,format=raw,file="floppy.img" -boot a
QEMUに関する注意点
-
VGAビデオを無効にするには(シリアルコンソールのみを使用)、
-nographic -display none -vga noneを使用します。 -
シリアルUARTを無効にするには(VGAコンソールのみを使用)、
-serial noneを使用します。 -
QEMUにメディアをアタッチするには、以下を使用します。
-drive if=floppy,format=raw,file="blankfd.img" -drive if=ide,format=raw,file="blankhd.img",index=0
含まれるユーティリティ
| プログラム | 説明 |
|---|---|
ACLOCKDV.386 | aclock (VGAテキストコンソール版) |
ACLOCKVT.386 | aclock (ANSIターミナル版) |
ALVTST.386 | 割り当てベクトルテスト (DRV_ALLOCVEC, BDOS 27) |
CAPSLOCK.386 | Caps‑Lockキーの動作ユーティリティ (BDOS 235) |
CLEARTPA.386 | TPAをクリア(ゼロ埋め)し、オプションで検証する |
CLS.386 | 画面クリア (BDOS 221) |
DELAY.386 | 遅延テスト (P_DELAY, BDOS 141) |
DEMO.SUB | SUBMITデモンストレーション |
DUMPDIR.386 | ディレクトリエントリーダンプユーティリティ (F_SFIRST/F_SNEXT, BDOS 17/18) |
DUMPFCB.386 | ファイルコントロールブロックダンプユーティリティ (F_OPEN, BDOS 15) |
ED.386 | ED (DRI CP/M Context Editorの移植版 WIP, 1982年8月) |
ENV.DAT | 環境データファイル |
ESCTILDE.386 | EscapeキーとTildeキーの動作ユーティリティ (BDOS 237) |
FPARSE.386 | ファイル名解析テスト (F_PARSE, BDOS 152) |
GETSN.386 | シリアル番号表示 (S_SERIAL, BDOS 107) |
GFXTEST.386 | グラフィックスとフレームバッファデモ (BDOS 229/230/231/233) |
HD.386 | 16進ダンプユーティリティ |
HELLO.386 | Hello world - 最初のCP/M‑386プログラム! (C_WRITESTR, BDOS 9) |
ILLEGAL.386 | Ring‑3保護と例外ハンドラテスト |
IOTEST.386 | ファイルI/O BDOSテスト |
JULIA.386 | ジュリア集合フラクタルを描画(ターミナル版) |
LRBC.386 | 最終レコードバイト数(Last Record Byte Count)を照会/設定 |
LS.386 | ファイル一覧表示(サイズ付き) |
MANDEL.386 | マンデルブロ集合フラクタルを描画(ターミナル版) |
MEM.386 | メモリマップユーティリティ (BDOS 227/228) |
MORE.386 | UNIXの more スタイルのページャ |
NUMLOCK.386 | Num‑Lockキーの動作ユーティリティ (BDOS 236) |
OD.386 | 8進ダンプユーティリティ |
PAUSE.386 | キー入力待ち (C_RAWIO, BDOS 6) |
PIP.386 | PIP (Zilog CP/M-Z8000 PIP v1.0Aの移植版, 1984年1月) |
PRINTENV.386 | 環境変数とシステムデータを表示 |
PRNG.386 | PRNGテストおよびデモユーティリティ (BDOS 253/254) |
PROFILE.SUB | SUBMITスクリプト(起動時に自動実行) |
RC.386 | リターンコードテストと照会 (P_CODE, BDOS 108) |
README.TXT | サンプルテキストファイル |
REBOOT.386 | 再起動ユーティリティ (BDOS 220) |
RM.386 | UNIXの rm 風対話型ファイル削除ユーティリティ (F_DELETE, BDOS 19) |
SEROFF.386 | シリアルコンソール無効化 (BDOS 223) |
SERON.386 | シリアルコンソール有効化 (BDOS 223) |
STAT.386 | STAT (Zilog CP/M‑Z8000 STAT v1.0C 1984年1月版の移植) |
SYNC.386 | ディスク同期 (DRV_FLUSH, BDOS 48) |
TERMTEST.386 | ターミナルとキーボードテストユーティリティ |
TEST110.386 | 文字列区切りテスト (C_DELIMIT, BDOS 110) |
TEST211.386 | 数値フォーマットテスト (C_DECNUM, BDOS 211) |
TEXTMODE.386 | テキストモードとカーソル状態の照会/設定 (BDOS 229/230/231/234) |
TICKS.386 | 高解像度タイマーテスト (BDOS 225/226) |
TOD.386 | 時刻(Time of Day)クロックの取得/設定 (T_SET/T_GET, BDOS 104/105) |
TOUCH.386 | 空ファイル作成 (F_MAKE, BDOS 22) |
TRUNCATE.386 | ファイル切り詰めユーティリティ (LRBC対応) |
TRUNCTST.386 | 切り詰めテスト (F_TRUNCATE, BDOS 99) |
TSEC.386 | 日付と時刻の取得 (T_SECONDS, BDOS 155) |
VER.386 | OSバージョン表示 (S_OSVER, BDOS 163) |
VGAFONT.386 | テキストコンソールフォントのロードまたはROMフォントの復元 (BDOS 232) |
VGAOFF.386 | VGAテキストコンソール無効化 (BDOS 222) |
VGAON.386 | VGAテキストコンソール有効化 (BDOS 222) |
VGATEXT.386 | VGAテキスト直接アクセスデモ (BDOS 224) |
コントリビューション
- 大量のLLM生成コードを含むプルリクエストは絶対に開かないでください。直ちに却下されます。
- 現在、コアオペレーティングシステムにはAI生成コードは含まれていません(ただし、AI生成されたテスト、コメント、分析は存在します)。このプロジェクトは、私にとって学習体験であると同時に、有用なOSポートでもあることを意図しています。
- 貢献者によるAI(人工知能)ツールの使用は、LLVM AI Tool Use Policy と同じ条件で現在許可されていますが、この許可はいつでも予告なく撤回される可能性があります。
将来の計画
FUTURE.md を参照してください。
コード統計
| 言語 | ファイル数 | 行数 | 空行 | コメント行 | コード行 | 複雑度 | バイト数 | Uloc |
|---|---|---|---|---|---|---|---|---|
| C | 74 | 46381 | 8781 | 7914 | 29686 | 6065 | 1281791 | 17652 |
| C Header | 24 | 3338 | 646 | 1481 | 1211 | 11 | 123146 | 1646 |
| Assembly | 8 | 1939 | 339 | 418 | 1182 | 1 | 47942 | 999 |
| Makefile | 2 | 1812 | 346 | 220 | 1246 | 383 | 60258 | 888 |
| SPDX | 1 | 1007 | 121 | 0 | 886 | 0 | 45939 | 504 |
| Markdown | 3 | 653 | 76 | 0 | 577 | 0 | 27319 | 505 |
| Shell | 1 | 298 | 88 | 63 | 147 | 31 | 8491 | 116 |
| Linker Script | 2 | 207 | 39 | 0 | 168 | 0 | 5159 | 96 |
| Dockerfile | 1 | 97 | 8 | 12 | 77 | 35 | 3197 | 82 |
| YAML | 1 | 87 | 6 | 15 | 66 | 0 | 3875 | 70 |
| Plain Text | 1 | 53 | 0 | 0 | 53 | 0 | 924 | 53 |
| Total | 118 | 55872 | 10450 | 10123 | 35299 | 6526 | 1608041 | 22503 |
ミラー
- このソフトウェアの正規のホームは
https://gitlab.com/johnsonjh/cpm386で、GitHub にミラーがあります。
ライセンス
- CP/M‑386 は、寛容なMITライセンスの条件の下で配布されます。
- いくつかの雑多なファイルとバンドルされたユーティリティは、他のライセンスの下で配布されます。
- SPDXソフトウェア部品表が提供されています。
- DRDOS, Inc. dba DeviceLogics LLC(Digital Research, Inc.のCP/M資産の後継者)のBryan W. Sparksは、CP/Mテクノロジー(CP/Mオペレーティングシステムとその派生物を含む)の使用、配布、変更、拡張、およびその他の利用に関する無制限の許可を明示的に付与しています。