menu module =========== The menu module uses the LCD display and five way switch to provide a method to configure and run MicroPython programs on the TurtlePlotBot without the use of another device such as a computer, phone or tablet. When run from the main.py file it will automatically run each time the TurtlePlotBot is powered on or reset. Main Menu ^^^^^^^^^ .. figure:: images/main_menu-1-1.jpg :align: center :scale: 200 % Connect to AP ^^^^^^^^^^^^^ .. figure:: images/main_menu-1-1.jpg :align: center :scale: 200 % Use the the up and down buttons to highlight the "Connect to AP" option and press the Center button to select. .. figure:: images/main_menu-1-2.jpg :align: center :scale: 200 % The TurtlePlotBot will scan for Wifi Access Points and show a list of all the available Access Points found. .. figure:: images/main_menu-1-3.jpg :align: center :scale: 200 % Use the the up and down buttons to highlight the Access Point you want to connect to and press the Center button to select. .. figure:: images/main_menu-1-4.jpg :align: center :scale: 200 % If you have connected to the Access Point before the password will already be filled in, otherwise it will be blank and you will have to enter the password using the joystick, buttons and on-screen keyboard. ====== ========================================== Button Action ====== ========================================== UP Moves the keyboard cursor up DOWN Moves the keyboard cursor down LEFT Moves the keyboard cursor left RIGHT Moves the keyboard cursor right CENTER Selects the current letter from keyboard UPPER Switches between keyboards LOWER Moves to next field if any ====== ========================================== ====== ========================================== Button Long Press Action ====== ========================================== LOWER Continue ====== ========================================== .. figure:: images/main_menu-1-5.jpg :align: center :scale: 200 % Use the LEFT and RIGHT buttons to highlight "Accept" or "Cancel" then press the CENTER button continue or cancel. .. figure:: images/main_menu-1-6.jpg :align: center :scale: 200 % The TurtlePlotBot will attempt to connect to the selected Access Point for up to 30 seconds. .. figure:: images/main_menu-1-7.jpg :align: center :scale: 200 % If successful the IP address assigned to the TurtlePlotBot will be displayed and the password will be saved and recalled the next time you connect to the AP. If the connection fails a "Connection Failed" screen will appear. Press any button to return to the Main Menu. Disconnect AP ^^^^^^^^^^^^^ Use the the up and down buttons to highlight the "Disconnect AP" option and press the Center button to select. .. figure:: images/main_menu-2-1.jpg :align: center :scale: 200 % The TurtlePlotBot will be disconnected from the Access Point. .. figure:: images/main_menu-2-2.jpg :align: center :scale: 200 % Press the Center Button to return to the Main Menu. .. figure:: images/main_menu-3-1.jpg :align: center :scale: 200 % Enable AP ^^^^^^^^^ The ESP32 in the TurtlePlotBot has the capability to create a Wifi access point that allows WiFi clients to connect directly to it without using a router. Use the the up and down buttons to highlight the "Enable AP" option and press the Center button to select. .. figure:: images/main_menu-3-2.jpg :align: center :scale: 200 % Enter the name and password to use for the new Access Point using the joystick, buttons and on-screen keyboard. ====== ========================================== Button Action ====== ========================================== UP Moves the keyboard cursor up DOWN Moves the keyboard cursor down LEFT Moves the keyboard cursor left RIGHT Moves the keyboard cursor right CENTER Selects the current letter from keyboard UPPER Switches between keyboards LOWER Moves to next field if any ====== ========================================== ====== ========================================== Button Long Press Action ====== ========================================== LOWER Continue ====== ========================================== .. figure:: images/main_menu-3-3.jpg :align: center :scale: 200 % Use the LEFT and RIGHT buttons to highlight "Accept" or "Cancel" then press the CENTER button continue or cancel. The AP Name and password you entered will be saved for the next time. .. figure:: images/main_menu-3-4.jpg :align: center :scale: 200 % | Disable AP ^^^^^^^^^^ Use the the up and down buttons to highlight the "Disable AP" option and press the Center button to select. .. figure:: images/main_menu-4-1.jpg :align: center :scale: 200 % .. figure:: images/main_menu-4-2.jpg :align: center :scale: 200 % | Run Program ^^^^^^^^^^^ The "Run Program" option shows a list of MicroPython programs in the /programs directory and allows you to select one to run. .. figure:: images/main_menu-5-1.jpg :align: center :scale: 200 % Use the UP and DOWN buttons to highlight a program, then press the CENTER button to run the selected program. .. figure:: images/main_menu-5-2.jpg :align: center :scale: 200 % Quit ^^^^ The "Quit" option will exit the menu program and return to the MicroPython REPL. .. figure:: images/main_menu-6-1.jpg :align: center :scale: 200 % .. figure:: images/main_menu-6-2.jpg :align: center :scale: 200 %