Change gg_init to gg_start. added GG_printf.ino.

Author: mkogax

README.md

@@ -30,24 +30,17 @@ After creating the function of the original command, register it as shown in the
 
 ## Functions
 
-|GG_for_Arduino.h|function|
-|--|---|
-|int gg_init(void)|Initialization of GG for Arduino|
-|int gg_tp1_no|Arduino output pin number for TP1. Set before gg_init() if necessary|
-|int gg_tp2_no|Arduino output pin number for TP2. Set before gg_init() if necessary|
-|long gg_con_baud|baud rate. Set before gg_init() if necessary|
-
-|gg_base.h|function|
+|Functions / Variables|Specification|
 |--|---|
+|***GG_for_Arduino.h***||
+|int gg_start(const char \*title)|Start processing GG for Arduino|
+|int gg_tp1_no|Arduino output pin number for TP1. Set before gg_start() if necessary|
+|int gg_tp2_no|Arduino output pin number for TP2. Set before gg_start() if necessary|
+|long gg_con_baud|baud rate. Set before gg_start() if necessary|
+|***gg_base.h***||
 |GG_TP_ON(number)|Turn on the TP status number|
 |GG_TP_OFF(number)|Turn off the TP status number|
-
-|gg_uty.h|function|
-|--|---|
-|int gg_init(void)|Initialization of GG for Arduino|
-|int gg_tp1_no|Arduino output pin number for TP1. Set before gg_init() if necessary|
-|int gg_tp2_no|Arduino output pin number for TP2. Set before gg_init() if necessary|
-|long gg_con_baud|baud rate. Set before gg_init() if necessary|
+|***gg_uty.h***||
 |GG_TP_ON(number)|Turn on the TP status number|
 |GG_TP_OFF(number)|Turn off the TP status number|
 |int gg_GetC(void)|1 character input (-1 = no input)|
@@ -70,28 +63,24 @@ After creating the function of the original command, register it as shown in the
 |int gg_tim_checkdt(GGT_TIME \*t)|Date and time validity check|
 |int gg_tim_repairdt(GGT_TIME \*t)|Date and time correction|
 |int gg_tim_tt2week(gg_time_t x)|Determine what day of the week from gg_time_t(0=sun,..)|
-
-|gg_printf.h|function|
-|--|---|
-|int gg_vxprintf(int (*putc)(int), const char *fmt, va_list vlst)|vprintf() with putc()|
-|int gg_xprintf(int (*putc)(int), const char *fmt, ...)|printf() with putc()|
-|int gg_printf(const char *fmt, ...)|printf() with standard output|
-|int gg_vsprintf(char *buf, const char *fmt, va_list vlst)|vsprintf() to buf[]|
-|int gg_sprintf(char *buf, const char *fmt, ...)|sprintf() to buf[]|
+|***gg_printf.h***||
+|int gg_vxprintf(int (\*putc)(int), const char \*fmt, va_list vlst)|vprintf() with putc()|
+|int gg_xprintf(int (\*putc)(int), const char \*fmt, ...)|printf() with putc()|
+|int gg_printf(const char \*fmt, ...)|printf() with standard output|
+|int gg_vsprintf(char \*buf, const char \*fmt, va_list vlst)|vsprintf() to buf[]|
+|int gg_sprintf(char \*buf, const char \*fmt, ...)|sprintf() to buf[]|
 |gg_printDATE(gg_time_t)|"YY/MM/DD"|
 |gg_printTIME(gg_time_t)|"hh:mm:ss"|
 |gg_printDT(gg_time_t)|"YY/MM/DD hh:mm:ss"|
 |gg_printDTs(gg_time_t)|"YY/MM/DD hh:mm:ss "|
-
-|gg_console.h|function|
-|--|---|
+|***gg_console.h***||
 |GG_CON_CMDADD(func, cmd, prm, help)|Registering console commands|
 |GG_CON_CMDMRK(title)|Display delimiter of list in help|
 |GG_CON|Work area for console (internal use)|
 |int gg_con_MonInit(void)|Console initialization|
+|char \*gg_con_prompt|Prompt string|
 |int gg_con_MonRePrompt(void)|Redisplay prompt|
 |int gg_con_MonPrompt(void)|Prompt display (used internally)|
-|int gg_con_MonStart(void)|Console start (title)|
 |int gg_con_Check(void)|Console check with gg_GetC()|
 |int gg_con_MonCheck(int c)|Console check with 1 character|
 |int gg_con_MonExec(char \*buf)|Command line processing (Note: buf is destroyed by arg analysis)|

examples/GG_console/GG_console.ino

@@ -7,7 +7,7 @@
 */
 
 void setup() {
-  gg_init();    // initialization
+  gg_start("** GG **\n>");    // Start processing GG for Arduino
 }
 
 void loop() {

examples/GG_console_cmd/GG_console_cmd.ino

@@ -36,7 +36,7 @@
 */
 
 void setup() {
-  gg_init();    // initialization
+  gg_start("** GG **\n>");    // Start processing GG for Arduino
 
   // Register with console command (you can add more and more in this way)
   GG_CON_CMDMRK("-- Example of original command registration --");     // Delimited line (displayed in the command list)

examples/GG_printf/GG_printf.ino

@@ -0,0 +1,21 @@
+#include <GG_for_Arduino.h>
+
+/*
+  GG for Arduino ** Printf() demo
+  Arduino standard serial (115200bps / 8bit length / non-parity)
+  No command line interface
+*/
+
+void setup() {
+  gg_start("** GG start\n");     // Start processing GG for Arduino
+  gg_printf("[setup] millis()=%8ld\n", millis());
+}
+
+void loop() {
+  static unsigned char c = 0;
+  gg_printf("[loop] millis()=%8ld\n", millis());
+  c++;
+  gg_printf("c=%3d=0x%02X=0b%08b\n", c, c, c);
+  gg_printf("delay(1000)\n");
+  delay(1000);
+}

examples/GG_tp/GG_tp.ino

@@ -18,7 +18,7 @@
 void setup() {
   gg_tp1_no = 2;  // Arduino pin number for TP1
   gg_tp2_no = 3;  // Arduino pin number for TP2
-  gg_init();      // initialization
+  gg_start("** GG **\n>");    // Start processing GG for Arduino
 }
 
 void loop() {

src/GG_for_Arduino.cpp

@@ -11,7 +11,7 @@
 int gg_DI_count;					// 割込み禁止ネスト数(0=割込み許可中)
 int gg_tp1_no = -1;					// TP1出力ピン番号(-1=なし)
 int gg_tp2_no = -1;					// TP2出力ピン番号(-1=なし)
-long gg_con_baud = 115200;			// コンソール用シリアル(Serial)のボーレート(-1=gg_init()で初期化しない)
+long gg_con_baud = 115200;			// コンソール用シリアル(Serial)のボーレート(-1=gg_start()で初期化しない)
 
 static int std_putc_sub(int c)
 {
@@ -28,7 +28,7 @@ static int std_getc()
   return Serial.read();
 }
 
-int gg_init(void)					// Arduino用GGツール初期化
+int gg_start(const char *title)		// Arduino用GGの処理開始
 {
 	// TP出力の初期化(セットされてれば出力に初期化)
 	if (gg_tp1_no>=0) pinMode(gg_tp1_no, OUTPUT);
@@ -45,7 +45,9 @@ int gg_init(void)					// Arduino用GGツール初期化
 	ggbase_init();    	// GGツール初期化
 	gg_con_MonInit();	// GGモニタ初期化	
 	gg_con_RegistCMD();	// 標準コマンド登録
-	gg_con_MonStart();	// GGモニタ開始(タイトルとプロンプト表示)
+
+	// デバッグモニタ開始(タイトル表示) 旧:gg_con_MonStart()
+	if (title) gg_PutS(title);
 
 	return 0;
 }

src/GG_for_Arduino.h

@@ -10,12 +10,12 @@
 
 #include "ggbase.h"
 
-//	gg_init()時の変更可能パラメータ(事前にデフォルト値が入っている)(Arduino専用)
+//	gg_start()時の変更可能パラメータ(事前にデフォルト値が入っている)(Arduino専用)
 extern int gg_tp1_no;				// TP1出力ピン番号(-1=なし)
 extern int gg_tp2_no;				// TP2出力ピン番号(-1=なし)
-extern long gg_con_baud;			// コンソール用シリアル(Serial)のボーレート(負数ならgg_init()で初期化しない)
+extern long gg_con_baud;			// コンソール用シリアル(Serial)のボーレート(負数ならgg_start()で初期化しない)
 
-int gg_init(void);					// Arduino用GGツール初期化
+int gg_start(const char *title);	// Arduino用GGの処理開始
 
 
 #endif	//	__GG_FOR_ARDUINO_H__

src/gg_console.c

@@ -23,10 +23,11 @@ int gg_con_MonInit(void)			// デバッグモニタ初期化
 	return 0;
 }
 
+char *gg_con_prompt = ">";			// プロンプト文字列		2022.05.24 M.Kogan
 int gg_con_MonRePrompt(void)		// プロンプト再表示
 {
 	int i;
-	gg_PutC('>');							// プロンプト
+	if (gg_con_prompt) gg_PutS(gg_con_prompt);	// プロンプト
 	for (i=0; i<GG_CON.BufP; i++) {
 		gg_PutC(GG_CON.Buf[i]);
 	}
@@ -39,13 +40,6 @@ int gg_con_MonPrompt(void)			// プロンプト表示(内部で使用)
 	return gg_con_MonRePrompt();
 }
 
-int gg_con_MonStart(void)			// デバッグモニタ開始(タイトル表示)
-{
-	gg_PutS("** GG console\n");
-	gg_con_MonPrompt();				// バッファクリアとプロンプト表示
-	return 0;
-}
-
 int gg_con_Check(void)				// デバッグモニタチェック(0=実行無か実行成功,-999=EXIT要請)(gg_GetC()から1文字受付)
 {
 	return gg_con_MonCheck(gg_GetC());		// gg_GetC()から1文字受付

src/gg_console.h

@@ -72,9 +72,9 @@ extern GGT_CON GG_CON;				// GG_CONワーク(gg_console.c)
 //
 #define GG_CON_EXIT	(-999)			// EXITコード
 int gg_con_MonInit(void);			// デバッグモニタ初期化
+extern char *gg_con_prompt;			// プロンプト文字列
 int gg_con_MonRePrompt(void);		// プロンプト再表示
 int gg_con_MonPrompt(void);			// プロンプト表示(内部で使用)
-int gg_con_MonStart(void);			// デバッグモニタ開始(タイトル表示)
 int gg_con_Check(void);				// デバッグモニタチェック(0=実行無か実行成功,-999=EXIT要請)(gg_GetC()から1文字受付)
 int gg_con_MonCheck(int c);			// デバッグモニタチェック(0=実行無か実行成功,-999=EXIT要請)(1文字受付)