From 055fcfca1719fd857467947cfa9fbe2424e82e3d Mon Sep 17 00:00:00 2001
From: RTL <24235755+Telemechanics@users.noreply.github.com>
Date: Thu, 8 May 2025 09:42:29 +0200
Subject: [PATCH 01/10] Adding new example Xedge

Draft build instructions:

Xedge on NuttX
==============

Xedge is a robust IoT and web framework that is designed for microcontrollers. It is based on the industrial-grade Barracuda Application Server, designed for seamless OEM integration. Xedge accelerates embedded firmware development by providing a flexible, Lua-based environment and a full stack of industrial-strength protocols, including:

- OPC UA
- Modbus
- MQTT
- SMQ
- WebSockets
- HTTP/HTTPS

This Xedge port for NuttX comes pre-configured and requires:

- TCP/IP v4 and v6 support
- File System support
- 2 MB RAM allocated statically in ``xedge/xedge_main.c``

.. note::
   These instructions set up Xedge in **development mode**. Xedge supports many configuration options that differ between development and production builds. For production settings and optimization, refer to the general Xedge build instructions (details below).

Getting Started
---------------

To compile Xedge for NuttX, follow these steps:

1. **Prepare the Xedge apps directory.**

   Navigate to the Xedge application folder:

   .. code-block:: bash

      cd nuttxspace/apps/examples/xedge

2. **Clone the required dependencies.**

   .. code-block:: bash

      git clone https://github.com/RealTimeLogic/BAS.git
      git clone https://github.com/RealTimeLogic/BAS-Resources.git

3. **Build the Xedge resources.**

   Move into the build directory:

   .. code-block:: bash

      cd BAS-Resources/build/

   Run the Xedge resource build script. The following command answers the script prompts automatically:

   .. code-block:: bash

      printf "n\nl\nn\n" | bash Xedge.sh

4. **Copy the generated file.**

   Copy ``XedgeZip.c`` to the Xedge example directory:

   .. code-block:: bash

      cp XedgeZip.c ../../BAS/examples/xedge/

5. **Configure NuttX for Xedge.**

   Return to the NuttX top-level directory and start the configuration tool:

   .. code-block:: bash

      make menuconfig

   In the configuration menu:

   - Enable the Xedge application:

     ``Application Configuration -> Examples -> Xedge``

   - Enable dynamic socket callback allocation:

     ``Networking Support -> Socket Support -> Enable dynamic socket callback allocation`` (set value to **1**)

   - Increase the number of dynamic TCP connections:

     ``Networking Support -> TCP/IP Networking -> Dynamic TCP/IP connections allocation`` (set value to **at least 20**)

   - Enable automatic time synchronization via SNTP:

     ``Application Configuration -> Network Utilities -> NTP Client``

   - Make sure syslog is enabled:

     ``Device Drivers  -> System Logging   -> Enable system logging``
     ``Device Drivers  -> System Logging   -> Log to /dev/console ``

6. **Build NuttX.**

   Save your changes, exit ``menuconfig``, and build:

   .. code-block:: bash

      make

Running Xedge
-------------

Once NuttX is flashed and running, bring up the network interface and start time synchronization:

.. code-block:: bash

   ifup eth0
   xedge

Further Reading
===============

To learn more about Xedge and how to work with it effectively, see the following resources:

- **Using Xedge in Developer Mode:**
  Learn how to configure and work with Xedge during development, including dynamic Lua scripting, file system layout, and runtime behavior.

  `How to use Xedge when in developer mode <https://realtimelogic.com/ba/doc/en/Xedge.html>`_

- **Building Xedge for Developer or Production Mode:**
  Understand the differences between development and production builds, and follow detailed instructions for compiling Xedge appropriately for your target environment.

  `How to compile Xedge for developer or production mode <https://realtimelogic.com/ba/examples/xedge/readme.html>`_
---
 examples/xedge/Kconfig      |  29 ++++++
 examples/xedge/Make.defs    |  24 +++++
 examples/xedge/Makefile     |  35 ++++++++
 examples/xedge/xedge_main.c | 173 ++++++++++++++++++++++++++++++++++++
 4 files changed, 261 insertions(+)
 create mode 100644 examples/xedge/Kconfig
 create mode 100644 examples/xedge/Make.defs
 create mode 100644 examples/xedge/Makefile
 create mode 100644 examples/xedge/xedge_main.c

diff --git a/examples/xedge/Kconfig b/examples/xedge/Kconfig
new file mode 100644
index 00000000000..ece0f482371
--- /dev/null
+++ b/examples/xedge/Kconfig
@@ -0,0 +1,29 @@
+#
+# For a description of the syntax of this configuration file,
+# see the file kconfig-language.txt in the NuttX tools repository.
+#
+
+config EXAMPLES_XEDGE
+	tristate "Xedge IoT Toolkit"
+	default n
+	---help---
+		Enable Xedge
+
+if EXAMPLES_XEDGE
+
+config EXAMPLES_XEDGE_PROGNAME
+	string "Program name"
+	default "xedge"
+	---help---
+		This is the name of the program that will be used when the NSH ELF
+		program is installed.
+
+config EXAMPLES_XEDGE_PRIORITY
+	int "Xedge task priority"
+	default 100
+
+config EXAMPLES_XEDGE_STACKSIZE
+	int "Xedge stack size"
+	default 20000
+
+endif
diff --git a/examples/xedge/Make.defs b/examples/xedge/Make.defs
new file mode 100644
index 00000000000..cc246251349
--- /dev/null
+++ b/examples/xedge/Make.defs
@@ -0,0 +1,24 @@
+############################################################################
+# apps/examples/xedge/Make.defs
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+############################################################################
+
+ifneq ($(CONFIG_EXAMPLES_XEDGE),)
+CONFIGURED_APPS += $(APPDIR)/examples/xedge
+CFLAGS += ${INCDIR_PREFIX}$(APPDIR)/examples/xedge/BAS/inc ${INCDIR_PREFIX}$(APPDIR)/examples/xedge/BAS/inc/arch/Posix ${INCDIR_PREFIX}$(APPDIR)/examples/xedge/BAS/inc/arch/NET/Posix -DNO_INIT_DISK_IO -DUSE_DBGMON=1 -DUSE_IPV6
+endif
diff --git a/examples/xedge/Makefile b/examples/xedge/Makefile
new file mode 100644
index 00000000000..4002c909438
--- /dev/null
+++ b/examples/xedge/Makefile
@@ -0,0 +1,35 @@
+############################################################################
+# apps/examples/xedge/Make.defs
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+############################################################################
+
+include $(APPDIR)/Make.defs
+
+# Xedge, World! built-in application info
+
+PROGNAME  = $(CONFIG_EXAMPLES_XEDGE_PROGNAME)
+PRIORITY  = $(CONFIG_EXAMPLES_XEDGE_PRIORITY)
+STACKSIZE = $(CONFIG_EXAMPLES_XEDGE_STACKSIZE)
+MODULE    = $(CONFIG_EXAMPLES_XEDGE)
+
+# Xedge: BAS Example
+
+MAINSRC = xedge_main.c BAS/src/BAS.c BAS/src/dlmalloc.c BAS/src/arch/Posix/ThreadLib.c BAS/src/arch/NET/generic/SoDisp.c BAS/src/DiskIo/posix/BaFile.c BAS/examples/xedge/src/xedge.c BAS/examples/xedge/ BAS/examples/xedge/XedgeZip.c
+
+
+include $(APPDIR)/Application.mk
diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
new file mode 100644
index 00000000000..db532947600
--- /dev/null
+++ b/examples/xedge/xedge_main.c
@@ -0,0 +1,173 @@
+/*
+  Xedge Startup Code
+
+  Xedge, including this startup code, requires the Barracuda App
+  Server library and is licensed using the three license options as
+  explained here: https://github.com/RealTimeLogic/BAS#license
+
+*/
+#include <nuttx/config.h>
+#include <stdio.h>
+#include <syslog.h>
+#include <netutils/ntpclient.h>
+#include <HttpTrace.h>
+#include <BaDiskIo.h>
+#include <BaServerLib.h>
+#include "BAS/examples/xedge/src/xedge.h"
+
+extern void barracuda();  /* BAS/examples/xedge/src/xedge.c */
+extern void init_dlmalloc(char* heapstart, char* heapend); /* dlmalloc.c */
+extern int (*platformInitDiskIo)(DiskIo*); /* xedge.c */
+
+/* The LThreadMgr configured in xedge.c */
+extern LThreadMgr ltMgr;
+
+/* BAS is configured to use dlmalloc for NuttX. This is the pool.
+*/
+static char poolBuf[2*1024*1024]; /* 2M : recommended minimum */
+
+
+/* The following two functions are copied from the example:
+   https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
+   Details:
+   https://realtimelogic.com/ba/examples/xedge/readme.html#time
+ */
+
+/* This callback is called by one of the threads managed by LThreadMgr
+ * when a job is taken off the queue and executed. The callback
+ * attempts to find the global Lua function '_XedgeEvent', and if the
+ * function is found, it will be executed as follows: _XedgeEvent("sntp")
+ */
+static void executeXedgeEvent(ThreadJob* job, int msgh, LThreadMgr* mgr)
+{
+   lua_State* L = job->Lt;
+   lua_pushglobaltable(L); /* _G */
+   lua_getfield(L, -1, "_XedgeEvent");
+   if(lua_isfunction(L, -1))  /* Do we have _G._XedgeEvent */
+   {
+      /* Call _XedgeEvent("sntp") */
+      lua_pushstring(L,"sntp"); /* Arg */
+      lua_pcall(L, 1, 0, msgh); /* one arg, no return value */
+   }
+}
+
+
+/* Thread started by xedgeOpenAUX() */
+static void*
+checkTimeThread(void *arg)
+{
+   ThreadMutex* soDispMutex = HttpServer_getMutex(ltMgr.server);
+   (void)arg;
+   /* Use the compile time macros for date and time and convert the
+    * date/time to a value that can be used by function baParseDate
+    */
+   const char* d = __DATE__;
+   char buf[50];
+   if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
+                    d[4],d[5], d[0],d[1],d[2], d + 7, __TIME__) < 0))
+   {
+      BaTime compileT = baParseDate(buf);
+      if(compileT) /* If OK: Seconds since 1970 */
+      {
+         compileT -= 24*60*60; /* Give it one day for time zone adj. */
+         /* Wait for time to be updated by NTP */
+         while(baGetUnixTime() < compileT)
+            Thread_sleep(500);
+         /* Initiate executing the Lua func _XedgeEvent("sntp") */
+         ThreadJob* job=ThreadJob_lcreate(sizeof(ThreadJob), executeXedgeEvent);
+         ThreadMutex_set(soDispMutex);
+         LThreadMgr_run(&ltMgr, job);
+         ThreadMutex_release(soDispMutex);
+      }
+   }
+   /* Exit thread */
+   return NULL;
+}
+
+/* xedge.c calls this to initialize the IO.
+   Change "/mnt/lfs" to your preference.
+ */
+int xedgeInitDiskIo(DiskIo* io)
+{
+   if(DiskIo_setRootDir(io,"/mnt/lfs"))
+   {
+      syslog(LOG_ERR,"Error: cannot set root to /mnt/lfs\n");
+      return -1;
+   }
+   return 0;
+}
+
+
+/*
+  xedge.c calls this; include your Lua bindings here.
+  Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
+*/
+int xedgeOpenAUX(XedgeOpenAUX* aux)
+{
+   (void)aux;
+
+   /* Start thread waiting for time to be set */
+   pthread_t thread;
+   pthread_attr_t attr;
+   struct sched_param param;
+   pthread_attr_init(&attr);
+   pthread_attr_setstacksize(&attr, 4096);
+   param.sched_priority = SCHED_PRIORITY_DEFAULT;
+   pthread_attr_setschedparam(&attr, &param);
+   pthread_create(&thread, &attr, checkTimeThread, NULL);
+
+   return 0; /* OK */
+}
+
+
+static void
+myErrHandler(BaFatalErrorCodes ecode1,
+             unsigned int ecode2,
+             const char* file,
+             int line)
+{
+   syslog(LOG_ERR,"Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
+   exit(1);
+}
+
+
+/* Redirect server's HttpTrace to syslog.
+   https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
+ */
+static void
+flushTrace(char* buf, int bufLen)
+{
+   buf[bufLen]=0; /* Zero terminate. Bufsize is at least bufLen+1. */
+   syslog(LOG_INFO,"%s",buf);
+}
+
+static BaBool isRunning; /* Flag used for running state */
+
+/* CTRL-C handler makes Xedge perform a graceful shutdown.
+ */
+static void
+sigHandler(int signo)
+{
+   if(isRunning)
+   {
+      isRunning=FALSE;
+      printf("\nGot SIGTERM; exiting...\n");
+      setDispExit(); /* Graceful shutdown : xedge.c */
+      Thread_sleep(2000);
+   }
+}
+
+
+int main(int argc, FAR char *argv[])
+{
+   signal(SIGINT, sigHandler);
+   signal(SIGTERM, sigHandler);
+   ntpc_start(); /* Make sure it runs; time is reqired when using TLS */
+   init_dlmalloc(poolBuf, poolBuf + sizeof(poolBuf));
+   HttpTrace_setFLushCallback(flushTrace);
+   HttpServer_setErrHnd(myErrHandler);
+   isRunning=true;
+   barracuda(); /* xedge.c; does not return unless setDispExit() is called */
+   printf("Exiting Xedge\n");
+   return 0;
+}

From 919b7f1481785635dbb456efdd00181a2001b011 Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Fri, 9 May 2025 10:53:10 +0200
Subject: [PATCH 02/10] improving comments and config file

---
 examples/xedge/Kconfig      | 27 ++++++++++++++++++----
 examples/xedge/xedge_main.c | 46 +++++++++++++++++--------------------
 2 files changed, 43 insertions(+), 30 deletions(-)

diff --git a/examples/xedge/Kconfig b/examples/xedge/Kconfig
index ece0f482371..40ad7ffb5ec 100644
--- a/examples/xedge/Kconfig
+++ b/examples/xedge/Kconfig
@@ -1,13 +1,27 @@
 #
-# For a description of the syntax of this configuration file,
-# see the file kconfig-language.txt in the NuttX tools repository.
+# Xedge IoT Toolkit - NuttX Kconfig integration
+#
+# Xedge is an embedded software toolkit designed to enable high-level developers
+# (e.g., web and Lua programmers) to create sophisticated, secure IoT and industrial
+# device applications. It abstracts low-level embedded development through a lightweight
+# runtime built on top of the Barracuda App Server and Lua, giving developers direct access
+# to HTTP(S), WebSockets, MQTT, file system, and device I/O - all from high-level Lua scripts.
+#
+# This NuttX integration allows developers to compile and run Xedge as a user application,
+# bringing powerful device control capabilities and an embedded web server to NuttX-based
+# systems.
+#
+# Use this if you want to build smart, networked embedded devices with minimal C code,
+# and maximum productivity.
 #
 
 config EXAMPLES_XEDGE
 	tristate "Xedge IoT Toolkit"
 	default n
 	---help---
-		Enable Xedge
+	  Enable Xedge support in NuttX. Xedge is a high-level toolkit that lets you
+	  develop complete IoT device applications using Lua, backed by the Barracuda App Server.
+	  This application demonstrates a complete Xedge runtime integrated into NuttX.
 
 if EXAMPLES_XEDGE
 
@@ -15,15 +29,18 @@ config EXAMPLES_XEDGE_PROGNAME
 	string "Program name"
 	default "xedge"
 	---help---
-		This is the name of the program that will be used when the NSH ELF
-		program is installed.
+	  This is the name of the ELF executable for the Xedge application in NSH.
 
 config EXAMPLES_XEDGE_PRIORITY
 	int "Xedge task priority"
 	default 100
+	---help---
+	  Set the task priority for the Xedge runtime.
 
 config EXAMPLES_XEDGE_STACKSIZE
 	int "Xedge stack size"
 	default 20000
+	---help---
+	  Set the stack size allocated to the Xedge Lua interpreter and application runtime.
 
 endif
diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
index db532947600..adb346f713f 100644
--- a/examples/xedge/xedge_main.c
+++ b/examples/xedge/xedge_main.c
@@ -1,11 +1,10 @@
-/*
-  Xedge Startup Code
-
-  Xedge, including this startup code, requires the Barracuda App
-  Server library and is licensed using the three license options as
-  explained here: https://github.com/RealTimeLogic/BAS#license
-
+/* Xedge NuttX Startup Code (may need adjustments)
+ *
+ * Xedge, including this startup code, requires the Barracuda App
+ * Server library and is licensed using the three license options as
+ * explained here: https://github.com/RealTimeLogic/BAS#license
 */
+
 #include <nuttx/config.h>
 #include <stdio.h>
 #include <syslog.h>
@@ -22,15 +21,14 @@ extern int (*platformInitDiskIo)(DiskIo*); /* xedge.c */
 /* The LThreadMgr configured in xedge.c */
 extern LThreadMgr ltMgr;
 
-/* BAS is configured to use dlmalloc for NuttX. This is the pool.
-*/
+/* BAS is configured to use dlmalloc for NuttX. This is the pool. */
 static char poolBuf[2*1024*1024]; /* 2M : recommended minimum */
 
 
 /* The following two functions are copied from the example:
-   https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
-   Details:
-   https://realtimelogic.com/ba/examples/xedge/readme.html#time
+ * https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
+ * Details:
+ * https://realtimelogic.com/ba/examples/xedge/readme.html#time
  */
 
 /* This callback is called by one of the threads managed by LThreadMgr
@@ -46,7 +44,7 @@ static void executeXedgeEvent(ThreadJob* job, int msgh, LThreadMgr* mgr)
    if(lua_isfunction(L, -1))  /* Do we have _G._XedgeEvent */
    {
       /* Call _XedgeEvent("sntp") */
-      lua_pushstring(L,"sntp"); /* Arg */
+      lua_pushstring(L, "sntp"); /* Arg */
       lua_pcall(L, 1, 0, msgh); /* one arg, no return value */
    }
 }
@@ -64,7 +62,7 @@ checkTimeThread(void *arg)
    const char* d = __DATE__;
    char buf[50];
    if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
-                    d[4],d[5], d[0],d[1],d[2], d + 7, __TIME__) < 0))
+                    d[4], d[5], d[0], d[1], d[2], d + 7, __TIME__) < 0))
    {
       BaTime compileT = baParseDate(buf);
       if(compileT) /* If OK: Seconds since 1970 */
@@ -85,22 +83,21 @@ checkTimeThread(void *arg)
 }
 
 /* xedge.c calls this to initialize the IO.
-   Change "/mnt/lfs" to your preference.
+ * Change "/mnt/lfs" to your preference.
  */
 int xedgeInitDiskIo(DiskIo* io)
 {
-   if(DiskIo_setRootDir(io,"/mnt/lfs"))
+   if(DiskIo_setRootDir(io, "/mnt/lfs"))
    {
-      syslog(LOG_ERR,"Error: cannot set root to /mnt/lfs\n");
+      syslog(LOG_ERR, "Error: cannot set root to /mnt/lfs\n");
       return -1;
    }
    return 0;
 }
 
 
-/*
-  xedge.c calls this; include your Lua bindings here.
-  Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
+/* xedge.c calls this; include your Lua bindings here.
+ * Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
 */
 int xedgeOpenAUX(XedgeOpenAUX* aux)
 {
@@ -126,25 +123,24 @@ myErrHandler(BaFatalErrorCodes ecode1,
              const char* file,
              int line)
 {
-   syslog(LOG_ERR,"Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
+   syslog(LOG_ERR, "Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
    exit(1);
 }
 
 
 /* Redirect server's HttpTrace to syslog.
-   https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
+ * https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
  */
 static void
 flushTrace(char* buf, int bufLen)
 {
    buf[bufLen]=0; /* Zero terminate. Bufsize is at least bufLen+1. */
-   syslog(LOG_INFO,"%s",buf);
+   syslog(LOG_INFO, "%s", buf);
 }
 
 static BaBool isRunning; /* Flag used for running state */
 
-/* CTRL-C handler makes Xedge perform a graceful shutdown.
- */
+/* CTRL-C handler makes Xedge perform a graceful shutdown. */
 static void
 sigHandler(int signo)
 {

From 8e8c9a6b62bc02365a26823b6a4d3624b6b31804 Mon Sep 17 00:00:00 2001
From: RTL <24235755+Telemechanics@users.noreply.github.com>
Date: Thu, 8 May 2025 09:42:29 +0200
Subject: [PATCH 03/10] Adding new example Xedge

Draft build instructions:

Xedge on NuttX
==============

Xedge is a robust IoT and web framework that is designed for microcontrollers. It is based on the industrial-grade Barracuda Application Server, designed for seamless OEM integration. Xedge accelerates embedded firmware development by providing a flexible, Lua-based environment and a full stack of industrial-strength protocols, including:

- OPC UA
- Modbus
- MQTT
- SMQ
- WebSockets
- HTTP/HTTPS

This Xedge port for NuttX comes pre-configured and requires:

- TCP/IP v4 and v6 support
- File System support
- 2 MB RAM allocated statically in ``xedge/xedge_main.c``

.. note::
   These instructions set up Xedge in **development mode**. Xedge supports many configuration options that differ between development and production builds. For production settings and optimization, refer to the general Xedge build instructions (details below).

Getting Started
---------------

To compile Xedge for NuttX, follow these steps:

1. **Prepare the Xedge apps directory.**

   Navigate to the Xedge application folder:

   .. code-block:: bash

      cd nuttxspace/apps/examples/xedge

2. **Clone the required dependencies.**

   .. code-block:: bash

      git clone https://github.com/RealTimeLogic/BAS.git
      git clone https://github.com/RealTimeLogic/BAS-Resources.git

3. **Build the Xedge resources.**

   Move into the build directory:

   .. code-block:: bash

      cd BAS-Resources/build/

   Run the Xedge resource build script. The following command answers the script prompts automatically:

   .. code-block:: bash

      printf "n\nl\nn\n" | bash Xedge.sh

4. **Copy the generated file.**

   Copy ``XedgeZip.c`` to the Xedge example directory:

   .. code-block:: bash

      cp XedgeZip.c ../../BAS/examples/xedge/

5. **Configure NuttX for Xedge.**

   Return to the NuttX top-level directory and start the configuration tool:

   .. code-block:: bash

      make menuconfig

   In the configuration menu:

   - Enable the Xedge application:

     ``Application Configuration -> Examples -> Xedge``

   - Enable dynamic socket callback allocation:

     ``Networking Support -> Socket Support -> Enable dynamic socket callback allocation`` (set value to **1**)

   - Increase the number of dynamic TCP connections:

     ``Networking Support -> TCP/IP Networking -> Dynamic TCP/IP connections allocation`` (set value to **at least 20**)

   - Enable automatic time synchronization via SNTP:

     ``Application Configuration -> Network Utilities -> NTP Client``

   - Make sure syslog is enabled:

     ``Device Drivers  -> System Logging   -> Enable system logging``
     ``Device Drivers  -> System Logging   -> Log to /dev/console ``

6. **Build NuttX.**

   Save your changes, exit ``menuconfig``, and build:

   .. code-block:: bash

      make

Running Xedge
-------------

Once NuttX is flashed and running, bring up the network interface and start time synchronization:

.. code-block:: bash

   ifup eth0
   xedge

Further Reading
===============

To learn more about Xedge and how to work with it effectively, see the following resources:

- **Using Xedge in Developer Mode:**
  Learn how to configure and work with Xedge during development, including dynamic Lua scripting, file system layout, and runtime behavior.

  `How to use Xedge when in developer mode <https://realtimelogic.com/ba/doc/en/Xedge.html>`_

- **Building Xedge for Developer or Production Mode:**
  Understand the differences between development and production builds, and follow detailed instructions for compiling Xedge appropriately for your target environment.

  `How to compile Xedge for developer or production mode <https://realtimelogic.com/ba/examples/xedge/readme.html>`_
---
 examples/xedge/Kconfig      |  29 ++++++
 examples/xedge/Make.defs    |  24 +++++
 examples/xedge/Makefile     |  35 ++++++++
 examples/xedge/xedge_main.c | 173 ++++++++++++++++++++++++++++++++++++
 4 files changed, 261 insertions(+)
 create mode 100644 examples/xedge/Kconfig
 create mode 100644 examples/xedge/Make.defs
 create mode 100644 examples/xedge/Makefile
 create mode 100644 examples/xedge/xedge_main.c

diff --git a/examples/xedge/Kconfig b/examples/xedge/Kconfig
new file mode 100644
index 00000000000..ece0f482371
--- /dev/null
+++ b/examples/xedge/Kconfig
@@ -0,0 +1,29 @@
+#
+# For a description of the syntax of this configuration file,
+# see the file kconfig-language.txt in the NuttX tools repository.
+#
+
+config EXAMPLES_XEDGE
+	tristate "Xedge IoT Toolkit"
+	default n
+	---help---
+		Enable Xedge
+
+if EXAMPLES_XEDGE
+
+config EXAMPLES_XEDGE_PROGNAME
+	string "Program name"
+	default "xedge"
+	---help---
+		This is the name of the program that will be used when the NSH ELF
+		program is installed.
+
+config EXAMPLES_XEDGE_PRIORITY
+	int "Xedge task priority"
+	default 100
+
+config EXAMPLES_XEDGE_STACKSIZE
+	int "Xedge stack size"
+	default 20000
+
+endif
diff --git a/examples/xedge/Make.defs b/examples/xedge/Make.defs
new file mode 100644
index 00000000000..cc246251349
--- /dev/null
+++ b/examples/xedge/Make.defs
@@ -0,0 +1,24 @@
+############################################################################
+# apps/examples/xedge/Make.defs
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+############################################################################
+
+ifneq ($(CONFIG_EXAMPLES_XEDGE),)
+CONFIGURED_APPS += $(APPDIR)/examples/xedge
+CFLAGS += ${INCDIR_PREFIX}$(APPDIR)/examples/xedge/BAS/inc ${INCDIR_PREFIX}$(APPDIR)/examples/xedge/BAS/inc/arch/Posix ${INCDIR_PREFIX}$(APPDIR)/examples/xedge/BAS/inc/arch/NET/Posix -DNO_INIT_DISK_IO -DUSE_DBGMON=1 -DUSE_IPV6
+endif
diff --git a/examples/xedge/Makefile b/examples/xedge/Makefile
new file mode 100644
index 00000000000..4002c909438
--- /dev/null
+++ b/examples/xedge/Makefile
@@ -0,0 +1,35 @@
+############################################################################
+# apps/examples/xedge/Make.defs
+#
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.  The
+# ASF licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations
+# under the License.
+#
+############################################################################
+
+include $(APPDIR)/Make.defs
+
+# Xedge, World! built-in application info
+
+PROGNAME  = $(CONFIG_EXAMPLES_XEDGE_PROGNAME)
+PRIORITY  = $(CONFIG_EXAMPLES_XEDGE_PRIORITY)
+STACKSIZE = $(CONFIG_EXAMPLES_XEDGE_STACKSIZE)
+MODULE    = $(CONFIG_EXAMPLES_XEDGE)
+
+# Xedge: BAS Example
+
+MAINSRC = xedge_main.c BAS/src/BAS.c BAS/src/dlmalloc.c BAS/src/arch/Posix/ThreadLib.c BAS/src/arch/NET/generic/SoDisp.c BAS/src/DiskIo/posix/BaFile.c BAS/examples/xedge/src/xedge.c BAS/examples/xedge/ BAS/examples/xedge/XedgeZip.c
+
+
+include $(APPDIR)/Application.mk
diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
new file mode 100644
index 00000000000..db532947600
--- /dev/null
+++ b/examples/xedge/xedge_main.c
@@ -0,0 +1,173 @@
+/*
+  Xedge Startup Code
+
+  Xedge, including this startup code, requires the Barracuda App
+  Server library and is licensed using the three license options as
+  explained here: https://github.com/RealTimeLogic/BAS#license
+
+*/
+#include <nuttx/config.h>
+#include <stdio.h>
+#include <syslog.h>
+#include <netutils/ntpclient.h>
+#include <HttpTrace.h>
+#include <BaDiskIo.h>
+#include <BaServerLib.h>
+#include "BAS/examples/xedge/src/xedge.h"
+
+extern void barracuda();  /* BAS/examples/xedge/src/xedge.c */
+extern void init_dlmalloc(char* heapstart, char* heapend); /* dlmalloc.c */
+extern int (*platformInitDiskIo)(DiskIo*); /* xedge.c */
+
+/* The LThreadMgr configured in xedge.c */
+extern LThreadMgr ltMgr;
+
+/* BAS is configured to use dlmalloc for NuttX. This is the pool.
+*/
+static char poolBuf[2*1024*1024]; /* 2M : recommended minimum */
+
+
+/* The following two functions are copied from the example:
+   https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
+   Details:
+   https://realtimelogic.com/ba/examples/xedge/readme.html#time
+ */
+
+/* This callback is called by one of the threads managed by LThreadMgr
+ * when a job is taken off the queue and executed. The callback
+ * attempts to find the global Lua function '_XedgeEvent', and if the
+ * function is found, it will be executed as follows: _XedgeEvent("sntp")
+ */
+static void executeXedgeEvent(ThreadJob* job, int msgh, LThreadMgr* mgr)
+{
+   lua_State* L = job->Lt;
+   lua_pushglobaltable(L); /* _G */
+   lua_getfield(L, -1, "_XedgeEvent");
+   if(lua_isfunction(L, -1))  /* Do we have _G._XedgeEvent */
+   {
+      /* Call _XedgeEvent("sntp") */
+      lua_pushstring(L,"sntp"); /* Arg */
+      lua_pcall(L, 1, 0, msgh); /* one arg, no return value */
+   }
+}
+
+
+/* Thread started by xedgeOpenAUX() */
+static void*
+checkTimeThread(void *arg)
+{
+   ThreadMutex* soDispMutex = HttpServer_getMutex(ltMgr.server);
+   (void)arg;
+   /* Use the compile time macros for date and time and convert the
+    * date/time to a value that can be used by function baParseDate
+    */
+   const char* d = __DATE__;
+   char buf[50];
+   if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
+                    d[4],d[5], d[0],d[1],d[2], d + 7, __TIME__) < 0))
+   {
+      BaTime compileT = baParseDate(buf);
+      if(compileT) /* If OK: Seconds since 1970 */
+      {
+         compileT -= 24*60*60; /* Give it one day for time zone adj. */
+         /* Wait for time to be updated by NTP */
+         while(baGetUnixTime() < compileT)
+            Thread_sleep(500);
+         /* Initiate executing the Lua func _XedgeEvent("sntp") */
+         ThreadJob* job=ThreadJob_lcreate(sizeof(ThreadJob), executeXedgeEvent);
+         ThreadMutex_set(soDispMutex);
+         LThreadMgr_run(&ltMgr, job);
+         ThreadMutex_release(soDispMutex);
+      }
+   }
+   /* Exit thread */
+   return NULL;
+}
+
+/* xedge.c calls this to initialize the IO.
+   Change "/mnt/lfs" to your preference.
+ */
+int xedgeInitDiskIo(DiskIo* io)
+{
+   if(DiskIo_setRootDir(io,"/mnt/lfs"))
+   {
+      syslog(LOG_ERR,"Error: cannot set root to /mnt/lfs\n");
+      return -1;
+   }
+   return 0;
+}
+
+
+/*
+  xedge.c calls this; include your Lua bindings here.
+  Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
+*/
+int xedgeOpenAUX(XedgeOpenAUX* aux)
+{
+   (void)aux;
+
+   /* Start thread waiting for time to be set */
+   pthread_t thread;
+   pthread_attr_t attr;
+   struct sched_param param;
+   pthread_attr_init(&attr);
+   pthread_attr_setstacksize(&attr, 4096);
+   param.sched_priority = SCHED_PRIORITY_DEFAULT;
+   pthread_attr_setschedparam(&attr, &param);
+   pthread_create(&thread, &attr, checkTimeThread, NULL);
+
+   return 0; /* OK */
+}
+
+
+static void
+myErrHandler(BaFatalErrorCodes ecode1,
+             unsigned int ecode2,
+             const char* file,
+             int line)
+{
+   syslog(LOG_ERR,"Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
+   exit(1);
+}
+
+
+/* Redirect server's HttpTrace to syslog.
+   https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
+ */
+static void
+flushTrace(char* buf, int bufLen)
+{
+   buf[bufLen]=0; /* Zero terminate. Bufsize is at least bufLen+1. */
+   syslog(LOG_INFO,"%s",buf);
+}
+
+static BaBool isRunning; /* Flag used for running state */
+
+/* CTRL-C handler makes Xedge perform a graceful shutdown.
+ */
+static void
+sigHandler(int signo)
+{
+   if(isRunning)
+   {
+      isRunning=FALSE;
+      printf("\nGot SIGTERM; exiting...\n");
+      setDispExit(); /* Graceful shutdown : xedge.c */
+      Thread_sleep(2000);
+   }
+}
+
+
+int main(int argc, FAR char *argv[])
+{
+   signal(SIGINT, sigHandler);
+   signal(SIGTERM, sigHandler);
+   ntpc_start(); /* Make sure it runs; time is reqired when using TLS */
+   init_dlmalloc(poolBuf, poolBuf + sizeof(poolBuf));
+   HttpTrace_setFLushCallback(flushTrace);
+   HttpServer_setErrHnd(myErrHandler);
+   isRunning=true;
+   barracuda(); /* xedge.c; does not return unless setDispExit() is called */
+   printf("Exiting Xedge\n");
+   return 0;
+}

From 4b2fca159ce49037575f055db09fc98c9f37eca1 Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Fri, 9 May 2025 10:53:10 +0200
Subject: [PATCH 04/10] improving comments and config file

---
 examples/xedge/Kconfig      | 27 ++++++++++++++++++----
 examples/xedge/xedge_main.c | 46 +++++++++++++++++--------------------
 2 files changed, 43 insertions(+), 30 deletions(-)

diff --git a/examples/xedge/Kconfig b/examples/xedge/Kconfig
index ece0f482371..40ad7ffb5ec 100644
--- a/examples/xedge/Kconfig
+++ b/examples/xedge/Kconfig
@@ -1,13 +1,27 @@
 #
-# For a description of the syntax of this configuration file,
-# see the file kconfig-language.txt in the NuttX tools repository.
+# Xedge IoT Toolkit - NuttX Kconfig integration
+#
+# Xedge is an embedded software toolkit designed to enable high-level developers
+# (e.g., web and Lua programmers) to create sophisticated, secure IoT and industrial
+# device applications. It abstracts low-level embedded development through a lightweight
+# runtime built on top of the Barracuda App Server and Lua, giving developers direct access
+# to HTTP(S), WebSockets, MQTT, file system, and device I/O - all from high-level Lua scripts.
+#
+# This NuttX integration allows developers to compile and run Xedge as a user application,
+# bringing powerful device control capabilities and an embedded web server to NuttX-based
+# systems.
+#
+# Use this if you want to build smart, networked embedded devices with minimal C code,
+# and maximum productivity.
 #
 
 config EXAMPLES_XEDGE
 	tristate "Xedge IoT Toolkit"
 	default n
 	---help---
-		Enable Xedge
+	  Enable Xedge support in NuttX. Xedge is a high-level toolkit that lets you
+	  develop complete IoT device applications using Lua, backed by the Barracuda App Server.
+	  This application demonstrates a complete Xedge runtime integrated into NuttX.
 
 if EXAMPLES_XEDGE
 
@@ -15,15 +29,18 @@ config EXAMPLES_XEDGE_PROGNAME
 	string "Program name"
 	default "xedge"
 	---help---
-		This is the name of the program that will be used when the NSH ELF
-		program is installed.
+	  This is the name of the ELF executable for the Xedge application in NSH.
 
 config EXAMPLES_XEDGE_PRIORITY
 	int "Xedge task priority"
 	default 100
+	---help---
+	  Set the task priority for the Xedge runtime.
 
 config EXAMPLES_XEDGE_STACKSIZE
 	int "Xedge stack size"
 	default 20000
+	---help---
+	  Set the stack size allocated to the Xedge Lua interpreter and application runtime.
 
 endif
diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
index db532947600..adb346f713f 100644
--- a/examples/xedge/xedge_main.c
+++ b/examples/xedge/xedge_main.c
@@ -1,11 +1,10 @@
-/*
-  Xedge Startup Code
-
-  Xedge, including this startup code, requires the Barracuda App
-  Server library and is licensed using the three license options as
-  explained here: https://github.com/RealTimeLogic/BAS#license
-
+/* Xedge NuttX Startup Code (may need adjustments)
+ *
+ * Xedge, including this startup code, requires the Barracuda App
+ * Server library and is licensed using the three license options as
+ * explained here: https://github.com/RealTimeLogic/BAS#license
 */
+
 #include <nuttx/config.h>
 #include <stdio.h>
 #include <syslog.h>
@@ -22,15 +21,14 @@ extern int (*platformInitDiskIo)(DiskIo*); /* xedge.c */
 /* The LThreadMgr configured in xedge.c */
 extern LThreadMgr ltMgr;
 
-/* BAS is configured to use dlmalloc for NuttX. This is the pool.
-*/
+/* BAS is configured to use dlmalloc for NuttX. This is the pool. */
 static char poolBuf[2*1024*1024]; /* 2M : recommended minimum */
 
 
 /* The following two functions are copied from the example:
-   https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
-   Details:
-   https://realtimelogic.com/ba/examples/xedge/readme.html#time
+ * https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
+ * Details:
+ * https://realtimelogic.com/ba/examples/xedge/readme.html#time
  */
 
 /* This callback is called by one of the threads managed by LThreadMgr
@@ -46,7 +44,7 @@ static void executeXedgeEvent(ThreadJob* job, int msgh, LThreadMgr* mgr)
    if(lua_isfunction(L, -1))  /* Do we have _G._XedgeEvent */
    {
       /* Call _XedgeEvent("sntp") */
-      lua_pushstring(L,"sntp"); /* Arg */
+      lua_pushstring(L, "sntp"); /* Arg */
       lua_pcall(L, 1, 0, msgh); /* one arg, no return value */
    }
 }
@@ -64,7 +62,7 @@ checkTimeThread(void *arg)
    const char* d = __DATE__;
    char buf[50];
    if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
-                    d[4],d[5], d[0],d[1],d[2], d + 7, __TIME__) < 0))
+                    d[4], d[5], d[0], d[1], d[2], d + 7, __TIME__) < 0))
    {
       BaTime compileT = baParseDate(buf);
       if(compileT) /* If OK: Seconds since 1970 */
@@ -85,22 +83,21 @@ checkTimeThread(void *arg)
 }
 
 /* xedge.c calls this to initialize the IO.
-   Change "/mnt/lfs" to your preference.
+ * Change "/mnt/lfs" to your preference.
  */
 int xedgeInitDiskIo(DiskIo* io)
 {
-   if(DiskIo_setRootDir(io,"/mnt/lfs"))
+   if(DiskIo_setRootDir(io, "/mnt/lfs"))
    {
-      syslog(LOG_ERR,"Error: cannot set root to /mnt/lfs\n");
+      syslog(LOG_ERR, "Error: cannot set root to /mnt/lfs\n");
       return -1;
    }
    return 0;
 }
 
 
-/*
-  xedge.c calls this; include your Lua bindings here.
-  Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
+/* xedge.c calls this; include your Lua bindings here.
+ * Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
 */
 int xedgeOpenAUX(XedgeOpenAUX* aux)
 {
@@ -126,25 +123,24 @@ myErrHandler(BaFatalErrorCodes ecode1,
              const char* file,
              int line)
 {
-   syslog(LOG_ERR,"Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
+   syslog(LOG_ERR, "Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
    exit(1);
 }
 
 
 /* Redirect server's HttpTrace to syslog.
-   https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
+ * https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
  */
 static void
 flushTrace(char* buf, int bufLen)
 {
    buf[bufLen]=0; /* Zero terminate. Bufsize is at least bufLen+1. */
-   syslog(LOG_INFO,"%s",buf);
+   syslog(LOG_INFO, "%s", buf);
 }
 
 static BaBool isRunning; /* Flag used for running state */
 
-/* CTRL-C handler makes Xedge perform a graceful shutdown.
- */
+/* CTRL-C handler makes Xedge perform a graceful shutdown. */
 static void
 sigHandler(int signo)
 {

From 13a35703d42b04c159c042ed6e35e8e42dbfacd9 Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Fri, 9 May 2025 13:45:21 +0200
Subject: [PATCH 05/10] examples/xedge:
 https://github.com/apache/nuttx/pull/16352

Signed-off-by: surfskidude <wilfrednilsen@hotmail.com>
---
 examples/xedge/prepare.sh | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 examples/xedge/prepare.sh

diff --git a/examples/xedge/prepare.sh b/examples/xedge/prepare.sh
new file mode 100644
index 00000000000..969c3bfa377
--- /dev/null
+++ b/examples/xedge/prepare.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+# This script clones the required repos and builds the Xedge resource file
+
+# Clone BAS repo if not already present
+if [ ! -d "BAS" ]; then
+  git clone https://github.com/RealTimeLogic/BAS.git
+fi
+
+# Clone BAS-Resources repo if not already present
+if [ ! -d "BAS-Resources" ]; then
+  git clone https://github.com/RealTimeLogic/BAS-Resources.git
+fi
+
+# Build XedgeZip.c (Xedge resource file) only if it doesn't exist
+if [ ! -f "BAS/examples/xedge/XedgeZip.c" ]; then
+  echo "Building XedgeZip.c"
+  cd BAS-Resources/build/ || exit 1
+  printf "n\nl\nn\n" | bash Xedge.sh > /dev/null
+  cp XedgeZip.c ../../BAS/examples/xedge/  || exit 1
+fi

From 58e379bed2e5c8e2bdbc78ad1e4a794b4b473f5e Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Fri, 9 May 2025 15:26:47 +0200
Subject: [PATCH 06/10] Tabify Kconfig

Signed-off-by: surfskidude <wilfrednilsen@hotmail.com>
---
 examples/xedge/Kconfig | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/examples/xedge/Kconfig b/examples/xedge/Kconfig
index 40ad7ffb5ec..491e2200ef1 100644
--- a/examples/xedge/Kconfig
+++ b/examples/xedge/Kconfig
@@ -19,9 +19,11 @@ config EXAMPLES_XEDGE
 	tristate "Xedge IoT Toolkit"
 	default n
 	---help---
-	  Enable Xedge support in NuttX. Xedge is a high-level toolkit that lets you
-	  develop complete IoT device applications using Lua, backed by the Barracuda App Server.
-	  This application demonstrates a complete Xedge runtime integrated into NuttX.
+		Enable Xedge support in NuttX. Xedge is a high-level
+		toolkit that lets you develop complete IoT device
+		applications using Lua, backed by the Barracuda App
+		Server.	This application demonstrates a complete
+		Xedge runtime integrated into NuttX.
 
 if EXAMPLES_XEDGE
 
@@ -29,18 +31,18 @@ config EXAMPLES_XEDGE_PROGNAME
 	string "Program name"
 	default "xedge"
 	---help---
-	  This is the name of the ELF executable for the Xedge application in NSH.
+		This is the name of the ELF executable for the Xedge application in NSH.
 
 config EXAMPLES_XEDGE_PRIORITY
 	int "Xedge task priority"
 	default 100
 	---help---
-	  Set the task priority for the Xedge runtime.
+		Set the task priority for the Xedge runtime.
 
 config EXAMPLES_XEDGE_STACKSIZE
 	int "Xedge stack size"
 	default 20000
 	---help---
-	  Set the stack size allocated to the Xedge Lua interpreter and application runtime.
+		Set the stack size allocated to the Xedge Lua interpreter and application runtime.
 
 endif

From b8f8b3b478041fb26ebaba901afc12938d30133a Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Fri, 9 May 2025 17:16:46 +0200
Subject: [PATCH 07/10] Now same license as in webserver/webserver_main.c

---
 examples/xedge/xedge_main.c | 228 +++++++++++++++++++++---------------
 1 file changed, 133 insertions(+), 95 deletions(-)

diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
index adb346f713f..9eab6e79a98 100644
--- a/examples/xedge/xedge_main.c
+++ b/examples/xedge/xedge_main.c
@@ -1,13 +1,55 @@
+/****************************************************************************
+ * xedge_main.c
+ *
+ *   Copyright (C) 2025. All rights reserved.
+ *   Author: Real Time Logic
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ *    must display the following acknowledgement:
+ *      This product includes software developed by Adam Dunkels.
+ * 4. The name of the author may not be used to endorse or promote
+ *    products derived from this software without specific prior
+ *    written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
+ * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+ * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+ * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ ****************************************************************************/
+
 /* Xedge NuttX Startup Code (may need adjustments)
  *
- * Xedge, including this startup code, requires the Barracuda App
- * Server library and is licensed using the three license options as
- * explained here: https://github.com/RealTimeLogic/BAS#license
-*/
+ * Additional License Note: Xedge, based on the Barracuda
+ * App Server, uses the license options explained here:
+ * https://github.com/RealTimeLogic/BAS#license
+ * This repo does not include Xedge and the Barracuda App Server
+ * library and must be downloaded separately. Use the script
+ * prepare.sh to clone and prepare the build env.
+ */
 
 #include <nuttx/config.h>
 #include <stdio.h>
+#include <stdlib.h>
+#include <signal.h>
 #include <syslog.h>
+#include <pthread.h>
 #include <netutils/ntpclient.h>
 #include <HttpTrace.h>
 #include <BaDiskIo.h>
@@ -22,8 +64,7 @@ extern int (*platformInitDiskIo)(DiskIo*); /* xedge.c */
 extern LThreadMgr ltMgr;
 
 /* BAS is configured to use dlmalloc for NuttX. This is the pool. */
-static char poolBuf[2*1024*1024]; /* 2M : recommended minimum */
-
+static char poolBuf[2 * 1024 * 1024]; /* 2M : recommended minimum */
 
 /* The following two functions are copied from the example:
  * https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
@@ -36,134 +77,131 @@ static char poolBuf[2*1024*1024]; /* 2M : recommended minimum */
  * attempts to find the global Lua function '_XedgeEvent', and if the
  * function is found, it will be executed as follows: _XedgeEvent("sntp")
  */
-static void executeXedgeEvent(ThreadJob* job, int msgh, LThreadMgr* mgr)
+static void executeXedgeEvent(ThreadJob *job, int msgh, LThreadMgr *mgr)
 {
-   lua_State* L = job->Lt;
-   lua_pushglobaltable(L); /* _G */
-   lua_getfield(L, -1, "_XedgeEvent");
-   if(lua_isfunction(L, -1))  /* Do we have _G._XedgeEvent */
-   {
-      /* Call _XedgeEvent("sntp") */
-      lua_pushstring(L, "sntp"); /* Arg */
-      lua_pcall(L, 1, 0, msgh); /* one arg, no return value */
-   }
+  lua_State *L = job->Lt;
+  lua_pushglobaltable(L);
+  lua_getfield(L, -1, "_XedgeEvent");
+
+  if (lua_isfunction(L, -1))
+    {
+      lua_pushstring(L, "sntp");
+      lua_pcall(L, 1, 0, msgh);
+    }
 }
 
-
 /* Thread started by xedgeOpenAUX() */
-static void*
-checkTimeThread(void *arg)
+static void *checkTimeThread(void *arg)
 {
-   ThreadMutex* soDispMutex = HttpServer_getMutex(ltMgr.server);
-   (void)arg;
-   /* Use the compile time macros for date and time and convert the
-    * date/time to a value that can be used by function baParseDate
-    */
-   const char* d = __DATE__;
-   char buf[50];
-   if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
-                    d[4], d[5], d[0], d[1], d[2], d + 7, __TIME__) < 0))
-   {
+  ThreadMutex *soDispMutex = HttpServer_getMutex(ltMgr.server);
+  const char *d = __DATE__;
+  char buf[50];
+
+  (void)arg;
+
+  if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
+                   d[4], d[5], d[0], d[1], d[2], d + 7, __TIME__) < 0))
+    {
       BaTime compileT = baParseDate(buf);
-      if(compileT) /* If OK: Seconds since 1970 */
-      {
-         compileT -= 24*60*60; /* Give it one day for time zone adj. */
-         /* Wait for time to be updated by NTP */
-         while(baGetUnixTime() < compileT)
-            Thread_sleep(500);
-         /* Initiate executing the Lua func _XedgeEvent("sntp") */
-         ThreadJob* job=ThreadJob_lcreate(sizeof(ThreadJob), executeXedgeEvent);
-         ThreadMutex_set(soDispMutex);
-         LThreadMgr_run(&ltMgr, job);
-         ThreadMutex_release(soDispMutex);
-      }
-   }
-   /* Exit thread */
-   return NULL;
+      if (compileT)
+        {
+          compileT -= 24 * 60 * 60;
+          while (baGetUnixTime() < compileT)
+            {
+              Thread_sleep(500);
+            }
+
+          ThreadJob *job = ThreadJob_lcreate(sizeof(ThreadJob), executeXedgeEvent);
+          ThreadMutex_set(soDispMutex);
+          LThreadMgr_run(&ltMgr, job);
+          ThreadMutex_release(soDispMutex);
+        }
+    }
+
+  return NULL;
 }
 
 /* xedge.c calls this to initialize the IO.
  * Change "/mnt/lfs" to your preference.
  */
-int xedgeInitDiskIo(DiskIo* io)
+int xedgeInitDiskIo(DiskIo *io)
 {
-   if(DiskIo_setRootDir(io, "/mnt/lfs"))
-   {
+  if (DiskIo_setRootDir(io, "/mnt/lfs"))
+    {
       syslog(LOG_ERR, "Error: cannot set root to /mnt/lfs\n");
       return -1;
-   }
-   return 0;
+    }
+
+  return 0;
 }
 
 
 /* xedge.c calls this; include your Lua bindings here.
  * Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
 */
-int xedgeOpenAUX(XedgeOpenAUX* aux)
+int xedgeOpenAUX(XedgeOpenAUX *aux)
 {
-   (void)aux;
-
-   /* Start thread waiting for time to be set */
-   pthread_t thread;
-   pthread_attr_t attr;
-   struct sched_param param;
-   pthread_attr_init(&attr);
-   pthread_attr_setstacksize(&attr, 4096);
-   param.sched_priority = SCHED_PRIORITY_DEFAULT;
-   pthread_attr_setschedparam(&attr, &param);
-   pthread_create(&thread, &attr, checkTimeThread, NULL);
-
-   return 0; /* OK */
-}
+  pthread_t thread;
+  pthread_attr_t attr;
+  struct sched_param param;
+
+  (void)aux;
+
+  pthread_attr_init(&attr);
+  pthread_attr_setstacksize(&attr, 4096);
+  param.sched_priority = SCHED_PRIORITY_DEFAULT;
+  pthread_attr_setschedparam(&attr, &param);
+  pthread_create(&thread, &attr, checkTimeThread, NULL);
 
+  return 0;
+}
 
-static void
-myErrHandler(BaFatalErrorCodes ecode1,
-             unsigned int ecode2,
-             const char* file,
-             int line)
+static void myErrHandler(BaFatalErrorCodes ecode1,
+                         unsigned int ecode2,
+                         const char *file,
+                         int line)
 {
-   syslog(LOG_ERR, "Fatal error in Barracuda %d %d %s %d\n", ecode1, ecode2, file, line);
-   exit(1);
+  syslog(LOG_ERR, "Fatal error in Barracuda %d %d %s %d\n",
+         ecode1, ecode2, file, line);
+  exit(1);
 }
 
 
 /* Redirect server's HttpTrace to syslog.
  * https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
  */
-static void
-flushTrace(char* buf, int bufLen)
+static void flushTrace(char *buf, int bufLen)
 {
-   buf[bufLen]=0; /* Zero terminate. Bufsize is at least bufLen+1. */
-   syslog(LOG_INFO, "%s", buf);
+  buf[bufLen] = 0;
+  syslog(LOG_INFO, "%s", buf);
 }
 
-static BaBool isRunning; /* Flag used for running state */
+static BaBool isRunning;
 
-/* CTRL-C handler makes Xedge perform a graceful shutdown. */
-static void
-sigHandler(int signo)
+static void sigHandler(int signo)
 {
-   if(isRunning)
-   {
-      isRunning=FALSE;
+  if (isRunning)
+    {
+      isRunning = FALSE;
       printf("\nGot SIGTERM; exiting...\n");
-      setDispExit(); /* Graceful shutdown : xedge.c */
+      setDispExit();
       Thread_sleep(2000);
-   }
+    }
 }
 
-
 int main(int argc, FAR char *argv[])
 {
-   signal(SIGINT, sigHandler);
-   signal(SIGTERM, sigHandler);
-   ntpc_start(); /* Make sure it runs; time is reqired when using TLS */
-   init_dlmalloc(poolBuf, poolBuf + sizeof(poolBuf));
-   HttpTrace_setFLushCallback(flushTrace);
-   HttpServer_setErrHnd(myErrHandler);
-   isRunning=true;
-   barracuda(); /* xedge.c; does not return unless setDispExit() is called */
-   printf("Exiting Xedge\n");
-   return 0;
+  signal(SIGINT, sigHandler);
+  signal(SIGTERM, sigHandler);
+
+  ntpc_start();
+  init_dlmalloc(poolBuf, poolBuf + sizeof(poolBuf));
+  HttpTrace_setFLushCallback(flushTrace);
+  HttpServer_setErrHnd(myErrHandler);
+
+  isRunning = TRUE;
+  barracuda();
+
+  printf("Exiting Xedge\n");
+  return 0;
 }

From b25086916dd86e738f104bea95fc6c8539e25611 Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Fri, 9 May 2025 18:04:19 +0200
Subject: [PATCH 08/10] Adding 	depends on ALLOW_GPL_COMPONENTS

---
 examples/xedge/Kconfig | 1 +
 1 file changed, 1 insertion(+)

diff --git a/examples/xedge/Kconfig b/examples/xedge/Kconfig
index 491e2200ef1..1e5e0ae9593 100644
--- a/examples/xedge/Kconfig
+++ b/examples/xedge/Kconfig
@@ -17,6 +17,7 @@
 
 config EXAMPLES_XEDGE
 	tristate "Xedge IoT Toolkit"
+	depends on ALLOW_GPL_COMPONENTS
 	default n
 	---help---
 		Enable Xedge support in NuttX. Xedge is a high-level

From 00266e34cabc10a9bd46b1684661d99930bc8c31 Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Mon, 12 May 2025 09:28:57 +0200
Subject: [PATCH 09/10] Now auto building resources. No checkpatch.sh errors,
 except "Mixed case identifier found"

---
 examples/xedge/Makefile     |   7 ++
 examples/xedge/xedge_main.c | 150 +++++++++++++++++++++---------------
 2 files changed, 97 insertions(+), 60 deletions(-)

diff --git a/examples/xedge/Makefile b/examples/xedge/Makefile
index 4002c909438..3952ab8db1c 100644
--- a/examples/xedge/Makefile
+++ b/examples/xedge/Makefile
@@ -31,5 +31,12 @@ MODULE    = $(CONFIG_EXAMPLES_XEDGE)
 
 MAINSRC = xedge_main.c BAS/src/BAS.c BAS/src/dlmalloc.c BAS/src/arch/Posix/ThreadLib.c BAS/src/arch/NET/generic/SoDisp.c BAS/src/DiskIo/posix/BaFile.c BAS/examples/xedge/src/xedge.c BAS/examples/xedge/ BAS/examples/xedge/XedgeZip.c
 
+XEDGEZIP = BAS/examples/xedge/XedgeZip.c
+
+$(XEDGEZIP):
+	. prepare.sh
+
+context:: $(XEDGEZIP)
+
 
 include $(APPDIR)/Application.mk
diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
index 9eab6e79a98..bdf49aa7e1a 100644
--- a/examples/xedge/xedge_main.c
+++ b/examples/xedge/xedge_main.c
@@ -1,5 +1,5 @@
-/****************************************************************************
- * xedge_main.c
+/***************************************************************************
+ * apps/examples/xedge/xedge_main.c
  *
  *   Copyright (C) 2025. All rights reserved.
  *   Author: Real Time Logic
@@ -32,7 +32,7 @@
  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  *
- ****************************************************************************/
+ ***************************************************************************/
 
 /* Xedge NuttX Startup Code (may need adjustments)
  *
@@ -44,6 +44,10 @@
  * prepare.sh to clone and prepare the build env.
  */
 
+/***************************************************************************
+ * Included Files
+ ***************************************************************************/
+
 #include <nuttx/config.h>
 #include <stdio.h>
 #include <stdlib.h>
@@ -56,15 +60,33 @@
 #include <BaServerLib.h>
 #include "BAS/examples/xedge/src/xedge.h"
 
-extern void barracuda();  /* BAS/examples/xedge/src/xedge.c */
-extern void init_dlmalloc(char* heapstart, char* heapend); /* dlmalloc.c */
-extern int (*platformInitDiskIo)(DiskIo*); /* xedge.c */
+/***************************************************************************
+ * Private Data
+ ***************************************************************************/
+
+static int running; /* Server running mode */
+
+/* BAS is configured to use dlmalloc for NuttX. This is the pool.
+ * 2M : recommended minimum
+ */
+
+static char poolbuf[2 * 1024 * 1024];
 
-/* The LThreadMgr configured in xedge.c */
-extern LThreadMgr ltMgr;
+extern LThreadMgr ltMgr; /* The LThreadMgr configured in xedge.c */
 
-/* BAS is configured to use dlmalloc for NuttX. This is the pool. */
-static char poolBuf[2 * 1024 * 1024]; /* 2M : recommended minimum */
+/***************************************************************************
+ * External Function Prototypes
+ ***************************************************************************/
+
+/* barracuda(): BAS/examples/xedge/src/xedge.c */
+
+extern void barracuda(void);
+extern void init_dlmalloc(char *heapstart, char *heapend); /* dlmalloc.c */
+extern int (*platformInitDiskIo)(DiskIo *io);              /* xedge.c */
+
+/***************************************************************************
+ * Private Functions
+ ***************************************************************************/
 
 /* The following two functions are copied from the example:
  * https://github.com/RealTimeLogic/BAS/blob/main/examples/xedge/src/led.c
@@ -77,7 +99,8 @@ static char poolBuf[2 * 1024 * 1024]; /* 2M : recommended minimum */
  * attempts to find the global Lua function '_XedgeEvent', and if the
  * function is found, it will be executed as follows: _XedgeEvent("sntp")
  */
-static void executeXedgeEvent(ThreadJob *job, int msgh, LThreadMgr *mgr)
+
+static void execevent(ThreadJob *job, int msgh, LThreadMgr *mgr)
 {
   lua_State *L = job->Lt;
   lua_pushglobaltable(L);
@@ -91,9 +114,10 @@ static void executeXedgeEvent(ThreadJob *job, int msgh, LThreadMgr *mgr)
 }
 
 /* Thread started by xedgeOpenAUX() */
+
 static void *checkTimeThread(void *arg)
 {
-  ThreadMutex *soDispMutex = HttpServer_getMutex(ltMgr.server);
+  ThreadMutex *dm = HttpServer_getMutex(ltMgr.server);
   const char *d = __DATE__;
   char buf[50];
 
@@ -102,28 +126,66 @@ static void *checkTimeThread(void *arg)
   if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
                    d[4], d[5], d[0], d[1], d[2], d + 7, __TIME__) < 0))
     {
-      BaTime compileT = baParseDate(buf);
-      if (compileT)
+      BaTime t = baParseDate(buf);
+      if (t)
         {
-          compileT -= 24 * 60 * 60;
-          while (baGetUnixTime() < compileT)
+          t -= 24 * 60 * 60;
+          while (baGetUnixTime() < t)
             {
               Thread_sleep(500);
             }
 
-          ThreadJob *job = ThreadJob_lcreate(sizeof(ThreadJob), executeXedgeEvent);
-          ThreadMutex_set(soDispMutex);
+          ThreadJob *job = ThreadJob_lcreate(sizeof(ThreadJob), execevent);
+          ThreadMutex_set(dm);
           LThreadMgr_run(&ltMgr, job);
-          ThreadMutex_release(soDispMutex);
+          ThreadMutex_release(dm);
         }
     }
 
   return NULL;
 }
 
+static void panic(BaFatalErrorCodes ecode1,
+                         unsigned int ecode2,
+                         const char *file,
+                         int line)
+{
+  syslog(LOG_ERR, "Fatal error in Barracuda %d %d %s %d\n",
+         ecode1, ecode2, file, line);
+  exit(1);
+}
+
+/* Redirect server's HttpTrace to syslog.
+ * https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
+ */
+
+static void flushtrace(char *buf, int bufLen)
+{
+  buf[bufLen] = 0;
+  syslog(LOG_INFO, "%s", buf);
+}
+
+static void sighandler(int signo)
+{
+  if (running)
+    {
+      printf("\nGot SIGTERM; exiting...\n");
+      setDispExit();
+
+      /* NuttX feature: Must wait for socket select() to return */
+
+      Thread_sleep(2000);
+    }
+}
+
+/***************************************************************************
+ * Public Functions
+ ***************************************************************************/
+
 /* xedge.c calls this to initialize the IO.
  * Change "/mnt/lfs" to your preference.
  */
+
 int xedgeInitDiskIo(DiskIo *io)
 {
   if (DiskIo_setRootDir(io, "/mnt/lfs"))
@@ -135,10 +197,10 @@ int xedgeInitDiskIo(DiskIo *io)
   return 0;
 }
 
-
 /* xedge.c calls this; include your Lua bindings here.
  * Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
-*/
+ */
+
 int xedgeOpenAUX(XedgeOpenAUX *aux)
 {
   pthread_t thread;
@@ -156,51 +218,19 @@ int xedgeOpenAUX(XedgeOpenAUX *aux)
   return 0;
 }
 
-static void myErrHandler(BaFatalErrorCodes ecode1,
-                         unsigned int ecode2,
-                         const char *file,
-                         int line)
-{
-  syslog(LOG_ERR, "Fatal error in Barracuda %d %d %s %d\n",
-         ecode1, ecode2, file, line);
-  exit(1);
-}
-
-
-/* Redirect server's HttpTrace to syslog.
- * https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
- */
-static void flushTrace(char *buf, int bufLen)
-{
-  buf[bufLen] = 0;
-  syslog(LOG_INFO, "%s", buf);
-}
-
-static BaBool isRunning;
-
-static void sigHandler(int signo)
-{
-  if (isRunning)
-    {
-      isRunning = FALSE;
-      printf("\nGot SIGTERM; exiting...\n");
-      setDispExit();
-      Thread_sleep(2000);
-    }
-}
-
 int main(int argc, FAR char *argv[])
 {
-  signal(SIGINT, sigHandler);
-  signal(SIGTERM, sigHandler);
+  signal(SIGINT, sighandler);
+  signal(SIGTERM, sighandler);
 
   ntpc_start();
-  init_dlmalloc(poolBuf, poolBuf + sizeof(poolBuf));
-  HttpTrace_setFLushCallback(flushTrace);
-  HttpServer_setErrHnd(myErrHandler);
+  init_dlmalloc(poolbuf, poolbuf + sizeof(poolbuf));
+  HttpTrace_setFLushCallback(flushtrace);
+  HttpServer_setErrHnd(panic);
 
-  isRunning = TRUE;
+  running = TRUE;
   barracuda();
+  running = FALSE;
 
   printf("Exiting Xedge\n");
   return 0;

From 60916b74454ed265e8b2d43e1d2c5ff1fcd7410b Mon Sep 17 00:00:00 2001
From: surfskidude <wilfrednilsen@hotmail.com>
Date: Wed, 14 May 2025 09:27:17 +0200
Subject: [PATCH 10/10] Now passes checkpatch.sh

---
 examples/xedge/xedge_main.c | 91 +++++++++++++++++++++++++++----------
 1 file changed, 66 insertions(+), 25 deletions(-)

diff --git a/examples/xedge/xedge_main.c b/examples/xedge/xedge_main.c
index bdf49aa7e1a..f19444f611e 100644
--- a/examples/xedge/xedge_main.c
+++ b/examples/xedge/xedge_main.c
@@ -60,11 +60,46 @@
 #include <BaServerLib.h>
 #include "BAS/examples/xedge/src/xedge.h"
 
+/***************************************************************************
+ * Pre-processor Definitions
+ ***************************************************************************/
+
+/* The following is a horrible hack to make the code pass the NuttX
+ * checkpatch.sh tool. The Barracuda App Server uses a type of
+ * camelCase encoding as explained here:
+ * https://realtimelogic.com/ba/doc/en/C/introduction.html#oo_c
+ */
+
+#define ltmgr ltMgr
+#define lthreadmgr LThreadMgr
+#define lthreadmgr_run LThreadMgr_run
+#define platforminitdiskio platformInitDiskIo
+#define diskio DiskIo
+#define diskio_setrootdir DiskIo_setRootDir
+#define threadjob ThreadJob
+#define threadjob_lcreate ThreadJob_lcreate
+#define lt Lt
+#define threadmutex ThreadMutex
+#define threadmutex_set ThreadMutex_set
+#define httpserver_getmutex HttpServer_getMutex
+#define threadmutex_release ThreadMutex_release
+#define xedgeinitdiskio xedgeInitDiskIo
+#define batime BaTime
+#define baparsedate baParseDate
+#define bagetunixtime baGetUnixTime
+#define thread_sleep Thread_sleep
+#define bafatalerrorcodes BaFatalErrorCodes
+#define setdispexit setDispExit
+#define xedgeopenaux xedgeOpenAUX
+#define xedgeopenauxt XedgeOpenAUX
+#define httptrace_setflushcallback HttpTrace_setFLushCallback
+#define httpserver_seterrhnd HttpServer_setErrHnd
+
 /***************************************************************************
  * Private Data
  ***************************************************************************/
 
-static int running; /* Server running mode */
+static int running = FALSE; /* Running mode: 2 running, 1 exiting, 0 stopped */
 
 /* BAS is configured to use dlmalloc for NuttX. This is the pool.
  * 2M : recommended minimum
@@ -72,7 +107,7 @@ static int running; /* Server running mode */
 
 static char poolbuf[2 * 1024 * 1024];
 
-extern LThreadMgr ltMgr; /* The LThreadMgr configured in xedge.c */
+extern lthreadmgr ltmgr; /* The LThreadMgr configured in xedge.c */
 
 /***************************************************************************
  * External Function Prototypes
@@ -82,7 +117,7 @@ extern LThreadMgr ltMgr; /* The LThreadMgr configured in xedge.c */
 
 extern void barracuda(void);
 extern void init_dlmalloc(char *heapstart, char *heapend); /* dlmalloc.c */
-extern int (*platformInitDiskIo)(DiskIo *io);              /* xedge.c */
+extern int (*platforminitdiskio)(diskio *io);              /* xedge.c */
 
 /***************************************************************************
  * Private Functions
@@ -100,9 +135,9 @@ extern int (*platformInitDiskIo)(DiskIo *io);              /* xedge.c */
  * function is found, it will be executed as follows: _XedgeEvent("sntp")
  */
 
-static void execevent(ThreadJob *job, int msgh, LThreadMgr *mgr)
+static void execevent(threadjob *job, int msgh, lthreadmgr *mgr)
 {
-  lua_State *L = job->Lt;
+  lua_State *L = job->lt;
   lua_pushglobaltable(L);
   lua_getfield(L, -1, "_XedgeEvent");
 
@@ -115,9 +150,9 @@ static void execevent(ThreadJob *job, int msgh, LThreadMgr *mgr)
 
 /* Thread started by xedgeOpenAUX() */
 
-static void *checkTimeThread(void *arg)
+static void *checktimethread(void *arg)
 {
-  ThreadMutex *dm = HttpServer_getMutex(ltMgr.server);
+  threadmutex *dm = httpserver_getmutex(ltmgr.server);
   const char *d = __DATE__;
   char buf[50];
 
@@ -126,26 +161,26 @@ static void *checkTimeThread(void *arg)
   if (!(basnprintf(buf, sizeof(buf), "Mon, %c%c %c%c%c %s %s",
                    d[4], d[5], d[0], d[1], d[2], d + 7, __TIME__) < 0))
     {
-      BaTime t = baParseDate(buf);
+      batime t = baparsedate(buf);
       if (t)
         {
           t -= 24 * 60 * 60;
-          while (baGetUnixTime() < t)
+          while (bagetunixtime() < t)
             {
-              Thread_sleep(500);
+              thread_sleep(500);
             }
 
-          ThreadJob *job = ThreadJob_lcreate(sizeof(ThreadJob), execevent);
-          ThreadMutex_set(dm);
-          LThreadMgr_run(&ltMgr, job);
-          ThreadMutex_release(dm);
+          threadjob *job = threadjob_lcreate(sizeof(threadjob), execevent);
+          threadmutex_set(dm);
+          lthreadmgr_run(&ltmgr, job);
+          threadmutex_release(dm);
         }
     }
 
   return NULL;
 }
 
-static void panic(BaFatalErrorCodes ecode1,
+static void panic(bafatalerrorcodes ecode1,
                          unsigned int ecode2,
                          const char *file,
                          int line)
@@ -159,9 +194,9 @@ static void panic(BaFatalErrorCodes ecode1,
  * https://realtimelogic.com/ba/doc/en/C/reference/html/structHttpTrace.html
  */
 
-static void flushtrace(char *buf, int bufLen)
+static void flushtrace(char *buf, int buflen)
 {
-  buf[bufLen] = 0;
+  buf[buflen] = 0;
   syslog(LOG_INFO, "%s", buf);
 }
 
@@ -170,11 +205,11 @@ static void sighandler(int signo)
   if (running)
     {
       printf("\nGot SIGTERM; exiting...\n");
-      setDispExit();
+      setdispexit();
 
       /* NuttX feature: Must wait for socket select() to return */
 
-      Thread_sleep(2000);
+      thread_sleep(2000);
     }
 }
 
@@ -186,9 +221,9 @@ static void sighandler(int signo)
  * Change "/mnt/lfs" to your preference.
  */
 
-int xedgeInitDiskIo(DiskIo *io)
+int xedgeinitdiskio(diskio *io)
 {
-  if (DiskIo_setRootDir(io, "/mnt/lfs"))
+  if (diskio_setrootdir(io, "/mnt/lfs"))
     {
       syslog(LOG_ERR, "Error: cannot set root to /mnt/lfs\n");
       return -1;
@@ -201,7 +236,7 @@ int xedgeInitDiskIo(DiskIo *io)
  * Tutorial: https://tutorial.realtimelogic.com/Lua-Bindings.lsp
  */
 
-int xedgeOpenAUX(XedgeOpenAUX *aux)
+int xedgeopenaux(xedgeopenauxt *aux)
 {
   pthread_t thread;
   pthread_attr_t attr;
@@ -213,20 +248,26 @@ int xedgeOpenAUX(XedgeOpenAUX *aux)
   pthread_attr_setstacksize(&attr, 4096);
   param.sched_priority = SCHED_PRIORITY_DEFAULT;
   pthread_attr_setschedparam(&attr, &param);
-  pthread_create(&thread, &attr, checkTimeThread, NULL);
+  pthread_create(&thread, &attr, checktimethread, NULL);
 
   return 0;
 }
 
 int main(int argc, FAR char *argv[])
 {
+  if (running)
+    {
+      printf("Already running!\n");
+      return 1;
+    }
+
   signal(SIGINT, sighandler);
   signal(SIGTERM, sighandler);
 
   ntpc_start();
   init_dlmalloc(poolbuf, poolbuf + sizeof(poolbuf));
-  HttpTrace_setFLushCallback(flushtrace);
-  HttpServer_setErrHnd(panic);
+  httptrace_setflushcallback(flushtrace);
+  httpserver_seterrhnd(panic);
 
   running = TRUE;
   barracuda();