はじめの一歩

採用このページでのバージョン表記はバージョン数字のみで、IchigoJam BASIC のバージョンを表します。

「RPi」を含むバージョンは IchigoJam BASIC RPi のバージョンです。

IchigoCake BASIC は特筆していなければ IchigoJam BASIC 共通です。
IchigoCake BASIC の正式初バージョンは 1.3.2 で、IchigoJam BASIC 1.3.1 直後のベータ晩がベースになっています。 

仮想メモリの領域は BASIC/メモリマップ で記載しています。ページの記載量が多くなったので、ページ分割しています。

BASIC の特殊キー割り当ては下記のとおりです。記載がない特殊キーは一部を除きスペースと同等に動作します。

IchigoJam PC・IchigoJam ap・IchigoJam web では一部機能しないキーが存在します。

BASIC 1.2.4〜・1.2b56〜・1.2.5RPi～ の変化は左 Alt・右 Alt の機能を共通化しています。
コンパクトなキーボードでは片方の Alt しか存在していない場合があるため、その考慮です。

カタカナ ひらがな | ローマ字 以外にカナ入力の切替が割り当ててあるのは、US キーボードの考慮です。

また、カナ印字がない US キーボードの考慮で、カナ入力はローマ字入力です。

ファンクションキーは特に F4 で LIST、F5 で RUN に割り当てているパソコンが多かったため、

違和感なく操作できるのではないでしょうか。

BASIC 0.8.0 よりカナが入っています。英語キーボードでもカナ入力ができるよう、ローマ字入力が採用されています。

日本語キーボード（JIS キーボード）でキーボード印字されている文字ではない事に注意が必要です。

シリアル経由では関係ありません。USB-シリアルの場合は使用する OS の設定に依存します。

ローマ字の英→カナ変換は次のとおりです。

• () 1.2 beta 27 (正式版 IchigoJam BASIC 1.2.1) 以降対応、1.2.0 以前非対応
• [] 0.9.4 (正式版 IchigoJam BASIC 0.9.7) 以降対応、0.9.3 以前非対応 

ッ の LTSU XTSU など、最新版でもメモリの都合上対応していないものがあります。

関数は BASIC を触れていた人であればほぼ当時のまま扱えるでしょう。

変数の値が整数の数値のみなので、割り算の影響がある位です。

他の言語で使用されている記載も一部採用されています。

BASIC での計算による優先順位は下記のとおりです。（BASIC 1.0.0〜・1.0.0 beta 4〜)

BASIC 0.9.9 RC6〜1.0.0 beta3 では下記のとおりです。それ以前のバージョンでは異なる可能性があります。

BASIC 1.0.0・0.9.8 RC2 から 16 進数表記に対応しました。頭に # を付けます。

• #5 → 5
• #05 → 5
• #5F → 95
• #FF → 255
• #FFFF → -1

PRINT で 16 進数表示にする場合は HEX$ を用いて下さい。
PanCake が 16 進数でコマンド送信を行う仕組みなので、これが役に立つでしょう。
 
IF 文に 16 進数表記を用いたあと、A〜F ではじまるコマンドを入れると 16 進数を誤解読してしまいます。
IchigoJam BASIC では空白（スペース）を無視し、
次の 0～9・A～F 以外の文字が出てくるところまで判断する仕様になっているためです。
 

この問題は IchigoJam BASIC 1.1 beta12 で空白（スペース）を認識する処理が追加されていましたが、

空白（スペース）区切りの判別による別の問題が発生し、それを解決するために

IchigoJam BASIC 1.2b52（正式版 IchigoJam BASIC 1.2.4）より空白を完全無視する仕様になり、再度発生しています。

また、IchigoJam BASIC 1.0.0・IchigoJam BASIC 0.9.9 RC2 から 2 進数表記も対応しています。頭に ` を付けます。

` は JIS キーボードの Shift+@、US キーボードは通常 1 の左です。

• `101 → 5
• `0101 → 5
• `1011111 → 95
• `11111111 → 255
• `1111111111111111 → -1

PRINT で ２進数表示にする場合は BIN$ を用いて下さい。

ASC、CHR$、INKEY、PEEK、POKE などで用いる事ができるキャラクターコードです。

範囲は 0〜255（#00〜#FF）になります。

32〜126（#20〜#7E）の英数・記号は ASCII 規格に同じで、現在の UTF-8 などでも共通です。

ただし 92 は途中から ￥ から ＼ に変化していて、この辺は国際規格準拠になっています。

現在 160～224（#A0～#DF）は国によって可変される部分で、160 は通貨記号で固定となっています。

カナ版の場合、161〜224（#A1〜#DF）は JIS 規格に同じで、シフト JIS の半角カナに共通で、

また 1980 年代に出ている日本発のパソコンなどでも共通しています。

BASIC 0.9.8-RC6・1.0.0 以降のコード 5〜31（#05〜#1F）および 127（#7F）の一部は
PRINT CHR$ では出力できず、POKE を用いる必要があります。

これは CHR$ ではコントロールコードに変わっているためです。 

BASIC 0.9.7 以前を除き、横に 2 種類ならべている場合、左が 10 進数、右が 16 進数です。

PDF にして紙面印刷し使用できるようにした IchigoJam キャラクターコード一覧 を公開しています。ご利用下さい。

BASIC 1.4.0b8～1.4.0b9 で次のキャラクターに変更が入りました。
そのまま正式版の BASIC 1.4.1 以降で採用されています。1.5 は変更が入っていません。

• 040・#28 (
• 041・#29 )
• 060・#3C <
• 062・#3E >
• 099・#63 c
• 123・#7B {
• 125・#7D }
• 202・#CA ハ (カナフォントのみ）

正式版 BASIC 1.2.0～1.3.1・ベータ版 BASIC 1.2b20～1.4.0b7 で採用されたフォントです。

BASIC 1.1 までのフォントとの変更は次のとおりです。

• 英数と ￥ を 1 ドット右へ移動（カナの並びと揃うように）
• , と ; は 1 ドット上へ移動（下に空白を空け、他の文字と重ならないように）
• カナ のキャラクターフォントを変更
• 2・#02〜12・#0C、15・#0E〜31・#1F、127・#7F、156・#9C、157・#9D、234・#EA を変更
• 2・#02 のハーフトーンを 3・#03 へ、156・#9C の ＼ を 26・#1A へ、157・#9D の ／ を  25・#19 へ移動

BASIC 0.9.8 RC6〜1.2b14（正式版 BASIC 1.0.0〜1.1.1）のフォントです。

27 までのフォントは 0.9.7 以前に含まれていましたが、
コントロールコード割り当てに順次変更されているため、実際には POKE を使用する必要があり、互換性はほぼなくなっています。

一方 128（#80）以降のキャラクターは一部を除き 1.2 以降でも共通です。

そのため、同じキャラクターが存在するキャラクターは、数字の大きい方を用いる事が推奨されます。

例えば CHR$(5) と CHR$(239) が同じキャラクターですが、 CHR$(239) を使用するようにして下さい。

なお、初期の BASIC 0.9.9-RC では更にキャラクターコードが移動していますが、
これは不具合で、BASIC 0.9.9-RC の途中から修正されました。

（224・#E0〜 からの ←→↑↓ がなく、4文字ずれていた）

BASIC 0.8.0 でカタカナが追加され、合わせて現在の英数・記号のフォントが定まっています。

その前 BASIC 0.7.4～0.7.7 では英数が現在と若干異なったものになっていました。
現在も採用されているキャラクターのいくつかがこの時にできています。

16 進数は非対応だったため、10 進数必須となります。

存在していないキャラクター、場所が異なっているキャラクターがあります。

• ￥ は 92（BASIC 0.9.8 以降の ＼）にあります。
• 126 の 〜 は上にずれたものです。（MSX に同じ）
• このバージョンでは 27 以前のコードも PRINT CHR$ で出力します。
  BASIC 0.7.4 で CHR$ が追加されています。POKE はまだ存在しませんでした。
  7〜31 の空いている部分の一部はコントロールコードが入っています。

参考に一部影響を受けている MSX のキャラクターコードを掲載します。

フォントは MSX2+ 以降です。（ひらがなが変更されています）

数値は VPOKE 使用時で、0〜31（16 進数 &H00〜&H1F）を CHR$() で出力する場合は 2 バイト使用して出力します。

MSX は株式会社MSXライセンシングコーポレーションの登録商標です。

MSX is a registered trademark or trademark of the MSX Licensing Corporation

BASIC 1.0.0・0.9.8 RC2 より
左 Alt キー＋英数 または 左 Alt+Shift+英数 でキャラクターコードを直接入力できるようになっています。

割り当ては下記のとおりです。（Shift+ は Shift も押しながら）

16進数表記と比較すると分かりやすいです。

一部のコードは制御用に用意されています。INKEY でのキー判定、CHR$ での出力などで使用できます。

28〜32（#1C〜#20）の代わりに LEFT・RIGHT・UP・DOWN・SPACE が使えます。

5PRINT で 28〜31（#1C〜#1F）も使用できますが、

BASIC 1.1 beta12 までは文字が存在しない場合（0（#00）の場合）は左へ移動してしまうので、
意図しない動作をするかもしれません。

BASIC 1.1 beta13 で改修され、28〜31 も使えるようになりました。

これ以外に INKEY では 0（#00）を用います。何も押されていない時です。

BASIC 1.2 以降、シリアルから CHR$(0) を送出している場合、INKEY では 256（#100）になります。

BASIC 1.0.0 以降 28・LEFT 29・RIGHT 30・UP 31・DOWN 32・SPACE は
INKEY の代わりに BTN(値) を使用する事によって

キーバッファ（長押しによるオートリピート）の影響を受けない現在のキー状態を得られます。
また、BTN(-1) で複数キーの同時検出も可能です。
これは PEEK(#1002)、IchigoCake BASIC は PEEK(#1E02) と同じ値です。メモリマップ も参照して下さい。

BASIC 1.4.0b5 以降、X キーの 88 も割り当てが増えています。

ゲーム用途では、BTN(値) を使用する事で理想的な操作を得られるでしょう。

また、CLK を用いてキーバッファをなくす方法もあります。

LOCATE（LC）や VPEEK（SCR）で指定する座標は 横座標,縦座標（X 座標,Y 座標）の順です。

左上が 0,0 となります。これはすべての画面モードで共通です。 

VIDEO 0・1 は BASIC 0.9.4 以降、VIDEO 2 は BASIC 1.2.0・1.2 beta 9 以降、
VIDEO 3～8 は BASIC 1.2.2・1.2 beta 34-5 以降で対応します。

IchigoJam BASIC RPi では BASIC RPi 1.2.5RPi・1.2b17RPi よりこれらの VIDEO コマンドが対応しています。

PRINT で末尾に ; を入れずに出力し、縦座標一番下にカーソルがある場合は1行上にスクロールします。

また右下で文字を出力した場合も1行上にスクロールします。
POKE で出力した場合はスクロールしません。

縦座標・横座標は画面サイズを超えた値も指定できますが、その場合は一番右および一番下の位置になります。 

VIDEO を実行した際、画面サイズが異なる場合は画面がクリアされます。
反転処理や VIDEO 0 による非表示では画面クリアされません。

VIDEO の画面モードを一覧すると、次のとおりです。バージョン表記がなければ BASIC 1.2.2 以降対応です。
ビデオ出力（SWITCH 0）以外に液晶モジュール ST7567・ST7565 （SWITCH 1・下項目参照）での表示も含めました。

カラー液晶モジュール ILI9341 は SWITCH 0 と同じ表示になります。

BASIC 1.4.0～・1.3b8～ では横幅を POS(3)、縦幅を POS(4) で得る事ができます。 

下の各画像では、縦横の座標が 5 の倍数で表示を変えてみています。

LPC1114 使用の IchigoJam BASIC・IchigoCake BASIC では
バージョンによりカーソルの点滅に合わせて画面が左右に振れる場合があります。

PRINT がループ状態になっている場合、表示に変化がない場合は PRINT しないようにすると振れを軽減できます。

また、IchigoJam BASIC RPi・IchigoJam web では発生しません。IchigoJam BASIC RPi を使用するのも解決手段です。

BASIC 0.9.8 までは横座標が 0〜35、縦座標が 0〜26 の 36×27 文字となっています。

左上が 0,0、右下が 35,26 となります。

この画面サイズでは文字が画面からはみ出す報告が耐えなかったため、
仮想メモリのメモリマップ対応と共に画面サイズの縮小で対応しています。
 

なお、IchigoJam BASIC の初期は 37×27 文字になっていましたが、
この IchigoJam BASIC が動作する IchigoJam を所有している人はごく少数と思われます。
現在公開されているファームウェアで最も古い IchigoJam BASIC 0.7 の段階で、すでに 36✕27 文字になっています。

この当時はまだ IchigoJam 初代プリント基板が公開される前で、ユニバサール基板やブレッドボードなどで作られています。

また IchigoJam BASIC は更新が可能です。そのため、37×27 文字対応の考慮は必要ないと思われます。

★ LED 端子は外しても使用可能です。外すと液晶のバックライトが光らなくなります。

☆ 液晶モジュールによって 3.3V の場合と 5V の場合があります。どちらも使用できる場合もあります。

電源を入れた後 SWITCH を実行して下さい。F10 に割り当てられています。（ベータ版では一時的に F12 割り当て） 

再度 SWITCH を実行してビデオ画面に戻せます。SWITCH 1 で液晶、SWITCH 0 でビデオ画面へ戻す事も可能です。
VIDEO 0 による非表示、VIDEO 1 の再表示も可能です。1.4.0b3 より VIDEO 2 で反転表示ができるようになっています。

BASIC 1.3.2b12（正式版 1.4.0）より液晶のコントラストが追加されています。SWITCH 1,5 などと値を加えます。

値は 0～63 です。(0 が最も薄い・63 が最も濃い）デフォルトは 14 になっています。

液晶モジュールによって最適なコントラストの値が異なるため、この値は可変できるようにするのが良いでしょう。

液晶モジュールによってはデフォルト値ではかなり薄く表示される場合もあります。

よく見ると薄く表示されている場合があり、この場合はコントラスト値を調整して使用できます。

★ LED 端子は外しても使用可能です。外すと液晶のバックライトが光らなくなります。抵抗を挟んで明るさを調整できます。

☆ 液晶モジュールによって 3.3V の場合と 5V の場合があります。どちらも使用できる場合もあります。

変数やコマンドの制限から、IchigoJam BASIC・IchigoCake BASIC では独特の記載をしなければいけない場合があります。

IF は BASIC 0.9.4 より AND・OR・ELSE に対応しただめ、他の BASIC と同じように記載が可能となっていますが、

旧バージョン対応で *・+ および &・| も最新バージョンで使用可能です。条件を () で囲って下さい。

IF～THEN の THEN はここでは表記していますが、実際には THEN を省略可能 です。

その他、変数が A〜Z のみ で整数の数値でしか扱えない事に注意して下さい。

XX=0、Y=5.5 などは IchigoJam BASIC で扱えません。

IchigoJam BASIC・IchigoCake BASIC では次のエラーが表示されます。バージョンによって表示が異なります。

※ IchigoJam BASIC・IchigoCake BASIC では処理を中断する一つのエラーとして扱っています。

• 使用できる行番号は 1〜32767 です。
  BASIC 1.2.2 より 16385～32767 は通常の LIST では表示されない隠し状態になります。
• RENUM で行番号は 10 から 10 おきに更新されますが、GOTO・GOSUB は更新されません。
  BASIC 1.0.0 より行番号の変更が必要な行を表示します。
  BASIC 1.3.0 より一部を除き GOTO・GOSUB の行番号も変更します。
• PRINT で出力していない時は CHR$(0) になっています。一方でスペース・空白は CHR$(32) です。
  これは VPEEK・SCR・PEEK で影響を受けます。（多くの BASIC は CHR$(32) です）
• 条件判断に対して、真は 1、偽は 0 を返します。多くの BASIC では真が -1 です。
  そのため論理式は X=X-(I=ASC("4"))+(I=ASC("6")) と、他とは ＋・ー 逆になります。
• ウェイト（一定時間停止）を行う場合は WAIT や TICK を用いて下さい。
  バージョンや実行環境（LPC1114 と RISC-V、IchigoJam web、IchigoJam BASIC RPi）の違いで
  処理速度が異なるため、待ち時間を大きく変化させずに済みます。
• IchigoJam BASIC で一つのプログラムで使用できる容量は 1K バイトです。
  （初期は 512 バイト、BASIC 0.8.6 より 1022 バイト、BASIC 0.9.9-RC2 より現在 1024 バイト）
  これは1行を30文字としておよそ34行＝およそ1.3画面分、1行を20文字としておよそ51行＝およそ2画面分となります。
  これで少なすぎる場合、LRUN を用いて他番号のプログラムを呼び出す事で長いプログラムにできます。
  IchigoCake BASIC は 4096 バイトに拡張されています。これは EEPROM の扱いにも影響があります。
• プログラムの文字数はそのまま容量に影響します。
  例えば LOCATE→LC、PRINT→? と短縮形にした方が容量を節約できます。
  ただし行番号部分は固定で 2 バイトのため、1 と 10000 で容量に変化はありませんが、
  GOSUB 10000 よりも GSB 100 の方が文字数が少ないため、短くなります。
  詳細は BASIC/メモリマップ の プログラム を参照して下さい。
• 最新版で 1 行の最大文字数は 200 文字です。これは行番号とその右の空白を含みます。
  またプログラム以外にダイレクトモードで入力する場合の文字数も共通で 200 文字です。
• LRUN はプログラムでも使用できます。これを生かして長いプログラムを生成できます。
  ただし BASIC 0.9.3 まではプログラムを読み込む際に変数・配列は初期化されます。
  （値を文字で出力させ、先のプログラムで VPEEK・SCR で取り込む手法を用いていたプログラムがあります）
  BASIC 0.9.4 からは CLV コマンドで初期化するようになりました。
  EEPROM や MixJuice でシーン毎にプログラムを作成して、ストーリー選択型のアドベンチャーゲームが作れそうです。
• IchigoJam BASIC・IchigoCake BASIC はプログラム実行中に順次プログラムを解読し、コマンドを実行しようとします。
  例えば IF で条件文に該当しない場合、THEN 以降のコマンドを一切無視します。
  これを用いて IF VER()>=対象バージョン コマンド という記載を行うと、
  対象バージョンより古いバージョンでは コマンド を無視するので、エラーにならずに処理できます。
  バージョンによって異なる処理を要する場合でもこの方法で分岐して処理可能です。

2019年4月より IchigoCake BASIC が製品発売されました。IchigoCake BASIC は IchigoJam BASIC と次の点が異なります。

• プログラムサイズが 4k バイトになっています。IchigoJam BASIC は 1k バイトなので、領域が 4 倍です。
• 配列が [0]～[357] になっています。IchigoJam BASIC は [0]～[101] なので、約 3.5 倍です。
• 本体へのプログラム保存は 0～5、EEPROM は 100～131（1024k EEPROM の場合）となっています。
  EEPROM 保存も 4k バイト単位なので、IchigoJam BASIC とは別に EEPROM を用意する事をおすすめします。
• 上記の拡張により、IchigoCake の仮想メモリは IchigoJam BASIC とは一部異なります。メモリマップ も参照して下さい。
  仮想メモリへアクセスしているプログラムは変更が必要な場合があります。
• PanCake を操作する IchigoCake 独自の PC.～ コマンドが追加されています。
  IchigoJam＋PanCake では PRINT で出力する必要があり、通常は IchigoJam BASIC の画面はコマンドで埋まりますが、
  PC.～ コマンドを使う事で、IchigoCake BASIC も使用でき、2 画面表示を実現できます。
• キーボード切り替えは KBD コマンドが使用できます。IchigoJam BASIC RPi と同じ仕様です。