豊四季Tiny BASIC for Arduino STM32 V0.87 リファレンスマニュアル

GOTO 行番号
GOTO "ラベル"

プログラムの実行を行番号、"ラベル"で指定した行にジャンプします。
行番号には数値、式（変数、関数を含む）が利用可能です。
ラベルを指定した場合、行先頭に同じラベルがある行にジャンプします。
ラベルはダブルクオテーション( " )で囲って指定します。

上記の例では、40行の GOTO で60行にジャンプ、50行のラベル指定で20行にジャンプしています。
ラベルを使うとプログラムの流れがわかりやすくなります。
ラベルは必ず行の先頭に記述してください。行に先頭にない場合は、ラベルとして認識されません。

上記の例では、30行の真ん中にラベルをつけているのでエラーとなります。

行番号には式や変数の指定が可能です。
ただしその場合は、 RENUM コマンドよる行番号付け替えに対応出来ない場合があります。

(1)では RENUM コマンドは何もしません。
(2)は500を号番号とみなして更新します。
ただし(1)(2)とも計算結果が正しい行番号となることは保証出来ません。
ご注意下さい。

GOSUB 行番号
GOSUB "ラベル"

プログラムの実行を一旦、行番号またはラベルで指定した行に移ります。
移った先で RETURN 命令により、呼び出した GOSUB 命令の次の位置に戻ります。
行番号には数値、式（変数、関数を含む）が利用できます。
ラベルを指定した場合は、行先頭に同じラベルがある行に移ります。
ラベルはダブルクオテーション`"`で囲って指定します。

上記の例では、10行、20行でラベルを指定してサブルーチンを呼び出しています。
30行では、行番号を指定してサブルーチンを呼び出しています。
ラベルを使うことで、プログラムの実行がわかりやすくなります。
行の先頭に無いラベルは、GOSUB 文の呼び出し先としての参照はされません。

行番号には式や変数の指定が可能ですが、 RENUM コマンドよる行番号付け替えに対応出来ない場合があります。

(1)では RENUM コマンドは何もしません。
(2)は500を行番号とみなして更新します。
ただし(1)(2)とも計算結果が正しい行番号となることは保証出来ません。ご注意下さい。

RETURN

なし

直前に呼び出された GOSUB の次の処理に復帰します。
詳細は GOSUB のコマンドリファレンスを参照して下さい。

IF 条件式 真の場合の実行文
IF 条件式 真の場合の実行文 ELSE 偽の場合の実行文

条件式の真偽判定を行い、真の場合は 真の場合の実行文 を実行します。
条件式が偽の場合、ELSE がある場合は 偽の場合の実行文 を実行します。

真偽は次の条件となります。

真偽判定を行う条件式には定数、数値、関数を含む式が記述できます。

実行文には、`:`を使って複数のコマンドを記述することが可能です。 .例

上記のプログラムでは、入力した年齢の範囲をチェックし、
不当な値である場合は、再入力を行います。+ 20行の真の場合に実行される命令文では PRINT 、GOTO が逐次実行されます。
実行文には IF 、GOTO 、GOSUB 等の制御命令を使うことも可能です。

yを押したら、"Y key" を表示して終了、その他のキーなら"End" を表示して終了する 何も押されていなければ10行から30行をループする。

FOR 変数 = 初期値 TO 最終値 [STEP 増分]
　＜繰り返し実行文(複数行可能)＞
NEXT 変数

FOR から NEXT の間の実行文を繰り返し実行します。
繰り返し実行は、指定した変数が最終値以上になるで行われます。

変数には初期値がセットされ、一回の繰り返し毎に、増分を加算します。
加算された変数が最終値またはそれ以上の値になった時点で繰り返し処理を終了し、NEXTの次の命令の実行に移ります。

STEP にて増分を指定しない場合、増分は1となります。
STEP 増分には、負の値の指定も可能です。

上記の例ではIを0から5まで、2ずつ増加して30行の命令を繰り返し実行します。 Iが4の時、増分2を足すと終了値5を超えた6となるので繰り返しを終了し、50行を実行します。

FOR 文はネストも可能です(利用例 のプログラムを参照）。
最大で10段のネストを行うことが出来ます。
ネストする場合、各 FOR ～ NEXT の組み合わせには異なる変数を指定します。

FOR ～ NEXT の繰り返しは、利用している変数が繰り返し条件を満たさなくなった時点で繰り返しを終了します。
例1 に`35 I=6`を追加した 例2 では、ループ内で条件を満たさなくすることでループを抜けることが出来ます。

END

なし

プログラムの実行を終了します。

BANK プログラム番号

内部フラッシュメモリのプログラム保存領域 0～5の領域のうちの
プログラム番号 で指定した領域(4096バイト)を仮想アドレスにて参照可能な
領域：PRG2 (領域サイズ 4096バイト)にマッピングします。

すなわち、BANK にてプログラム番号を指定することで、
フラッシュメモリのプログラム保存領域にアクセスすることが出来ます。

下記の図は、BANK 4 を実行した例です。

プログラム番号4の4096バイトの領域は、
PRG2 ～ PRG2 + 4095の領域にマッピングされています。
この領域は、PEEK コマンドにより参照することが出来ます。

さらに、ERASEコマンドでプログラム保存領域を消去した直後は、
１回だけ、FWRITEコマンド、BLOADコマンドにて
書き込みを行うここが出来ます。

プログラム領域への直接書き込みを行う際は、操作ミス等により
削除すべきでないプログラムを消去してしまう可能性がありますので、ご注意願います。

仮想アドレスを参照する定数 ＊PTG2*を含め、仮想アドレスの詳細については、 +「メモリーマップ」の「仮想アドレス」を参照下さい。

フラッシュメモリ内の保存プログラムをSDカードに退避する

上位の退避したプログラムをロードする

CONFIG 項目番号, 設定値 [,設定値2, 設定値3]

項目で指定した機器の設定を行います。

設定はコマンド実行後、直ちに反映されます。本設定は電源を落とすまで有効です。
次回以降の起動にも適用したい場合は、SAVECONFIG コマンドで保存して下さい。

FWRITE アドレス, データ

プログラム保存領域（指定した仮想アドレス）に２バイトデータを書き込みます。
書き込み対象のプログラム保存領域は、BANKコマンドにて、切り替えることが出来ます。
書き込みを行うには、事前にERASEコマンドで対象のプログラム保存領域を消去しておく必要があります。

仮想アドレスは必ず偶数アドレスを指定しなければなりません。

書き込み先の仮想アドレスの指定には定数 PRG2の利用を推奨します。

SAVECONFIG

なし

CONFIG コマンドの設定内容をフラッシュメモリに保存します。
次回以降の起動でも設定を有効にします。

フラッシュメモリの利用状況により、保存に失敗する場合があります。
その場合は、フラッシュメモリの初期化を EEPFORMAT にて行って下さい。

SYSINFO

なし

システム情報を表示します。
スタックアドレス、ヒープアドレス、SRAM未使用サイズ、キーワード数を表示します。

本コマンドは、「Tiny BASIC for Arduino STM32」のプログラム本体を拡張・改造した際の、リソース残量を把握するために利用します。

CLV

なし

変数領域（変数、配列）の初期化を行います。
変数A～Z、A0～Z6、配列@(0)～@(99)はすべて0に初期化されます。

LRUN コマンドにてプログラムをロードして実行する場合、変数領域は初期化されません。
これにより呼び出し元のプログラムの変数を引き継ぐことが出来ます。
呼び出されたプログラムにて明示的に変数領域の初期化を行う場合は、CLV コマンドを使って下さい。

CONSOLE モード

コンソール画面の切替を行います。

モードの指定で、デバイスコンソールを指定した場合、利用している表示デバイス（NTSC、OLED、TFT）がコンソール画面となります。
シリアルコンソールを指定した場合、USBシリアルまたはシリアルポート接続のシリアルターミナルがコンソール画面となります。

シリアルコンソールでは、パソコン上のターミナルソフトにてスクリーン編集を行うことが出来ます。デフォルトでは２つのシリアルポート（USBシリアル、シリアル端子PA9、PA10)のうち、USBシリアルがスクリーン編集用として機能します。

シリアルポートをスクリーン編集用に利用する場合は、SMODE コマンドを使うことで、利用することが出来ます。

シリアルコンソールを利用している状態で SCREEN コマンドを実行した場合、デバイスコンソールに切り替わり、指定したスクリーンモードの設定が反映されます。 シリアルコンソールからデバイスコンソールに切り替えた場合、スクリーンモードはデフォルトの設定となります。

コンソール画面をシリアルコンソールに切り替える

DELETE 行番号
DELETE 先頭行番号, 末尾行番号

プログラム内の指定した行、指定した範囲（先頭行番号、末尾行番号）の行を削除します。

プログラム内の20行から50行の範囲を削除する

ERASE プログラム番号
ERASE 開始プログラム番号 , 終了プログラム番号

マイコン内のフラッシュメモリに保存されているプログラム(プログラム番号0～5)の削除を行います。
削除対象プログラムは、コマンド引数にてプログラム番号を指定するか、
削除するプログラム番号の範囲（開始プログラム番号、終了プログラム番号）を指定します。

EXPORT
EXPORT 対象番号
EXPORT 開始番号 , 終了番号

マイコン内のフラッシュメモリに保存されているプログラム(プログラム番号0～5)を出力表示します。
ターミナルソフト等を利用することにより、出力表示されたプログラムリストをコピーすることで、
内部保存されたプログラムのバックアップを行うことが出来ます。

引数に何も指定しない場合は、0 ～ 5までの全てのプログラムを画面に出力します。
対象番号を指定した場合は、該当するプログラム番号の内容のみ出力します。
開始番号と終了番号を指定した場合はその範囲のプログラムを出力します。

出力形式は次の形式となります。

プログラム番号毎のプログラムリストの先頭に NEW コマンド、末尾に SAVE プログラム番号 が付加されます。
ターミナルソフトにペーストすることにより、フラッシュメモリ内に再登録することが出来ます。

FILES
FILES 開始プログラム番号
FILES 開始プログラム番号, 終了プログラム番号
FILES "ファイルパス"

マイコン内のフラッシュメモリに保存されているプログラムまたは、SDカード内に保存されているファイルの一覧を表示します。

引数を指定しない場合は、内部フラッシュメモリ内のプログラム番号0～5の先頭行をリスト表示します。開始プログラム番号,終了プログラム番号を指定した場合、その範囲のリストを表示します。
プログラム番号にプログラムが保存されていない場合は(none)と表示されます。
保存されている場合は先頭行の内容の一部を表示します。
プログラム先頭行にコメントをつけると、一覧表示でのプログラムの内容が分かり易くなります。

引数にファイルパスを指定した場合、SDカード内のファイルを一覧表示します。
ファイル名は8.3形式となります。
ファイルパスには、ディレクトリ名、ディレクトリ名＋ファイル名(ワイルドカード指定可能）の記述が可能です。ワイルドカードは、*と?が利用可能です。ディレクトリ名指定の上位、下位の"/"は省略可能です。""と"/"は同じ出力となります。

出力されるファイル一覧の順番は不定となります。ディレクトリファイルの場合は、ファイル名の最後に*が付きます。

FREE()

なし

プログラム領域の残りバイト数： 0 ～ 4095

プログラム領域の残りバイト数を返します。
作成したプログラムサイズを確認する場合は、下記の記述にて行うことが可能です。

LIST
LIST 表示開始行番号
LIST 表示開始行番号, 表示終了行番号

プログラムリストの表示を行います。
引数を指定しない場合は、全てのプログラムを表示します。
表示開始番号のみ指定した場合は、その行番号のプログラムリストを表示します。
表示開始番号、表示終了番号を指定した場合は、そこ範囲のプログラムリストを表示します。

表示したプログラムリストは、カーソルを移動して編集することが出来ます。
編集した行は必ず ENTER キーを押して入力確定を行って下さい。

LOAD
LOAD プログラム番号
LOAD "ファイル名"
LOAD "ファイル名", モード

内部フラッシュメモリ、または外付けSDカードからプログラムを読み込みます。

引数を省略した場合は、内部フラッシュメモリのプログラム番号を読み込みます。
引数にプログラム番号を指定した場合は、指定したプログラム番号を読み込みます。
プログラムを読込の際、変数は初期化 されます。

引数にファイル名を指定した場合、SDカードからプログラムを読み込みます。
ファイル形式は、テキスト形式またはバイナリ形式(SAVE時にバイナリ形式指定）対応しています。

ファイル名にはディレクトリパスを付けることが出来ます。
ファイル名には大文字小文字の区別はありません。

ＳＤカードからの読み込みには、引数のモードにて
0 : 上書きモード、 1 : 追記モード を指定することが出来ます。

上書きモード の場合、メモリー上のプログラムの初期化後に読み込みます。
変数領域は初期化されます。

追記モード の場合、メモリー上の既存プログラムに追記して読み込みを行います。
ただし、行番号が同じ行は上書きされます。
また、変数領域は初期化されません。

LRUN プログラム番号
LRUN プログラム番号 ,行番号
LRUN プログラム番号 ,"ラベル"
LRUN "ファイル名"
LRUN "ファイル名" ,行番号
LRUN "ファイル名" ,"ラベル"

プログラム番号またはファイル名で指定したプログラムを実行します。
第1引数に数値を指定した場合は、内部フラッシュメモリから指定したプログラム番号のプログラムを読み込んで実行します。ファイル名を指定した場合は、SDカードから指定ファイルを読み込んで実行します。
第2引数に行番号またはラベルの指定がある場合は、その行からプログラムの実行を開始します。

ファイル名の指定には、PRINT 文と同等の記述(文字列関数の利用、文字の結合等)が可能です。

上記の例では、Nの値が1～9の場合には 対応する"PRG01.BAS"～"PROG09.BAS"をロードして実行します。

NEW

なし

プログラム領域のプログラム、変数、配列変数を消去します。

REM コメント
' コメント

プログラムに説明等の記載を行います。
‘ (シングルクオート)は REM の省略形です。

REM および ’ 以降の文字以降はすべてコメントとみなし、プログラムとして実行されません。
プログラムの先頭行にコメントを付けた場合、
FILES コマンドによる、フラシュメモリのプログラム一覧表示時に、
プログラムの見出しとして表示されます。

RENUM
RENUM 開始行番号
RENUM 開始行番号, 増分

プログラム全体の行番号を指定した条件にて振り直します。
引数を省略した場合は、行番号を10行から10間隔で振り直します。

開始番号のみ指定した場合、指定した開始番号から10間隔で振り直します。
開始番号と増分を指定した場合、指定した開始番号から指定した増分で振り直します。
振り直しにおいて、GOTO 文、GOSUB 文のとび先の行番号も更新されます。

行番号を100から10間隔で振り直す。

RUN

なし

プログラムの実行を行います。
実行中のプログラムは ESC キーまたは、CTRL+C キーにて強制終了することが出来ます。
シリアルコンソール上で ESC キーにて中断する場合は、ESC キーを２回押す必要があります。

プログラムの実行中は、カーソルが非表示となります。
プログラムの実行中は実行すべき次の行が無い場合、実行を終了します。
また END コマンドにより実行を終了します。
プログラムの実行中にエラーが発生した場合は実行を終了します。

プログラムを実行する。

SAVE
SAVE プログラム番号
SAVE "ファイル名"
SAVE "ファイル名", 保存形式

プログラムをマイコン内のフラッシュメモリ、またはSDカードに保存します。

引数の省略、数値を指定した場合は内部フラッシュメモリに保存します。
プログラムは最大で6つ保存可能です。保存先はプログラム番号0～5で指定します。
引数の省略した場合、プログラム番号0に保存します。

ファイル名を指定した場合は、SDカードにプログラムを保存します。
保存形式の指定により、テキスト形式またはバイナリ形式にて保存が行えます。
保存形式を指定しない場合は、テキスト形式で保存されます。
バイナリ形式での保存はプログラム領域4kバイトの全てを保存します。

WIDTH 横文字数, 縦文字数

シリアルコンソール画面上のスクリーンサイズの設定を行います。
この設定にてスクリーンエディタの表示文字数、スクロール範囲の変更を行うことが出来ます。
スクリーンサイズは、最小サイズ16桁×10行 ～ 最大 128桁×45行 となります。

スクリーンサイズを80桁×30行に設定する

ATTR 属性

文字の表示属性を設定します。指定した表示属性は以降の文字表示に反映されます。
属性に指定する属性コードは次の表の通りです。

CLS
CLS 消去対象画面

画面上に表示している内容を全て消します。
引数に消去対象画面を指定した場合、指定した画面の消去を行います。
OLED版、TFT版ではシリアルコンソール画面切り替え中でも、
デバイス画面へのグラフィック描画コマンドを使った描画が可能です。
その際、CLS コマンドの引数にてどちらの画面を消去するかを指定することが出来ます 。

COLOR 文字色
COLOR 文字色, 背景色

文字色の設定を行います。指定した色は以降の文字表示に反映されます。
文字色、背景色で指定する色コードに対する色は次の表の通りです。

TFT(ILI9341)ディスプレイを利用している場合、上記の色コードに加えて、
RGBコード：$0009 ～ $FFFFの色指定が可能です。RGBコードは次の構成となります。

RGBコードの指定は、RGB 関数を使うことで直感的な色を指定することが出来ます。

GETS (文字列格納先仮想アドレス[,有効文字列長] )
GETS (文字列格納先仮想アドレス,有効文字列長,モード[,参照元仮想アドレス])

文字列格納先仮想アドレス

コンソール画面のカーソル位置での文字列入力を行います(モード 0時)。
または、参照元仮想アドレスに格納されているバイナリーデータを
文字列として取得します(モード1時)。

取得した文字列データは引数で指定した文字列格納先仮想アドレスに格納されます。
戻り値として、そのアドレスを返します。

取得した文字列は、有効文字列長(デフォルトでは32)の長さ分が文字列として利用されます。

仮想アドレスの指定には次の定数することが出来ます。

モード１において、引数の参照元仮想アドレスを省略した場合は、領域のみを確保します。

仮想アドレスの詳細については、「メモリーマップ」の「仮想アドレス」を参照下さい。

指定した仮想アドレスには次の形式にて文字列が格納されます。

下記の例では、変数 S1 、 S2 に文字列の入力を行い、その内容を表示しています。

有効文字列長に8を指定しているため、入力した文字列のうち、先頭から8バイトが格納されます。
変数に代入されている仮想アドレスに格納されている文字列を表示する場合は STR$ 関数を利用します。
変数 S2 の格納アドレスを MEM+10 としているのは、文字列8バイト分に長さと文字列終端コードの2バイトが必要なためです。

全角を含む文字列を入力した場合、有効文字列長は全角2バイト文字を考慮します。
上記のプログラムを再度実行し、今度は全角半角混合文字を入力してみます。

入力した文字列 "あeいうえお" は11バイトです。 有効文字列長に8を指定しているため*S1* には "あeいう"の7バイト分が格納されます。

入力した文字列は、BYTE 関数でバイト数、LEN 関数で文字数を調べることが出来ます。

INKEY( )

なし

押したキーの文字コード： 0 ～ 255
キーが押されていない場合は0を返します。

キーボード上の押しているキーのコードを取得します。
キーが押されていない場合は、0を返します。
押したキーが返すコードについては「キー入力コード」を参照下さい。

INPUT 変数
INPUT 変数,オーバーフロー時の既定値
INPUT プロンプト, 変数
INPUT プロンプト, 変数, オーバーフロー時の既定値

現在のカーソル位置にて数値の入力をし、指定した変数にその値を格納します。
キーボードから入力できる文字は符号-、+、数値 0～9、入力訂正の BS、DEL、入力確定のEnterキーです。
それ以外の入力はできません。
数値を入力せずに、Enterキーにて入力確定を行った場合、変数には0が格納されます。

引数に変数のみを指定した場合、"変数名:"を表示しその後ろの位置から数値を入力します。

プロンプトを指定した場合は、そのプロンプトを表示しその後ろ位置から数値を入力します。

例.

オーバーフロー時の既定値を指定した場合、入力値した数値がオーバーフローを発生した場合は、オーバーフロー時の既定値を変数に設定します。オーバーフロー時の既定値を設定していない場合は、Overflowエラーとなります。

LOCATE 横位置, 縦位置

カーソルを指定した位置に移動します。

縦横位置それぞれの指定に0以下の数値を指定した場合、それぞれの位置は0となります。
横位置にCW-1を超える数値を指定した場合、横位置はCW-1となります。
縦位置にCH-1を超える数値を指定した場合、縦位置はCH-1となります。

定数CW、CHに設定されている値は次のようすることで確認することができます。

PRINT
PRINT 文字列 | 数値
PRINT 文字列 | 数値 ;
PRINT 文字列 | 数値 ; 文字列 | 数値 ;…
PRINT 文字列 | 数値 ; 文字列 | 数値 ;… ;
PRINT # 桁数,文字列 | 数値 ; 文字列 | 数値 ;… ;

… は可変指定を示す
‘;’ は連結・改行抑制指定(オプション)、カンマ ‘,’ も可能
PRINT の代わりに、省略形 ? も利用可能

指定した文字列、数値をスクリーン画面のカーソル位置に表示します。

文字列、数値は連結指定のセミコロン’;’、またはカンマ’,’にて連結して表示することが出来ます。
また最後に’;’または’,’が付加されている場合は改行しません。

数値の整形表示
#数値 にて桁数を指定することで、任意の桁数（指定桁に満たない場合は空白を入れる）にて等間隔で表示します。
数値の前に-（マイナス）を付加した場合、空白をではなく、0(零)で不足桁を補います。
#数値 は任意の位置、任意の回数指定できます。

桁数指定なし

桁数指定あり(空白文字で補間)

桁数指定あり(0で補間)

表示位置の指定
LOCATE コマンドを併用することで、スクリーン画面の任意の位置に文字を表示することが出来ます。

色、属性の指定
スクリーン画面が SCREEN 0 のターミナルコンソールの場合、
COLOR コマンド、ATTR コマンドを併用することで、文字の前景色、背景色の指定、点滅、アンダーライン等の属性を付加することが出来ます。

REDRAW

なし

テキスト画面表示用メモリ（VRAM）の内容を画面に再表示を行います。
再表示においては、個々に色付しけした文字の色、背景色、属性は欠落します。
再表示後の表示内容は指定した文字色、背景色、属性に統一されます。

POKE コマンド等にて画面表示用メモリにデータを書き込んだ場合、
そのままでは表示が反映されません。
REDRAW コマンドを実行して再表示を行う必要があります。

VPEEK (横位置 , 縦位置)

指定位置に表示されている文字の文字コード（0 ～ 255）

画面上の指定位置に表示されている文字の文字コードを取得します。
引数の指定位置が範囲外の場合は0を返します。

ABS (数値)

指定した 数値 の絶対値

指定した 数値 の絶対値を返します。

ASC (文字列)
ASC (文字列 , 文字位置)
ASC (変数)
ASC (変数 , 文字位置)

指定した 文字列 に対応する 文字コード ： 0 ～ $FFFF
(1バイト文字コード または 2バイト文字コード）

指定した 文字列 (全角文字または半角文字)に対応する 文字コード を返します。
文字列 のみを指定した場合は、先頭の 文字コード を返します。

文字位置 を指定した場合は、指定した 文字列 の 文字位置 の 文字コード を返します。

変数 を指定した場合、変数 が参照している文字列の 文字コード を返します。

BIN$ (数値)
BIN$ (数値 , 桁数)

2進数文字列(1桁～16桁)

指定した 数値 を2進数文字列に変換する 文字列関数 です。
数値 には式、変数、定数等の指定が可能です。

桁数 を指定した場合は数値が 桁数 に満たない場合は、0で桁を補います。
桁数 を超える場合は数値の 桁数 を優先します。
桁数 を指定しない場合は、先頭の0は付加されません。

本関数を含め 文字列関数 は、
BLOAD、BSAVE、CAT、DWBMP、FILES、GPRINT、 KANJI、LDBMP、
LOAD、LRUN、PLAY、PRINT、REMOVE、SAVE、SPRINT
コマンドの引数にて利用可能です。

BYTE (変数)
BYTE (文字列)

文字列の長さ: 0 ～ 32767

文字列定数、変数で参照してる文字列のバイト数をカウントし、その値を返します。

例：文字列のバイト数を求める

本関数は全角1文字は2バイトとしてカウントします。
全角を1文字として扱いたい場合は、LEN 関数を利用して下さい。

CHR$ (文字コード)
CHR$ (文字コード, 文字コード, … , 文字コード)

指定した 文字コード に対する文字、または文字列

指定した 文字コード に対応する文字、文字列を返します。
文字コード は2バイトシフトJISコード(全角含む)、1バイト半角アスキーコードに対応ます。
文字コード をカンマ区切りで複数指定した場合は、文字列を返します。

本関数を含め 文字列関数 は、
BLOAD、BSAVE、CAT、DWBMP、FILES、GPRINT、 KANJI、LDBMP、
LOAD、LRUN、PLAY、PRINT、REMOVE、SAVE、SPRINT
コマンドの引数にて利用可能です。

DMP$ (数値)
DMP$ (数値 , 小数点桁数)
DMP$ (数値 , 小数点桁数 , 整数部桁数)

小数点を付加した数値文字列

指定した 数値 を小数点付きの文字列に変換する文字列関数です。
引数の 小数点桁数 をnとした場合、数値÷10ⁿの計算を行い、
小数点以下の数値を含めて表示します。

小数点桁数 を指定しない場合、小数点桁数 はデフォルトの2となります。

整数部桁数 を指定した場合、その桁数に満たない場合は空白で補完します。

本関数を含め 文字列関数 は、
BLOAD、BSAVE、CAT、DWBMP、FILES、GPRINT、 KANJI、LDBMP、
LOAD、LRUN、PLAY、PRINT、REMOVE、SAVE、SPRINT
コマンドの引数にて利用可能です。

アナログ入力値0～4095を MAP 関数にて0～3300に変換し、
0～3300の数値を DMP$ 関数にて"0.000"～"3.300"の文字列数値に変換して表示しています。

HEX$ (数値)
HEX$ (数値 , 桁数)

16進数文字列(1桁～4桁)

指定した 数値 を16進数文字列に変換する 文字列関数 です。
数値 には式、変数、定数等の指定が可能です。

桁数 を指定した場合は 数値 が 桁数 に満たない場合は、0で桁を補います。
桁数 を超える場合は 数値 の 桁数 を優先します。
桁数 をしない場合は、先頭の0は付加されません。

本関数を含め 文字列関数 は、
BLOAD、BSAVE、CAT、DWBMP、FILES、GPRINT、 KANJI、LDBMP、
LOAD、LRUN、PLAY、PRINT、REMOVE、SAVE、SPRINT
コマンドの引数にて利用可能です。

LEN (変数)
LEN (文字列)

文字列の長さ: 0 ～ 32767

文字列定数、変数で参照してる文字列の文字数をカウントし、その値を返します。
全角文字、半角文字とも1文字としてカウントします。

変数Aが参照している文字列の長さ LEN 関数で取得し、その長の分、文字を拡大表示します。

実行結果

LET 変数 = 数値
LET 配列変数 = 数値, 数値, 数値, 数値．．．
変数 = 数値
配列変数 = 数値, 数値, 数値, 数値．．．

LET は省略可能

変数 に値を代入します。
数値 には式、定数、変数、配列変数等を評価した整数値の記述が可能です。
配列変数 への代入は、指定した複数の 数値 の連続代入が可能です。
指定した 添え字 を起点に順番に代入します。

上記の記述は、

と同じです。

LET は省略可能です。
次の2は同じ結果となります。

MAP (値 , 範囲下限 , 範囲上限 , 新範囲下限 , 新範囲上限)

スケール変換後の値: -32767 ～ 32767

指定した値のスケール変換を行い、その値を返します。

上記の例ではアナログ入力値0～4095を0 ～ 99のレンジに変換し、その値を返します。
アナログ入力や画面座標指定、PWMパルス出力等にて MAP 関数を使うことで、簡単にレンジ変換を行うことができます。

RND (数値)

0から指定した値未満の乱数

0から指定した値－1の範囲の乱数を発生させ、その値を返します。

上記の例では変数 R には0～9範囲の値が代入されます。

STR$ (変数)
STR$ (変数,先頭位置,長さ)
STR$ (文字列)
STR$ (文字列,先頭位置,長さ)

指定した 文字列 および 変数 が参照している文字列を全部または一部を切り出して返します。
全角(シフトJIS)1文字は1文字としてカウントします。

指定した 文字列 および 変数 が参照している文字列を全部または一部を 切り出して返す文字列関数です。
引数に 先頭位置、長さ を指定した場合は、その条件にて文字列を切り出して返します。
先頭位置 は1からの指定となります。

本関数を含め 文字列関数 は、
BLOAD、BSAVE、CAT、DWBMP、FILES、GPRINT、 KANJI、LDBMP、
LOAD、LRUN、PLAY、PRINT、REMOVE、SAVE、SPRINT
コマンドの引数にて利用可能です。

上記の例では、変数Sが参照している文字列" Hello,world! こんにちは世界!"に対して、
20行は全て出力、30行は14番目からの文字から8文字 "こんにちは世界!""を出力、
40行は直接指定した文字列"あいうえお"の5番目の文字から1文字 "お"を出力しています。

STRCMP(文字列1, 文字列2[, 長さ])

※文字列1、文字列2 には文字列定数、変数の指定が可能

0：等しい
1：等しくない

文字列1 と 文字列2 を比較し、等しい場合は0、等しくない場合は1を返します。
引数に 長さ を指定している場合は、その長さの文字列分の比較を行い判定します。
長さ の指定を行っていない場合は、単純に文字列1と文字列2の比較を行います。

PEEK (仮想アドレス)

指定した仮想アドレスに格納されている1バイトデータ：0～255

指定した仮想アドレスに格納されている値（１バイト）を返します。
仮想アドレスの指定には次の定数を利用することで有用な領域への参照が簡単に行えます。

仮想アドレスの詳細については、「メモリーマップ」の「仮想アドレス」を参照下さい。

ユーザーワーク領域は利用者が自由に利用出来る領域です。
それ以外の領域はBASICの実行にて利用する領域です。
例として画面上のカーソル位置X,Yに格納されている文字の参照は次のようになります。

POKE 仮想アドレス , データ
POKE 仮想アドレス , データ , データ , … ,データ(可変個数指定)

指定した仮想アドレスに指定したデータを書き込みます。
仮想アドレスの指定には次の定数を利用することで有用な領域への書込みが簡単に行えます。

仮想アドレスの詳細については、「メモリーマップ」の「仮想アドレス」を参照下さい。

ユーザーワーク領域は利用者が自由に利用出来る領域です。
それ以外の領域はBASICの実行にて利用する領域です。
指定した仮想アドレスに上記以外の領域を指定した場合はエラーとなります。

例として画面上のカーソル位置X,Yへの文字の書込みは次のようになります。
VRAMに書き込んだ内容を画面の表示に反映するには REDRAW コマンドを実行します。

TICK ()
TICK (モード)

モード指定に従った経過時間を返す。
モード 0： 0 ～ 32767 ミリ秒の経過時間を返す(約32.767秒でオーバーフロー)
モード 1： 0 ～ 32767 秒の経過時間を返す(約9.1時間でオーバーフロー）

起動からの経過時間を返します。
経過時間は CLT コマンドにて初期化が可能です。
CLT コマンドと組み合わせて使うことで、処理時間の測定を行うことが出来ます。
モード 指定無し、または0を指定の場合、ミリ秒単位 の経過時間を返します。
モード に1を指定した場合は、秒単位 の経過時間を返します。

DATE

なし

内蔵RTCから現在の時刻を読み、その情報を画面に表示します。

GETDATE 年格納変数, 月格納変数, 日格納変数, 曜日格納変数

内蔵RTCから日付情報を取得し、その値を指定した変数に格納します。
格納される値は次の通りです。

年格納変数： 西暦年4桁整数 1970 ～ 2036
月格納変数： 1 ～ 12
日格納変数： 1 ～ 31
曜日格納変数： 曜日コード 0 ～ 6（0:月 1:火 2:水 3:木 4:金 5:土 6:日）

GETTIME 時格納変数 , 分格納変数 , 秒格納変数

内蔵RTCから日付情報を取得し、その値を指定した変数に格納します。
格納される値を次の通りです。

時格納変数： 0 ～ 23 整数
分格納変数： 0 ～ 59 整数
秒格納変数： 0 ～ 59 整数

CLT

なし

起動からの経過時間カウンタをリセット（0を設定）します。
TICK 関数使う前に経過時間カウントをリセットすることで0からのカウントを行うことが出来ます。

SETDATE 年,月,日,時,分,秒

指定した時刻を内蔵RTCに設定します。

WAIT 時間(ミリ秒)

引数で指定した 時間 (ミリ秒単位)、時間待ち(ウェイト)を行います。
最大で32767ミリ秒（32.8秒）の時間待ちが可能です。
長い時間待ちを行う必要がある場合は、TICK 関数や GETTIME コマンドを使った方法を検討してください。

ANA (ピン番号)

取得した値： 0～4095(12ビット)

指定ピンのアナログ入力値を読み取り、その値を返します。
アナログ入力を行う場合は事前に GPIO コマンドによる機能設定（アナログ入力）が必要です。

GPIO ピン番号, モード

ボード上の指定したピン番号の入出力機能の設定を行います。
Arduino の pinMode 関数に相当します。
ピン番号の指定には、0 ～ 34の数値または、定数 PA0 ～ PC15 が可能です。
また、GPIO は省略可能です。下記の2行は等価です。

各モードの機能に対応しているピン番号は次の表の通りです。

PWMの同一グループ内ではPWMの周波数は共有となります。

ピン番号にサポートしていないモードを指定した場合、
エラー( Cannot use GPIO fuintion )となります。

起動直後では各ピンの設定は、デジタル入力（ INPUT_FL ）、
またはアナログ入力（ ANALOG ）となります。
ただし、これは動作を保障するものではありません。
GPIO コマンドによる機能設定を行って下さい。

I2CCLK バス速度

I2Cバスのクロック速度を設定します。
デフォルト値は、400(400kHz)です。

I2CR (I2Cアドレス, コマンド, コマンド長, 受信データ, データ長)

I2Cスレーブデバイスからデータを受信します。

通信対象のI2Cデバイス(スレーブ)のアドレスを引数デバイスアドレスに指定します。
受信において、コマンド等の制御データの送信が必要な場合は、
コマンド、コマンド長にてそのデータを指定します。
受信のみを行う場合は、コマンド、コマンド長に0を設定します。

コマンド、受信データは仮想アドレスにて指定します。
仮想アドレスの指定には次の定数を利用することで有用な領域への書込み・参照が簡単に行えます。

仮想アドレスの詳細については、「メモリーマップ」の「仮想アドレス」を参照下さい。

I2C通信には次の接続ピンを利用します。
PB6：SCL（I2Cクロック）
PB7：SDA（I2Cデータ）

0：正常終了
1：通信バッファに対してデータが長すぎる
2：アドレス送信にNACKが返された
3：データ送信にNACKが返された
4：その他のエラー

I2CW (I2Cアドレス, コマンド, コマンド長, 送信データ, データ長)

I2Cスレーブデバイスにデータを送信します。
（注意）I2Cバスは必ずプルアップ抵抗によるプルアップを行って下さい。
プルアップされていない状態で I2CW 関数を実行するとハングアップします。

I2Cアドレスにて送信先のI2Cスレーブアドレスを指定します。
コマンド、送信データはデータを格納した仮想アドレスを指定します。

コマンドと送信データの区別はありません。
デバイスに対して、単純にコマンド、データの順に送信しています。

仮想アドレスの指定には次の定数の利用が便利です。