Online Minnow Server IoT Bridge Demo. See detailed instructions below the two embedded frames.
This is the online Minnow Server IoT Bridge demo which shows how to access an embedded web server behind a firewall. There are currently too many users using the online 'repl.it' C compiler. However, you may download the C code as explained in the section "Clone the repl.it setup" below. The instructions below configure the C code for IoT bridge mode.
Compile and run the code as explained below. The IoT bridge mode should kick in three seconds after starting the compiled code, and you should see the simulated device appearing as a link in the pane below. Click your device link and login with the credentials root/password. See the DZone article below for details on how to use the example application.
The service 'repl.it' enables online compiling of the Minnow Server and example code. The example code is configured for IoT bridge mode. Click the 'repl.it' start button above and wait for the Minnow Server C code to compile and start. Note: this may take several seconds. You should eventually see the Minnow Server example start and print information in the top right pane (the console). The IoT bridge mode should kick in after another three seconds, and you should see the simulated device appearing as a link in the bottom pane above. Find the device by the repl.it number and click the link in the bottom pane. Login with the credentials root/password. See the DZone article below for details on how to use the example application.
We are using the Minnow Server as the embedded web server in this demo, however, any WebSocket enabled server, such as the Barracuda App Server, can be used. The main focus of this demo is the actual web application and how a Single Page Application can be reused "as is" for IoT bridge mode. The IoT bridge mode enables a remote user to access a private web server without having to use a VPN solution.
You may clone the repl.it Minnow Server IoT bridge mode setup by copying and pasting the following into a shell window:
git clone https://github.com/RealTimeLogic/MinnowServer.git git clone https://github.com/RealTimeLogic/JSON.git git clone https://github.com/RealTimeLogic/SMQ.git cd MinnowServer/example/make make packwww minnow IOT=true ./minnow
Note: the above commands require git, zip, curl, gcc, and make -- e.g. sudo apt install git zip curl gcc make
The commands are intended for Linux, but the commands also work on Windows 10 if you install the Linux sub system. If you are using Windows, open Microsoft Store and search for "debian". Install the Debian Windows Subsystem for Linux and open a bash shell. You may also use Cygwin.
The above commands download the Minnow Server, JSON, and SMQ libraries, compile the code for IoT bridge mode setup, and run the Mako Server executable. The local Minnow Server executable connects to the IoT bridge after three seconds. You may navigate to the Minnow Server's local IP address or you may control the server via the IoT bridge. Note that the IoT bridge https://minnow.ml is setup for demo purposes only. See the Minnow Server GitHub page for details.
The following video shows how to compile the Minnow Server for a microcontroller and how to connect the microcontroller to the IoT bridge.