メモリマップ

BASIC 0.9.9-RC6、正式版では BASIC 1.0.0 より

POKE・PEEK・COPY などのコマンドを用いて仮想メモリへの参照・書き込みが可能になっています。

このページでは仮想メモリの詳細な説明を記載しています。

IchigoJam BASIC 0.9.9-RC11 に限り、メモリマップの構成が異なります。
IchigoJam BASIC 0.9.9-RC12 で戻されています。古いベータ版なので、0.9.9-RC11 は考慮していません。

RISC-V プロセッサの IchigoJam では一部メモリマップに違いがある事が分かっています。

現在のところ #1003 キーバッファ は別アドレスである事が分かっていて、その後のバッファも異なっている可能性があります。

IchigoCake BASIC は配列・プログラム領域が拡大されています。そのため、メモリマップが異なります。

アクセスできる仮想メモリのメモリマップは下のとおりです。

アドレスは 16 進数表記で記載していますが、10 進数表記でも正常に動作します。
1 つのアドレスで扱える値は 0〜255・#00〜#FF です。

メモリマップの範囲は IchigoJam BASIC のバージョンによって異なります。次の範囲になっています。

基本的に使用するのは #000～#FFF（#000～#1001）となります。

そのため、最新ではアドレスが 16 進数 4 桁ですが、3 桁で表記するのが通常となっています。

配列とプログラムの領域が増えているため、その分仮想メモリがずれています。

IchigoCake BASIC 1.3b7.2・正式版 IchigoCake BASIC 1.3.2 で次のとおりです。

これらのメモリマップは HELP コマンドを用いて表示できます。

HELP コマンドは BASIC 1.0.1 以降で使用できます。バージョンによって記載が異なります。
正式版 BASIC 1.1.1 以降はアドレスの先頭のみになっています。

ベータ版では容量の都合により、短くなったり、非対応（エラー）となる場合があります。

CHR$(0) から CHR$(255) までの全キャラクターパターンを参照できます。

この領域は IchigoCake BASIC も共通です。

8 バイトで 1 キャラクターを構成します。0・#000 がキャラクターコード 0・#00 のキャラクターなので、
単にキャラクターコードに 8 をかける事でキャラクターパターンの先頭アドレスを得られます。

例えばキャラクターコード 255・#FF のイチゴを参照する場合は 255✕8＝2040＝#7F8 で、

このアドレスからの 8 バイト 2040～2047・#7F8～#7FF がイチゴのキャラクターパターンです。

PCG として POKE などでキャラクターの書き換えができるのは

キャラクターコード 224〜255・#E0〜#FF にある 32 文字の領域 #700〜#7FF に限られます。

キャラクターコード 0～223・#00～#DF の領域 #000〜#6FF は

PEEK で参照できますが、POKE で変更する事はできません。COPY も同様です。

2 バイトで配列 1 つを構成します。#800 と #801 が [0] の値で、#8CA・#8BB の [101] まで並んでいます。

頭が下位 8 ビット、次が上位 8 ビット（リトルエンディアン）の 16 ビットで、

一番上位のビットが符号ビットになります。

IchigoJam BASiC 1.2 IoT 版は IoT.IN・IoT.OUT コマンドの実行時にこの領域を使用してモジュールの送受を行います。

この領域が破壊されますので、使用しないで下さい。 BASIC 1.3 では専用の領域ができています。

IchigoCake BASIC では [102]～[357] が増えています。#C00 以降で割り当てられています。
従ってプログラム以降の領域は IchigoCake BASIC と IchigoJam BASIC でアドレスが異なります。

2 バイトで変数 1 つを構成します。#8CC と #8CD が変数 A の値で、#8FE・#8FF の変数 Z まで並んでいます。

頭が下位 8 ビット、次が上位 8 ビット（リトルエンディアン）の 16 ビットで、

一番上位のビットが符号ビットになります。

この領域は IchigoCake BASIC も共通です。

画面左上（LOCATE の座標で 0,0）を #900 として、右へ向かって右下までキャラクターの参照・配置を行います。

値はキャラクターコードです。0～31 と 127 は CHR$() とは異なりキャラクターを出力します。

POKE でのキャラクター配置はビデオ出力・液晶モジュールへの表示が有効で、シリアルへは送出しません。

この領域は IchigoCake BASIC も共通です。

VIDEO１・2 は 32✕24 文字です。（横座標 0～31・縦座標 0～23）

画面左上（LOCATE の座標で 0,0）が #900 なのは VIDEO による画面モードを変更しても共通です。

従って VIDEO 3～8 では後方のアドレスが使用されない事になります。

CLS や VIDEO などの画面クリアではその画面で使用される範囲の値が 0 クリアされます。

画面外の領域はクリアされません。この領域は別の目的で使用可能です。

VIDEO 3・4 は 16✕12 文字です。（横座標 0～15・縦座標 0～11）

VIDEO 1・2 の縦・横共に文字サイズ 2 倍、座標は半分となっています。

IchigoJam BIG も同じ画面サイズになります。

VIDEO 5・6 は 8✕6 文字です。（横座標 0～7・縦座標 0～5）

VIDEO 3・4 の縦・横共に文字サイズ 2 倍、座標は半分、VIDEO 1・2 の縦・横共に文字サイズ 4 倍、座標は 4 分の1 となっています。

VIDEO 7・8 は 4✕3 文字です。（横座標 0～3・縦座標 0～2）

VIDEO 5・6 の縦・横共に文字サイズ 2 倍、座標は半分、VIDEO 3・4 の縦・横共に文字サイズ 4 倍、座標は 4 分の1、

VIDEO 1・2 の縦・横共に文字サイズ 8 倍、座標は 8 分の 1 となっています。

プログラムの入力により IchigoJam BASIC は #C00 から、IchigoCake BASIC は #E00 から入ります。

例えば 10 CLS というプログラムではじまり、次が 20 になる場合、下記のようになります。

※ 文字数部分は「2 バイト」と公開されているところがありますが、正しくは「1 バイト」です。

行番号は必ず偶数のアドレスではじまります。下位 8 ビット・上位 8 ビットの順（リトルエンディアン）です。

例えば、行番号 1 と 10000 では共に 2 バイトを固定使用するため、容量は変わりません。 

行の終了コードは #00 の 1 バイトですが、

ここで次のアドレスが奇数になっている場合、補正のためにもう 1 バイト #00 を含めます。

これは LPC1114 が 2 バイトずつ処理しているため、調整を行っています。

この仕様により、?FREE() などで見る場合、必ず偶数のバイト数が返ってきます。

IchigoJam BASIC ではプログラム終了から #FFF までは #00 が続きますが、

プログラムが 1024 バイトになる場合、終了コードははみ出します。

IchigoJam BASIC 1.1 beta8 (正式版 IchigoJam BASIC 1.1.1) より

この終了コードは #1000〜#1001 に入りますが、

必ず固定値 #00 となるので、保存・読み出しの対象になっていません。

IchigoCake BASIC の場合 #1E00～#1E01 が固定値 #00 になります。

SAVE でプログラムの内容がそのまま保存領域（LPC1114・LPC1115 または EEPROM）へ写され、

また LOAD・LRUN では保存領域からプログラムへそのまま写されます。

IchigoJam BASIC RPi ではプログラムの内容がそのままバイナリーファイルで SD カードへ保存されます。

これを活用し、プログラムの空き領域に POKE でデータなどを入れ、SAVE でプログラムと一緒に保存させる事が可能です。

IchigoJam BASIC では #1002、IchigoCake BASIC では #1E02 に

矢印キーとスペースキーの押した状態が入っています。キー同時押しの検出が可能です。

例えば IchigoJam BASIC の場合、IF PEEK(#1002)=0 で矢印キーとスペースキーが押されていないかを確認できます。

BASIC 1.4.0・1.3.2b17 よりこの値は BTN(-1) で得る事ができます。

IchigoCake BASIC 1.3.2 では #1E02 の値がクリアされていないため、不正確な値で検出される場合があります。
（32 以上の値を得る場合があり、BTN(～) も状態とは異なる値で返す場合があります）

こちら不具合と確認され、後のバージョンで改善される予定です。回避手段として POKE #1E02,0 とゼロクリアして下さい。

キーボードからの入力により、この領域へ参照していない文字を蓄えます。
INKEY() などで消費します。CLK でクリアが可能です。

また、シリアルから受け取ったデータの蓄えにも使用されます。

IchigoJam BASIC では #1003 にバッファに入っている文字数が入り、
#1004 以降がバッファとしてキャラクターコードが入ります。

#1003 が 5 であれば、#1004～#1008 の 5 文字がバッファとして入っています。

IchigoCake BASIC では #1E03 にバッファに入っている文字数、#1E04 以降がバッファとなります。

処理高速化の考慮で、バッファから取り出した場合でも、#1004 または #1e04 以降の内容はクリアされません。

#1003 または #1E03 の値を 0 にするだけです。
参照する場合は必ず #1003 または #1E03 の文字数を参照して下さい。

BASIC 1.3.0・1.3b2 で追加されています。200 文字です。

Enter（return）を押した際、その行を一時的に収納し処理します。
BASIC 1.2.3・1.3b1 までは画面のキャラクター領域をそのまま使っていたため、
CLS:PRINT"HELLO! では PRINT は実行されませんが、

BASIC 1.3.0・1.3b2 以降では表示されるようになっています。

BASIC 1.3.0・1.3b2 で追加されています。IoT.IN・IoT.OUT コマンドで I2C 送受に使用します。

BASIC 1.2 IoT 版では配列領域を使っていたため、IoT.IN・IoT.OUT の実行で破壊されていましたが、

BASIC 1.3.0・1.3b2 以降ではこれがなくなっています。

BASIC 1.4.0・1.3.2b17 より EEPROM のアクセス時にも I2C バッファを使用します。