added Confirm example

and exit option with confirmation and menu lock

Author: neu-rah

examples/Confirm/.gitignore

@@ -0,0 +1,4 @@
+.pioenvs
+.piolibdeps
+.clang_complete
+.gcc-flags.json

examples/Confirm/.travis.yml

@@ -0,0 +1,65 @@
+# Continuous Integration (CI) is the practice, in software
+# engineering, of merging all developer working copies with a shared mainline
+# several times a day < http://docs.platformio.org/page/ci/index.html >
+#
+# Documentation:
+#
+# * Travis CI Embedded Builds with PlatformIO
+#   < https://docs.travis-ci.com/user/integration/platformio/ >
+#
+# * PlatformIO integration with Travis CI
+#   < http://docs.platformio.org/page/ci/travis.html >
+#
+# * User Guide for `platformio ci` command
+#   < http://docs.platformio.org/page/userguide/cmd_ci.html >
+#
+#
+# Please choice one of the following templates (proposed below) and uncomment
+# it (remove "# " before each line) or use own configuration according to the
+# Travis CI documentation (see above).
+#
+
+
+#
+# Template #1: General project. Test it using existing `platformio.ini`.
+#
+
+# language: python
+# python:
+#     - "2.7"
+#
+# sudo: false
+# cache:
+#     directories:
+#         - "~/.platformio"
+#
+# install:
+#     - pip install -U platformio
+#
+# script:
+#     - platformio run
+
+
+#
+# Template #2: The project is intended to by used as a library with examples
+#
+
+# language: python
+# python:
+#     - "2.7"
+#
+# sudo: false
+# cache:
+#     directories:
+#         - "~/.platformio"
+#
+# env:
+#     - PLATFORMIO_CI_SRC=path/to/test/file.c
+#     - PLATFORMIO_CI_SRC=examples/file.ino
+#     - PLATFORMIO_CI_SRC=path/to/test/directory
+#
+# install:
+#     - pip install -U platformio
+#
+# script:
+#     - platformio ci --lib="." --board=ID_1 --board=ID_2 --board=ID_N

examples/Confirm/Confirm/Confirm.ino

@@ -0,0 +1,71 @@
+/*
+
+Custom sub-menu prompt used as exit confirmation
+the Exit option on this example presents only the "Exit" text
+but the submenu really as an "Exit?" text for confirmation
+choosing "yes" will suspend the menu and possibly do other stuff
+while "no" will just return to previous menu
+
+*/
+
+#include <menu.h>
+#include <menuIO/serialOut.h>
+
+using namespace Menu;
+
+//customizing a menu prompt look
+class confirmExit:public menu {
+public:
+  confirmExit(const menuNodeShadow& shadow):menu(shadow) {}
+  idx_t printTo(navRoot &root,bool sel,menuOut& out, idx_t idx,idx_t len) override {
+    return out.printRaw("Exit",len);
+  }
+};
+
+// this function is defined below because we need to refer
+// to the navigation system (suspending the menu)
+result systemExit();
+
+//using the customized menu class
+//note that first parameter is the class name
+altMENU(confirmExit,subMenu,"Exit?",doNothing,anyEvent,noStyle
+  ,OP("Yes",systemExit,enterEvent)
+  ,EXIT("Cancel")
+);
+
+MENU(mainMenu,"Main menu",doNothing,noEvent,wrapStyle
+  ,OP("Op1",doNothing,noEvent)
+  ,SUBMENU(subMenu)
+);
+
+#define MAX_DEPTH 2
+
+MENU_OUTPUTS(out,MAX_DEPTH
+  ,SERIAL_OUT(Serial)
+  ,NONE//must have 2 items at least
+);
+
+NAVROOT(nav,mainMenu,MAX_DEPTH,Serial,out);
+
+bool running=true;//lock menu if false
+
+result systemExit() {
+  Serial.println();
+  Serial.println("Terminating...");
+  //do some termiination stuff here
+  running=false;//prevents the menu from running again!
+  Serial.println("done.");
+  nav.idleOn();//suspend the menu system
+  return quit;
+}
+
+void setup() {
+  Serial.begin(9600);
+  while(!Serial);
+  Serial.println("menu 3.x custom sub-menu prompt example");Serial.flush();
+}
+
+void loop() {
+  if (running) nav.poll();
+  delay(100);//simulate a delay when other tasks are done
+}

examples/Serial/ansiSerial/lib/readme.txt renamed to examples/Confirm/lib/readme.txt

@@ -33,4 +33,4 @@ PlatformIO will find your libraries automatically, configure preprocessor's
 include paths and build them.
 
 More information about PlatformIO Library Dependency Finder
-- http://docs.platformio.org/en/stable/librarymanager/ldf.html
+- http://docs.platformio.org/page/librarymanager/ldf.html

examples/Confirm/platformio.ini

@@ -0,0 +1,18 @@
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; Please visit documentation for the other options and examples
+; http://docs.platformio.org/page/projectconf.html
+
+[env:nanoatmega328]
+platform=atmelavr
+board=nanoatmega328
+framework=arduino
+
+[platformio]
+src_dir=Confirm
+lib_dir=~/Arduino/Libraries

examples/Serial/serialio/lib/readme.txt

@@ -9,34 +9,34 @@
 lib_dir =~/Arduino/libraries
 #,/usr/include/c++/5.4.0
 
-;[env:nanoatmega328]
-;platform = atmelavr
-;board = nanoatmega328
-;framework = arduino
+[env:nanoatmega328]
+platform = atmelavr
+board = nanoatmega328
+framework = arduino
 
 ;[env:teensy31]
 ;platform = teensy
 ;board = teensy31
 ;framework = arduino
 
-[env:nanoatmega328]
-platform=atmelavr
-board=nanoatmega328
-framework=arduino
-; build_flags = -Wno-comment -Wno-strict-aliasing -Wno-builtin-macro-redefined -Wno-strict-aliasing -DDEBUG
-
-[env:due]
-platform = atmelsam
-board = due
-framework = arduino
-; build_flags = -Wno-comment -Wno-reorder -Wno-strict-aliasing -Wno-builtin-macro-redefined -Wno-strict-aliasing
-
-[env:esp12e]
-platform = espressif8266
-board = esp12e
-framework = arduino
-
-[env:uno]
-platform = atmelavr
-board = uno
-framework = arduino
+; [env:nanoatmega328]
+; platform=atmelavr
+; board=nanoatmega328
+; framework=arduino
+; ; build_flags = -Wno-comment -Wno-strict-aliasing -Wno-builtin-macro-redefined -Wno-strict-aliasing -DDEBUG
+;
+; [env:due]
+; platform = atmelsam
+; board = due
+; framework = arduino
+; ; build_flags = -Wno-comment -Wno-reorder -Wno-strict-aliasing -Wno-builtin-macro-redefined -Wno-strict-aliasing
+;
+; [env:esp12e]
+; platform = espressif8266
+; board = esp12e
+; framework = arduino
+;
+; [env:uno]
+; platform = atmelavr
+; board = uno
+; framework = arduino