Serial Service Menu

Tactile Switch, Top Actuated

putty - for Windows and Linux

Arduino MKR WiFi 1010

Serial USB Terminal - for Android Phones

Arduino Web Editor

<h3 >Motivation</h3>When I handover Arduino IoT projects to friends I realize that I need to address the following requirements: <ul ><li >Various network credentials must be changeable by others without an IDE. Here some examples: SSID/Key for WiFi, APN/Pin/UN/PW for GSM, APP_EUI/KEY for LoRa-WAN, etc.)</li></ul><ul ><li >A Hostname byside the THING_ID would be useful.</li></ul><ul ><li >The Serial-Line is slow by design and therefore I avoid printing out unnecessary information's. But in kind of troubles it must be possible to activate serial debugging. And of course, without restarting the Arduino - to avoid that the reboot temporary fix a problem...</li></ul><ul ><li >Get some general status information's out of the Arduino. </li></ul><h3 >Requirements</h3>I use various Arduino MKRs (WiFi, LoRa, GSM) because of their IoT functions. The following solutions are possible for all the MKR variants... StorageThe <a href="https://content.arduino.cc/assets/mkr-microchip_samd21_family_full_datasheet-ds40001882d.pdf">SAMD21G18 Microcontroller</a> has an on-board flash with 256KB capacity. This is more than enough to store everything for my projects. No extra hardware is needed. <blockquote >There is one important fact to know: The flash will be completely erased when you upload a new Sketch. So, the settings get lost in this case. Not a showstopper for my projects. But maybe for yours!!! </blockquote>The <a href="https://content.arduino.cc/assets/mkr-microchip_atecc508a_cryptoauthentication_device_summary_datasheet-20005927a.pdf">ATECC508 Chip</a> was also a possible storage place. But because only three Slots with 72 Bytes are free - it is not a good choice for me. User InterfaceTo keep it simple I selected the USB Port to interact with the user. This port is available on all Arduino's and serial terminal client programs (putty) are free available on nearly all computers and mobile devices. To protect from unauthorized access, the serial line must be secured with a password! Recover from lost passwordIf the password will be forgotten, a button to reset the flash to factory defaults is required.<h3 >The Solution</h3>I have called it Serial Service Menu - view the video to see how it behaves...<div class="se-component se-video-container __se__float-none" contenteditable="false" style="width: 100%;"><figure style="width: 100%; height: 56.25%; padding-bottom: 56.25%; margin: 0px;"><iframe frameborder="0" allowfullscreen="" src="https://www.youtube.com/embed/FHtuD-bYGQo" data-proportion="true" data-percentage="100%,56.25%" data-size="100%,56.25%" data-align="none" style="width: 100%; height: 100%;" data-index="0" data-file-size="0" data-origin="100%,56.25%"></iframe><figcaption contenteditable="true"><div>take a look...</div></figcaption></figure></div>The communication is done by using Arduino's Micro-B USB Port yes, the same you use for uploading your sketch. In fact, a virtual RS232 serial communication channel was used. If you like to connect your mobile device, you need an OTG (On the Go) Ready Smartphone and an OTG adapter cable. It is the short cable directly connect to my phone. This Cable signals the phone that it should behave as a USB host and not like a USB Client which it normally does. As Host you can connect USB Devices like a USB Stick into your phone or get use of virtual USB COM Ports as we need here. <figure><img src=https://projects.arduinocontent.cc/2b821be9-5b24-449f-9d29-4af809fe0d66.jpg /><figcaption>The Serial Service Menu used with my Smartphone</figcaption></figure>The Arduino acts as Terminal Server and on the other side the PC/MAC/Mobile-Phone needs to run a Terminal Client program. This client used the virtual COM Port which appears when you connect the Arduino to your PC. <figure><img src=https://projects.arduinocontent.cc/31d73a07-3c84-4d2f-ae7c-664e73caa793.png /><figcaption>The virtual COM Port on my Windows 10 PC</figcaption></figure>I recommend using putty as terminal client for PCs and Linux systems. For Android Phones I recommend the Serial USB Terminal App from Kai Morich. It's in the Play-Store. Because I am not an Apple user I cannot recommend terminal client apps for MACs or iPhones - sorry. But there are good programs available for the Apple world too!Beside the Arduino MKR you only need a push button for the factory reset function. This is necessary when the user losts his password! The factory reset button was only checked once during the Arduino startup (void setup()) so you can also reuse an already existing button from your project!<h3 >The Sketch</h3>See the section CODE below for the complete Arduino sketch. I have documented a lot inside the code. But let me explain some details right away:1. I have connected and used one SHT35 Temperature and Humidity Sensor to demonstrate a possible task/job for the MKR. This has nothing to do with the Serial Service Menu, it is just an example. 2. The SHT35 values are presented by the Arduino IoT Dashboard, again just for demonstration purposes. 3. There is also a dashboard button to reset the Arduino from remote. Maybe this is also interesting for you... <figure><img src=https://projects.arduinocontent.cc/c9eca320-6bb6-4d75-ac2e-f9284cfca522.png /><figcaption>Arduino IoT Dashboard</figcaption></figure>When you push the "RestartCpu" button you can reboot your Arduino MKR from remote. You can watch the restart by entering the debug mode on the Serial Service Menu...<div class="se-component se-video-container __se__float-none" contenteditable="false" style="width: 100%;"><figure style="width: 100%; height: 56.25%; padding-bottom: 56.25%; margin: 0px;"><iframe frameborder="0" allowfullscreen="" src="https://www.youtube.com/embed/WzM3w_v0xng" data-proportion="true" data-percentage="100%,56.25%" data-size="100%,56.25%" data-align="none" style="width: 100%; height: 100%;" data-index="0" data-file-size="0" data-origin="100%,56.25%"></iframe><figcaption contenteditable="true"><div>restart from dashboard</div></figcaption></figure></div>I also wrote three flowcharts for the three main code parts in the sketch. You will find them below. Use them together with the notes inside the sketch to get familiar...

Serial Service Menu

Show status information, change NW credentials, ping your gateway, show sensor values or get more details by activating debugging…