update version

Add file upload functionality to the http-server example

.github/issue_template.md

@@ -10,3 +10,4 @@
 - Compiler/IDE and SDK: ZZZ version _X.Y_
 - Target hardware/board: _?_
 - Connectivity chip/module: _?_
+- Target RTOS/OS (if applicable): _?_

.github/workflows/cifuzz.yml

@@ -1,17 +1,27 @@
 name: CIFuzz
-on: [pull_request]
+on:
+  schedule:
+    - cron: '0 2 * * *' # run at 2 AM UTC
+  # Allow manual runs
+  workflow_dispatch:
+
 jobs:
   Fuzzing:
     runs-on: ubuntu-latest
     steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^src/' ; then echo GO=1 >> $GITHUB_ENV ; fi
     - name: Build Fuzzers
       id: build
+      if: ${{ env.GO == 1 }}
       uses: google/oss-fuzz/infra/cifuzz/actions/build_fuzzers@master
       with:
         oss-fuzz-project-name: 'mongoose'
         dry-run: false
         language: c++
     - name: Run Fuzzers
+      if: ${{ env.GO == 1 }}
       uses: google/oss-fuzz/infra/cifuzz/actions/run_fuzzers@master
       with:
         oss-fuzz-project-name: 'mongoose'
@@ -20,7 +30,7 @@ jobs:
         language: c++
     - name: Upload Crash
       uses: actions/upload-artifact@v1
-      if: failure() && steps.build.outcome == 'success'
+      if: env.GO == 1 && failure() && steps.build.outcome == 'success'
       with:
         name: artifacts
         path: ./out/artifacts

.github/workflows/codeql.yml

@@ -0,0 +1,32 @@
+name: "CodeQL Scanning"
+# https://github.com/github/codeql-action
+
+on:
+  schedule:
+    - cron: '30 2 * * *' # run at 2:30 AM UTC
+  # Allow manual runs
+  workflow_dispatch:
+
+env:
+  IPV6: 0
+jobs:
+  CodeQL-Build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+    permissions:
+      security-events: write
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v2
+      with:
+        languages: cpp
+    - run: |
+        make test CC=gcc ASAN= ASAN_OPTIONS=
+        ./test/setup_ga_network.sh && make mip_test CC=gcc ASAN= ASAN_OPTIONS=
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v2

.github/workflows/nightly.yml

@@ -0,0 +1,453 @@
+name: Full build and test
+on:
+  schedule:
+    - cron: '0 1 * * *' # run at 1 AM UTC
+  # Allow manual runs
+  workflow_dispatch:
+env:
+  IPV6: 0
+jobs:
+  linux:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        cc: [gcc, clang, g++, clang++]
+        target: [test, mip_test]
+        ssl: ["", MBEDTLS, OPENSSL]
+        select: ["-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0", "-DMG_ENABLE_POLL=1 -DMG_ENABLE_EPOLL=0", "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=1"]
+        exclude:
+        - ssl: MBEDTLS
+          select: "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0"
+        - ssl: MBEDTLS
+          select: "-DMG_ENABLE_POLL=1 -DMG_ENABLE_EPOLL=0"
+        - ssl: OPENSSL
+          select: "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0"
+        - ssl: OPENSSL
+          select: "-DMG_ENABLE_POLL=1 -DMG_ENABLE_EPOLL=0"
+    name: linux ${{ matrix.target }} CC=${{ matrix.cc }} SSL=${{ matrix.ssl }} TFLAGS=${{ matrix.select }}
+    env:
+      CC: ${{ matrix.cc }}
+      SSL: ${{ matrix.ssl }}
+      TFLAGS: ${{ matrix.select }}
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: ./test/setup_ga_network.sh && sudo apt -y update ; sudo apt -y install libmbedtls-dev && make ${{ matrix.target }}
+  s390:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install qemu binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make s390
+  armhf:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install qemu binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make armhf
+  linux2:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install libmbedtls-dev valgrind
+    - run: make unamalgamated && make valgrind && make mg_prefix
+  macos:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", MBEDTLS, OPENSSL]
+        select: [-DMG_ENABLE_POLL=0, -DMG_ENABLE_POLL=1]
+        exclude:
+        - ssl: MBEDTLS
+          select: -DMG_ENABLE_POLL=0
+        - ssl: OPENSSL
+          select: -DMG_ENABLE_POLL=0
+    name: macos SSL=${{ matrix.ssl }} TFLAGS=${{ matrix.select }}
+    env:
+      SSL: ${{ matrix.ssl }}
+      TFLAGS: ${{ matrix.select }} -DNO_SNTP_CHECK -Wno-sign-conversion # Workaround for MbedTLS 3.5.0
+      HOMEBREW_NO_AUTO_UPDATE: 1
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: brew install jq mbedtls openssl
+    - run:  make test ASAN_OPTIONS= MBEDTLS=`echo /usr/local/Cellar/mbedtls*/*` OPENSSL=`echo /usr/local/Cellar/openssl*/*`
+    - run: make mg_prefix
+  windows:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [vc98, vc17, vc22, mingw, mingw++]
+        select: [-DMG_ENABLE_POLL=0, -DMG_ENABLE_POLL=1]
+        exclude:
+        - target: vc98
+          select: -DMG_ENABLE_POLL=1
+    name: windows ${{ matrix.target }} TFLAGS=${{ matrix.select }}
+    env:
+      TFLAGS: ${{ matrix.select }}
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: make ${{ matrix.target }} 
+  arm:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: make arm
+  riscv:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: make riscv
+
+  examples:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: sudo apt -y install libmbedtls-dev libpcap-dev
+    - run: make examples
+    - run: make clean
+  examples_win:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v3
+#    - uses: egor-tensin/setup-mingw@v2
+#      with:
+#        platform: x64
+    - name: test they build
+      run: make examples_win
+      shell: cmd
+    - name: test they clean
+      run: make clean_examples_win
+      shell: cmd
+  examples_mac:
+    runs-on: macos-latest
+    env: { HOMEBREW_NO_AUTO_UPDATE: 1 }
+    steps:
+    - uses: actions/checkout@v3
+    - run: make examples_mac
+    - run: make clean_examples_mac
+
+
+  arduino:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: echo # nothing specific to install or do
+    - run: make -C examples/arduino arduino-xiao
+#   - run: make -C examples/arduino arduino-nano
+    - run: make -C examples/arduino clean
+
+
+  generic_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32/uart-bridge
+          - path: esp32/micropython
+          - path: esp8266/http-client-server
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: if ./test/match_changed_files.sh '^src|^examples/${{ matrix.example.path }}'; then echo GO=1 >> $GITHUB_ENV ; fi
+      - run: echo # nothing specific to install or do
+      - run: make -C examples/${{ matrix.example.path }} build
+  
+  generic_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: microchip/same54-xpro/mqtt-client
+          - path: infineon/infineon-xmc4700_4800-lwip-rtx-rtos
+          - path: nxp/nxp-mimxrt1020-azurertos
+          - path: nxp/nxp-frdmk66f-freertos
+          - path: nxp/nxp-lpcxpresso54s018m-freertos
+          - path: nxp/nxp-mimxrt1020-freertos
+          - path: nxp/nxp-evkbimxrt1050-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1020-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1024-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1060-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1064-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1160-cm7-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1170-cm7-lwip-freertos
+          - path: nxp/nxp-frdmk64f-lwip-freertos
+          - path: nxp/nxp-frdmk66f-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54018-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54608-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54618-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54628-lwip-freertos
+          - path: nxp/nxp-twrk65f180m-lwip-freertos
+          - path: nxp/nxp-twrkv58f220m-lwip-freertos
+          - path: rp2040/pico-rmii
+          - path: stm32/nucleo-f429zi-make-baremetal-builtin-rndis
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-rndis
+          - path: stm32/nucleo-g031-make-baremetal-builtin
+          - path: ti/ti-ek-tm4c1294xl-http-server
+          - path: ti/ek-tm4c1294xl-make-baremetal-builtin-rndis
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C examples/${{ matrix.example.path }} build
+
+  device_dashboard_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32/device-dashboard
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: echo # nothing specific to install or do
+      - run: make -C examples/${{ matrix.example.path }} build
+
+  device_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: microchip/same54-xpro/device-dashboard
+          - path: nxp/rt1020-evk-make-baremetal-builtin
+          - path: nxp/rt1020-evk-make-freertos-builtin
+          - path: nxp/rt1060-evk-make-baremetal-builtin
+          - path: nxp/rt1060-evk-make-freertos-builtin
+          - path: rp2040/pico-rndis-dashboard
+          - path: rp2040/pico-w
+          - path: rp2040/pico-w5500
+          - path: stm32/nucleo-f429zi-make-baremetal-builtin
+          - path: stm32/nucleo-f429zi-make-freertos-builtin
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin
+          - path: stm32/nucleo-f746zg-make-freertos-builtin
+          - path: stm32/nucleo-f746zg-make-freertos-tcp
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-cmsis_driver
+          - path: stm32/nucleo-h563zi-make-baremetal-builtin
+          - path: stm32/nucleo-h563zi-make-freertos-builtin
+          - path: stm32/nucleo-h723zg-make-freertos-builtin
+          - path: stm32/nucleo-h743zi-make-baremetal-builtin
+          - path: stm32/nucleo-h743zi-make-freertos-builtin
+          - path: stm32/stm32h573i-dk-make-baremetal-builtin
+          - path: stm32/stm32h573i-dk-make-freertos-builtin
+          - path: ti/ek-tm4c1294xl-make-baremetal-builtin
+          - path: ti/ek-tm4c1294xl-make-freertos-builtin
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C examples/${{ matrix.example.path }} build
+
+#  mqtt_dashboard_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    steps:
+#      - uses: actions/checkout@v3
+#        with: { fetch-depth: 2 }
+#      - run: echo # nothing specific to install or do
+#      - run: make -C examples/${{ matrix.example.path }} build
+      
+  mqtt_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: rp2040/pico-rndis-device
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C examples/${{ matrix.example.path }} build
+      
+#  dual_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    steps:
+#      - uses: actions/checkout@v3
+#        with: { fetch-depth: 2 }
+#      - run: echo # nothing specific to install or do
+#      - run: make -C examples/${{ matrix.example.path }} device_dashboard
+#      - run: make -C examples/${{ matrix.example.path }} mqtt_dashboard
+
+  dual_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: stm32/nucleo-h723zg-make-baremetal-builtin
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C examples/${{ matrix.example.path }} device_dashboard
+      - run: make -C examples/${{ matrix.example.path }} mqtt_dashboard
+
+  cube_examples:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: echo # nothing specific to install or do
+      - run: cd test/cube && make
+
+  zephyr_examples:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C examples/zephyr init
+      - name: minify manifest
+        uses: mikefarah/yq@master
+        with:
+          cmd: yq -i eval '(.manifest.defaults, .manifest.remotes, .manifest.projects[] | select(.name == "cmsis" or .name == "hal_stm32" or .name == "mbedtls" or .name == "mcuboot" or .name == "picolibc" | del(.null) ), .manifest.self) as $i ireduce({};setpath($i | path; $i)) | del(.manifest.projects.[].null) | del(..|select(length==0))' examples/zephyr/zephyrproject/zephyr/west.yml
+      - run: make -C examples/zephyr update
+      - run: make -C examples/zephyr/device-dashboard build
+      - run: make -C examples/zephyr/http-client build
+      - run: make -C examples/zephyr/http-server build
+      - run: make -C examples/zephyr/mqtt-aws-client build
+      - run: make -C examples/zephyr/websocket-server build
+
+  test_f7:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/stm32/nucleo-f746zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/stm32/nucleo-f746zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/stm32/nucleo-f746zg-make-freertos-tcp test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - name: Cube
+      run: echo # nothing specific to install or do
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5    
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-freertos-lwip VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+
+  test_f4:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/stm32/nucleo-f429zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/stm32/nucleo-f429zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - name: Cube
+      run: echo # nothing specific to install or do
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-freertos-lwip VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+
+  test_h743:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/stm32/nucleo-h743zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/stm32/nucleo-h743zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - name: Cube
+      run: echo # nothing specific to install or do
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-h743zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+    - run: make -C test/cube test PROJECTS=../../examples/stm32/nucleo-h743zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+
+  test_h723:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/stm32/nucleo-h723zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/stm32/nucleo-h723zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    
+  test_h5:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/stm32/nucleo-h563zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/stm32/nucleo-h563zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_rt1020:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/nxp/rt1020-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/nxp/rt1020-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_rt1060:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C examples/nxp/rt1060-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C examples/nxp/rt1060-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_tm4c:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run:  make -C examples/ti/ek-tm4c1294xl-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run:  make -C examples/ti/ek-tm4c1294xl-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_same54:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run:  make -C examples/microchip/same54-xpro/device-dashboard test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run:  make -C examples/microchip/same54-xpro/mqtt-client test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_pico_w5500:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: SDK
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run:  make -C examples/rp2040/pico-w5500 test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+

.github/workflows/quicktest.yml

@@ -0,0 +1,674 @@
+name: Build and test - essentials
+on:
+  push:
+    paths:
+      - "**Makefile"
+      - "**.c"
+      - "**.h"
+env:
+  IPV6: 0
+jobs:
+  linux:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        cc: [gcc, clang++]
+        target: [test, mip_test]
+        ssl: ["", MBEDTLS]
+    name: linux ${{ matrix.target }} CC=${{ matrix.cc }} SSL=${{ matrix.ssl }}}
+    env:
+      CC: ${{ matrix.cc }}
+      SSL: ${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: ./test/setup_ga_network.sh && sudo apt -y update ; sudo apt -y install libmbedtls-dev && make ${{ matrix.target }}
+  s390:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: sudo apt -y update ; sudo apt -y install qemu binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make s390
+  armhf:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: sudo apt -y update ; sudo apt -y install qemu binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make armhf
+  linux2:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: sudo apt -y update ; sudo apt -y install libmbedtls-dev valgrind
+    - if: ${{ env.GO == 1 }}
+      run: make unamalgamated && make valgrind && make mg_prefix
+  macos:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", MBEDTLS]
+    name: macos SSL=${{ matrix.ssl }}
+    env:
+      SSL: ${{ matrix.ssl }}
+      TFLAGS: -DNO_SNTP_CHECK -Wno-sign-conversion # Workaround for MbedTLS 3.5.0
+      HOMEBREW_NO_AUTO_UPDATE: 1
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: brew install jq mbedtls openssl
+    - if: ${{ env.GO == 1 }}
+      run:  make test ASAN_OPTIONS= MBEDTLS=`echo /usr/local/Cellar/mbedtls*/*` OPENSSL=`echo /usr/local/Cellar/openssl*/*`
+    - if: ${{ env.GO == 1 }}
+      run: make mg_prefix
+  windows:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [vc98, vc22, mingw++]
+    name: windows ${{ matrix.target }}
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: make ${{ matrix.target }} 
+  arm:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: make arm
+  riscv:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: make riscv
+
+  examples:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: sudo apt -y install libmbedtls-dev libpcap-dev
+    - run: make examples
+    - run: make clean
+  examples_win:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v3
+#    - uses: egor-tensin/setup-mingw@v2
+#      with:
+#        platform: x64
+    - name: test they build
+      run: make examples_win
+      shell: cmd
+    - name: test they clean
+      run: make clean_examples_win
+      shell: cmd
+  examples_mac:
+    runs-on: macos-latest
+    env: { HOMEBREW_NO_AUTO_UPDATE: 1 }
+    steps:
+    - uses: actions/checkout@v3
+    - run: make examples_mac
+    - run: make clean_examples_mac
+
+
+  arduino:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/arduino" ; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/arduino'; then
+          make -C examples/arduino arduino-xiao
+        fi
+#    - if: ${{ env.GO == 1 }}
+#      run: |
+#        if ./test/match_changed_files.sh '^src|examples/arduino'; then
+#          make -C examples/arduino arduino-nano
+#        fi
+    - if: ${{ env.GO == 1 }}
+      run: make -C examples/arduino clean
+
+
+  generic_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32/uart-bridge
+          - path: esp8266/http-client-server
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: if ./test/match_changed_files.sh '^src|^examples/${{ matrix.example.path }}'; then echo GO=1 >> $GITHUB_ENV ; fi
+      - if: ${{ env.GO == 1 }}
+        run: |
+          # nothing specific to install or do
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+  
+  generic_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: infineon/infineon-xmc4700_4800-lwip-rtx-rtos
+          - path: stm32/nucleo-g031-make-baremetal-builtin
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: if ./test/match_changed_files.sh '^src|^examples/${{ matrix.example.path }}'; then echo GO=1 >> $GITHUB_ENV ; fi
+      - if: ${{ env.GO == 1 }}
+        run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+
+  device_dashboard_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32/device-dashboard
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            # nothing specific to install or do
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+
+  device_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: microchip/same54-xpro/device-dashboard
+          - path: nxp/rt1020-evk-make-baremetal-builtin
+          - path: nxp/rt1020-evk-make-freertos-builtin
+          - path: nxp/rt1060-evk-make-baremetal-builtin
+          - path: nxp/rt1060-evk-make-freertos-builtin
+          - path: rp2040/pico-rndis-dashboard
+          - path: rp2040/pico-w
+          - path: rp2040/pico-w5500
+          - path: stm32/nucleo-f429zi-make-baremetal-builtin
+          - path: stm32/nucleo-f429zi-make-freertos-builtin
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin
+          - path: stm32/nucleo-f746zg-make-freertos-builtin
+          - path: stm32/nucleo-f746zg-make-freertos-tcp
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-cmsis_driver
+          - path: stm32/nucleo-h563zi-make-baremetal-builtin
+          - path: stm32/nucleo-h563zi-make-freertos-builtin
+          - path: stm32/nucleo-h723zg-make-freertos-builtin
+          - path: stm32/nucleo-h743zi-make-baremetal-builtin
+          - path: stm32/nucleo-h743zi-make-freertos-builtin
+          - path: stm32/stm32h573i-dk-make-baremetal-builtin
+          - path: stm32/stm32h573i-dk-make-freertos-builtin
+          - path: ti/ek-tm4c1294xl-make-baremetal-builtin
+          - path: ti/ek-tm4c1294xl-make-freertos-builtin
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+
+#  mqtt_dashboard_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    env:
+#      GO: 0
+#    steps:
+#      - uses: actions/checkout@v3
+#        with: { fetch-depth: 2 }
+#      - run: |
+#          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+#            echo GO=1 >> $GITHUB_ENV
+#            # nothing specific to install or do
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: make -C examples/${{ matrix.example.path }} build
+      
+  mqtt_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: rp2040/pico-rndis-device
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+      
+#  dual_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    env:
+#      GO: 0
+#    steps:
+#      - uses: actions/checkout@v3
+#        with: { fetch-depth: 2 }
+#      - run: |
+#          if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+#            echo GO=1 >> $GITHUB_ENV
+#            # nothing specific to install or do
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: |
+#          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+#            make -C examples/${{ matrix.example.path }} device_dashboard
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: |
+#          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+#            make -C examples/${{ matrix.example.path }} mqtt_dashboard
+#          fi
+
+  dual_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: stm32/nucleo-h723zg-make-baremetal-builtin
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+            make -C examples/${{ matrix.example.path }} device_dashboard
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: |
+          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+            make -C examples/${{ matrix.example.path }} mqtt_dashboard
+          fi
+
+  cube_examples:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/stm32/nucleo-*-cube-*'; then
+            echo GO=1 >> $GITHUB_ENV
+            # nothing specific to install or do
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: cd test/cube && make
+
+  test_f7:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32|examples/nxp|examples/ti|examples/microchip/same" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    # always run baremetal on core or dashboard or specific example changes; other examples only on specific example changes
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-f746zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f746zg-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-f746zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f746zg-make-freertos-tcp'; then
+          make -C examples/stm32/nucleo-f746zg-make-freertos-tcp test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - name: Cube
+      run: |
+        echo GO=0 >> $GITHUB_ENV
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f7.*-cube-'; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f746zg-cube-baremetal-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f746zg-cube-freertos-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5    
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f746zg-cube-freertos-lwip'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-freertos-lwip VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+        fi
+
+
+  test_f4:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-f4.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f429zi-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-f429zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f429zi-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-f429zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - name: Cube
+      run: |
+        echo GO=0 >> $GITHUB_ENV
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f4.*-cube-'; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f429zi-cube-baremetal-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f429zi-cube-freertos-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-f429zi-cube-freertos-lwip'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-freertos-lwip VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+        fi
+
+  test_h743:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-h74.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h743zi-make-baremetal-builtin'; then
+        make -C examples/stm32/nucleo-h743zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-h743zi-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-h743zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - name: Cube
+      run: |
+        echo GO=0 >> $GITHUB_ENV
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-h74.*-cube-'; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-h743zi-cube-baremetal-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-h743zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-h743zi-cube-freertos-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-h743zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+        fi
+
+  test_h723:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-h72.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h723zg-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-h723zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-h723zg-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-h723zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    
+  test_h5:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-h5.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h563zi-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-h563zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/stm32/nucleo-h563zi-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-h563zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_rt1020:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/nxp/rt1020.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/nxp/rt1020-evk-make-baremetal-builtin'; then
+          make -C examples/nxp/rt1020-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/nxp/rt1020-evk-make-freertos-builtin'; then
+          make -C examples/nxp/rt1020-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_rt1060:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/nxp/rt1060.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/nxp/rt1060-evk-make-baremetal-builtin'; then
+          make -C examples/nxp/rt1060-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/nxp/rt1060-evk-make-freertos-builtin'; then
+          make -C examples/nxp/rt1060-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_tm4c:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/ti/ek-tm4c.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/ti/ek-tm4c1294xl-make-baremetal-builtin'; then
+          make -C examples/ti/ek-tm4c1294xl-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/ti/ek-tm4c1294xl-make-freertos-builtin'; then
+          make -C examples/ti/ek-tm4c1294xl-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_same54:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/microchip/same54-xpro" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/microchip/same54-xpro/device-dashboard'; then
+          make -C examples/microchip/same54-xpro/device-dashboard test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'examples/microchip/same54-xpro/mqtt-client'; then
+          make -C examples/microchip/same54-xpro/mqtt-client test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_pico_w5500:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: SDK
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/rp2040/pico-w5500" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run:  make -C examples/rp2040/pico-w5500 test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+

.github/workflows/test.yml

@@ -1,135 +1,740 @@
-name: build
+name: original workflow, updated
-on: [push, pull_request]
+on:
+  workflow_dispatch:
+env:
+  IPV6: 0
 jobs:
   linux:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        cc: [gcc, clang]
+        cc: [gcc, clang, g++, clang++]
-        target: [test, test++, valgrind]
+        target: [test, mip_test]
-        ssl: [MBEDTLS, OPENSSL]
+        ssl: ["", MBEDTLS, OPENSSL]
-    name: linux ${{ matrix.target }} CC=${{ matrix.cc }} SSL=${{ matrix.ssl }}
+        select: ["-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0", "-DMG_ENABLE_POLL=1 -DMG_ENABLE_EPOLL=0", "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=1"]
+        exclude:
+        - ssl: MBEDTLS
+          select: "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0"
+        - ssl: MBEDTLS
+          select: "-DMG_ENABLE_POLL=1 -DMG_ENABLE_EPOLL=0"
+        - ssl: OPENSSL
+          select: "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0"
+        - ssl: OPENSSL
+          select: "-DMG_ENABLE_POLL=1 -DMG_ENABLE_EPOLL=0"
+    name: linux ${{ matrix.target }} CC=${{ matrix.cc }} SSL=${{ matrix.ssl }} TFLAGS=${{ matrix.select }}
     env:
-      IPV6: 0
       CC: ${{ matrix.cc }}
       SSL: ${{ matrix.ssl }}
+      TFLAGS: ${{ matrix.select }}
     steps:
     - uses: actions/checkout@v3
-    - name: Install packages
+      with: { fetch-depth: 2 }
-      run: sudo apt-get update ; sudo apt-get install libmbedtls-dev valgrind
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - name: test
+    - if: ${{ env.GO == 1 }}
-      run: make ${{ matrix.target }}
+      run: ./test/setup_ga_network.sh && sudo apt -y update ; sudo apt -y install libmbedtls-dev && make ${{ matrix.target }}
-    - name: unamalgamated
+  s390:
-      run: make unamalgamated
-  examples:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: Install packages
+      with: { fetch-depth: 2 }
-      run: sudo apt-get install libmbedtls-dev
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - name: examples
+    - if: ${{ env.GO == 1 }}
-      run: make clean examples
+      run: sudo apt -y update ; sudo apt -y install qemu binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make s390
-  macos:
+  armhf:
-    runs-on: macos-latest
+    runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: Install packages
+      with: { fetch-depth: 2 }
-      run: HOMEBREW_NO_AUTO_UPDATE=1 brew install jq mbedtls openssl
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - name: make
+    - if: ${{ env.GO == 1 }}
-      run: make test++ upload-coverage IPV6=0 ASAN_OPTIONS=
+      run: sudo apt -y update ; sudo apt -y install qemu binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make armhf
-    - name: openssl
+  linux2:
-      run: make test SSL=OPENSSL IPV6=0 ASAN_OPTIONS= OPENSSL=`echo /usr/local/Cellar/openssl*/*`
+    runs-on: ubuntu-latest
-    - name: exports
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: sudo apt -y update ; sudo apt -y install libmbedtls-dev valgrind
+    - if: ${{ env.GO == 1 }}
+      run: make unamalgamated && make valgrind && make mg_prefix
+  macos:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", MBEDTLS, OPENSSL]
+        select: [-DMG_ENABLE_POLL=0, -DMG_ENABLE_POLL=1]
+        exclude:
+        - ssl: MBEDTLS
+          select: -DMG_ENABLE_POLL=0
+        - ssl: OPENSSL
+          select: -DMG_ENABLE_POLL=0
+    name: macos SSL=${{ matrix.ssl }} TFLAGS=${{ matrix.select }}
+    env:
+      SSL: ${{ matrix.ssl }}
+      TFLAGS: ${{ matrix.select }} -DNO_SNTP_CHECK -Wno-sign-conversion # Workaround for MbedTLS 3.5.0
+      HOMEBREW_NO_AUTO_UPDATE: 1
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
+    - if: ${{ env.GO == 1 }}
+      run: brew install jq mbedtls openssl
+    - if: ${{ env.GO == 1 }}
+      run:  make test ASAN_OPTIONS= MBEDTLS=`echo /usr/local/Cellar/mbedtls*/*` OPENSSL=`echo /usr/local/Cellar/openssl*/*`
+    - if: ${{ env.GO == 1 }}
       run: make mg_prefix
   windows:
     runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [vc98, vc17, vc22, mingw, mingw++]
+        select: [-DMG_ENABLE_POLL=0, -DMG_ENABLE_POLL=1]
+        exclude:
+        - target: vc98
+          select: -DMG_ENABLE_POLL=1
+    name: windows ${{ matrix.target }} TFLAGS=${{ matrix.select }}
+    env:
+      TFLAGS: ${{ matrix.select }}
     steps:
     - uses: actions/checkout@v3
-    - name: vc98
+      with: { fetch-depth: 2 }
-      run: make vc98
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - name: vc2017
+    - if: ${{ env.GO == 1 }}
-      run: make vc2017
+      run: make ${{ matrix.target }} 
-    - name: mingw
-      run: make mingw
-    - name: mingw++
-      run: make mingw++
   arm:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: arm
+    - run: make arm
-      run: make arm
+  riscv:
-  matrix_examples:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: make riscv
+
+  examples:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - run: sudo apt -y install libmbedtls-dev libpcap-dev
+    - run: make examples
+    - run: make clean
+  examples_win:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v3
+#    - uses: egor-tensin/setup-mingw@v2
+#      with:
+#        platform: x64
+    - name: test they build
+      run: make examples_win
+      shell: cmd
+    - name: test they clean
+      run: make clean_examples_win
+      shell: cmd
+  examples_mac:
+    runs-on: macos-latest
+    env: { HOMEBREW_NO_AUTO_UPDATE: 1 }
+    steps:
+    - uses: actions/checkout@v3
+    - run: make examples_mac
+    - run: make clean_examples_mac
+
+
+  arduino:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/arduino" ; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/arduino'; then
+          make -C examples/arduino arduino-xiao
+        fi
+#    - if: ${{ env.GO == 1 }}
+#      run: |
+#        if ./test/match_changed_files.sh '^src|examples/arduino'; then
+#          make -C examples/arduino arduino-nano
+#        fi
+    - if: ${{ env.GO == 1 }}
+      run: make -C examples/arduino clean
+
+
+  generic_examples:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
         example:
-          - name: esp32
+          - path: esp32/uart-bridge
-            path: esp32
+          - path: esp32/micropython
-          - name: esp8266
+          - path: esp8266/http-client-server
-            path: esp8266
+    name: ${{ matrix.example.path }}
-          - name: stm32-freertos-tcp
+    env:
-            path: stm32/stm32-freertos-tcp
+      GO: 0
-          - name: stm32-nucleo-f746z
-            path: stm32/stm32-nucleo-f746z
-          - name: stm32-nucleo-f429z
-            path: stm32/stm32-nucleo-f429z
-          - name: stm32-nucleo-h743z
-            path: stm32/stm32-nucleo-h743z
-          - name: nxp-mimxrt1020-azurertos
-            path: nxp/nxp-mimxrt1020-azurertos
-          - name: nxp-frdmk66f-freertos
-            path: nxp/nxp-frdmk66f-freertos
-          - name: nxp-lpcxpresso54s018m-freertos
-            path: nxp/nxp-lpcxpresso54s018m-freertos
-          - name: nxp-mimxrt1020-freertos
-            path: nxp/nxp-mimxrt1020-freertos
-          - name: nxp-evkbimxrt1050-lwip-freertos
-            path: nxp/nxp-evkbimxrt1050-lwip-freertos
-          - name: nxp-evkmimxrt1020-lwip-freertos
-            path: nxp/nxp-evkmimxrt1020-lwip-freertos
-          - name: nxp-evkmimxrt1024-lwip-freertos
-            path: nxp/nxp-evkmimxrt1024-lwip-freertos
-          - name: nxp-evkmimxrt1060-lwip-freertos
-            path: nxp/nxp-evkmimxrt1060-lwip-freertos
-          - name: nxp-evkmimxrt1064-lwip-freertos
-            path: nxp/nxp-evkmimxrt1064-lwip-freertos
-          - name: nxp-evkmimxrt1160-cm7-lwip-freertos
-            path: nxp/nxp-evkmimxrt1160-cm7-lwip-freertos
-          - name: nxp-evkmimxrt1170-cm7-lwip-freertos
-            path: nxp/nxp-evkmimxrt1170-cm7-lwip-freertos
-          - name: nxp-frdmk64f-lwip-freertos
-            path: nxp/nxp-frdmk64f-lwip-freertos
-          - name: nxp-frdmk66f-lwip-freertos
-            path: nxp/nxp-frdmk66f-lwip-freertos
-          - name: nxp-lpcxpresso54018-lwip-freertos
-            path: nxp/nxp-lpcxpresso54018-lwip-freertos
-          - name: nxp-lpcxpresso54608-lwip-freertos
-            path: nxp/nxp-lpcxpresso54608-lwip-freertos
-          - name: nxp-lpcxpresso54618-lwip-freertos
-            path: nxp/nxp-lpcxpresso54618-lwip-freertos
-          - name: nxp-lpcxpresso54628-lwip-freertos
-            path: nxp/nxp-lpcxpresso54628-lwip-freertos
-          - name: nxp-twrk65f180m-lwip-freertos
-            path: nxp/nxp-twrk65f180m-lwip-freertos
-          - name: nxp-twrkv58f220m-lwip-freertos
-            path: nxp/nxp-twrkv58f220m-lwip-freertos
-          - name: infineon-xmc4700_4800-lwip-rtx-rtos
-            path: infineon/infineon-xmc4700_4800-lwip-rtx-rtos
-          - name: ti
-            path: ti/ti-ek-tm4c1294xl-http-server
-          - name: nucleo_f746zg-zephyr-http-client
-            path: zephyr/http-client
-          - name: nucleo_f746zg-zephyr-http-server
-            path: zephyr/http-server
-          - name: nucleo_f746zg-zephyr-mqtt-aws-client
-            path: zephyr/mqtt-aws-client
-          - name: nucleo_f746zg-zephyr-websocket-server
-            path: zephyr/websocket-server             
-    name: ${{ matrix.example.name }}
     steps:
       - uses: actions/checkout@v3
-      - name: ${{ matrix.example.name }}
+        with: { fetch-depth: 2 }
-        run: make -C examples/${{ matrix.example.path }} build
+      - run: if ./test/match_changed_files.sh '^src|^examples/${{ matrix.example.path }}'; then echo GO=1 >> $GITHUB_ENV ; fi
+      - if: ${{ env.GO == 1 }}
+        run: |
+          # nothing specific to install or do
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+  
+  generic_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: microchip/same54-xpro/mqtt-client
+          - path: infineon/infineon-xmc4700_4800-lwip-rtx-rtos
+          - path: nxp/nxp-mimxrt1020-azurertos
+          - path: nxp/nxp-frdmk66f-freertos
+          - path: nxp/nxp-lpcxpresso54s018m-freertos
+          - path: nxp/nxp-mimxrt1020-freertos
+          - path: nxp/nxp-evkbimxrt1050-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1020-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1024-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1060-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1064-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1160-cm7-lwip-freertos
+          - path: nxp/nxp-evkmimxrt1170-cm7-lwip-freertos
+          - path: nxp/nxp-frdmk64f-lwip-freertos
+          - path: nxp/nxp-frdmk66f-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54018-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54608-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54618-lwip-freertos
+          - path: nxp/nxp-lpcxpresso54628-lwip-freertos
+          - path: nxp/nxp-twrk65f180m-lwip-freertos
+          - path: nxp/nxp-twrkv58f220m-lwip-freertos
+          - path: rp2040/pico-rmii
+          - path: stm32/nucleo-f429zi-make-baremetal-builtin-rndis
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-rndis
+          - path: stm32/nucleo-g031-make-baremetal-builtin
+          - path: ti/ti-ek-tm4c1294xl-http-server
+          - path: ti/ek-tm4c1294xl-make-baremetal-builtin-rndis
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: if ./test/match_changed_files.sh '^src|^examples/${{ matrix.example.path }}'; then echo GO=1 >> $GITHUB_ENV ; fi
+      - if: ${{ env.GO == 1 }}
+        run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+
+  device_dashboard_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32/device-dashboard
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            # nothing specific to install or do
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+
+  device_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: microchip/same54-xpro/device-dashboard
+          - path: nxp/rt1020-evk-make-baremetal-builtin
+          - path: nxp/rt1020-evk-make-freertos-builtin
+          - path: nxp/rt1060-evk-make-baremetal-builtin
+          - path: nxp/rt1060-evk-make-freertos-builtin
+          - path: rp2040/pico-rndis-dashboard
+          - path: rp2040/pico-w
+          - path: rp2040/pico-w5500
+          - path: stm32/nucleo-f429zi-make-baremetal-builtin
+          - path: stm32/nucleo-f429zi-make-freertos-builtin
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin
+          - path: stm32/nucleo-f746zg-make-freertos-builtin
+          - path: stm32/nucleo-f746zg-make-freertos-tcp
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-cmsis_driver
+          - path: stm32/nucleo-h563zi-make-baremetal-builtin
+          - path: stm32/nucleo-h563zi-make-freertos-builtin
+          - path: stm32/nucleo-h723zg-make-freertos-builtin
+          - path: stm32/nucleo-h743zi-make-baremetal-builtin
+          - path: stm32/nucleo-h743zi-make-freertos-builtin
+          - path: stm32/stm32h573i-dk-make-baremetal-builtin
+          - path: stm32/stm32h573i-dk-make-freertos-builtin
+          - path: ti/ek-tm4c1294xl-make-baremetal-builtin
+          - path: ti/ek-tm4c1294xl-make-freertos-builtin
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+
+#  mqtt_dashboard_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    env:
+#      GO: 0
+#    steps:
+#      - uses: actions/checkout@v3
+#        with: { fetch-depth: 2 }
+#      - run: |
+#          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+#            echo GO=1 >> $GITHUB_ENV
+#            # nothing specific to install or do
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: make -C examples/${{ matrix.example.path }} build
+      
+  mqtt_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: rp2040/pico-rndis-device
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/${{ matrix.example.path }} build
+      
+#  dual_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    env:
+#      GO: 0
+#    steps:
+#      - uses: actions/checkout@v3
+#        with: { fetch-depth: 2 }
+#      - run: |
+#          if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+#            echo GO=1 >> $GITHUB_ENV
+#            # nothing specific to install or do
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: |
+#          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+#            make -C examples/${{ matrix.example.path }} device_dashboard
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: |
+#          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+#            make -C examples/${{ matrix.example.path }} mqtt_dashboard
+#          fi
+
+  dual_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: stm32/nucleo-h723zg-make-baremetal-builtin
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: |
+          if ./test/match_changed_files.sh '^src|examples/device-dashboard|^examples/${{ matrix.example.path }}'; then
+            make -C examples/${{ matrix.example.path }} device_dashboard
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: |
+          if ./test/match_changed_files.sh '^src|examples/mqtt-dashboard/device|^examples/${{ matrix.example.path }}'; then
+            make -C examples/${{ matrix.example.path }} mqtt_dashboard
+          fi
+
+  cube_examples:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|examples/stm32/nucleo-*-cube-*'; then
+            echo GO=1 >> $GITHUB_ENV
+            # nothing specific to install or do
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: cd test/cube && make
+
+  zephyr_examples:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v3
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src/.*.[ch]|^examples/zephyr'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+            fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr init
+      - name: minify manifest
+        if: ${{ env.GO == 1 }}
+        uses: mikefarah/yq@master
+        with:
+          cmd: yq -i eval '(.manifest.defaults, .manifest.remotes, .manifest.projects[] | select(.name == "cmsis" or .name == "hal_stm32" or .name == "mbedtls" or .name == "mcuboot" or .name == "picolibc" | del(.null) ), .manifest.self) as $i ireduce({};setpath($i | path; $i)) | del(.manifest.projects.[].null) | del(..|select(length==0))' examples/zephyr/zephyrproject/zephyr/west.yml
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr update
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr/device-dashboard build
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr/http-client build
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr/http-server build
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr/mqtt-aws-client build
+      - if: ${{ env.GO == 1 }}
+        run: make -C examples/zephyr/websocket-server build
+
+  test_f7:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-f7.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-f746zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-f746zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-make-freertos-tcp'; then
+          make -C examples/stm32/nucleo-f746zg-make-freertos-tcp test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - name: Cube
+      run: |
+        echo GO=0 >> $GITHUB_ENV
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f7.*-cube-'; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-cube-baremetal-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-cube-freertos-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5    
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f746zg-cube-freertos-lwip'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f746zg-cube-freertos-lwip VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+        fi
+
+
+  test_f4:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-f4.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f429zi-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-f429zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f429zi-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-f429zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - name: Cube
+      run: |
+        echo GO=0 >> $GITHUB_ENV
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f4.*-cube-'; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f429zi-cube-baremetal-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f429zi-cube-freertos-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-f429zi-cube-freertos-lwip'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-f429zi-cube-freertos-lwip VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+        fi
+
+  test_h743:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-h74.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h743zi-make-baremetal-builtin'; then
+        make -C examples/stm32/nucleo-h743zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h743zi-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-h743zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - name: Cube
+      run: |
+        echo GO=0 >> $GITHUB_ENV
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h74.*-cube-'; then
+          echo GO=1 >> $GITHUB_ENV
+          # nothing specific to install or do
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h743zi-cube-baremetal-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-h743zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h743zi-cube-freertos-builtin'; then
+          make -C test/cube test PROJECTS=../../examples/stm32/nucleo-h743zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+        fi
+
+  test_h723:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-h72.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h723zg-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-h723zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h723zg-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-h723zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    
+  test_h5:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/stm32/nucleo-h5.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h563zi-make-baremetal-builtin'; then
+          make -C examples/stm32/nucleo-h563zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/stm32/nucleo-h563zi-make-freertos-builtin'; then
+          make -C examples/stm32/nucleo-h563zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_rt1020:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/nxp/rt1020.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        #if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/nxp/rt1020-evk-make-baremetal-builtin'; then
+        if ./test/match_changed_files.sh '^src|examples/nxp/rt1020-evk-make-baremetal-builtin'; then
+          make -C examples/nxp/rt1020-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        #if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/nxp/rt1020-evk-make-freertos-builtin'; then
+        if ./test/match_changed_files.sh '^src|examples/nxp/rt1020-evk-make-freertos-builtin'; then
+          make -C examples/nxp/rt1020-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_rt1060:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/nxp/rt1060.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/nxp/rt1060-evk-make-baremetal-builtin'; then
+          make -C examples/nxp/rt1060-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|examples/device-dashboard|examples/nxp/rt1060-evk-make-freertos-builtin'; then
+          make -C examples/nxp/rt1060-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_tm4c:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/ti/ek-tm4c.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run:  make -C examples/ti/ek-tm4c1294xl-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - if: ${{ env.GO == 1 }}
+      run:  make -C examples/ti/ek-tm4c1294xl-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_same54:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/microchip/same54-xpro" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run:  make -C examples/microchip/same54-xpro/device-dashboard test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - if: ${{ env.GO == 1 }}
+      run:  make -C examples/microchip/same54-xpro/mqtt-client test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_pico_w5500:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v3
+      with: { fetch-depth: 2 }
+    - name: SDK
+      run: |
+        if ./test/match_changed_files.sh "^src|examples/device-dashboard|examples/rp2040/pico-w5500" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      run:  make -C examples/rp2040/pico-w5500 test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+

LICENSE

@@ -1,5 +1,5 @@
 Copyright (c) 2004-2013 Sergey Lyubka
-Copyright (c) 2013-2021 Cesanta Software Limited
+Copyright (c) 2013-2023 Cesanta Software Limited
 All rights reserved
 
 This software is dual-licensed: you can redistribute it and/or modify

Makefile

@@ -1,89 +1,114 @@
 SRCS = mongoose.c test/unit_test.c test/packed_fs.c
-HDRS = $(wildcard src/*.h)
+HDRS = $(wildcard src/*.h) $(wildcard src/drivers/*.h)
-DEFS ?= -DMG_MAX_HTTP_HEADERS=7 -DMG_ENABLE_LINES -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_SSI=1
+DEFS ?= -DMG_MAX_HTTP_HEADERS=7 -DMG_ENABLE_LINES -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_SSI=1 -DMG_ENABLE_ASSERT=1
-C_WARN ?= -Wmissing-prototypes -Wstrict-prototypes
+WARN ?= -pedantic -W -Wall -Werror -Wshadow -Wdouble-promotion -fno-common -Wconversion -Wundef
-WARN ?= -W -Wall -Werror -Wshadow -Wdouble-promotion -fno-common -Wconversion -Wundef $(C_WARN)
 OPTS ?= -O3 -g3
-VALGRIND_OPTS ?= -O0 -g3
 INCS ?= -Isrc -I.
-SSL ?= MBEDTLS
+SSL ?=
 CWD ?= $(realpath $(CURDIR))
-DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(CWD):$(CWD) -w $(CWD)
+ENV ?=  -e Tmp=. -e WINEDEBUG=-all
-VCFLAGS = /nologo /W3 /O2 /I. $(DEFS) $(TFLAGS)
+DOCKER_BIN ?= docker
+DOCKER ?= $(DOCKER_BIN) run --platform linux/amd64 --rm $(ENV) -v $(CWD):$(CWD) -w $(CWD)
+VCFLAGS = /nologo /W3 /O2 /MD /I. $(DEFS) $(TFLAGS)
 IPV6 ?= 1
-ASAN ?= -fsanitize=address,undefined -fno-sanitize-recover=all
+ASAN ?= -fsanitize=address,undefined,alignment -fno-sanitize-recover=all -fno-omit-frame-pointer -fno-common
 ASAN_OPTIONS ?= detect_leaks=1
 EXAMPLES := $(dir $(wildcard examples/*/Makefile))
+EXAMPLES_MAC := $(filter-out examples/mip-pcap/ examples/mip-tap/ examples/micropython/, $(EXAMPLES))
+EXAMPLES_WIN := $(dir $(wildcard examples/device-dashboard/Makefile) $(wildcard examples/file-*/Makefile) $(wildcard examples/http-*/Makefile) $(wildcard examples/mqtt-*/Makefile) $(wildcard examples/websocket-*/Makefile) $(wildcard examples/webui-*/Makefile))
+EXAMPLES_EMBEDDED := $(filter-out $(wildcard examples/zephyr/*/), $(dir $(wildcard examples/*/*/Makefile)))
 PREFIX ?= /usr/local
+LIBDIR ?= $(PREFIX)/lib
+INCLUDEDIR ?= $(PREFIX)/include
 VERSION ?= $(shell cut -d'"' -f2 src/version.h)
-COMMON_CFLAGS ?= $(WARN) $(INCS) $(DEFS) -DMG_ENABLE_IPV6=$(IPV6) $(TFLAGS) $(EXTRA)
+COMMON_CFLAGS ?= $(C_WARN) $(WARN) $(INCS) $(DEFS) -DMG_ENABLE_IPV6=$(IPV6) $(TFLAGS) -pthread
 CFLAGS ?= $(OPTS) $(ASAN) $(COMMON_CFLAGS)
-VALGRIND_CFLAGS ?= $(VALGRIND_OPTS) $(COMMON_CFLAGS)
+VALGRIND_CFLAGS ?= $(OPTS) $(COMMON_CFLAGS)
-VALGRIND_RUN ?= valgrind --tool=memcheck --gen-suppressions=all --leak-check=full --show-leak-kinds=all --leak-resolution=high --track-origins=yes --error-exitcode=1 --exit-on-first-error=yes
+VALGRIND_RUN ?= valgrind --tool=memcheck --gen-suppressions=all --leak-check=full --show-leak-kinds=all --leak-resolution=high --track-origins=yes --error-exitcode=1 --exit-on-first-error=yes --fair-sched=yes
-.PHONY: examples test valgrind
+.PHONY: clean_examples examples mip_test test valgrind
+
+ifeq "$(findstring ++,$(CC))" ""
+# $(CC) does not end with ++, i.e. we're using C. Apply C flags
+C_WARN ?= -Wmissing-prototypes -Wstrict-prototypes
+else
+# $(CC) ends with ++, i.e. we're using C++. Apply C++ flags
+C_WARN ?= -Wno-deprecated
+endif
 
 ifeq "$(SSL)" "MBEDTLS"
 MBEDTLS ?= /usr/local
-CFLAGS  += -DMG_ENABLE_MBEDTLS=1 -I$(MBEDTLS)/include -I/usr/include
+CFLAGS  += -DMG_TLS=MG_TLS_MBED -I$(MBEDTLS)/include -I/usr/include
-LDFLAGS ?= -L$(MBEDTLS)/lib -lmbedtls -lmbedcrypto -lmbedx509
+LDFLAGS += -L$(MBEDTLS)/lib -lmbedtls -lmbedcrypto -lmbedx509
-endif
-ifeq "$(SSL)" "OPENSSL"
-OPENSSL ?= /usr/local
-CFLAGS  += -DMG_ENABLE_OPENSSL=1 -I$(OPENSSL)/include
-LDFLAGS ?= -L$(OPENSSL)/lib -lssl -lcrypto
 endif
 
-all: mg_prefix unamalgamated unpacked test test++ valgrind arm examples vc98 vc2017 mingw mingw++ linux linux++ fuzz
+ifeq "$(SSL)" "OPENSSL"
+OPENSSL ?= /usr/local
+CFLAGS  += -DMG_TLS=MG_TLS_OPENSSL -I$(OPENSSL)/include
+LDFLAGS += -L$(OPENSSL)/lib -lssl -lcrypto
+endif
+
+all:
+	$(MAKE) -C examples/http-server
+
+tall: mg_prefix unamalgamated test mip_test arm examples vc98 vc17 vc22 mingw mingw++ fuzz
+
+mip_test: test/mip_test.c mongoose.c mongoose.h Makefile mip_tap_test
+	$(CC) test/mip_test.c $(INCS) $(WARN) $(OPTS) $(C_WARN) $(ASAN) -o $@
+	ASAN_OPTIONS=$(ASAN_OPTIONS) $(RUN) ./$@
+
+mip_tap_test: test/mip_tap_test.c mongoose.c mongoose.h Makefile
+	$(CC) test/mip_tap_test.c $(INCS) $(WARN) $(OPTS) $(C_WARN) $(ASAN) -o $@
+	ASAN_OPTIONS=$(ASAN_OPTIONS) $(RUN) ./$@
 
 examples:
 	@for X in $(EXAMPLES); do test -f $$X/Makefile || continue; $(MAKE) -C $$X example || exit 1; done
+clean_examples:
+	for X in $(EXAMPLES); do test -f $$X/Makefile || continue; $(MAKE) -C $$X clean || exit 1; done
 
-test/packed_fs.c: Makefile src/ssi.h test/fuzz.c test/data/a.txt
+examples_mac:
-	$(CC) $(CFLAGS) test/pack.c -o pack
+	for X in $(EXAMPLES_MAC); do test -f $$X/Makefile || continue; $(MAKE) -C $$X example || exit 1; done
-	./pack Makefile src/ssi.h test/fuzz.c test/data/a.txt test/data/range.txt > $@
+clean_examples_mac:
+	for X in $(EXAMPLES_MAC); do test -f $$X/Makefile || continue; $(MAKE) -C $$X clean || exit 1; done
 
-DIR ?= test/data/
+examples_win:
-OUT ?= fs_packed.c
+	$(foreach X, $(EXAMPLES_WIN), $(MAKE) -C $(X) example &)
-mkfs:
+clean_examples_win:
+	$(foreach X, $(EXAMPLES_WIN), $(MAKE) -C $(X) clean &)
+
+test/packed_fs.c: Makefile src/ssi.h test/fuzz.c test/data/a.txt test/data/ca.pem
 	$(CC) $(CFLAGS) test/pack.c -o pack
-	./pack -s $(DIR) `find $(DIR) -type f` > $(OUT)
+	$(RUN) ./pack Makefile src/ssi.h test/fuzz.c test/data/a.txt test/data/range.txt test/data/ca.pem > $@
-#	find $(DIR) -type f | sed -e s,^$(DIR),,g -e s,^/,,g
 
 # Check that all external (exported) symbols have "mg_" prefix
 mg_prefix: mongoose.c mongoose.h
-	$(CC) mongoose.c $(CFLAGS) -c -o /tmp/x.o && nm /tmp/x.o | grep ' T' | grep -v 'mg_' ; test $$? = 1
+	$(CC) mongoose.c $(CFLAGS) -c -o /tmp/x.o && nm /tmp/x.o | grep ' T ' | grep -v 'mg_' ; test $$? = 1
-
-# C++ build
-test++: CC = g++
-test++: C_WARN =
-test++: WARN += -Wno-shadow -Wno-missing-field-initializers -Wno-deprecated
-test++: test
 
 musl: test
 musl: ASAN =
 musl: WARN += -Wno-sign-conversion
 musl: CC = $(DOCKER) mdashnet/cc1 gcc
+musl: RUN = $(DOCKER) mdashnet/cc1
 
-# Make sure we can build from an unamalgamated sources
+# Make sure we can build from unamalgamated sources.
+unamalgamated: CFLAGS += -DMG_ENABLE_MD5=1
 unamalgamated: $(HDRS) Makefile test/packed_fs.c
 	$(CC) src/*.c test/packed_fs.c test/unit_test.c $(CFLAGS) $(LDFLAGS) -g -o unit_test
 
-unpacked:
+fuzz: ASAN = -fsanitize=fuzzer,signed-integer-overflow,address,undefined
-	$(CC) -I. mongoose.c test/unit_test.c -o $@
+fuzz: mongoose.c mongoose.h Makefile test/fuzz.c
-
+	$(CC) test/fuzz.c $(OPTS) $(WARN) $(INCS) $(TFLAGS) $(ASAN) -o fuzzer
-fuzzer: mongoose.c mongoose.h Makefile test/fuzz.c
-	clang++ mongoose.c test/fuzz.c $(WARN) $(INCS) $(TFLAGS) $(EXTRA) -DMG_ENABLE_LINES -fsanitize=fuzzer,signed-integer-overflow,address -Wno-deprecated -o $@
-
-fuzz: fuzzer
 	$(RUN) ./fuzzer
 
-unit_test: Makefile mongoose.h $(SRCS)
+FUZZDATA ?= /tmp/fuzzdata
-	$(CC) $(SRCS) $(CFLAGS) -coverage $(LDFLAGS) -g -o unit_test
+fuzz2: mongoose.c mongoose.h Makefile test/fuzz.c
+	$(CC) test/fuzz.c -DMAIN $(OPTS) $(WARN) $(ASAN) $(INCS) -o fuzzer
+	$(RUN) ./fuzzer $(FUZZDATA)
 
-# make CC=/usr/local/opt/llvm\@8/bin/clang ASAN_OPTIONS=detect_leaks=1
+test: Makefile mongoose.h $(SRCS)
-test: unit_test
+	$(CC) $(SRCS) $(CFLAGS) $(LDFLAGS) -o unit_test
 	ASAN_OPTIONS=$(ASAN_OPTIONS) $(RUN) ./unit_test
 
+coverage: CFLAGS += -coverage
 coverage: test
 	gcov -l -n *.gcno | sed '/^$$/d' | sed 'N;s/\n/ /'
 	gcov -t mongoose.c > mongoose.gcov
@@ -91,67 +116,81 @@ coverage: test
 upload-coverage: coverage
 	curl -s https://codecov.io/bash | /bin/bash
 
-valgrind_unit_test: Makefile mongoose.h $(SRCS)
+valgrind: Makefile mongoose.h mongoose.c
-	$(CC) $(SRCS) $(VALGRIND_CFLAGS) -coverage $(LDFLAGS) -g -o valgrind_unit_test
+	$(CC) $(SRCS) $(VALGRIND_CFLAGS) $(LDFLAGS) -g -o unit_test
+	$(VALGRIND_RUN) ./unit_test
 
-valgrind: valgrind_unit_test
+misra:
-	$(VALGRIND_RUN) ./valgrind_unit_test
+	cppcheck --addon=misra -DMG_ARCH=MG_ARCH_UNIX -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_SSI=1 mongoose.c >/tmp/x 2>&1
+	cppcheck --addon=misra -DMG_ARCH=MG_ARCH_CUSTOM -DMG_ENABLE_LINES=1 -DTLS=MG_TLS_BUILTIN -DMG_ENABLE_TCPIP=1 mongoose.c  >>/tmp/x 2>&1
+	cppcheck --addon=misra --clang -DMG_ENABLE_LINES=1 -DTLS=MG_TLS_BUILTIN -DMG_ENABLE_TCPIP=1 mongoose.c  >>/tmp/x 2>&1
+	cppcheck --addon=misra --clang -DMG_ENABLE_LINES=1 -DMG_ENABLE_SSI=1 mongoose.c  >>/tmp/x 2>&1
+	less /tmp/x
 
-infer:
+armhf: ASAN=
-	infer run -- cc test/unit_test.c -c -W -Wall -Werror -Isrc -I. -O2 -DMG_ENABLE_MBEDTLS=1 -DMG_ENABLE_LINES -I/usr/local/Cellar/mbedtls/2.23.0/include  -DMG_ENABLE_IPV6=1 -g -o /dev/null
+armhf: IPV6=0
+armhf: CC = $(DOCKER) mdashnet/armhf cc
+armhf: RUN = $(DOCKER) mdashnet/armhf
+armhf: test
 
+s390: ASAN=
+s390: IPV6=0
+s390: CC = $(DOCKER) mdashnet/s390 cc
+s390: RUN = $(DOCKER) mdashnet/s390
+s390: test
+
+arm: DEFS += -DMG_ENABLE_POSIX_FS=0 -DMG_ENABLE_TCPIP=1 -DMG_ARCH=MG_ARCH_NEWLIB 
 arm: mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/armgcc arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb $(SRCS) test/mongoose_custom.c -Itest -DMG_ARCH=MG_ARCH_NEWLIB $(OPTS) $(WARN) $(INCS) $(DEFS) -o unit_test -nostartfiles --specs nosys.specs -e 0
+	$(DOCKER) mdashnet/armgcc arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb $(SRCS) $(OPTS) $(WARN) $(INCS) $(DEFS) $(TFLAGS) -o unit_test -nostartfiles --specs nosys.specs -e 0
 
+riscv: DEFS += -DMG_ENABLE_POSIX_FS=0 -DMG_ENABLE_TCPIP=1 -DMG_ARCH=MG_ARCH_NEWLIB 
 riscv: mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/riscv riscv-none-elf-gcc -march=rv32imc -mabi=ilp32 $(SRCS) test/mongoose_custom.c -Itest -DMG_ARCH=MG_ARCH_NEWLIB $(OPTS) $(WARN) $(INCS) $(DEFS) -o unit_test
+	$(DOCKER) mdashnet/riscv riscv-none-elf-gcc -march=rv32imc -mabi=ilp32 $(SRCS) $(OPTS) $(WARN) $(INCS) $(DEFS) $(TFLAGS) -o unit_test
 
-#vc98: VCFLAGS += -DMG_ENABLE_IPV6=1
 vc98: Makefile mongoose.h $(SRCS)
 	$(DOCKER) mdashnet/vc98 wine cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
 	$(DOCKER) mdashnet/vc98 wine $@.exe
 
-#vc2017: VCFLAGS += -DMG_ENABLE_IPV6=1
+vc17: Makefile mongoose.h $(SRCS)
-vc2017: Makefile mongoose.h $(SRCS)
+	$(DOCKER) mdashnet/vc17 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
-	$(DOCKER) mdashnet/vc2017 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
+	$(DOCKER) mdashnet/vc17 wine64 $@.exe
-	$(DOCKER) mdashnet/vc2017 wine64 $@.exe
+
+vc22: Makefile mongoose.h $(SRCS)
+	$(DOCKER) mdashnet/vc22 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
+	$(DOCKER) mdashnet/vc22 wine64 $@.exe
 
 mingw: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/mingw i686-w64-mingw32-gcc $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o test.exe
+	$(DOCKER) mdashnet/mingw x86_64-w64-mingw32-gcc $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o $@.exe
-	$(DOCKER) mdashnet/vc98 wine test.exe
+	$(DOCKER) mdashnet/mingw wine64 $@.exe
 
 mingw++: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/mingw i686-w64-mingw32-g++ $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o test.exe
+	$(DOCKER) mdashnet/mingw x86_64-w64-mingw32-g++ $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o $@.exe
-  # Note: for some reason, a binary built with mingw g++, fails to run
-
-linux: IPV6=0
-linux: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/cc2 gcc $(SRCS) $(CFLAGS) $(LDFLAGS) -o unit_test_gcc
-	$(DOCKER) mdashnet/cc2 ./unit_test_gcc
-
-linux++: CC = g++
-linux++: WARN += -Wno-missing-field-initializers
-linux++: linux
 
 linux-libs: CFLAGS += -fPIC
+linux-libs: LDFLAGS += -Wl,-soname,libmongoose.so.$(VERSION)
 linux-libs: mongoose.o
 	$(CC) mongoose.o $(LDFLAGS) -shared -o libmongoose.so.$(VERSION)
 	$(AR) rcs libmongoose.a mongoose.o
 
 install: linux-libs
-	install -Dm644 libmongoose.a libmongoose.so.$(VERSION) $(DESTDIR)$(PREFIX)/lib
+	install -Dm644 libmongoose.a libmongoose.so.$(VERSION) $(DESTDIR)$(LIBDIR)
-	ln -s libmongoose.so.$(VERSION) $(DESTDIR)$(PREFIX)/lib/libmongoose.so
+	ln -s libmongoose.so.$(VERSION) $(DESTDIR)$(LIBDIR)/libmongoose.so
-	install -Dm644 mongoose.h $(DESTDIR)$(PREFIX)/include/mongoose.h
+	install -Dm644 mongoose.h $(DESTDIR)$(INCLUDEDIR)/mongoose.h
 
 uninstall:
-	rm -rf $(DESTDIR)$(PREFIX)/lib/libmongoose.a $(DESTDIR)$(PREFIX)/lib/libmongoose.so.$(VERSION) $(DESTDIR)$(PREFIX)/include/mongoose.h $(DESTDIR)$(PREFIX)/lib/libmongoose.so
+	rm -rf $(DESTDIR)$(LIBDIR)/libmongoose.a $(DESTDIR)$(LIBDIR)/libmongoose.so.$(VERSION) $(DESTDIR)$(INCLUDEDIR)/mongoose.h $(DESTDIR)$(LIBDIR)/libmongoose.so
 
-mongoose.c: Makefile $(wildcard src/*)
+mongoose.c: Makefile $(wildcard src/*.c) $(wildcard src/drivers/*.c)
-	(cat src/license.h; echo; echo '#include "mongoose.h"' ; (for F in src/*.c ; do echo; echo '#ifdef MG_ENABLE_LINES'; echo "#line 1 \"$$F\""; echo '#endif'; cat $$F | sed -e 's,#include ".*,,'; done))> $@
+	(export LC_ALL=C ; cat src/license.h; echo; echo '#include "mongoose.h"' ; (for F in src/*.c src/drivers/*.c ; do echo; echo '#ifdef MG_ENABLE_LINES'; echo "#line 1 \"$$F\""; echo '#endif'; cat $$F | sed -e 's,#include ".*,,'; done))> $@
 
 mongoose.h: $(HDRS) Makefile
-	(cat src/license.h; echo; echo '#ifndef MONGOOSE_H'; echo '#define MONGOOSE_H'; echo; cat src/version.h ; echo; echo '#ifdef __cplusplus'; echo 'extern "C" {'; echo '#endif'; cat src/arch.h src/arch_*.h src/config.h src/str.h src/log.h src/timer.h src/fs.h src/util.h src/url.h src/iobuf.h src/base64.h src/md5.h src/sha1.h src/event.h src/net.h src/http.h src/ssi.h src/tls.h src/tls_mbed.h src/tls_openssl.h src/ws.h src/sntp.h src/mqtt.h src/dns.h src/mip.h | sed -e 's,#include ".*,,' -e 's,^#pragma once,,'; echo; echo '#ifdef __cplusplus'; echo '}'; echo '#endif'; echo '#endif  // MONGOOSE_H')> $@
+	(cat src/license.h; echo; echo '#ifndef MONGOOSE_H'; echo '#define MONGOOSE_H'; echo; cat src/version.h ; echo; echo '#ifdef __cplusplus'; echo 'extern "C" {'; echo '#endif'; cat src/arch.h src/arch_*.h src/net_ft.h src/net_lwip.h src/net_rl.h src/config.h src/str.h src/queue.h src/fmt.h src/printf.h src/log.h src/timer.h src/fs.h src/util.h src/url.h src/iobuf.h src/base64.h src/md5.h src/sha1.h src/sha256.h src/tls_aes128.h src/tls_uecc.h src/event.h src/net.h src/http.h src/ssi.h src/tls.h src/tls_mbed.h src/tls_openssl.h src/ws.h src/sntp.h src/mqtt.h src/dns.h src/json.h src/rpc.h src/ota.h src/device.h src/net_builtin.h src/profile.h src/drivers/*.h | sed -e '/keep/! s,#include ".*,,' -e 's,^#pragma once,,'; echo; echo '#ifdef __cplusplus'; echo '}'; echo '#endif'; echo '#endif  // MONGOOSE_H')> $@
+
+
+clean: clean_examples clean_embedded
+	rm -rf $(PROG) *.exe *.o *.dSYM *_test* ut fuzzer *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb slow-unit* _CL_* infer-out data.txt crash-* test/packed_fs.c pack
+	#find examples -maxdepth 3 -name zephyr -prune -o -name Makefile -print | xargs dirname | xargs -n1 make clean -C
+
+clean_embedded:
+	for X in $(EXAMPLES_EMBEDDED); do test -f $$X/Makefile || continue; $(MAKE) -C $$X clean || exit 1; done
 
-clean:
-	rm -rf $(PROG) *.o *.dSYM unit_test* valgrind_unit_test* ut fuzzer *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb slow-unit* _CL_* infer-out data.txt crash-* test/packed_fs.c pack unpacked
-	@for X in $(EXAMPLES); do $(MAKE) -C $$X clean; done

README.md

@@ -5,27 +5,96 @@
 [![Code Coverage](https://codecov.io/gh/cesanta/mongoose/branch/master/graph/badge.svg)](https://codecov.io/gh/cesanta/mongoose)
 [![Fuzzing Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/mongoose.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:mongoose)
 
-Mongoose is a networking library for C/C++. It implements event-driven
+Mongoose is a network library for C/C++. 
+It implements event-driven
 non-blocking APIs for TCP, UDP, HTTP, WebSocket, MQTT.  It is designed for
 connecting devices and bringing them online. On the market since 2004, used by
 vast number of open source and commercial products - it even runs on the
 International Space Station!  Mongoose makes embedded network programming fast,
 robust, and easy. Features include:
 
-- Cross-platform: works on Linux/UNIX, MacOS, Windows, Android, FreeRTOS, etc.
+- Cross-platform:
-- Supported embedded architectures: ESP32, NRF52, STM32, NXP, and more
+  - works on Linux/UNIX, MacOS, Windows, Android
-- Built-in protocols: plain TCP/UDP, HTTP, MQTT, Websocket
+  - works on STM32, NXP, ESP32, NRF52, TI, Microchip, and other
-- SSL/TLS support: mbedTLS, OpenSSL or custom (via API)
+  - write code once - and it'll work everywhere
+  - ideal for the unification of the network infrastructure code across company
+- Built-in protocols: plain TCP/UDP, SNTP, HTTP, MQTT, Websocket
+- SSL/TLS support for mbedTLS and OpenSSL
 - Asynchronous DNS resolver
 - Tiny static and run-time footprint
 - Source code is both ISO C and ISO C++ compliant
-- Works with any network stack with socket API, like LwIP or FreeRTOS-Plus-TCP
+- Very easy to integrate: just copy `mongoose.c` and `mongoose.h` files to your source tree. See
-- Very easy to integrate: just copy `mongoose.c` and `mongoose.h` files to your build tree
+  [exact steps](https://mongoose.ws/documentation/#2-minute-integration-guide)
-- Detailed [documentation](https://mongoose.ws/documentation/) and
+- Works in any environment with socket API, like LwIP, Zephyr, Azure
-  [tutorials](https://mongoose.ws/tutorials/)
+- Built-in TCP/IP stack with drivers for bare metal or RTOS systems
+   - Available drivers: STM32F, STM32H; NXP RT1xxx; TI TM4C; Microchip SAME54; Wiznet W5500
+   - A complete Web device dashboard on bare metal
+  [Nucleo-F429ZI](examples/stm32/nucleo-f429zi-baremetal) is only 6 files
+   - For comparison, a CubeIDE generated HTTP example is 400+ files
+- Built-in TLS 1.3 server-side support
+- Does not depend on any other software to implement networking
+- Built-in firmware updates for STM32H5, STM32H7, and more coming
+- Detailed [user guide, API reference and tons of tutorials](https://mongoose.ws/documentation/)
 
+## Usage
 
-# Commercial use
+Create a simple web server that serves a directory. The behavior of the
+HTTP server is specified by its event handler function:
+
+```c
+#include "mongoose.h"
+
+int main(void) {
+  struct mg_mgr mgr;  // Declare event manager
+  mg_mgr_init(&mgr);  // Initialise event manager
+  mg_http_listen(&mgr, "http://0.0.0.0:8000", fn, NULL);  // Setup listener
+  for (;;) {
+    mg_mgr_poll(&mgr, 1000);  // Run an infinite event loop
+  }
+  return 0;
+}
+
+// HTTP server event handler function
+void fn(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_HTTP_MSG) {
+    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
+    struct mg_http_serve_opts opts = { .root_dir = "./web_root/" };
+    mg_http_serve_dir(c, hm, &opts);
+  }
+}
+```
+
+HTTP server implements a REST API that returns current time. JSON formatting:
+```c
+static void fn(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_HTTP_MSG) {
+    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
+    if (mg_http_match_uri(hm, "/api/time/get")) {
+      mg_http_reply(c, 200, "", "{%m:%lu}\n", MG_ESC("time"), time(NULL));
+    } else {
+      mg_http_reply(c, 500, "", "{%m:%m}\n", MG_ESC("error"), MG_ESC("Unsupported URI")); 
+    }
+  }
+}
+```
+
+MQTT client that subscribes to a topic `aa/bb` and prints all incoming messages:
+
+```c
+static void fn(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_MQTT_OPEN) {
+    struct mg_mqtt_opts opts = {.qos = 1, .topic = mg_str("aa/bb")};
+    mg_mqtt_sub(c, &opts);
+  } else if (ev == MG_EV_MQTT_MSG) {
+    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
+    printf("Topic: %.*s, Message: %.*s",
+           mm->topic.len, mm->topic.ptr,
+           mm->data.len, mm->data.ptr);
+  }
+}
+```
+
+## Commercial use
 - Mongoose is used by hundreds of businesses, from Fortune500 giants like
   Siemens, Schneider Electric, Broadcom, Bosch, Google, Samsung, Qualcomm, Caterpillar to the small businesses
 - Used to solve a wide range of business needs, like implementing Web UI
@@ -35,11 +104,11 @@ robust, and easy. Features include:
 - See [Case Studies](https://mongoose.ws/case-studies/) from our respected
   customers like [Schneider Electric](https://mongoose.ws/case-studies/schneider-electric/) (industrial automation), [Broadcom](https://mongoose.ws/case-studies/broadcom/) (semiconductors), [Pilz](https://mongoose.ws/case-studies/pilz/) (industrial automation), and others
 - See [Testimonials](https://mongoose.ws/testimonials/) from engineers that integrated Mongoose in their commercial products
-- We provide [Evaluation and Commercial licensing](https://mongoose.ws/licensing/), [support](https://mongoose.ws/support/), consultancy and integration
+- We provide [Evaluation and Commercial licensing](https://mongoose.ws/licensing/), [support](https://mongoose.ws/support/), consultancy and [integration
-  assistance - don't hesitate to [contact us](https://mongoose.ws/contact/)
+  services](https://mongoose.ws/integration/) - don't hesitate to [contact us](https://mongoose.ws/contact/)
 
 
-# Security
+## Security
 
 We take security seriously:
 1. Mongoose repository runs a
@@ -64,18 +133,8 @@ We take security seriously:
   have specific security requirements and run independent security audits,
   of which we get notified and in case of any issue, act similar to (3).
 
-# Supplement software
 
-This software is often used together with Mongoose:
+## Contributions
-- [mjson](https://github.com/cesanta/mjson) - a JSON parser, emitter and
-  JSON-RPC engine. Used to implement
-  RESTful APIs that use JSON, or implement data exchange (e.g. over MQTT
-  or Websocket) that use JSON for data encapsulation
-- [elk](https://github.com/cesanta/elk) - a tiny JavaScript engine.
-  Used to implement scripting support
-
-
-# Contributions
 
 Contributions are welcome! Please follow the guidelines below:
 

drivers/README.md

@@ -1,2 +0,0 @@
-# This is a collection of low-level drivers for the experimental
-# built-in TCP/IP stack

drivers/mip_driver_stm32.c

@@ -1,140 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-
-#include "mip_driver_stm32.h"
-#include <stdint.h>
-#include <stdio.h>
-#include <string.h>
-
-struct eth {
-  uint32_t MACCR, MACFFR, MACHTHR, MACHTLR, MACMIIAR, MACMIIDR, MACFCR,
-      MACVLANTR, RESERVED0[2], MACRWUFFR, MACPMTCSR, RESERVED1, MACDBGR, MACSR,
-      MACIMR, MACA0HR, MACA0LR, MACA1HR, MACA1LR, MACA2HR, MACA2LR, MACA3HR,
-      MACA3LR, RESERVED2[40], MMCCR, MMCRIR, MMCTIR, MMCRIMR, MMCTIMR,
-      RESERVED3[14], MMCTGFSCCR, MMCTGFMSCCR, RESERVED4[5], MMCTGFCR,
-      RESERVED5[10], MMCRFCECR, MMCRFAECR, RESERVED6[10], MMCRGUFCR,
-      RESERVED7[334], PTPTSCR, PTPSSIR, PTPTSHR, PTPTSLR, PTPTSHUR, PTPTSLUR,
-      PTPTSAR, PTPTTHR, PTPTTLR, RESERVED8, PTPTSSR, PTPPPSCR, RESERVED9[564],
-      DMABMR, DMATPDR, DMARPDR, DMARDLAR, DMATDLAR, DMASR, DMAOMR, DMAIER,
-      DMAMFBOCR, DMARSWTR, RESERVED10[8], DMACHTDR, DMACHRDR, DMACHTBAR,
-      DMACHRBAR;
-};
-#define ETH ((struct eth *) 0x40028000)
-
-#define BIT(x) (1UL << (x))
-#define ETH_PKT_SIZE 1540  // Max frame size
-#define ETH_DESC_CNT 4     // Descriptors count
-#define ETH_DS 4           // Descriptor size (words)
-
-static uint32_t s_rxdesc[ETH_DESC_CNT][ETH_DS];      // RX descriptors
-static uint32_t s_txdesc[ETH_DESC_CNT][ETH_DS];      // TX descriptors
-static uint8_t s_rxbuf[ETH_DESC_CNT][ETH_PKT_SIZE];  // RX ethernet buffers
-static uint8_t s_txbuf[ETH_DESC_CNT][ETH_PKT_SIZE];  // TX ethernet buffers
-static void (*s_rx)(void *, size_t, void *);         // Recv callback
-static void *s_rxdata;                               // Recv callback data
-static void *s_userdata;                             // Driver data
-enum { PHY_ADDR = 0, PHY_BCR = 0, PHY_BSR = 1 };     // PHY constants
-
-static inline void spin(volatile uint32_t count) {
-  while (count--) asm("nop");
-}
-
-uint32_t eth_read_phy(uint8_t addr, uint8_t reg) {
-  ETH->MACMIIAR &= (7 << 2);
-  ETH->MACMIIAR |= ((uint32_t) addr << 11) | ((uint32_t) reg << 6);
-  ETH->MACMIIAR |= BIT(0);
-  while (ETH->MACMIIAR & BIT(0)) spin(1);
-  return ETH->MACMIIDR;
-}
-
-void eth_write_phy(uint8_t addr, uint8_t reg, uint32_t val) {
-  ETH->MACMIIDR = val;
-  ETH->MACMIIAR &= (7 << 2);
-  ETH->MACMIIAR |= ((uint32_t) addr << 11) | ((uint32_t) reg << 6) | BIT(1);
-  ETH->MACMIIAR |= BIT(0);
-  while (ETH->MACMIIAR & BIT(0)) spin(1);
-}
-
-void mip_driver_stm32_init(void *userdata) {
-  s_userdata = userdata;
-
-  // Init RX descriptors
-  for (int i = 0; i < ETH_DESC_CNT; i++) {
-    s_rxdesc[i][0] = BIT(31);                       // Own
-    s_rxdesc[i][1] = sizeof(s_rxbuf[i]) | BIT(14);  // 2nd address chained
-    s_rxdesc[i][2] = (uint32_t) s_rxbuf[i];         // Point to data buffer
-    s_rxdesc[i][3] = (uint32_t) s_rxdesc[(i + 1) % ETH_DESC_CNT];  // Chain
-  }
-
-  // Init TX descriptors
-  for (int i = 0; i < ETH_DESC_CNT; i++) {
-    s_txdesc[i][2] = (uint32_t) s_txbuf[i];  // Buf pointer
-    s_txdesc[i][3] = (uint32_t) s_txdesc[(i + 1) % ETH_DESC_CNT];  // Chain
-  }
-
-  ETH->DMABMR |= BIT(0);                        // Software reset
-  while ((ETH->DMABMR & BIT(0)) != 0) spin(1);  // Wait until done
-  // NOTE(cpq): we do not use extended descriptor bit 7, and do not use
-  // hardware checksum. Therefore, descriptor size is 4, not 8
-  // ETH->DMABMR = BIT(13) | BIT(16) | BIT(22) | BIT(23) | BIT(25);
-  ETH->MACIMR = BIT(3) | BIT(9);              // Mask timestamp & PMT IT
-  ETH->MACMIIAR = 4 << 2;                     // MDC clock 150-216 MHz, 38.8.1
-  ETH->MACFCR = BIT(7);                       // Disable zero quarta pause
-  ETH->MACFFR = BIT(31);                      // Receive all
-  eth_write_phy(PHY_ADDR, PHY_BCR, BIT(15));  // Reset PHY
-  eth_write_phy(PHY_ADDR, PHY_BCR, BIT(12));  // Set autonegotiation
-  ETH->DMARDLAR = (uint32_t) s_rxdesc;        // RX descriptors
-  ETH->DMATDLAR = (uint32_t) s_txdesc;        // RX descriptors
-  ETH->DMAIER = BIT(6) | BIT(16);             // RIE, NISE
-  ETH->MACCR = BIT(2) | BIT(3) | BIT(11) | BIT(14);    // RE, TE, Duplex, Fast
-  ETH->DMAOMR = BIT(1) | BIT(13) | BIT(21) | BIT(25);  // SR, ST, TSF, RSF
-}
-
-void mip_driver_stm32_setrx(void (*rx)(void *, size_t, void *), void *rxdata) {
-  s_rx = rx;
-  s_rxdata = rxdata;
-}
-
-static uint32_t s_txno;
-size_t mip_driver_stm32_tx(const void *buf, size_t len, void *userdata) {
-  if (len > sizeof(s_txbuf[s_txno])) {
-    printf("%s: frame too big, %ld\n", __func__, (long) len);
-    len = 0;  // Frame is too big
-  } else if ((s_txdesc[s_txno][0] & BIT(31))) {
-    printf("%s: no free descr\n", __func__);
-    len = 0;  // All descriptors are busy, fail
-  } else {
-    memcpy(s_txbuf[s_txno], buf, len);     // Copy data
-    s_txdesc[s_txno][1] = (uint32_t) len;  // Set data len
-    s_txdesc[s_txno][0] = BIT(20) | BIT(28) | BIT(29) | BIT(30);  // Chain,FS,LS
-    s_txdesc[s_txno][0] |= BIT(31);  // Set OWN bit - let DMA take over
-    if (++s_txno >= ETH_DESC_CNT) s_txno = 0;
-  }
-  uint32_t sr = ETH->DMASR;
-  if (sr & BIT(2)) ETH->DMASR = BIT(2), ETH->DMATPDR = 0;  // Resume
-  if (sr & BIT(5)) ETH->DMASR = BIT(5), ETH->DMATPDR = 0;  // if busy
-  if (len == 0) printf("E: D0 %lx, DMASR %lx\n", s_txdesc[0][0], sr);
-  return len;
-  (void) userdata;
-}
-
-bool mip_driver_stm32_status(void *userdata) {
-  uint32_t bsr = eth_read_phy(PHY_ADDR, PHY_BSR);
-  return bsr & BIT(2) ? 1 : 0;
-  (void) userdata;
-}
-
-void ETH_IRQHandler(void) {
-  volatile uint32_t sr = ETH->DMASR;
-  if (sr & BIT(6)) {  // Frame received, loop
-    for (uint32_t i = 0; i < ETH_DESC_CNT; i++) {
-      if (s_rxdesc[i][0] & BIT(31)) continue;
-      uint32_t len = ((s_rxdesc[i][0] >> 16) & (BIT(14) - 1));
-      //    printf("%lx %lu %lx %lx\n", i, len, s_rxdesc[i][0], sr);
-      if (s_rx != NULL) s_rx(s_rxbuf[i], len > 4 ? len - 4 : len, s_rxdata);
-      s_rxdesc[i][0] = BIT(31);
-    }
-  }
-  if (sr & BIT(7)) ETH->DMARPDR = 0;     // Resume RX
-  ETH->DMASR = sr & ~(BIT(2) | BIT(7));  // Clear status
-}

drivers/mip_driver_stm32.h

@@ -1,12 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-
-#pragma once
-
-#include <stdbool.h>
-#include <stddef.h>
-
-void mip_driver_stm32_init(void *userdata);
-bool mip_driver_stm32_status(void *);
-void mip_driver_stm32_setrx(void (*rx)(void *, size_t, void *), void *);
-size_t mip_driver_stm32_tx(const void *buf, size_t len, void *);

drivers/mip_driver_w5500.h

@@ -1,99 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-//
-// This software is dual-licensed: you can redistribute it and/or modify
-// it under the terms of the GNU Affero General Public License version 3 as
-// published by the Free Software Foundation. For the terms of this
-// license, see http://www.fsf.org/licensing/licenses/agpl-3.0.html
-//
-// You are free to use this software under the terms of the GNU General
-// Public License, but WITHOUT ANY WARRANTY; without even the implied
-// warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-// See the GNU General Public License for more details.
-//
-// Alternatively, you can license this software under a commercial
-// license, please contact us at https://cesanta.com/contact.html
-
-#pragma once
-
-struct w5500 {
-  uint8_t mac[6];                   // MAC address
-  void *spi;                        // Opaque SPI bus descriptor
-  uint8_t (*txn)(void *, uint8_t);  // SPI transaction
-  void (*begin)(void *);            // SPI begin
-  void (*end)(void *);              // SPI end
-};
-
-enum { W5500_CR = 0, W5500_S0 = 1, W5500_TX0 = 2, W5500_RX0 = 3 };
-
-static inline void w5500_txn(struct w5500 *w, uint8_t block, uint16_t addr,
-                             bool wr, void *buf, size_t len) {
-  uint8_t *p = buf, cmd[] = {(uint8_t) (addr >> 8), (uint8_t) (addr & 255),
-                             (uint8_t) ((block << 3) | (wr ? 4 : 0))};
-  w->begin(w->spi);
-  for (size_t i = 0; i < sizeof(cmd); i++) w->txn(w->spi, cmd[i]);
-  for (size_t i = 0; i < len; i++) {
-    uint8_t r = w->txn(w->spi, p[i]);
-    if (!wr) p[i] = r;
-  }
-  w->end(w->spi);
-}
-
-// clang-format off
-static inline void w5500_wn(struct w5500 *w, uint8_t block, uint16_t addr, void *buf, size_t len) { w5500_txn(w, block, addr, true, buf, len); }
-static inline void w5500_w1(struct w5500 *w, uint8_t block, uint16_t addr, uint8_t val) { w5500_wn(w, block, addr, &val, 1); }
-static inline void w5500_w2(struct w5500 *w, uint8_t block, uint16_t addr, uint16_t val) { uint8_t buf[2] = {(uint8_t) (val >> 8), (uint8_t) (val & 255)}; w5500_wn(w, block, addr, buf, sizeof(buf)); }
-static inline void w5500_rn(struct w5500 *w, uint8_t block, uint16_t addr, void *buf, size_t len) { w5500_txn(w, block, addr, false, buf, len); }
-static inline uint8_t w5500_r1(struct w5500 *w, uint8_t block, uint16_t addr) { uint8_t r = 0; w5500_rn(w, block, addr, &r, 1); return r; }
-static inline uint16_t w5500_r2(struct w5500 *w, uint8_t block, uint16_t addr) { uint8_t buf[2] = {0, 0}; w5500_rn(w, block, addr, buf, sizeof(buf)); return (uint16_t) ((buf[0] << 8) | buf[1]); }
-// clang-format on
-
-static inline uint8_t w5500_status(struct w5500 *w) {
-  return w5500_r1(w, W5500_CR, 0x2e);
-}
-
-static inline uint16_t w5500_rx(struct w5500 *w, uint8_t *buf, uint16_t len) {
-  uint16_t r = 0, n = 0, n2;                              // Read recv len
-  while ((n2 = w5500_r2(w, W5500_S0, 0x26)) > n) n = n2;  // Until it is stable
-  // printf("RSR: %d\n", (int) n);
-  if (n > 0) {
-    uint16_t ptr = w5500_r2(w, W5500_S0, 0x28);  // Get read pointer
-    n = w5500_r2(w, W5500_RX0, ptr);             // Read frame length
-    if (n <= len + 2) r = n - 2, w5500_rn(w, W5500_RX0, ptr + 2, buf, r);
-    w5500_w2(w, W5500_S0, 0x28, ptr + n);  // Advance read pointer
-    w5500_w1(w, W5500_S0, 1, 0x40);        // Sock0 CR -> RECV
-    // printf("  RX_RD: tot=%u n=%u r=%u\n", n2, n, r);
-  }
-  return r;
-}
-
-static inline uint16_t w5500_tx(struct w5500 *w, void *buf, uint16_t len) {
-  uint16_t n = 0;
-  while (n < len) n = w5500_r2(w, W5500_S0, 0x20);  // Wait for space
-  uint16_t ptr = w5500_r2(w, W5500_S0, 0x24);       // Get write pointer
-  w5500_wn(w, W5500_TX0, ptr, buf, len);            // Write data
-  w5500_w2(w, W5500_S0, 0x24, ptr + len);           // Advance write pointer
-  w5500_w1(w, W5500_S0, 1, 0x20);                   // Sock0 CR -> SEND
-  for (int i = 0; i < 40; i++) {
-    uint8_t ir = w5500_r1(w, W5500_S0, 2);  // Read S0 IR
-    if (ir == 0) continue;
-    // printf("IR %d, len=%d, free=%d, ptr %d\n", ir, (int) len, (int) n, ptr);
-    w5500_w1(w, W5500_S0, 2, ir);  // Write S0 IR: clear it!
-    if (ir & 8) len = 0;           // Timeout. Report error
-    if (ir & (16 | 8)) break;      // Stop on SEND_OK or timeout
-  }
-  return len;
-}
-
-static inline bool w5500_init(struct w5500 *w) {
-  w->end(w->spi);
-  w5500_w1(w, W5500_CR, 0, 0x80);     // Reset chip: CR -> 0x80
-  w5500_w1(w, W5500_CR, 0x2e, 0);     // CR PHYCFGR -> reset
-  w5500_w1(w, W5500_CR, 0x2e, 0xf8);  // CR PHYCFGR -> set
-  // w5500_wn(w, W5500_CR, 9, w->mac, 6);      // Set source MAC
-  w5500_w1(w, W5500_S0, 0x1e, 16);          // Sock0 RX buf size
-  w5500_w1(w, W5500_S0, 0x1f, 16);          // Sock0 TX buf size
-  w5500_w1(w, W5500_S0, 0, 4);              // Sock0 MR -> MACRAW
-  w5500_w1(w, W5500_S0, 1, 1);              // Sock0 CR -> OPEN
-  return w5500_r1(w, W5500_S0, 3) == 0x42;  // Sock0 SR == MACRAW
-}

examples/README.md

@@ -0,0 +1,24 @@
+# Mongoose Network Library Examples
+
+In order to build and run any of the existing examples, please follow:
+https://mongoose.ws/documentation/#how-to-build-and-run-examples
+
+## Contributing
+
+Rules for creating a new example:
+
+- Makefile golden reference for desktop/server example: [http-server](http-server)
+- Makefile golden reference for the embedded example:
+   [stm32/nucleo-f746zg-baremetal](stm32/nucleo-f746zg-baremetal)
+- An example must build on Windows, Mac and Ubuntu Linux systems
+- Assume that user installed tools according to https://mongoose.ws/tutorials/tools/
+- Makefile must not include any other make files
+- Use `CFLAGS` for system-specific compilation options
+- Use `CFLAGS_MONGOOSE` for mongoose-specific compilation options
+- Use `$(CFLAGS) $(CFLAGS_MONGOOSE) $(CFLAGS_EXTRA)` to compile
+- If external repository is required, download it on demand using git
+  shallow clone. See embedded example golden reference
+- Keep Makefile as short as possible, but verbose to understand it easily
+- Symlink files when required, like `mongoose.c`, `ca.pem`, etc. Make no copies
+- Example's README.md should contain only the title and the link to mongoose.ws
+  tutorial page

examples/arduino/Makefile

@@ -0,0 +1,28 @@
+
+all:
+example:
+	true
+
+arduino: ENV = -v $(CWD):/root
+arduino:
+	curl -sL http://downloads.arduino.cc/arduino-1.8.19-linux64.tar.xz | unxz | tar -xf -
+	mv arduino-* $@
+
+arduino-xiao-board:
+	./arduino/arduino --pref "boardsmanager.additional.urls=https://files.seeedstudio.com/arduino/package_seeeduino_boards_index.json" --save-prefs
+	./arduino/arduino --pref "compiler.warning_level=all" --save-prefs
+	./arduino/arduino --install-boards Seeeduino:samd
+
+arduino-xiao: arduino arduino-xiao-board
+	cd w5500-http && ../arduino/arduino --verbose --verify --board Seeeduino:samd:seeed_XIAO_m0 w5500-http.ino
+	cd w5500-mqtt && ../arduino/arduino --verbose --verify --board Seeeduino:samd:seeed_XIAO_m0 w5500-mqtt.ino
+
+arduino-nano: arduino
+	cd w5500-http && ../arduino/arduino --pref compiler.cpp.extra_flags=-DMG_ENABLE_LOG=0 --verbose --verify --board arduino:avr:nano w5500-http.ino
+	cd w5500-mqtt && ../arduino/arduino --pref compiler.cpp.extra_flags=-DMG_ENABLE_LOG=0 --verbose --verify --board arduino:avr:nano w5500-mqtt.ino
+
+clean:
+	rm -rf arduino 
+
+cleanall: clean		#otherwise some parts of xiao-board installation will fail as already installed
+	rm -rf ~/.arduino15 ~/.oracle_jre_usage

examples/arduino/teensy41-http/mongoose_custom.h

@@ -0,0 +1,11 @@
+#pragma once
+
+#define MG_ARCH MG_ARCH_NEWLIB     // Use ARM toolchain
+#define MG_ENABLE_TCPIP 1          // Enable built-in network stack
+#define MG_ENABLE_DRIVER_IMXRT 1   // Enable RTxx driver
+#define MG_ENABLE_CUSTOM_MILLIS 1  // Let user implement mg_millis()
+#define MG_ENABLE_POSIX_FS 0       // Disable POSIX filesystem
+#define MG_ENABLE_PACKED_FS 1      // Enable packed filesystem
+
+#define HTTP_URL "http://0.0.0.0"
+#define HTTPS_URL "https://0.0.0.0"

examples/arduino/teensy41-http/net.c

@@ -0,0 +1 @@
+../../device-dashboard/net.c

examples/arduino/teensy41-http/net.h

@@ -0,0 +1 @@
+../../device-dashboard/net.h

examples/arduino/teensy41-http/packed_fs.c

@@ -0,0 +1 @@
+../../device-dashboard/packed_fs.c

examples/arduino/teensy41-http/teensy41-http.ino

@@ -0,0 +1,149 @@
+#include "mongoose.h"
+#include "net.h"
+
+void ethernet_init(void);
+struct mg_mgr mgr;
+struct mg_tcpip_driver_imxrt_data data = {.mdc_cr = 24, .phy_addr = 0};
+struct mg_tcpip_if mif = {
+    // Construct MAC address from the unique chip ID
+    .mac = {2, (uint8_t) (HW_OCOTP_CFG0 & 255),
+            (uint8_t) ((HW_OCOTP_CFG0 >> 10) & 255),
+            (uint8_t) (((HW_OCOTP_CFG0 >> 19) ^ (HW_OCOTP_CFG1 >> 19)) & 255),
+            (uint8_t) ((HW_OCOTP_CFG1 >> 10) & 255),
+            (uint8_t) (HW_OCOTP_CFG1 & 255)},
+    // The default is DHCP. Uncomment 3 lines below for static IP config:
+    // .ip = mg_htonl(MG_U32(192, 168, 0, 223)),
+    // .mask = mg_htonl(MG_U32(255, 255, 255, 0)),
+    // .gw = mg_htonl(MG_U32(192, 168, 0, 1)),
+    .driver = &mg_tcpip_driver_imxrt,
+    .driver_data = &data};
+
+uint64_t mg_millis(void) {  // Let Mongoose use our uptime function
+  return millis();
+}
+
+// Simple HTTP server that runs on port 8000
+// Mongoose event handler function, gets called by the mg_mgr_poll()
+// See https://mongoose.ws/documentation/#2-minute-integration-guide
+static void simple_http_listener(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_HTTP_MSG) {
+    // The MG_EV_HTTP_MSG event means HTTP request. `hm` holds parsed request,
+    // see https://mongoose.ws/documentation/#struct-mg_http_message
+    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
+
+    // If the requested URI is "/api/hi", send a simple JSON response back
+    if (mg_http_match_uri(hm, "/api/hi")) {
+      // Use mg_http_reply() API function to generate JSON response. It adds a
+      // Content-Length header automatically. In the response, we show
+      // the requested URI and HTTP body:
+      mg_http_reply(c, 200, "", "{%m:%m,%m:%m}\n",  // See mg_snprintf doc
+                    MG_ESC("uri"), mg_print_esc, hm->uri.len, hm->uri.ptr,
+                    MG_ESC("body"), mg_print_esc, hm->body.len, hm->body.ptr);
+    } else {
+      // For all other URIs, serve some static content
+      mg_http_reply(c, 200, "", "<html>millis: %lu</html>", millis());
+    }
+  }
+}
+
+void setup() {
+  pinMode(LED_BUILTIN, OUTPUT);
+  Serial.begin(115200);
+  while (!Serial) delay(50);
+
+  mg_mgr_init(&mgr);        // Initialise Mongoose event manager
+  mg_log_set(MG_LL_DEBUG);  // Set log level and log function
+  mg_log_set_fn([](char ch, void *) { Serial.print(ch); }, NULL);
+
+  MG_INFO(("CPU %g MHz. Starting TCP/IP stack", (double) F_CPU / 1000000));
+  ethernet_init();
+  mg_tcpip_init(&mgr, &mif);  // Initialise built-in TCP/IP stack
+
+  MG_INFO(("Waiting for IP..."));
+  while (mif.state != MG_TCPIP_STATE_READY) mg_mgr_poll(&mgr, 1);
+
+  // We start two HTTP listeners: one is a simple one on port 8000,
+  // with event handler function defined above - simple_http_listener
+  // See https://mongoose.ws/documentation/#2-minute-integration-guide
+  // Another listener is for a more sophisticated Web device dashboard
+  MG_INFO(("Starting web dashboard"));
+  mg_http_listen(&mgr, "http://0.0.0.0:8000", simple_http_listener, NULL);
+  web_init(&mgr);  // Sophisticated Web UI, see net.c :: fn()
+}
+
+void loop() {
+  static uint64_t timer;
+  if (mg_timer_expired(&timer, 500, mg_millis())) {        // Every 500ms
+    digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN));  // blink an LED
+  }
+
+  mg_mgr_poll(&mgr, 1);  // Process network events
+}
+
+extern "C" void ENET_IRQHandler(void);
+
+#define CLRSET(reg, clear, set) ((reg) = ((reg) & ~(clear)) | (set))
+#define RMII_PAD_INPUT_PULLDOWN 0x30E9
+#define RMII_PAD_INPUT_PULLUP 0xB0E9
+#define RMII_PAD_CLOCK 0x0031
+
+// initialize the ethernet hardware
+void ethernet_init(void) {
+  CCM_CCGR1 |= CCM_CCGR1_ENET(CCM_CCGR_ON);
+  // configure PLL6 for 50 MHz, pg 1173
+  CCM_ANALOG_PLL_ENET_CLR =
+      CCM_ANALOG_PLL_ENET_POWERDOWN | CCM_ANALOG_PLL_ENET_BYPASS | 0x0F;
+  CCM_ANALOG_PLL_ENET_SET = CCM_ANALOG_PLL_ENET_ENABLE |
+                            CCM_ANALOG_PLL_ENET_BYPASS
+                            /*| CCM_ANALOG_PLL_ENET_ENET2_REF_EN*/
+                            | CCM_ANALOG_PLL_ENET_ENET_25M_REF_EN
+                            /*| CCM_ANALOG_PLL_ENET_ENET2_DIV_SELECT(1)*/
+                            | CCM_ANALOG_PLL_ENET_DIV_SELECT(1);
+  while (!(CCM_ANALOG_PLL_ENET & CCM_ANALOG_PLL_ENET_LOCK))
+    ;  // wait for PLL lock
+  CCM_ANALOG_PLL_ENET_CLR = CCM_ANALOG_PLL_ENET_BYPASS;
+  // configure REFCLK to be driven as output by PLL6, pg 326
+
+  CLRSET(IOMUXC_GPR_GPR1,
+         IOMUXC_GPR_GPR1_ENET1_CLK_SEL | IOMUXC_GPR_GPR1_ENET_IPG_CLK_S_EN,
+         IOMUXC_GPR_GPR1_ENET1_TX_CLK_DIR);
+
+  // Configure pins
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B0_14 = 5;  // Reset   B0_14 Alt5 GPIO7.15
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B0_15 = 5;  // Power   B0_15 Alt5 GPIO7.14
+  GPIO7_GDIR |= (1 << 14) | (1 << 15);
+  GPIO7_DR_SET = (1 << 15);                                    // Power on
+  GPIO7_DR_CLEAR = (1 << 14);                                  // Reset PHY chip
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_04 = RMII_PAD_INPUT_PULLDOWN;  // PhyAdd[0] = 0
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_06 = RMII_PAD_INPUT_PULLDOWN;  // PhyAdd[1] = 1
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_05 = RMII_PAD_INPUT_PULLUP;    // Slave mode
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_11 = RMII_PAD_INPUT_PULLDOWN;  // Auto MDIX
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_07 = RMII_PAD_INPUT_PULLUP;
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_08 = RMII_PAD_INPUT_PULLUP;
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_09 = RMII_PAD_INPUT_PULLUP;
+  IOMUXC_SW_PAD_CTL_PAD_GPIO_B1_10 = RMII_PAD_CLOCK;
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_05 = 3;         // RXD1    B1_05 Alt3, pg 525
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_04 = 3;         // RXD0    B1_04 Alt3, pg 524
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_10 = 6 | 0x10;  // REFCLK  B1_10 Alt6, pg 530
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_11 = 3;         // RXER    B1_11 Alt3, pg 531
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_06 = 3;         // RXEN    B1_06 Alt3, pg 526
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_09 = 3;         // TXEN    B1_09 Alt3, pg 529
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_07 = 3;         // TXD0    B1_07 Alt3, pg 527
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_08 = 3;         // TXD1    B1_08 Alt3, pg 528
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_15 = 0;         // MDIO    B1_15 Alt0, pg 535
+  IOMUXC_SW_MUX_CTL_PAD_GPIO_B1_14 = 0;         // MDC     B1_14 Alt0, pg 534
+  IOMUXC_ENET_MDIO_SELECT_INPUT = 2;            // GPIO_B1_15_ALT0, pg 792
+  IOMUXC_ENET0_RXDATA_SELECT_INPUT = 1;         // GPIO_B1_04_ALT3, pg 792
+  IOMUXC_ENET1_RXDATA_SELECT_INPUT = 1;         // GPIO_B1_05_ALT3, pg 793
+  IOMUXC_ENET_RXEN_SELECT_INPUT = 1;            // GPIO_B1_06_ALT3, pg 794
+  IOMUXC_ENET_RXERR_SELECT_INPUT = 1;           // GPIO_B1_11_ALT3, pg 795
+  IOMUXC_ENET_IPG_CLK_RMII_SELECT_INPUT = 1;    // GPIO_B1_10_ALT6, pg 791
+  delay(1);
+  GPIO7_DR_SET = (1 << 14);  // Start PHY chip
+  // ENET_MSCR = ENET_MSCR_MII_SPEED(9);
+  delay(1);
+
+  // Setup IRQ handler
+  attachInterruptVector(IRQ_ENET, ENET_IRQHandler);
+  NVIC_ENABLE_IRQ(IRQ_ENET);
+}

examples/arduino/w5500-http/mongoose.c

@@ -0,0 +1 @@
+../../../mongoose.c

examples/arduino/w5500-http/mongoose.h

@@ -0,0 +1 @@
+../../../mongoose.h

examples/arduino/w5500-http/mongoose_custom.h

@@ -0,0 +1,15 @@
+#pragma once
+
+#include "Arduino.h"
+
+#include <errno.h>
+#include <stdarg.h>
+#include <stdio.h>
+#include <time.h>
+
+#define MG_ARCH MG_ARCH_CUSTOM
+#define MG_ENABLE_SOCKET 0
+#define MG_ENABLE_TCPIP 1
+#define mkdir(a, b) (-1)
+#define MG_IO_SIZE 128
+//#define MG_ENABLE_LOG 0

examples/arduino/w5500-http/w5500-http.ino

@@ -0,0 +1,49 @@
+#include <SPI.h>
+#include "mongoose.h"
+
+#define SS_PIN 3    // Slave select pin
+struct mg_mgr mgr;  // Mongoose event manager
+struct mg_tcpip_spi spi = {
+    NULL,                                               // SPI data
+    [](void *) { digitalWrite(SS_PIN, LOW); },          // begin transation
+    [](void *) { digitalWrite(SS_PIN, HIGH); },         // end transaction
+    [](void *, uint8_t c) { return SPI.transfer(c); },  // execute transaction
+};
+struct mg_tcpip_if mif = {.mac = {2, 0, 1, 2, 3, 5}};  // network interface
+
+void setup() {
+  Serial.begin(115200);
+  pinMode(SS_PIN, OUTPUT);
+  SPI.begin();
+
+  // Set logging function to a serial print
+  mg_log_set_fn([](char ch, void *) { Serial.print(ch); }, NULL);
+  mg_mgr_init(&mgr);
+
+  delay(3000);
+  MG_INFO(("Starting TCP/IP stack..."));
+
+  mif.driver = &mg_tcpip_driver_w5500;
+  mif.driver_data = &spi;
+  mg_tcpip_init(&mgr, &mif);
+
+  // Start a 5 sec timer, print status message periodically
+  mg_timer_add(
+      &mgr, 5000, MG_TIMER_REPEAT,
+      [](void *) {
+        MG_INFO(("ethernet: %s", mg_tcpip_driver_w5500.up(&mif) ? "up" : "down"));
+      },
+      NULL);
+
+  // Setup HTTP listener. Respond "ok" on any HTTP request
+  mg_http_listen(
+      &mgr, "http://0.0.0.0",
+      [](struct mg_connection *c, int ev, void *ev_data) {
+        if (ev == MG_EV_HTTP_MSG) mg_http_reply(c, 200, "", "ok\n");
+      },
+      &mgr);
+}
+
+void loop() {
+  mg_mgr_poll(&mgr, 1);
+}

examples/arduino/w5500-mqtt/mongoose.c

@@ -0,0 +1 @@
+../../../mongoose.c

examples/arduino/w5500-mqtt/mongoose.h

@@ -0,0 +1 @@
+../../../mongoose.h

examples/arduino/w5500-mqtt/mongoose_custom.h

@@ -0,0 +1,15 @@
+#pragma once
+
+#include "Arduino.h"
+
+#include <errno.h>
+#include <stdarg.h>
+#include <stdio.h>
+#include <time.h>
+
+#define MG_ARCH MG_ARCH_CUSTOM
+#define MG_ENABLE_SOCKET 0
+#define MG_ENABLE_TCPIP 1
+#define mkdir(a, b) (-1)
+#define MG_IO_SIZE 512
+//#define MG_ENABLE_LOG 0

examples/arduino/w5500-mqtt/net.c

@@ -0,0 +1,58 @@
+#include "net.h"
+
+#define MQTT_SERVER "mqtt://broker.hivemq.com:1883"
+struct mg_connection *mqtt_connection;
+const char *mqtt_subscribe_topic = "mg/rx";
+const char *mqtt_publish_topic = "mg/tx";
+
+struct mg_mgr mgr;  // Mongoose event manager
+struct mg_tcpip_if mif = {.mac = {2, 0, 1, 2, 3, 5}};  // network interface
+
+void mqtt_publish(const char *message) {
+  struct mg_mqtt_opts opts = {};
+  opts.topic = mg_str(mqtt_publish_topic);
+  opts.message = mg_str(message);
+  if (mqtt_connection) mg_mqtt_pub(mqtt_connection, &opts);
+}
+
+static void fn(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_MQTT_OPEN) {
+    MG_INFO(("%lu CONNECTED to %s", c->id, MQTT_SERVER));
+    struct mg_mqtt_opts opts = {};
+    opts.topic = mg_str(mqtt_subscribe_topic);
+    mg_mqtt_sub(c, &opts);
+    MG_INFO(("%lu SUBSCRIBED to %s", c->id, mqtt_subscribe_topic));
+  } else if (ev == MG_EV_MQTT_MSG) {
+    // Received MQTT message
+    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
+    MG_INFO(("%lu RECEIVED %.*s <- %.*s", c->id, (int) mm->data.len,
+             mm->data.ptr, (int) mm->topic.len, mm->topic.ptr));
+    exec_command(mm->data.ptr, mm->data.len);
+  } else if (ev == MG_EV_CLOSE) {
+    MG_INFO(("%lu CLOSED", c->id));
+    mqtt_connection = NULL;
+  }
+}
+
+static void timer_fn(void *arg) {
+  struct mg_mgr *mgr = (struct mg_mgr *) arg;
+  struct mg_mqtt_opts opts;
+  memset(&opts, 0, sizeof(opts));
+  opts.clean = true;
+  if (mif.state == MG_TCPIP_STATE_READY && mqtt_connection == NULL) {
+    mqtt_connection = mg_mqtt_connect(mgr, MQTT_SERVER, &opts, fn, NULL);
+  }
+  // MG_INFO(("Eth: %d, MQTT: %p", mif.state, mqtt_connection));
+}
+
+void net_init(void) {
+  // Set Mongoose logging function to a serial print
+  mg_mgr_init(&mgr);
+
+  mif.driver = &mg_tcpip_driver_w5500;
+  mif.driver_data = &spi;
+  mg_tcpip_init(&mgr, &mif);
+
+  // Start a timer that keeps MQTT connection alive
+  mg_timer_add(&mgr, 3000, MG_TIMER_REPEAT, timer_fn, &mgr);
+}

examples/arduino/w5500-mqtt/net.h

@@ -0,0 +1,16 @@
+#pragma once
+#include "mongoose.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern struct mg_tcpip_spi spi;
+extern struct mg_mgr mgr;
+void mqtt_publish(const char *message);
+void net_init(void);
+void exec_command(const char *req, size_t req_len);
+
+#ifdef __cplusplus
+}
+#endif

examples/arduino/w5500-mqtt/w5500-mqtt.ino

@@ -0,0 +1,51 @@
+#include <SPI.h>
+#include "net.h"
+
+#define SS_PIN 17   // Slave select pin
+struct mg_tcpip_spi spi = {
+    NULL,                                               // SPI data
+    [](void *) { digitalWrite(SS_PIN, LOW); },          // Begin transaction
+    [](void *) { digitalWrite(SS_PIN, HIGH); },         // End transaction
+    [](void *, uint8_t c) { return SPI.transfer(c); },  // Execute transaction
+};
+
+void exec_command(const char *req, size_t req_len) {
+  char res[100];
+  if (req_len == 2 && strncmp(req, "on", req_len) == 0) {
+    digitalWrite(LED_BUILTIN, true);
+    snprintf(res, sizeof(res), "LED on");
+  } else if (req_len == 3 && strncmp(req, "off", req_len) == 0) {
+    digitalWrite(LED_BUILTIN, false);
+    snprintf(res, sizeof(res), "LED off");
+  } else {
+    snprintf(res, sizeof(res), "Unknown command: [%.*s]", (int) req_len, req);
+  }
+  Serial.println(res);
+  mqtt_publish(res);
+}
+
+static void process_input(char c) {
+  static char buf[100];
+  static size_t len = 0;
+  char response[100];
+  if (c != '\n' && c != '\0') buf[len++] = c;  // Append to the buffer
+  if (len >= sizeof(buf)) len = 0;             // On overflow, reset
+  if (c == '\n' && len > 0) {
+    exec_command(buf, len);
+    len = 0;
+  }
+}
+
+void setup() {
+  Serial.begin(115200);
+  SPI.begin();
+  pinMode(SS_PIN, OUTPUT);
+  pinMode(LED_BUILTIN, OUTPUT);
+  mg_log_set_fn([](char ch, void *) { Serial.print(ch); }, NULL);
+  net_init();
+}
+
+void loop() {
+  if (Serial.available()) process_input(Serial.read());
+  mg_mgr_poll(&mgr, 1);
+}

examples/captive-dns-server/Makefile

@@ -1,11 +1,25 @@
-PROG ?= example
+PROG ?= example                   # Program we are building
-CFLAGS ?= -DMG_IO_SIZE=8192 -DMG_ENABLE_LINES
+DELETE = rm -rf                   # Command to remove files
+OUT ?= -o $(PROG)                 # Compiler argument for output file
+SOURCES = main.c mongoose.c       # Source code files
+CFLAGS = -W -Wall -Wextra -g -I.  # Build options
 
-all: $(PROG)
+# Mongoose build options. See https://mongoose.ws/documentation/#build-options
-	$(DEBUGGER) ./$(PROG) $(ARGS)
+CFLAGS_MONGOOSE += -DMG_IO_SIZE=8192 -DMG_ENABLE_LINES
 
-$(PROG): main.c
+ifeq ($(OS),Windows_NT)   # Windows settings. Assume MinGW compiler. To use VC: make CC=cl CFLAGS=/MD OUT=/Feprog.exe
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) -o $(PROG) main.c
+  PROG ?= example.exe           # Use .exe suffix for the binary
+  CC = gcc                      # Use MinGW gcc compiler
+  CFLAGS += -lws2_32            # Link against Winsock library
+  DELETE = cmd /C del /Q /F /S  # Command prompt command to delete files
+  OUT ?= -o $(PROG)             # Build output
+endif
 
-clean:
+all: $(PROG)              # Default target. Build and run program
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb
+	$(RUN) ./$(PROG) $(ARGS)
+
+$(PROG): $(SOURCES)       # Build program from sources
+	$(CC) $(SOURCES) $(CFLAGS) $(CFLAGS_MONGOOSE) $(CFLAGS_EXTRA) $(OUT)
+
+clean:                    # Cleanup. Delete built program and all build artifacts
+	$(DELETE) $(PROG) *.o *.obj *.exe *.dSYM

examples/captive-dns-server/README.md

@@ -1 +1 @@
-See detailed tutorial at https://mongoose.ws/tutorials/captive-dns-portal/
+See detailed tutorial at https://mongoose.ws/tutorials/captive-dns-server/

examples/captive-dns-server/main.c

@@ -20,7 +20,7 @@ uint8_t answer[] = {
     1,    2,    3, 4     // 4 bytes - IP address
 };
 
-static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
+static void fn(struct mg_connection *c, int ev, void *ev_data) {
   if (ev == MG_EV_OPEN) {
     c->is_hexdumping = 1;
   } else if (ev == MG_EV_READ) {
@@ -41,14 +41,13 @@ static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
     }
     mg_iobuf_del(&c->recv, 0, c->recv.len);
   }
-  (void) fn_data;
   (void) ev_data;
 }
 
 int main(void) {
   struct mg_mgr mgr;
 
-  mg_log_set("3");                          // Set log level
+  mg_log_set(MG_LL_DEBUG);                  // Set log level
   mg_mgr_init(&mgr);                        // Initialise event manager
   mg_listen(&mgr, s_listen_url, fn, NULL);  // Start DNS server
   for (;;) mg_mgr_poll(&mgr, 1000);         // Event loop

examples/captive-dns-server/mongoose.c

@@ -0,0 +1 @@
+../../mongoose.c

examples/captive-dns-server/mongoose.h

@@ -0,0 +1 @@
+../../mongoose.h

examples/device-dashboard/Makefile

@@ -1,32 +1,56 @@
-PROG ?= example
+PROG ?= ./example       # Program we are building
-SOURCES ?= ../../mongoose.c main.c web.c packed_fs.c
+PACK ?= ./pack          # Packing executable
-CFLAGS ?= -I../.. -DMG_ENABLE_PACKED_FS=1 $(EXTRA)
+DELETE = rm -rf         # Command to remove files
-FILES_TO_EMBED ?= $(wildcard web_root/*)
+GZIP ?= gzip            # For compressing files in web_root/
-ROOT ?= $(realpath $(CURDIR)/../../..)
+OUT ?= -o $(PROG)       # Compiler argument for output file
-DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CURDIR)
+SOURCES = main.c mongoose.c net.c packed_fs.c   # Source code files
-VC98 ?= $(DOCKER) mdashnet/vc98 wine
+CFLAGS = -W -Wall -Wextra -g -I.                # Build options
-MINGW ?= $(DOCKER) mdashnet/mingw
+NPX ?= npx
 
+# Mongoose build options. See https://mongoose.ws/documentation/#build-options
+CFLAGS_MONGOOSE += -DMG_ENABLE_PACKED_FS=1
+
+ifeq ($(OS),Windows_NT)         # Windows settings. Assume MinGW compiler. To use VC: make CC=cl CFLAGS=/MD OUT=/Feprog.exe
+  PROG = example.exe            # Use .exe suffix for the binary
+  PACK = pack.exe               # Packing executable
+  CC = gcc                      # Use MinGW gcc compiler
+  CFLAGS += -lws2_32            # Link against Winsock library
+  DELETE = cmd /C del /Q /F /S  # Command prompt command to delete files
+  GZIP = echo                   # No gzip on Windows
+endif
+
+# Default target. Build and run program
 all: $(PROG)
-	$(RUN) ./$(PROG)
+	$(RUN) $(PROG) $(ARGS)
 
-$(PROG): $(SOURCES) $(FILES_TO_EMBED)
+# Build program from sources
-	$(CC) ../../test/pack.c -o pack
+$(PROG): $(SOURCES)
-	./pack $(FILES_TO_EMBED) > packed_fs.c
+	$(CC) $(SOURCES) $(CFLAGS) $(CFLAGS_MONGOOSE) $(CFLAGS_EXTRA) $(OUT)
-	$(CC) -W -Wall -Wextra -O0 -g3 $(CFLAGS) -o $(PROG) $(SOURCES)
 
+# Bundle JS libraries (preact, preact-router, ...) into a single file
+web_root/bundle.js:
+	curl -s https://npm.reversehttp.com/preact,preact/hooks,htm/preact,preact-router -o $@
 
-mingw: $(SOURCES) $(FILES_TO_EMBED)
+# Create optimised CSS. Prerequisite: npm -g i tailwindcss tailwindcss-font-inter
-	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) ../../test/pack.c -o pack.exe
+web_root/main.css: web_root/index.html $(wildcard web_root/*.js)
-	$(MINGW) wine cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
+	$(NPX) tailwindcss -o $@ --minify
-	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) $(SOURCES) -lws2_32 -o $(PROG).exe
-	$(MINGW) wine $(PROG).exe
 
-vc98: $(SOURCES) $(FILES_TO_EMBED)
+# Generate packed filesystem for serving Web UI
-	$(VC98) cl.exe /nologo $(CFLAGS) ../../test/pack.c /Fepack.exe
+packed_fs.c: $(wildcard web_root/*) $(wildcard certs/*) Makefile web_root/main.css web_root/bundle.js
-	$(VC98) cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
+	$(GZIP) web_root/*
-	$(VC98) cl.exe /nologo /O2 $(CFLAGS) $(SOURCES) /Fe$(PROG).exe
+	$(CC) ../../test/pack.c -o $(PACK)
-	$(VC98) $(PROG).exe
+	$(PACK) web_root/* certs/* > $@
+	$(GZIP) -d web_root/*
 
+mbedtls:
+	git clone --depth 1 -b v2.28.2 https://github.com/mbed-tls/mbedtls $@
+
+ifeq ($(TLS), mbedtls)
+CFLAGS += -DMG_TLS=MG_TLS_MBED -Wno-conversion -Imbedtls/include
+CFLAGS += -DMBEDTLS_CONFIG_FILE=\"mbedtls_config.h\" mbedtls/library/*.c
+$(PROG): mbedtls
+endif
+
+# Cleanup. Delete built program and all build artifacts
 clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt pack
+	$(DELETE) $(PROG) $(PACK) *.o *.obj *.exe *.dSYM mbedtls

examples/device-dashboard/README.md

@@ -5,21 +5,22 @@ into an embedded device and provide a complete device dashboard with the
 following features:
 
 - Authentication: login-protected dashboard
-- Multiple logins with different permissions (admin and user)
+- Multiple logins (with possibly different permissions)
-- Web UI is fully embedded into the server/firmware binary, and does not
+- The Web UI can be fully embedded into the firmware binary, then not
-  need a filesystem to serve it. UI is resilient to FS problems
+  needing a filesystem to serve it; so being resilient to FS problems
-- View and change server settings
+- All changes are propagated to all connected clients
-- All changes are propagates to all connected clients
-- Live interactive chat that demonstrates bi-directional data exchange
 
-# Screenshots
+## Screenshots
 
 This is a login screen that prompts for user/password
 
-![](screenshots/login.png)
+![](screenshots/login.webp)
 
-# Main dashboard
+## Main dashboard
 
-A main dashboard page shows device settings form, and live chat
+The main dashboard page shows the interactive console
 
-![](screenshots/dashboard.png)
+![](screenshots/dashboard.webp)
+
+
+See a detailed tutorial at https://mongoose.ws/tutorials/device-dashboard/

examples/device-dashboard/certs/server_cert.pem

@@ -0,0 +1,8 @@
+-----BEGIN CERTIFICATE-----
+MIIBCTCBsAIJAK9wbIDkHnAoMAoGCCqGSM49BAMCMA0xCzAJBgNVBAYTAklFMB4X
+DTIzMDEyOTIxMjEzOFoXDTMzMDEyNjIxMjEzOFowDTELMAkGA1UEBhMCSUUwWTAT
+BgcqhkjOPQIBBggqhkjOPQMBBwNCAARzSQS5OHd17lUeNI+6kp9WYu0cxuEIi/JT
+jphbCmdJD1cUvhmzM9/phvJT9ka10Z9toZhgnBq0o0xfTQ4jC1vwMAoGCCqGSM49
+BAMCA0gAMEUCIQCe0T2E0GOiVe9KwvIEPeX1J1J0T7TNacgR0Ya33HV9VgIgNvdn
+aEWiBp1xshs4iz6WbpxrS1IHucrqkZuJLfNZGZI=
+-----END CERTIFICATE-----

examples/device-dashboard/certs/server_key.pem

@@ -0,0 +1,5 @@
+-----BEGIN EC PRIVATE KEY-----
+MHcCAQEEICBz3HOkQLPBDtdknqC7k1PNsWj6HfhyNB5MenfjmqiooAoGCCqGSM49
+AwEHoUQDQgAEc0kEuTh3de5VHjSPupKfVmLtHMbhCIvyU46YWwpnSQ9XFL4ZszPf
+6YbyU/ZGtdGfbaGYYJwatKNMX00OIwtb8A==
+-----END EC PRIVATE KEY-----

examples/device-dashboard/main.c

@@ -1,15 +1,32 @@
-// Copyright (c) 2020-2022 Cesanta Software Limited
+// Copyright (c) 2020-2023 Cesanta Software Limited
 // All rights reserved
 
 #include "mongoose.h"
+#include "net.h"
 
-void device_dashboard_fn(struct mg_connection *, int, void *, void *);
+static int s_sig_num;
+static void signal_handler(int sig_num) {
+  signal(sig_num, signal_handler);
+  s_sig_num = sig_num;
+}
 
 int main(void) {
   struct mg_mgr mgr;
+
+  signal(SIGPIPE, SIG_IGN);
+  signal(SIGINT, signal_handler);
+  signal(SIGTERM, signal_handler);
+
+  mg_log_set(MG_LL_DEBUG);  // Set debug log level
   mg_mgr_init(&mgr);
-  mg_http_listen(&mgr, "http://0.0.0.0:8000", device_dashboard_fn, &mgr);
+
-  for (;;) mg_mgr_poll(&mgr, 1000);
+  web_init(&mgr);
+  while (s_sig_num == 0) {
+    mg_mgr_poll(&mgr, 50);
+  }
+
   mg_mgr_free(&mgr);
+  MG_INFO(("Exiting on signal %d", s_sig_num));
+
   return 0;
 }

examples/device-dashboard/mbedtls_config.h

@@ -0,0 +1,64 @@
+/* Workaround for some mbedtls source files using INT_MAX without including limits.h */
+#include <limits.h>
+
+#define MBEDTLS_NO_PLATFORM_ENTROPY
+//#define MBEDTLS_ENTROPY_HARDWARE_ALT
+#define MBEDTLS_SSL_OUT_CONTENT_LEN    2048
+#define MBEDTLS_ALLOW_PRIVATE_ACCESS
+#define MBEDTLS_HAVE_TIME
+#define MBEDTLS_SSL_SESSION_TICKETS
+
+#define MBEDTLS_CIPHER_MODE_CBC
+#define MBEDTLS_ECP_DP_SECP192R1_ENABLED
+#define MBEDTLS_ECP_DP_SECP224R1_ENABLED
+#define MBEDTLS_ECP_DP_SECP256R1_ENABLED
+#define MBEDTLS_ECP_DP_SECP384R1_ENABLED
+#define MBEDTLS_ECP_DP_SECP521R1_ENABLED
+#define MBEDTLS_ECP_DP_SECP192K1_ENABLED
+#define MBEDTLS_ECP_DP_SECP224K1_ENABLED
+#define MBEDTLS_ECP_DP_SECP256K1_ENABLED
+#define MBEDTLS_ECP_DP_BP256R1_ENABLED
+#define MBEDTLS_ECP_DP_BP384R1_ENABLED
+#define MBEDTLS_ECP_DP_BP512R1_ENABLED
+#define MBEDTLS_ECP_DP_CURVE25519_ENABLED
+#define MBEDTLS_KEY_EXCHANGE_RSA_ENABLED
+#define MBEDTLS_PKCS1_V15
+#define MBEDTLS_SHA256_SMALLER
+#define MBEDTLS_SSL_SERVER_NAME_INDICATION
+#define MBEDTLS_AES_C
+#define MBEDTLS_ASN1_PARSE_C
+#define MBEDTLS_BIGNUM_C
+#define MBEDTLS_CIPHER_C
+#define MBEDTLS_CTR_DRBG_C
+#define MBEDTLS_ENTROPY_C
+#define MBEDTLS_ERROR_C
+#define MBEDTLS_MD_C
+#define MBEDTLS_MD5_C
+#define MBEDTLS_OID_C
+#define MBEDTLS_PKCS5_C
+#define MBEDTLS_PK_C
+#define MBEDTLS_PK_PARSE_C
+#define MBEDTLS_PLATFORM_C
+#define MBEDTLS_RSA_C
+#define MBEDTLS_SHA1_C
+#define MBEDTLS_SHA224_C
+#define MBEDTLS_SHA256_C
+#define MBEDTLS_SHA512_C
+#define MBEDTLS_SSL_CLI_C
+#define MBEDTLS_SSL_SRV_C
+#define MBEDTLS_SSL_TLS_C
+#define MBEDTLS_X509_CRT_PARSE_C
+#define MBEDTLS_X509_USE_C
+#define MBEDTLS_AES_FEWER_TABLES
+#define MBEDTLS_PEM_PARSE_C
+#define MBEDTLS_BASE64_C
+#define MBEDTLS_SSL_TICKET_C
+
+#define MBEDTLS_SSL_PROTO_TLS1_3
+#define MBEDTLS_SSL_PROTO_TLS1_2
+#define MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED
+#define MBEDTLS_GCM_C
+#define MBEDTLS_ECDH_C
+#define MBEDTLS_ECP_C
+#define MBEDTLS_ECDSA_C
+#define MBEDTLS_ASN1_WRITE_C

examples/device-dashboard/mongoose.c

@@ -0,0 +1 @@
+../../mongoose.c

examples/device-dashboard/mongoose.h

@@ -0,0 +1 @@
+../../mongoose.h

examples/device-dashboard/net.c

@@ -0,0 +1,327 @@
+// Copyright (c) 2023 Cesanta Software Limited
+// All rights reserved
+
+#include "net.h"
+
+// Authenticated user.
+// A user can be authenticated by:
+//   - a name:pass pair, passed in a header Authorization: Basic .....
+//   - an access_token, passed in a header Cookie: access_token=....
+// When a user is shown a login screen, she enters a user:pass. If successful,
+// a server responds with a http-only access_token cookie set.
+struct user {
+  const char *name, *pass, *access_token;
+};
+
+// Settings
+struct settings {
+  bool log_enabled;
+  int log_level;
+  long brightness;
+  char *device_name;
+};
+
+static struct settings s_settings = {true, 1, 57, NULL};
+
+static const char *s_json_header =
+    "Content-Type: application/json\r\n"
+    "Cache-Control: no-cache\r\n";
+static uint64_t s_boot_timestamp = 0;  // Updated by SNTP
+
+// This is for newlib and TLS (mbedTLS)
+uint64_t mg_now(void) {
+  return mg_millis() + s_boot_timestamp;
+}
+
+int ui_event_next(int no, struct ui_event *e) {
+  if (no < 0 || no >= MAX_EVENTS_NO) return 0;
+
+  srand((unsigned) no);
+  e->type = (uint8_t) rand() % 4;
+  e->prio = (uint8_t) rand() % 3;
+  e->timestamp =
+      (unsigned long) ((int64_t) mg_now() - 86400 * 1000 /* one day back */ +
+                       no * 300 * 1000 /* 5 mins between alerts */ +
+                       1000 * (rand() % 300) /* randomize event time */) /
+      1000UL;
+
+  mg_snprintf(e->text, MAX_EVENT_TEXT_SIZE, "event#%d", no);
+  return no + 1;
+}
+
+// SNTP connection event handler. When we get a response from an SNTP server,
+// adjust s_boot_timestamp. We'll get a valid time from that point on
+static void sfn(struct mg_connection *c, int ev, void *ev_data) {
+  uint64_t *expiration_time = (uint64_t *) c->data;
+  if (ev == MG_EV_OPEN) {
+    *expiration_time = mg_millis() + 3000;  // Store expiration time in 3s
+  } else if (ev == MG_EV_SNTP_TIME) {
+    uint64_t t = *(uint64_t *) ev_data;
+    s_boot_timestamp = t - mg_millis();
+    c->is_closing = 1;
+  } else if (ev == MG_EV_POLL) {
+    if (mg_millis() > *expiration_time) c->is_closing = 1;
+  }
+}
+
+static void timer_sntp_fn(void *param) {  // SNTP timer function. Sync up time
+  mg_sntp_connect(param, "udp://time.google.com:123", sfn, NULL);
+}
+
+// Parse HTTP requests, return authenticated user or NULL
+static struct user *authenticate(struct mg_http_message *hm) {
+  // In production, make passwords strong and tokens randomly generated
+  // In this example, user list is kept in RAM. In production, it can
+  // be backed by file, database, or some other method.
+  static struct user users[] = {
+      {"admin", "admin", "admin_token"},
+      {"user1", "user1", "user1_token"},
+      {"user2", "user2", "user2_token"},
+      {NULL, NULL, NULL},
+  };
+  char user[64], pass[64];
+  struct user *u, *result = NULL;
+  mg_http_creds(hm, user, sizeof(user), pass, sizeof(pass));
+  MG_VERBOSE(("user [%s] pass [%s]", user, pass));
+
+  if (user[0] != '\0' && pass[0] != '\0') {
+    // Both user and password is set, search by user/password
+    for (u = users; result == NULL && u->name != NULL; u++)
+      if (strcmp(user, u->name) == 0 && strcmp(pass, u->pass) == 0) result = u;
+  } else if (user[0] == '\0') {
+    // Only password is set, search by token
+    for (u = users; result == NULL && u->name != NULL; u++)
+      if (strcmp(pass, u->access_token) == 0) result = u;
+  }
+  return result;
+}
+
+static void handle_login(struct mg_connection *c, struct user *u) {
+  char cookie[256];
+  mg_snprintf(cookie, sizeof(cookie),
+              "Set-Cookie: access_token=%s; Path=/; "
+              "%sHttpOnly; SameSite=Lax; Max-Age=%d\r\n",
+              u->access_token, c->is_tls ? "Secure; " : "", 3600 * 24);
+  mg_http_reply(c, 200, cookie, "{%m:%m}", MG_ESC("user"), MG_ESC(u->name));
+}
+
+static void handle_logout(struct mg_connection *c) {
+  char cookie[256];
+  mg_snprintf(cookie, sizeof(cookie),
+              "Set-Cookie: access_token=; Path=/; "
+              "Expires=Thu, 01 Jan 1970 00:00:00 UTC; "
+              "%sHttpOnly; Max-Age=0; \r\n",
+              c->is_tls ? "Secure; " : "");
+  mg_http_reply(c, 200, cookie, "true\n");
+}
+
+static void handle_debug(struct mg_connection *c, struct mg_http_message *hm) {
+  int level = mg_json_get_long(hm->body, "$.level", MG_LL_DEBUG);
+  mg_log_set(level);
+  mg_http_reply(c, 200, "", "Debug level set to %d\n", level);
+}
+
+static size_t print_int_arr(void (*out)(char, void *), void *ptr, va_list *ap) {
+  size_t i, len = 0, num = va_arg(*ap, size_t);  // Number of items in the array
+  int *arr = va_arg(*ap, int *);              // Array ptr
+  for (i = 0; i < num; i++) {
+    len += mg_xprintf(out, ptr, "%s%d", i == 0 ? "" : ",", arr[i]);
+  }
+  return len;
+}
+
+static void handle_stats_get(struct mg_connection *c) {
+  int points[] = {21, 22, 22, 19, 18, 20, 23, 23, 22, 22, 22, 23, 22};
+  mg_http_reply(c, 200, s_json_header, "{%m:%d,%m:%d,%m:[%M]}\n",
+                MG_ESC("temperature"), 21,  //
+                MG_ESC("humidity"), 67,     //
+                MG_ESC("points"), print_int_arr,
+                sizeof(points) / sizeof(points[0]), points);
+}
+
+static size_t print_events(void (*out)(char, void *), void *ptr, va_list *ap) {
+  size_t len = 0;
+  struct ui_event ev;
+  int pageno = va_arg(*ap, int);
+  int no = (pageno - 1) * EVENTS_PER_PAGE;
+  int end = no + EVENTS_PER_PAGE;
+
+  while ((no = ui_event_next(no, &ev)) != 0 && no <= end) {
+    len += mg_xprintf(out, ptr, "%s{%m:%lu,%m:%d,%m:%d,%m:%m}\n",  //
+                      len == 0 ? "" : ",",                         //
+                      MG_ESC("time"), ev.timestamp,                //
+                      MG_ESC("type"), ev.type,                     //
+                      MG_ESC("prio"), ev.prio,                     //
+                      MG_ESC("text"), MG_ESC(ev.text));
+  }
+
+  return len;
+}
+
+static void handle_events_get(struct mg_connection *c,
+                              struct mg_http_message *hm) {
+  int pageno = mg_json_get_long(hm->body, "$.page", 1);
+  mg_http_reply(c, 200, s_json_header, "{%m:[%M], %m:%d}\n", MG_ESC("arr"),
+                print_events, pageno, MG_ESC("totalCount"), MAX_EVENTS_NO);
+}
+
+static void handle_settings_set(struct mg_connection *c, struct mg_str body) {
+  struct settings settings;
+  char *s = mg_json_get_str(body, "$.device_name");
+  bool ok = true;
+  memset(&settings, 0, sizeof(settings));
+  mg_json_get_bool(body, "$.log_enabled", &settings.log_enabled);
+  settings.log_level = mg_json_get_long(body, "$.log_level", 0);
+  settings.brightness = mg_json_get_long(body, "$.brightness", 0);
+  if (s && strlen(s) < MAX_DEVICE_NAME) {
+    free(settings.device_name);
+    settings.device_name = s;
+  } else {
+    free(s);
+  }
+  s_settings = settings; // Save to the device flash
+  mg_http_reply(c, 200, s_json_header,
+                "{%m:%s,%m:%m}",                          //
+                MG_ESC("status"), ok ? "true" : "false",  //
+                MG_ESC("message"), MG_ESC(ok ? "Success" : "Failed"));
+}
+
+static void handle_settings_get(struct mg_connection *c) {
+  mg_http_reply(c, 200, s_json_header, "{%m:%s,%m:%hhu,%m:%hhu,%m:%m}\n",  //
+                MG_ESC("log_enabled"),
+                s_settings.log_enabled ? "true" : "false",    //
+                MG_ESC("log_level"), s_settings.log_level,    //
+                MG_ESC("brightness"), s_settings.brightness,  //
+                MG_ESC("device_name"), MG_ESC(s_settings.device_name));
+}
+
+static void handle_firmware_upload(struct mg_connection *c,
+                                   struct mg_http_message *hm) {
+  char name[64], offset[20], total[20];
+  struct mg_str data = hm->body;
+  long ofs = -1, tot = -1;
+  name[0] = offset[0] = '\0';
+  mg_http_get_var(&hm->query, "name", name, sizeof(name));
+  mg_http_get_var(&hm->query, "offset", offset, sizeof(offset));
+  mg_http_get_var(&hm->query, "total", total, sizeof(total));
+  MG_INFO(("File %s, offset %s, len %lu", name, offset, data.len));
+  if ((ofs = mg_json_get_long(mg_str(offset), "$", -1)) < 0 ||
+      (tot = mg_json_get_long(mg_str(total), "$", -1)) < 0) {
+    mg_http_reply(c, 500, "", "offset and total not set\n");
+  } else if (ofs == 0 && mg_ota_begin((size_t) tot) == false) {
+    mg_http_reply(c, 500, "", "mg_ota_begin(%ld) failed\n", tot);
+  } else if (data.len > 0 && mg_ota_write(data.ptr, data.len) == false) {
+    mg_http_reply(c, 500, "", "mg_ota_write(%lu) @%ld failed\n", data.len, ofs);
+    mg_ota_end();
+  } else if (data.len == 0 && mg_ota_end() == false) {
+    mg_http_reply(c, 500, "", "mg_ota_end() failed\n", tot);
+  } else {
+    mg_http_reply(c, 200, s_json_header, "true\n");
+    if (data.len == 0) {
+      // Successful mg_ota_end() called, schedule device reboot
+      mg_timer_add(c->mgr, 500, 0, (void (*)(void *)) mg_device_reset, NULL);
+    }
+  }
+}
+
+static void handle_firmware_commit(struct mg_connection *c) {
+  mg_http_reply(c, 200, s_json_header, "%s\n",
+                mg_ota_commit() ? "true" : "false");
+}
+
+static void handle_firmware_rollback(struct mg_connection *c) {
+  mg_http_reply(c, 200, s_json_header, "%s\n",
+                mg_ota_rollback() ? "true" : "false");
+}
+
+static size_t print_status(void (*out)(char, void *), void *ptr, va_list *ap) {
+  int fw = va_arg(*ap, int);
+  return mg_xprintf(out, ptr, "{%m:%d,%m:%c%lx%c,%m:%u,%m:%u}\n",
+                    MG_ESC("status"), mg_ota_status(fw), MG_ESC("crc32"), '"',
+                    mg_ota_crc32(fw), '"', MG_ESC("size"), mg_ota_size(fw),
+                    MG_ESC("timestamp"), mg_ota_timestamp(fw));
+}
+
+static void handle_firmware_status(struct mg_connection *c) {
+  mg_http_reply(c, 200, s_json_header, "[%M,%M]\n", print_status,
+                MG_FIRMWARE_CURRENT, print_status, MG_FIRMWARE_PREVIOUS);
+}
+
+static void handle_device_reset(struct mg_connection *c) {
+  mg_http_reply(c, 200, s_json_header, "true\n");
+  mg_timer_add(c->mgr, 500, 0, (void (*)(void *)) mg_device_reset, NULL);
+}
+
+static void handle_device_eraselast(struct mg_connection *c) {
+  size_t ss = mg_flash_sector_size(), size = mg_flash_size();
+  char *base = (char *) mg_flash_start(), *last = base + size - ss;
+  if (mg_flash_bank() == 2) last -= size / 2;
+  mg_flash_erase(last);
+  mg_http_reply(c, 200, s_json_header, "true\n");
+}
+
+// HTTP request handler function
+static void fn(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_ACCEPT) {
+    if (c->fn_data != NULL) {  // TLS listener!
+      struct mg_tls_opts opts = {0};
+      opts.cert = mg_unpacked("/certs/server_cert.pem");
+      opts.key = mg_unpacked("/certs/server_key.pem");
+      mg_tls_init(c, &opts);
+    }
+  } else if (ev == MG_EV_HTTP_MSG) {
+    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
+    struct user *u = authenticate(hm);
+
+    if (mg_http_match_uri(hm, "/api/#") && u == NULL) {
+      mg_http_reply(c, 403, "", "Not Authorised\n");
+    } else if (mg_http_match_uri(hm, "/api/login")) {
+      handle_login(c, u);
+    } else if (mg_http_match_uri(hm, "/api/logout")) {
+      handle_logout(c);
+    } else if (mg_http_match_uri(hm, "/api/debug")) {
+      handle_debug(c, hm);
+    } else if (mg_http_match_uri(hm, "/api/stats/get")) {
+      handle_stats_get(c);
+    } else if (mg_http_match_uri(hm, "/api/events/get")) {
+      handle_events_get(c, hm);
+    } else if (mg_http_match_uri(hm, "/api/settings/get")) {
+      handle_settings_get(c);
+    } else if (mg_http_match_uri(hm, "/api/settings/set")) {
+      handle_settings_set(c, hm->body);
+    } else if (mg_http_match_uri(hm, "/api/firmware/upload")) {
+      handle_firmware_upload(c, hm);
+    } else if (mg_http_match_uri(hm, "/api/firmware/commit")) {
+      handle_firmware_commit(c);
+    } else if (mg_http_match_uri(hm, "/api/firmware/rollback")) {
+      handle_firmware_rollback(c);
+    } else if (mg_http_match_uri(hm, "/api/firmware/status")) {
+      handle_firmware_status(c);
+    } else if (mg_http_match_uri(hm, "/api/device/reset")) {
+      handle_device_reset(c);
+    } else if (mg_http_match_uri(hm, "/api/device/eraselast")) {
+      handle_device_eraselast(c);
+    } else {
+      struct mg_http_serve_opts opts;
+      memset(&opts, 0, sizeof(opts));
+#if MG_ARCH == MG_ARCH_UNIX || MG_ARCH == MG_ARCH_WIN32
+      opts.root_dir = "web_root";  // On workstations, use filesystem
+#else
+      opts.root_dir = "/web_root";  // On embedded, use packed files
+      opts.fs = &mg_fs_packed;
+#endif
+      mg_http_serve_dir(c, ev_data, &opts);
+    }
+    MG_DEBUG(("%lu %.*s %.*s -> %.*s", c->id, (int) hm->method.len,
+              hm->method.ptr, (int) hm->uri.len, hm->uri.ptr, (int) 3,
+              &c->send.buf[9]));
+  }
+}
+
+void web_init(struct mg_mgr *mgr) {
+  s_settings.device_name = strdup("My Device");
+  mg_http_listen(mgr, HTTP_URL, fn, NULL);
+  mg_http_listen(mgr, HTTPS_URL, fn, (void *) 1);
+  mg_timer_add(mgr, 3600 * 1000, MG_TIMER_RUN_NOW | MG_TIMER_REPEAT,
+               timer_sntp_fn, mgr);
+}

examples/device-dashboard/net.h

@@ -0,0 +1,35 @@
+// Copyright (c) 2023 Cesanta Software Limited
+// All rights reserved
+#pragma once
+
+#include "mongoose.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#if !defined(HTTP_URL)
+#define HTTP_URL "http://0.0.0.0:8000"
+#endif
+
+#if !defined(HTTPS_URL)
+#define HTTPS_URL "https://0.0.0.0:8443"
+#endif
+
+#define MAX_DEVICE_NAME 40
+#define MAX_EVENTS_NO 400
+#define MAX_EVENT_TEXT_SIZE 10
+#define EVENTS_PER_PAGE 20
+
+// Event log entry
+struct ui_event {
+  uint8_t type, prio;
+  unsigned long timestamp;
+  char text[10];
+};
+
+void web_init(struct mg_mgr *mgr);
+
+#ifdef __cplusplus
+}
+#endif

examples/device-dashboard/tailwind.config.js

@@ -0,0 +1,17 @@
+module.exports = {
+  content: ['./web_root/*.{html,js}'],
+  xplugins: [ 'tailwindcss', 'xautoprefixer' ],
+  corePlugins: {outline: false},
+  theme: {
+    extend: {},
+    fontFamily: {
+      sans:
+      [
+        "Inter var, Helvetica, sans-serif", {
+          fontFeatureSettings: '"cv11", "ss01"',
+          fontVariationSettings: '"opsz" 32',
+        }
+      ]
+    }
+  }
+}

examples/device-dashboard/web.c

@@ -1,130 +0,0 @@
-// Copyright (c) 2020-2022 Cesanta Software Limited
-// All rights reserved
-
-#include "mongoose.h"
-
-// Authenticated user.
-// A user can be authenticated by:
-//   - a name:pass pair
-//   - a token
-// When a user is shown a login screen, she enters a user:pass. If successful,
-// a server returns user info which includes token. From that point on,
-// client can use token for authentication. Tokens could be refreshed/changed
-// on a server side, forcing clients to re-login.
-struct user {
-  const char *name, *pass, *token;
-};
-
-// This is a configuration structure we're going to show on a dashboard
-static struct config {
-  int value1;
-  char *value2;
-} s_config = {123, NULL};
-
-// Update config structure. Return true if changed, false otherwise
-static bool update_config(struct mg_http_message *hm, struct config *cfg) {
-  bool changed = false;
-  char buf[256];
-  if (mg_http_get_var(&hm->body, "value1", buf, sizeof(buf)) > 0) {
-    cfg->value1 = atoi(buf);
-    changed = true;
-  }
-  if (mg_http_get_var(&hm->body, "value2", buf, sizeof(buf)) > 0) {
-    free(cfg->value2);
-    cfg->value2 = malloc(strlen(buf) + 1);
-    strcpy(cfg->value2, buf);
-    changed = true;
-  }
-  return changed;
-}
-
-// Parse HTTP requests, return authenticated user or NULL
-static struct user *getuser(struct mg_http_message *hm) {
-  // In production, make passwords strong and tokens randomly generated
-  // In this example, user list is kept in RAM. In production, it can
-  // be backed by file, database, or some other method.
-  static struct user users[] = {
-      {"admin", "pass0", "admin_token"},
-      {"user1", "pass1", "user1_token"},
-      {"user2", "pass2", "user2_token"},
-      {NULL, NULL, NULL},
-  };
-  char user[256], pass[256];
-  struct user *u;
-  mg_http_creds(hm, user, sizeof(user), pass, sizeof(pass));
-  if (user[0] != '\0' && pass[0] != '\0') {
-    // Both user and password is set, search by user/password
-    for (u = users; u->name != NULL; u++)
-      if (strcmp(user, u->name) == 0 && strcmp(pass, u->pass) == 0) return u;
-  } else if (user[0] == '\0') {
-    // Only password is set, search by token
-    for (u = users; u->name != NULL; u++)
-      if (strcmp(pass, u->token) == 0) return u;
-  }
-  return NULL;
-}
-
-// Notify all config watchers about the config change
-static void send_notification(struct mg_mgr *mgr, const char *name,
-                              const char *data) {
-  struct mg_connection *c;
-  for (c = mgr->conns; c != NULL; c = c->next) {
-    if (c->label[0] == 'W')
-      mg_http_printf_chunk(c, "{\"name\": \"%s\", \"data\": \"%s\"}", name,
-                           data == NULL ? "" : data);
-  }
-}
-
-// HTTP request handler function
-void device_dashboard_fn(struct mg_connection *c, int ev, void *ev_data,
-                         void *fn_data) {
-  if (ev == MG_EV_HTTP_MSG) {
-    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
-    struct user *u = getuser(hm);
-    // MG_INFO(("%p [%.*s] auth %s", c->fd, (int) hm->uri.len, hm->uri.ptr,
-    // u ? u->name : "NULL"));
-    if (mg_http_match_uri(hm, "/api/hi")) {
-      mg_http_reply(c, 200, "", "hi\n");  // Testing endpoint
-    } else if (u == NULL && mg_http_match_uri(hm, "/api/#")) {
-      // All URIs starting with /api/ must be authenticated
-      mg_printf(c, "%s", "HTTP/1.1 403 Denied\r\nContent-Length: 0\r\n\r\n");
-    } else if (mg_http_match_uri(hm, "/api/config/get")) {
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-      mg_http_printf_chunk(c, "{\"%s\":%d,\"%s\":\"%s\"}", "value1",
-                           s_config.value1, "value2", s_config.value2);
-      mg_http_printf_chunk(c, "");
-    } else if (mg_http_match_uri(hm, "/api/config/set")) {
-      // Admins only
-      if (strcmp(u->name, "admin") == 0) {
-        if (update_config(hm, &s_config))
-          send_notification(fn_data, "config", NULL);
-        mg_printf(c, "HTTP/1.1 200 OK\r\nContent-Length: 0\r\n\r\n");
-      } else {
-        mg_printf(c, "%s", "HTTP/1.1 403 Denied\r\nContent-Length: 0\r\n\r\n");
-      }
-    } else if (mg_http_match_uri(hm, "/api/message/send")) {
-      char buf[256];
-      if (mg_http_get_var(&hm->body, "message", buf, sizeof(buf)) > 0) {
-        send_notification(fn_data, "message", buf);
-      }
-      mg_printf(c, "HTTP/1.1 200 OK\r\nContent-Length: 0\r\n\r\n");
-    } else if (mg_http_match_uri(hm, "/api/watch")) {
-      c->label[0] = 'W';  // Mark ourselves as a event listener
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-    } else if (mg_http_match_uri(hm, "/api/login")) {
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-      mg_http_printf_chunk(c, "{\"user\":\"%s\",\"token\":\"%s\"}\n", u->name,
-                           u->token);
-      mg_http_printf_chunk(c, "");
-    } else {
-      struct mg_http_serve_opts opts = {0};
-#if 1
-      opts.root_dir = "/web_root";
-      opts.fs = &mg_fs_packed;
-#else
-      opts.root_dir = "web_root";
-#endif
-      mg_http_serve_dir(c, ev_data, &opts);
-    }
-  }
-}

examples/device-dashboard/web_root/bundle.js

@@ -0,0 +1 @@
+var n,t,e,_,r,o,i,u,l,c={},a=[],s=/acit|ex(?:s|g|n|p|$)|rph|grid|ows|mnc|ntw|ine[ch]|zoo|^ord|itera/i;function f(n,t){for(var e in t)n[e]=t[e];return n}function p(n){var t=n.parentNode;t&&t.removeChild(n)}function h(t,e,_){var r,o,i,u={};for(i in e)"key"==i?r=e[i]:"ref"==i?o=e[i]:u[i]=e[i];if(arguments.length>2&&(u.children=arguments.length>3?n.call(arguments,2):_),"function"==typeof t&&null!=t.defaultProps)for(i in t.defaultProps)void 0===u[i]&&(u[i]=t.defaultProps[i]);return d(t,u,r,o,null)}function d(n,_,r,o,i){var u={type:n,props:_,key:r,ref:o,__k:null,__:null,__b:0,__e:null,__d:void 0,__c:null,__h:null,constructor:void 0,__v:null==i?++e:i};return null==i&&null!=t.vnode&&t.vnode(u),u}function v(){return{current:null}}function m(n){return n.children}function y(n,t){this.props=n,this.context=t}function g(n,t){if(null==t)return n.__?g(n.__,n.__.__k.indexOf(n)+1):null;for(var e;t<n.__k.length;t++)if(null!=(e=n.__k[t])&&null!=e.__e)return e.__e;return"function"==typeof n.type?g(n):null}function b(n){var t,e;if(null!=(n=n.__)&&null!=n.__c){for(n.__e=n.__c.base=null,t=0;t<n.__k.length;t++)if(null!=(e=n.__k[t])&&null!=e.__e){n.__e=n.__c.base=e.__e;break}return b(n)}}function k(n){(!n.__d&&(n.__d=!0)&&r.push(n)&&!C.__r++||o!==t.debounceRendering)&&((o=t.debounceRendering)||i)(C)}function C(){var n,t,e,_,o,i,l,c;for(r.sort(u);n=r.shift();)n.__d&&(t=r.length,_=void 0,o=void 0,l=(i=(e=n).__v).__e,(c=e.__P)&&(_=[],(o=f({},i)).__v=i.__v+1,T(c,i,o,e.__n,void 0!==c.ownerSVGElement,null!=i.__h?[l]:null,_,null==l?g(i):l,i.__h),R(_,i),i.__e!=l&&b(i)),r.length>t&&r.sort(u));C.__r=0}function x(n,t,e,_,r,o,i,u,l,s){var f,p,h,v,y,b,k,C=_&&_.__k||a,x=C.length;for(e.__k=[],f=0;f<t.length;f++)if(null!=(v=e.__k[f]=null==(v=t[f])||"boolean"==typeof v||"function"==typeof v?null:"string"==typeof v||"number"==typeof v||"bigint"==typeof v?d(null,v,null,null,v):Array.isArray(v)?d(m,{children:v},null,null,null):v.__b>0?d(v.type,v.props,v.key,v.ref?v.ref:null,v.__v):v)){if(v.__=e,v.__b=e.__b+1,null===(h=C[f])||h&&v.key==h.key&&v.type===h.type)C[f]=void 0;else for(p=0;p<x;p++){if((h=C[p])&&v.key==h.key&&v.type===h.type){C[p]=void 0;break}h=null}T(n,v,h=h||c,r,o,i,u,l,s),y=v.__e,(p=v.ref)&&h.ref!=p&&(k||(k=[]),h.ref&&k.push(h.ref,null,v),k.push(p,v.__c||y,v)),null!=y?(null==b&&(b=y),"function"==typeof v.type&&v.__k===h.__k?v.__d=l=E(v,l,n):l=U(n,v,h,C,y,l),"function"==typeof e.type&&(e.__d=l)):l&&h.__e==l&&l.parentNode!=n&&(l=g(h))}for(e.__e=b,f=x;f--;)null!=C[f]&&("function"==typeof e.type&&null!=C[f].__e&&C[f].__e==e.__d&&(e.__d=A(_).nextSibling),W(C[f],C[f]));if(k)for(f=0;f<k.length;f++)M(k[f],k[++f],k[++f])}function E(n,t,e){for(var _,r=n.__k,o=0;r&&o<r.length;o++)(_=r[o])&&(_.__=n,t="function"==typeof _.type?E(_,t,e):U(e,_,_,r,_.__e,t));return t}function H(n,t){return t=t||[],null==n||"boolean"==typeof n||(Array.isArray(n)?n.some((function(n){H(n,t)})):t.push(n)),t}function U(n,t,e,_,r,o){var i,u,l;if(void 0!==t.__d)i=t.__d,t.__d=void 0;else if(null==e||r!=o||null==r.parentNode)n:if(null==o||o.parentNode!==n)n.appendChild(r),i=null;else{for(u=o,l=0;(u=u.nextSibling)&&l<_.length;l+=1)if(u==r)break n;n.insertBefore(r,o),i=o}return void 0!==i?i:r.nextSibling}function A(n){var t,e,_;if(null==n.type||"string"==typeof n.type)return n.__e;if(n.__k)for(t=n.__k.length-1;t>=0;t--)if((e=n.__k[t])&&(_=A(e)))return _;return null}function P(n,t,e,_,r){var o;for(o in e)"children"===o||"key"===o||o in t||N(n,o,null,e[o],_);for(o in t)r&&"function"!=typeof t[o]||"children"===o||"key"===o||"value"===o||"checked"===o||e[o]===t[o]||N(n,o,t[o],e[o],_)}function S(n,t,e){"-"===t[0]?n.setProperty(t,null==e?"":e):n[t]=null==e?"":"number"!=typeof e||s.test(t)?e:e+"px"}function N(n,t,e,_,r){var o;n:if("style"===t)if("string"==typeof e)n.style.cssText=e;else{if("string"==typeof _&&(n.style.cssText=_=""),_)for(t in _)e&&t in e||S(n.style,t,"");if(e)for(t in e)_&&e[t]===_[t]||S(n.style,t,e[t])}else if("o"===t[0]&&"n"===t[1])o=t!==(t=t.replace(/Capture$/,"")),t=t.toLowerCase()in n?t.toLowerCase().slice(2):t.slice(2),n.l||(n.l={}),n.l[t+o]=e,e?_||n.addEventListener(t,o?D:w,o):n.removeEventListener(t,o?D:w,o);else if("dangerouslySetInnerHTML"!==t){if(r)t=t.replace(/xlink(H|:h)/,"h").replace(/sName$/,"s");else if("width"!==t&&"height"!==t&&"href"!==t&&"list"!==t&&"form"!==t&&"tabIndex"!==t&&"download"!==t&&t in n)try{n[t]=null==e?"":e;break n}catch(n){}"function"==typeof e||(null==e||!1===e&&"-"!==t[4]?n.removeAttribute(t):n.setAttribute(t,e))}}function w(n){return this.l[n.type+!1](t.event?t.event(n):n)}function D(n){return this.l[n.type+!0](t.event?t.event(n):n)}function T(n,e,_,r,o,i,u,l,c){var a,s,p,h,d,v,g,b,k,C,E,H,U,A,P,S=e.type;if(void 0!==e.constructor)return null;null!=_.__h&&(c=_.__h,l=e.__e=_.__e,e.__h=null,i=[l]),(a=t.__b)&&a(e);try{n:if("function"==typeof S){if(b=e.props,k=(a=S.contextType)&&r[a.__c],C=a?k?k.props.value:a.__:r,_.__c?g=(s=e.__c=_.__c).__=s.__E:("prototype"in S&&S.prototype.render?e.__c=s=new S(b,C):(e.__c=s=new y(b,C),s.constructor=S,s.rLine truncated

examples/device-dashboard/web_root/components.js

@@ -0,0 +1,356 @@
+'use strict';
+import { h, render, useState, useEffect, useRef, html, Router } from  './bundle.js';
+
+// Helper function that returns a promise that resolves after delay
+const Delay = (ms, val) => new Promise(resolve => setTimeout(resolve, ms, val));
+
+export const Icons = {
+  heart: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4.318 6.318a4.5 4.5 0 000 6.364L12 20.364l7.682-7.682a4.5 4.5 0 00-6.364-6.364L12 7.636l-1.318-1.318a4.5 4.5 0 00-6.364 0z"></path></svg>`,
+  downArrowBox: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9 8.25H7.5a2.25 2.25 0 00-2.25 2.25v9a2.25 2.25 0 002.25 2.25h9a2.25 2.25 0 002.25-2.25v-9a2.25 2.25 0 00-2.25-2.25H15M9 12l3 3m0 0l3-3m-3 3V2.25" /> </svg>`,
+  upArrowBox: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9 8.25H7.5a2.25 2.25 0 00-2.25 2.25v9a2.25 2.25 0 002.25 2.25h9a2.25 2.25 0 002.25-2.25v-9a2.25 2.25 0 00-2.25-2.25H15m0-3l-3-3m0 0l-3 3m3-3V15" /> </svg>`,
+  cog: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9.594 3.94c.09-.542.56-.94 1.11-.94h2.593c.55 0 1.02.398 1.11.94l.213 1.281c.063.374.313.686.645.87.074.04.147.083.22.127.324.196.72.257 1.075.124l1.217-.456a1.125 1.125 0 011.37.49l1.296 2.247a1.125 1.125 0 01-.26 1.431l-1.003.827c-.293.24-.438.613-.431.992a6.759 6.759 0 010 .255c-.007.378.138.75.43.99l1.005.828c.424.35.534.954.26 1.43l-1.298 2.247a1.125 1.125 0 01-1.369.491l-1.217-.456c-.355-.133-.75-.072-1.076.124a6.57 6.57 0 01-.22.128c-.331.183-.581.495-.644.869l-.213 1.28c-.09.543-.56.941-1.11.941h-2.594c-.55 0-1.02-.398-1.11-.94l-.213-1.281c-.062-.374-.312-.686-.644-.87a6.52 6.52 0 01-.22-.127c-.325-.196-.72-.257-1.076-.124l-1.217.456a1.125 1.125 0 01-1.369-.49l-1.297-2.247a1.125 1.125 0 01.26-1.431l1.004-.827c.292-.24.437-.613.43-.992a6.932 6.932 0 010-.255c.007-.378-.138-.75-.43-.99l-1.004-.828a1.125 1.125 0 01-.26-1.43l1.297-2.247a1.125 1.125 0 011.37-.491l1.216.456c.356.133.751.072 1.076-.124.072-.044.146-.087.22-.128.332-.183.582-.495.644-.869l.214-1.281z" /> <path stroke-linecap="round" stroke-linejoin="round" d="M15 12a3 3 0 11-6 0 3 3 0 016 0z" /> </svg>`,
+  settingsH: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M10.5 6h9.75M10.5 6a1.5 1.5 0 11-3 0m3 0a1.5 1.5 0 10-3 0M3.75 6H7.5m3 12h9.75m-9.75 0a1.5 1.5 0 01-3 0m3 0a1.5 1.5 0 00-3 0m-3.75 0H7.5m9-6h3.75m-3.75 0a1.5 1.5 0 01-3 0m3 0a1.5 1.5 0 00-3 0m-9.75 0h9.75" /> </svg>`,
+  settingsV: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M6 13.5V3.75m0 9.75a1.5 1.5 0 010 3m0-3a1.5 1.5 0 000 3m0 3.75V16.5m12-3V3.75m0 9.75a1.5 1.5 0 010 3m0-3a1.5 1.5 0 000 3m0 3.75V16.5m-6-9V3.75m0 3.75a1.5 1.5 0 010 3m0-3a1.5 1.5 0 000 3m0 9.75V10.5" /> </svg>`,
+  scan: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M7.5 3.75H6A2.25 2.25 0 003.75 6v1.5M16.5 3.75H18A2.25 2.25 0 0120.25 6v1.5m0 9V18A2.25 2.25 0 0118 20.25h-1.5m-9 0H6A2.25 2.25 0 013.75 18v-1.5M15 12a3 3 0 11-6 0 3 3 0 016 0z" /> </svg> `,
+  desktop: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9 17.25v1.007a3 3 0 01-.879 2.122L7.5 21h9l-.621-.621A3 3 0 0115 18.257V17.25m6-12V15a2.25 2.25 0 01-2.25 2.25H5.25A2.25 2.25 0 013 15V5.25m18 0A2.25 2.25 0 0018.75 3H5.25A2.25 2.25 0 003 5.25m18 0V12a2.25 2.25 0 01-2.25 2.25H5.25A2.25 2.25 0 013 12V5.25" /> </svg>`,
+  alert: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M14.857 17.082a23.848 23.848 0 005.454-1.31A8.967 8.967 0 0118 9.75v-.7V9A6 6 0 006 9v.75a8.967 8.967 0 01-2.312 6.022c1.733.64 3.56 1.085 5.455 1.31m5.714 0a24.255 24.255 0 01-5.714 0m5.714 0a3 3 0 11-5.714 0M3.124 7.5A8.969 8.969 0 015.292 3m13.416 0a8.969 8.969 0 012.168 4.5" /> </svg>`,
+  bell: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M14.857 17.082a23.848 23.848 0 005.454-1.31A8.967 8.967 0 0118 9.75v-.7V9A6 6 0 006 9v.75a8.967 8.967 0 01-2.312 6.022c1.733.64 3.56 1.085 5.455 1.31m5.714 0a24.255 24.255 0 01-5.714 0m5.714 0a3 3 0 11-5.714 0M3.124 7.5A8.969 8.969 0 015.292 3m13.416 0a8.969 8.969 0 012.168 4.5" /> </svg>`,
+  refresh: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0l3.181 3.183a8.25 8.25 0 0013.803-3.7M4.031 9.865a8.25 8.25 0 0113.803-3.7l3.181 3.182m0-4.991v4.99" /> </svg> `,
+  bars4: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 5.25h16.5m-16.5 4.5h16.5m-16.5 4.5h16.5m-16.5 4.5h16.5" /> </svg>`,
+  bars3: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 6.75h16.5M3.75 12h16.5m-16.5 5.25h16.5" /> </svg>`,
+  logout: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M12.75 15l3-3m0 0l-3-3m3 3h-7.5M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /> </svg>`,
+  save: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M16.5 3.75V16.5L12 14.25 7.5 16.5V3.75m9 0H18A2.25 2.25 0 0120.25 6v12A2.25 2.25 0 0118 20.25H6A2.25 2.25 0 013.75 18V6A2.25 2.25 0 016 3.75h1.5m9 0h-9" /> </svg>`,
+  email: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M21.75 6.75v10.5a2.25 2.25 0 01-2.25 2.25h-15a2.25 2.25 0 01-2.25-2.25V6.75m19.5 0A2.25 2.25 0 0019.5 4.5h-15a2.25 2.25 0 00-2.25 2.25m19.5 0v.243a2.25 2.25 0 01-1.07 1.916l-7.5 4.615a2.25 2.25 0 01-2.36 0L3.32 8.91a2.25 2.25 0 01-1.07-1.916V6.75" /> </svg>`,
+  expand: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 3.75v4.5m0-4.5h4.5m-4.5 0L9 9M3.75 20.25v-4.5m0 4.5h4.5m-4.5 0L9 15M20.25 3.75h-4.5m4.5 0v4.5m0-4.5L15 9m5.25 11.25h-4.5m4.5 0v-4.5m0 4.5L15 15" /> </svg>`,
+  shrink: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9 9V4.5M9 9H4.5M9 9L3.75 3.75M9 15v4.5M9 15H4.5M9 15l-5.25 5.25M15 9h4.5M15 9V4.5M15 9l5.25-5.25M15 15h4.5M15 15v4.5m0-4.5l5.25 5.25" /> </svg>`,
+  ok: props => html`<svg class=${props.class} fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" aria-hidden="true"> <path stroke-linecap="round" stroke-linejoin="round" d="M9 12.75L11.25 15 15 9.75M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /> </svg>`,
+  fail: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9.75 9.75l4.5 4.5m0-4.5l-4.5 4.5M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /> </svg>`,
+  upload: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3 16.5v2.25A2.25 2.25 0 005.25 21h13.5A2.25 2.25 0 0021 18.75V16.5m-13.5-9L12 3m0 0l4.5 4.5M12 3v13.5" /> </svg> `,
+  download: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3 16.5v2.25A2.25 2.25 0 005.25 21h13.5A2.25 2.25 0 0021 18.75V16.5M16.5 12L12 16.5m0 0L7.5 12m4.5 4.5V3" /> </svg> `,
+  bolt: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 13.5l10.5-11.25L12 10.5h8.25L9.75 21.75 12 13.5H3.75z" /> </svg>`,
+  home: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M2.25 12l8.954-8.955c.44-.439 1.152-.439 1.591 0L21.75 12M4.5 9.75v10.125c0 .621.504 1.125 1.125 1.125H9.75v-4.875c0-.621.504-1.125 1.125-1.125h2.25c.621 0 1.125.504 1.125 1.125V21h4.125c.621 0 1.125-.504 1.125-1.125V9.75M8.25 21h8.25" /> </svg> `,
+  link: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M13.19 8.688a4.5 4.5 0 011.242 7.244l-4.5 4.5a4.5 4.5 0 01-6.364-6.364l1.757-1.757m13.35-.622l1.757-1.757a4.5 4.5 0 00-6.364-6.364l-4.5 4.5a4.5 4.5 0 001.242 7.244" /> </svg> `,
+  shield: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M9 12.75L11.25 15 15 9.75m-3-7.036A11.959 11.959 0 013.598 6 11.99 11.99 0 003 9.749c0 5.592 3.824 10.29 9 11.623 5.176-1.332 9-6.03 9-11.622 0-1.31-.21-2.571-.598-3.751h-.152c-3.196 0-6.1-1.248-8.25-3.285z" /> </svg> `,
+  barsdown: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M3 4.5h14.25M3 9h9.75M3 13.5h9.75m4.5-4.5v12m0 0l-3.75-3.75M17.25 21L21 17.25" /> </svg> `,
+  arrowdown: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M12 4.5v15m0 0l6.75-6.75M12 19.5l-6.75-6.75" /> </svg> `,
+  arrowup: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M12 19.5v-15m0 0l-6.75 6.75M12 4.5l6.75 6.75" /> </svg>`,
+  warn: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126zM12 15.75h.007v.008H12v-.008z" /> </svg>`,
+  info: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M11.25 11.25l.041-.02a.75.75 0 011.063.852l-.708 2.836a.75.75 0 001.063.853l.041-.021M21 12a9 9 0 11-18 0 9 9 0 0118 0zm-9-3.75h.008v.008H12V8.25z" /> </svg>`,
+  exclamationTriangle: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126zM12 15.75h.007v.008H12v-.008z" /> </svg>`,
+  thumbUp: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M6.633 10.5c.806 0 1.533-.446 2.031-1.08a9.041 9.041 0 012.861-2.4c.723-.384 1.35-.956 1.653-1.715a4.498 4.498 0 00.322-1.672V3a.75.75 0 01.75-.75A2.25 2.25 0 0116.5 4.5c0 1.152-.26 2.243-.723 3.218-.266.558.107 1.282.725 1.282h3.126c1.026 0 1.945.694 2.054 1.715.045.422.068.85.068 1.285a11.95 11.95 0 01-2.649 7.521c-.388.482-.987.729-1.605.729H13.48c-.483 0-.964-.078-1.423-.23l-3.114-1.04a4.501 4.501 0 00-1.423-.23H5.904M14.25 9h2.25M5.904 18.75c.083.205.173.405.27.602.197.4-.078.898-.523.898h-.908c-.889 0-1.713-.518-1.972-1.368a12 12 0 01-.521-3.507c0-1.553.295-3.036.831-4.398C3.387 10.203 4.167 9.75 5 9.75h1.053c.472 0 .745.556.5.96a8.958 8.958 0 00-1.302 4.665c0 1.194.232 2.333.654 3.375z" /> </svg>`,
+  backward: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M21 16.811c0 .864-.933 1.405-1.683.977l-7.108-4.062a1.125 1.125 0 010-1.953l7.108-4.062A1.125 1.125 0 0121 8.688v8.123zM11.25 16.811c0 .864-.933 1.405-1.683.977l-7.108-4.062a1.125 1.125 0 010-1.953L9.567 7.71a1.125 1.125 0 011.683.977v8.123z" /> </svg>`,
+  chip: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M8.25 3v1.5M4.5 8.25H3m18 0h-1.5M4.5 12H3m18 0h-1.5m-15 3.75H3m18 0h-1.5M8.25 19.5V21M12 3v1.5m0 15V21m3.75-18v1.5m0 15V21m-9-1.5h10.5a2.25 2.25 0 002.25-2.25V6.75a2.25 2.25 0 00-2.25-2.25H6.75A2.25 2.25 0 004.5 6.75v10.5a2.25 2.25 0 002.25 2.25zm.75-12h9v9h-9v-9z" /> </svg>`,
+  camera: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M6.827 6.175A2.31 2.31 0 015.186 7.23c-.38.054-.757.112-1.134.175C2.999 7.58 2.25 8.507 2.25 9.574V18a2.25 2.25 0 002.25 2.25h15A2.25 2.25 0 0021.75 18V9.574c0-1.067-.75-1.994-1.802-2.169a47.865 47.865 0 00-1.134-.175 2.31 2.31 0 01-1.64-1.055l-.822-1.316a2.192 2.192 0 00-1.736-1.039 48.774 48.774 0 00-5.232 0 2.192 2.192 0 00-1.736 1.039l-.821 1.316z" /> <path stroke-linecap="round" stroke-linejoin="round" d="M16.5 12.75a4.5 4.5 0 11-9 0 4.5 4.5 0 019 0zM18.75 10.5h.008v.008h-.008V10.5z" /> </svg>`,
+  arrows: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M7.5 21L3 16.5m0 0L7.5 12M3 16.5h13.5m0-13.5L21 7.5m0 0L16.5 12M21 7.5H7.5" /> </svg>`,
+  doc: props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"> <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 00-3.375-3.375h-1.5A1.125 1.125 0 0113.5 7.125v-1.5a3.375 3.375 0 00-3.375-3.375H8.25m2.25 0H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 00-9-9z" /></svg>`,
+};
+
+export const tipColors = {
+  green: 'bg-green-100 text-green-900 ring-green-300',
+  yellow: 'bg-yellow-100 text-yellow-900 ring-yellow-300',
+  red: 'bg-red-100 text-red-900 ring-red-300',
+};
+
+export function Button({title, onclick, disabled, cls, icon, ref, colors, hovercolor, disabledcolor}) {
+  const [spin, setSpin] = useState(false);
+  const cb = function(ev) {
+    const res = onclick ? onclick() : null;
+    if (res && typeof (res.catch) === 'function') {
+      setSpin(true);
+      res.catch(() => false).then(() => setSpin(false));
+    }
+  };
+  if (!colors) colors = 'bg-blue-600 hover:bg-blue-500 disabled:bg-blue-400';
+  return html`
+<button type="button" class="inline-flex justify-center items-center gap-2 rounded px-2.5 py-1.5 text-sm font-semibold text-white shadow-sm ${colors} ${cls}"
+  ref=${ref} onclick=${cb} disabled=${disabled || spin} >
+  ${title}
+  <${spin ? Icons.refresh : icon} class="w-4 ${spin ? 'animate-spin' : ''}" />
+<//>`
+};
+
+export function Notification({ok, text, close}) {
+  const closebtn = useRef(null);
+  const from = 'translate-y-2 opacity-0 sm:translate-y-0 sm:translate-x-2';
+  const to = 'translate-y-0 opacity-100 sm:translate-x-0';
+  const [tr, setTr] = useState(from);
+  useEffect(function() {
+    setTr(to); 
+    setTimeout(ev => closebtn && closebtn.current.click && closebtn.current.click(), 1500);
+  }, []);
+  const onclose = ev => { setTr(from); setTimeout(close, 300); };
+  return html`
+<div aria-live="assertive" class="z-10 pointer-events-none absolute inset-0 flex items-end px-4 py-6 sm:items-start sm:p-6">
+  <div class="flex w-full flex-col items-center space-y-4 sm:items-end">
+    <div class="pointer-events-auto w-full max-w-sm overflow-hidden rounded-lg bg-white shadow-lg ring-1 ring-black ring-opacity-5 transform ease-out duration-300 transition ${tr}">
+      <div class="p-4">
+        <div class="flex items-start">
+          <div class="flex-shrink-0">
+            <${ok ? Icons.ok : Icons.fail} class="h-6 w-6 ${ok ? 'text-green-400' : 'text-red-400'}" />
+          <//>
+          <div class="ml-3 w-0 flex-1 pt-0.5">
+            <p class="text-sm font-medium text-gray-900">${text}</p>
+            <p class="hidden mt-1 text-sm text-gray-500">Anyone with a link can now view this file.</p>
+          <//>
+          <div class="ml-4 flex flex-shrink-0">
+            <button type="button" ref=${closebtn} onclick=${onclose} class="inline-flex rounded-md bg-white text-gray-400 hover:text-gray-500 focus:outline-none">
+              <span class="sr-only">Close</span>
+              <svg class="h-5 w-5" viewBox="0 0 20 20" fill="currentColor" aria-hidden="true">
+                <path d="M6.28 5.22a.75.75 0 00-1.06 1.06L8.94 10l-3.72 3.72a.75.75 0 101.06 1.06L10 11.06l3.72 3.72a.75.75 0 101.06-1.06L11.06 10l3.72-3.72a.75.75 0 00-1.06-1.06L10 8.94 6.28 5.22z" />
+              <//>
+            <//>
+          <//>
+        <//>
+      <//>
+    <//>
+  <//>
+<//>`;
+};
+
+export function Login({loginFn, logoIcon, title, tipText}) {
+  const [user, setUser] = useState('');
+  const [pass, setPass] = useState('');
+  const onsubmit = function(ev) {
+    const authhdr = 'Basic ' + btoa(user + ':' + pass);
+    const headers = {Authorization: authhdr};
+    return fetch('api/login', {headers}).then(loginFn).finally(r => setPass(''));
+  };
+  return html`
+<div class="h-full flex items-center justify-center bg-slate-200">
+  <div class="border rounded bg-white w-96 p-5">
+    <div class="my-5 py-2 flex items-center justify-center gap-x-4">
+      <${logoIcon} class="h-12 stroke-cyan-600 stroke-1" />
+      <h1 class="font-bold text-xl">${title || 'Login'}<//>
+    <//>
+    <div class="my-3">
+      <label class="block text-sm mb-1 dark:text-white">Username</label>
+      <input type="text" autocomplete="current-user" required
+        class="font-normal bg-white rounded border border-gray-300 w-full 
+        flex-1 py-0.5 px-2 text-gray-900 placeholder:text-gray-400
+        focus:outline-none sm:text-sm sm:leading-6 disabled:cursor-not-allowed
+        disabled:bg-gray-100 disabled:text-gray-500"
+        oninput=${ev => setUser(ev.target.value)} value=${user}  />
+    <//>
+    <div class="my-3">
+      <label class="block text-sm mb-1 dark:text-white">Password</label>
+      <input type="password" autocomplete="current-password" required
+        class="font-normal bg-white rounded border border-gray-300 w-full flex-1 py-0.5 px-2 text-gray-900 placeholder:text-gray-400 focus:outline-none sm:text-sm sm:leading-6 disabled:cursor-not-allowed disabled:bg-gray-100 disabled:text-gray-500"
+        oninput=${ev => setPass(ev.target.value)}
+        value=${pass} onchange=${onsubmit} />
+    <//>
+    <div class="mt-7">
+      <${Button} title="Sign In" icon=${Icons.logout} onclick=${onsubmit} cls="flex w-full justify-center" />
+    <//>
+    <div class="mt-5 text-slate-400 text-xs">${tipText}<//>
+  <//>
+<//>`;
+};
+
+export function Colored({icon, text, colors}) {
+  colors ||= 'bg-slate-100 text-slate-900';
+  return html`
+<span class="inline-flex items-center gap-1.5 py-0.5">
+  ${icon && html`<${icon} class="w-5 h-5" />`}
+  <span class="inline-block font-medium rounded-md px-2 py-1 text-xs ring-1 ring-inset ${colors}">${text}<//>
+<//>`;
+};
+
+export function Stat({title, text, tipText, tipIcon, tipColors, colors}) {
+  return html`
+<div class="flex flex-col bg-white border shadow-sm rounded-xl dark:bg-slate-900 dark:border-gray-800">
+  <div class="overflow-auto rounded-lg bg-white px-4 py-2 ">
+    <div class="flex items-center gap-x-2">
+      <p class="text-sm truncate text-gray-500 font-medium"> ${title} </p>
+    <//>
+    <div class="mt-1 flex items-center gap-x-2">
+      <h3 class="text-xl truncate font-semibold tracking-tight ${colors || 'text-gray-800 dark:text-gray-200'}">
+        ${text}
+      <//>
+      <span class="flex items-center ${tipText || 'hidden'}">
+        <${Colored} text=${tipText} icon=${tipIcon} colors=${tipColors} />
+      <//>
+    <//>
+  <//>
+<//>`;
+};
+
+export function TextValue({value, setfn, disabled, placeholder, type, addonRight, addonLeft, attr, min, max, step, mult}) {
+  const [bg, setBg] = useState('bg-white');
+  useEffect(() => { if (type == 'number') checkval(+min, +max, +value); }, []);
+  step ||= '1', mult ||= 1;
+  const checkval = function(min, max, v) {
+    setBg('bg-white');
+    if (min && v < min) setBg('bg-red-100 border-red-200');
+    if (max && v > max) setBg('bg-red-100 border-red-200');
+  };
+  const m = step.match(/^.+\.(.+)/);
+  const digits = m ? m[1].length : 0;
+  const onchange = ev => {
+    let v = ev.target.value;
+    if (type == 'number') {
+      checkval(+min, +max, +v);
+      v = +(parseFloat(v) / mult).toFixed(digits);
+    }
+    setfn(v);
+  };
+  if (type == 'number') value = +(value * mult).toFixed(digits);
+  return html`
+<div class="flex w-full items-center rounded border shadow-sm ${bg}">
+  ${addonLeft && html`<span class="inline-flex font-normal truncate py-1 border-r bg-slate-100 items-center border-gray-300 px-2 text-gray-500 text-xs">${addonLeft}<//>` }
+  <input type=${type || 'text'} disabled=${disabled} value=${value}
+    step=${step} min=${min} max=${max} 
+    onchange=${onchange} ...${attr}
+    class="${bg} font-normal text-sm rounded w-full flex-1 py-0.5 px-2 text-gray-700 placeholder:text-gray-400 focus:outline-none disabled:cursor-not-allowed disabled:bg-gray-100 disabled:text-gray-500" placeholder=${placeholder} />
+  ${addonRight && html`<span class="inline-flex font-normal truncate py-1 border-l bg-slate-100 items-center border-gray-300 px-2 text-gray-500 text-xs overflow-scroll" style="min-width: 50%;">${addonRight}<//>` }
+<//>`;
+};
+
+export function SelectValue({value, setfn, options, disabled}) {
+  const toInt = x => x == parseInt(x) ? parseInt(x) : x;
+  const onchange = ev => setfn(toInt(ev.target.value));
+  return html`
+<select onchange=${onchange} class="w-full rounded font-normal border py-0.5 px-1 text-gray-600 focus:outline-none text-sm disabled:cursor-not-allowed" disabled=${disabled}>
+  ${options.map(v => html`<option value=${v[0]} selected=${v[0] == value}>${v[1]}<//>`) }
+<//>`;
+};
+
+export function SwitchValue({value, setfn}) {
+  const onclick = ev => setfn(!value);
+  const bg = !!value ? 'bg-blue-600' : 'bg-gray-200';
+  const tr = !!value ? 'translate-x-5' : 'translate-x-0';
+  return html`
+<button type="button" onclick=${onclick} class="${bg} inline-flex h-6 w-11 flex-shrink-0 cursor-pointer rounded-full border-2 border-transparent transition-colors duration-200 ease-in-out focus:outline-none focus:ring-0 ring-0" role="switch" aria-checked=${!!value}>
+  <span aria-hidden="true" class="${tr} pointer-events-none inline-block h-5 w-5 transform rounded-full bg-white shadow ring-0 focus:ring-0 transition duration-200 ease-in-out"></span>
+</button>`;
+};
+
+export function Setting(props) {
+  let input = TextValue;
+  if (props.type == 'switch') input = SwitchValue;
+  if (props.type == 'select') input = SelectValue;
+  return html`
+<div class=${props.cls || 'grid grid-cols-2 gap-2 my-1'}>
+  <label class="flex items-center text-sm text-gray-700 mr-2 font-medium ${props.title || 'hidden'}">${props.title}<//>
+  <div class="flex items-center">${h(input, props)}<//>
+<//>`;
+};
+
+export function Pagination({ totalItems, itemsPerPage, currentPage, setPageFn, colors }) {
+  const totalPages = Math.ceil(totalItems / itemsPerPage);
+  const maxPageRange = 2;
+  const lessThanSymbol = "<";
+  const greaterThanSymbol = ">";
+  const whiteSpace = " ";
+  const itemcls = 'relative inline-flex items-center px-3 py-1 text-sm focus:z-20 focus-visible:outline focus-visible:outline-2 focus-visible:outline-offset-0 focus-visible:outline-blue-600';
+  colors ||= 'bg-blue-600';
+
+  const PageItem = ({ page, isActive }) => (
+    html`<a
+      onClick=${() => setPageFn(page)}
+      class="${itemcls} ${isActive ? `${colors} text-white` : 'cursor-pointer text-gray-700 ring-1 ring-inset ring-gray-300 hover:bg-gray-50'}"
+    >
+      ${page}
+    </a>`
+  );
+
+  return html`
+    <div class="flex items-center justify-between bg-white px-3 py-2">
+      <div class="sm:flex sm:flex-1 sm:items-center sm:justify-between space-x-4 whitespace-nowrap select-none">
+          <p class="text-sm text-slate-500 font-medium">
+            showing <span class="font-bold text-slate-700">${(currentPage - 1) * itemsPerPage + 1}</span> - <span class="font-medium">${Math.min(currentPage * itemsPerPage, totalItems)}</span> of ${whiteSpace}
+            <span class="font-bold text-slate-700">${totalItems}</span> results
+          </p>
+        <div>
+          <nav class="isolate inline-flex -space-x-px rounded-md" aria-label="Pagination">
+            <a
+              onClick=${() => setPageFn(Math.max(currentPage - 1, 1))}
+              class="relative inline-flex px-3 items-center text-gray-400 ring-1 ring-inset ring-gray-300 hover:bg-gray-50 ${currentPage != 1 ? 'cursor-pointer' : ''} focus:z-20 focus:outline-offset-0">
+              ${lessThanSymbol}
+            </a>
+
+            <${PageItem} page=${1} isActive=${currentPage === 1} />
+            ${currentPage > maxPageRange + 2 ? html`<span class="${itemcls} ring-1 ring-inset ring-gray-300 text-slate-300">...</span>` : ''}
+            ${Array.from({length: Math.min(totalPages, maxPageRange * 2 + 1)}, (_, i) => Math.max(2, currentPage - maxPageRange) + i).map(page => page > 1 && page < totalPages && html`<${PageItem} page=${page} isActive=${currentPage === page} />`)}
+            ${currentPage < totalPages - (maxPageRange + 1) ? html`<span class="${itemcls} ring-1 ring-inset ring-gray-300 text-slate-300">...</span>` : ''}
+            ${totalPages > 1 ? html`<${PageItem} page=${totalPages} isActive=${currentPage === totalPages} />` : ''}
+
+            <a
+              onClick=${() => setPageFn(Math.min(currentPage + 1, totalPages))}
+              class="relative inline-flex px-3 items-center text-gray-400 ring-1 ring-inset ring-gray-300 hover:bg-gray-50 ${currentPage != totalPages ? 'cursor-pointer' : ''} focus:z-20 focus:outline-offset-0">
+              ${greaterThanSymbol}
+            </a>
+          </nav>
+        </div>
+      </div>
+    </div>`;
+};
+
+export function UploadFileButton(props) {
+  const [upload, setUpload] = useState(null);  // Upload promise
+  const [status, setStatus] = useState('');    // Current upload status
+  const btn = useRef(null);
+  const input = useRef(null);
+
+  // Send a large file chunk by chunk
+  const sendFileData = function(url, fileName, fileData, chunkSize) {
+    return new Promise(function(resolve, reject) {
+      const finish = ok => {
+        setUpload(null);
+        const res = props.onupload ? props.onupload(ok, fileName, fileData.length) : null;
+        if (res && typeof (res.catch) === 'function') {
+          res.catch(() => false).then(() => ok ? resolve() : reject());
+        } else {
+          ok ? resolve() : reject();
+        }
+      };
+      const sendChunk = function(offset) {
+        var chunk = fileData.subarray(offset, offset + chunkSize) || '';
+        var opts = {method: 'POST', body: chunk};
+        var fullUrl = url + '?offset=' + offset +
+          '&total=' + fileData.length  +
+          '&name=' + encodeURIComponent(fileName);
+        var ok;
+        setStatus('Uploading ' + fileName + ', bytes ' + offset + '..' +
+          (offset + chunk.length) + ' of ' + fileData.length);
+        fetch(fullUrl, opts)
+          .then(function(res) {
+            if (res.ok && chunk.length > 0) sendChunk(offset + chunk.length);
+            ok = res.ok;
+            return res.text();
+          })
+          .then(function(text) {
+            if (!ok) setStatus('Error: ' + text), finish(ok); // Fail
+            if (chunk.length > 0) return; // More chunks to send
+            setStatus(x => x + '. Done, resetting device...');
+            finish(ok); // All chunks sent
+          });
+      };
+      sendChunk(0);
+    });
+  };
+
+  const onchange = function(ev) {
+    if (!ev.target.files[0]) return;
+    let r = new FileReader(), f = ev.target.files[0];
+    r.readAsArrayBuffer(f);
+    r.onload = function() {
+      setUpload(sendFileData(props.url, f.name, new Uint8Array(r.result), 2048));
+      ev.target.value = '';
+      ev.preventDefault();
+      btn && btn.current.base.click();
+    };
+  };
+
+  const onclick = function(ev) {
+    let fn; setUpload(x => fn = x);
+    if (!fn) input.current.click();  // No upload in progress, show file dialog
+    return fn;
+  };
+
+  return html`
+<div class="inline-flex flex-col ${props.class}">
+  <input class="hidden" type="file" ref=${input} onchange=${onchange} accept=${props.accept} />
+  <${Button} title=${props.title} icon=${Icons.download} onclick=${onclick} ref=${btn} colors=${props.colors} />
+  <div class="pt-2 text-sm text-slate-400 ${status || 'hidden'}">${status}<//>
+<//>`;
+};

examples/device-dashboard/web_root/history.min.js

@@ -0,0 +1 @@
+!function(t,n){"object"==typeof exports&&"object"==typeof module?module.exports=n():"function"==typeof define&&define.amd?define([],n):"object"==typeof exports?exports.History=n():t.History=n()}(this,function(){return function(t){function n(o){if(e[o])return e[o].exports;var r=e[o]={exports:{},id:o,loaded:!1};return t[o].call(r.exports,r,r.exports,n),r.loaded=!0,r.exports}var e={};return n.m=t,n.c=e,n.p="",n(0)}([function(t,n,e){"use strict";function o(t){return t&&t.__esModule?t:{default:t}}n.__esModule=!0,n.createPath=n.parsePath=n.locationsAreEqual=n.createLocation=n.createMemoryHistory=n.createHashHistory=n.createBrowserHistory=void 0;var r=e(2);Object.defineProperty(n,"createLocation",{enumerable:!0,get:function(){return r.createLocation}}),Object.defineProperty(n,"locationsAreEqual",{enumerable:!0,get:function(){return r.locationsAreEqual}});var i=e(1);Object.defineProperty(n,"parsePath",{enumerable:!0,get:function(){return i.parsePath}}),Object.defineProperty(n,"createPath",{enumerable:!0,get:function(){return i.createPath}});var a=e(7),c=o(a),u=e(8),s=o(u),f=e(9),l=o(f);n.createBrowserHistory=c.default,n.createHashHistory=s.default,n.createMemoryHistory=l.default},function(t,n){"use strict";n.__esModule=!0;n.addLeadingSlash=function(t){return"/"===t.charAt(0)?t:"/"+t},n.stripLeadingSlash=function(t){return"/"===t.charAt(0)?t.substr(1):t},n.stripPrefix=function(t,n){return 0===t.indexOf(n)?t.substr(n.length):t},n.stripTrailingSlash=function(t){return"/"===t.charAt(t.length-1)?t.slice(0,-1):t},n.parsePath=function(t){var n=t||"/",e="",o="",r=n.indexOf("#");r!==-1&&(o=n.substr(r),n=n.substr(0,r));var i=n.indexOf("?");return i!==-1&&(e=n.substr(i),n=n.substr(0,i)),n=decodeURI(n),{pathname:n,search:"?"===e?"":e,hash:"#"===o?"":o}},n.createPath=function(t){var n=t.pathname,e=t.search,o=t.hash,r=encodeURI(n||"/");return e&&"?"!==e&&(r+="?"===e.charAt(0)?e:"?"+e),o&&"#"!==o&&(r+="#"===o.charAt(0)?o:"#"+o),r}},function(t,n,e){"use strict";function o(t){return t&&t.__esModule?t:{default:t}}n.__esModule=!0,n.locationsAreEqual=n.createLocation=void 0;var r=Object.assign||function(t){for(var n=1;n<arguments.length;n++){var e=arguments[n];for(var o in e)Object.prototype.hasOwnProperty.call(e,o)&&(t[o]=e[o])}return t},i=e(10),a=o(i),c=e(11),u=o(c),s=e(1);n.createLocation=function(t,n,e,o){var i=void 0;return"string"==typeof t?(i=(0,s.parsePath)(t),i.state=n):(i=r({},t),void 0===i.pathname&&(i.pathname=""),i.search?"?"!==i.search.charAt(0)&&(i.search="?"+i.search):i.search="",i.hash?"#"!==i.hash.charAt(0)&&(i.hash="#"+i.hash):i.hash="",void 0!==n&&void 0===i.state&&(i.state=n)),i.key=e,o&&(i.pathname?"/"!==i.pathname.charAt(0)&&(i.pathname=(0,a.default)(i.pathname,o.pathname)):i.pathname=o.pathname),i},n.locationsAreEqual=function(t,n){return t.pathname===n.pathname&&t.search===n.search&&t.hash===n.hash&&t.key===n.key&&(0,u.default)(t.state,n.state)}},function(t,n,e){"use strict";var o=function(){};t.exports=o},function(t,n,e){"use strict";function o(t){return t&&t.__esModule?t:{default:t}}n.__esModule=!0;var r=e(3),i=(o(r),function(){var t=null,n=function(n){return t=n,function(){t===n&&(t=null)}},e=function(n,e,o,r){if(null!=t){var i="function"==typeof t?t(n,e):t;"string"==typeof i?"function"==typeof o?o(i,r):r(!0):r(i!==!1)}else r(!0)},o=[],r=function(t){var n=!0,e=function(){n&&t.apply(void 0,arguments)};return o.push(e),function(){n=!1,o=o.filter(function(t){return t!==e})}},i=function(){for(var t=arguments.length,n=Array(t),e=0;e<t;e++)n[e]=arguments[e];o.forEach(function(t){return t.apply(void 0,n)})};return{setPrompt:n,confirmTransitionTo:e,appendListener:r,notifyListeners:i}});n.default=i},function(t,n){"use strict";n.__esModule=!0;n.canUseDOM=!("undefined"==typeof window||!window.document||!window.document.createElement),n.addEventListener=function(t,n,e){return t.addEventListener?t.addEventListener(n,e,!1):t.attachEvent("on"+n,e)},n.removeEventListener=function(t,n,e){return t.removeEventListener?t.removeEventListener(n,e,!1):t.detachEvent("on"+n,e)},n.getConfirmation=function(t,n){return n(window.confirm(t))},n.supportsHistory=function(){var t=window.navigator.userAgent;return(t.indexOf("Android 2.")===-1&&t.indexOf("Android 4.0")===-1||t.indexOf("Mobile Safari")===-1||t.indexOf("Chrome")!==-1||t.indexOf("Windows Phone")!==-1)&&(window.history&&"pushState"in window.history)},n.supportsPopStateOnHashChange=function(){return window.navigator.userAgent.indexOf("Trident")===-1},n.supportsGoWithoutReloadUsingHash=function(){return window.navigator.userAgent.indexOf("Firefox")===-1},n.isExtraneousPopstateEvent=function(t){return void 0===t.state&&navigator.userAgent.indexOf("CriOS")===-1}},function(t,n,e){"use strict";var o=function(t,n,e,o,r,i,a,c){if(!t){var u;if(void 0===n)u=new Error("Minified exception occurred; use the non-minified dev environment for the full error message and additional helpful warnings.");else{var s=[e,o,r,i,a,c],f=0;u=new Error(n.replace(/%s/g,function(){return s[f++]})),u.name="InLine truncated

examples/device-dashboard/web_root/index.html

@@ -1,12 +1,15 @@
 <!DOCTYPE html>
-<html lang="en">
+<html lang="en" class="h-full bg-white">
   <head>
-    <title>Device Dashboard</title>
+    <title></title>
     <meta charset="utf-8" />
     <meta http-equiv="X-UA-Compatible" content="IE=edge" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <link rel="stylesheet" href="style.css" />
+    <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' fill='none' viewBox='0 0 24 24' stroke-width='1.5' stroke='currentColor'> <path stroke-linecap='round' stroke-linejoin='round' d='M14.857 17.082a23.848 23.848 0 005.454-1.31A8.967 8.967 0 0118 9.75v-.7V9A6 6 0 006 9v.75a8.967 8.967 0 01-2.312 6.022c1.733.64 3.56 1.085 5.455 1.31m5.714 0a24.255 24.255 0 01-5.714 0m5.714 0a3 3 0 11-5.714 0' /> </svg>" />
+    <link href="main.css" rel="stylesheet" />
+    <link href="https://rsms.me/inter/inter.css" rel="stylesheet" />
   </head>
-  <body></body>
+  <body class="h-full"></body>
+  <script src="history.min.js"></script>
   <script type="module" src="main.js"></script>
 </html>

examples/device-dashboard/web_root/main.css

@@ -0,0 +1 @@
+/*! tailwindcss v3.3.2 | MIT License | https://tailwindcss.com*/*,:after,:before{box-sizing:border-box;border:0 solid #e5e7eb}:after,:before{--tw-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;-moz-tab-size:4;-o-tab-size:4;tab-size:4;font-family:Inter var,Helvetica,sans-serif;font-feature-settings:"cv11","ss01";font-variation-settings:"opsz" 32}body{margin:0;line-height:inherit}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:initial}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}button,input,optgroup,select,textarea{font-family:inherit;font-size:100%;font-weight:inherit;line-height:inherit;color:inherit;margin:0;padding:0}button,select{text-transform:none}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button;background-color:initial;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:initial}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{opacity:1;color:#9ca3af}input::placeholder,textarea::placeholder{opacity:1;color:#9ca3af}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{max-width:100%;height:auto}[hidden]{display:none}*,::backdrop,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:#3b82f680;--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: }.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border-width:0}.pointer-events-none{pointer-events:none}.pointer-events-auto{pointer-events:auto}.fixed{position:fixed}.absolute{position:absolute}.relative{position:relative}.sticky{position:sticky}.inset-0{inset:0}.bottom-0{bottom:0}.left-0{left:0}.right-auto{right:auto}.top-0{top:0}.isolate{isolation:isolate}.z-10{z-index:10}.z-\[48\]{z-index:48}.z-\[60\]{z-index:60}.col-span-2{grid-column:span 2/span 2}.m-4{margin:1rem}.mx-auto{margin-left:auto;margin-right:auto}.my-0{margin-top:0;margin-bottom:0}.my-1{margin-top:.25rem;margin-bottom:.25rem}.my-2{margin-top:.5rem;margin-bottom:.5rem}.my-3{margin-top:.75rem;margin-bottom:.75rem}.my-4{margin-top:1rem;margin-bottom:1rem}.my-5{margin-top:1.25rem;margin-bottom:1.25rem}.mb-1{margin-bottom:.25rem}.ml-3{margin-left:.75rem}.ml-4{margin-left:1rem}.mr-2{margin-right:.5rem}.mr-4{margin-right:1rem}.mt-1{margin-top:.25rem}.mt-3{margin-top:.75rem}.mt-5{margin-top:1.25rem}.mt-7{margin-top:1.75rem}.block{display:block}.inline-block{display:inline-block}.flex{display:flex}.inline-flex{display:inline-flex}.table{display:table}.grid{display:grid}.hidden{display:none}.h-10{height:2.5rem}.h-12{height:3rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-full{height:100%}.min-h-screen{min-height:100vh}.w-0{width:0}.w-11{width:2.75rem}.w-4{width:1rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-72{width:18rem}.w-96{width:24rem}.w-full{width:100%}.min-w-full{min-width:100%}.max-w-sm{max-width:24rem}.flex-1{flex:1 1 0%}.flex-shrink-0{flex-shrink:0}.shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.grow{flex-grow:1}.grow-0{flex-grow:0}.basis-\[30px\]{flex-basis:30px}.border-separate{border-collapse:initial}.border-spacing-0Line truncated

examples/device-dashboard/web_root/main.js

@@ -1,250 +1,376 @@
+//  NOTE: API calls must start with 'api/' in order to serve the app at any URI
+
 'use strict';
-import {Component, h, html, render, useEffect, useState} from './preact.min.js';
+import { h, render, useState, useEffect, useRef, html, Router } from  './bundle.js';
+import { Icons, Login, Setting, Button, Stat, tipColors, Colored, Notification, Pagination, UploadFileButton } from './components.js';
 
-const Nav = props => html`
+const Logo = props => html`<svg class=${props.class} xmlns="http://www.w3.org/2000/svg" viewBox="0 0 12.87 12.85"><defs><style>.ll-cls-1{fill:none;stroke:#000;stroke-miterlimit:10;stroke-width:0.5px;}</style></defs><g id="Layer_2" data-name="Layer 2"><g id="Layer_1-2" data-name="Layer 1"><path class="ll-cls-1" d="M12.62,1.82V8.91A1.58,1.58,0,0,1,11,10.48H4a1.44,1.44,0,0,1-1-.37A.69.69,0,0,1,2.84,10l-.1-.12a.81.81,0,0,1-.15-.48V5.57a.87.87,0,0,1,.86-.86H4.73V7.28a.86.86,0,0,0,.86.85H9.42a.85.85,0,0,0,.85-.85V3.45A.86.86,0,0,0,10.13,3,.76.76,0,0,0,10,2.84a.29.29,0,0,0-.12-.1,1.49,1.49,0,0,0-1-.37H2.39V1.82A1.57,1.57,0,0,1,4,.25H11A1.57,1.57,0,0,1,12.62,1.82Z"/><path class="ll-cls-1" d="M10.48,10.48V11A1.58,1.58,0,0,1,8.9,12.6H1.82A1.57,1.57,0,0,1,.25,11V3.94A1.57,1.57,0,0,1,1.82,2.37H8.9a1.49,1.49,0,0,1,1,.37l.12.1a.76.76,0,0,1,.11.14.86.86,0,0,1,.14.47V7.28a.85.85,0,0,1-.85.85H8.13V5.57a.86.86,0,0,0-.85-.86H3.45a.87.87,0,0,0-.86.86V9.4a.81.81,0,0,0,.15.48l.1.12a.69.69,0,0,0,.13.11,1.44,1.44,0,0,0,1,.37Z"/></g></g></svg>`;
-<div style="background: #333; padding: 0.5em; color: #fff;">
-  <div class="container d-flex">
-    <div style="flex: 1 1 auto; display: flex; align-items: center;">
-      <b>Your Product</b>
-    </div>
-    <div style="display: flex; align-items: center; flex: 0 0 auto; ">
-      <span>Logged in as:</span>
-      <span style="padding: 0 0.5em;"><img src="user.png" height="22" /></span>
-      <span>${props.user}</span>
-      <a class="btn" onclick=${props.logout}
-        style="margin-left: 1em; font-size: 0.8em; background: #8aa;">logout</a>
-    </div>
-  </div>
-</div>`;
 
-const Footer = props => html`
+function Header({logout, user, setShowSidebar, showSidebar}) {
-<div style="color: silver; margin-top: 2em; padding-top: 0.5em; border-top: 1px solid #ccc; ">
-  Copyright (c) Your Company
-</div>
-`;
-
-
-const Hero = props => html`
-<div style="margin-top: 1em; background: #eee; padding: 1em; border-radius: 0.5em; color: #777; ">
-  <h1 style="margin: 0.2em 0;">Interactive Device Dashboard</h1>
-
-  This device dashboard is developed with modern and compact Preact framework,
-  in order to fit on a very small devices. This is
-  a <a href="https://mongoose.ws/tutorials/http-server/">hybrid server</a> which
-  provides both static and dynamic content.  Static files, like CSS/JS/HTML
-  or images, are compiled into the server binary. Dynamic content is
-  served via the REST API. 
-
-  This dashboard shows values kept in server memory. Many clients can open
-  this page.  The JS code that watches state changes, reconnects on network
-  failures.  That means if server restarts, dashboard on all connected clients
-  refresh automatically.
-
-  NOTE: administrators can change settings values, whilst users cannot.
-
-  <p>
-  This UI uses the REST API implemented by the server, which you can examine
-  using  <code>curl</code> command-line utility:
-  </p>
-
-  <div><code>curl localhost:8000/api/config/get</code> - get current device configuration</div>
-  <div><code>curl localhost:8000/api/config/set -d 'value1=7&value2=hello'</code> - set device configuration</div>
-  <div><code>curl localhost:8000/api/message/send -d 'msg=hello'</code> - send chat message</div>
-  <div><code>curl localhost:8000/api/watch</code> - get notifications on config changes or chat messages</div>
-
-</div>`;
-
-const ShowSettings = function(props) {
   return html`
-<div style="margin: 0 0.3em;">
+<div class="bg-white sticky top-0 z-[48] xw-full border-b py-2 ${showSidebar && 'pl-72'} transition-all duration-300 transform">
-  <h3 style="background: #59d; color: #fff;padding: 0.4em;">Device configuration</h3>
+  <div class="px-2 w-full py-0 my-0 flex items-center">
-  <div style="margin: 0.5em 0;">
+    <button type="button" onclick=${ev => setShowSidebar(v => !v)} class="text-slate-400">
-    <span class="addon">value1:</span>
+      <${Icons.bars3} class="h-6" />
-    <input disabled type="text" class="smooth"
+    <//>
-      value=${(props.config || {}).value1 || ''} />
+    <div class="flex flex-1 gap-x-4 self-stretch lg:gap-x-6">
-  </div>
+      <div class="relative flex flex-1"><//>
-  <div style="margin: 0.5em 0;">
+      <div class="flex items-center gap-x-4 lg:gap-x-6">
-    <span class="addon">value2:</span>
+        <span class="text-sm text-slate-400">logged in as: ${user}<//>
-    <input disabled type="text" class="smooth" 
+        <div class="hidden lg:block lg:h-4 lg:w-px lg:bg-gray-200" aria-hidden="true"><//>
-      value=${(props.config || {}).value2 || ''} />
+        <${Button} title="Logout" icon=${Icons.logout} onclick=${logout} />
-  </div>
+      <//>
-  <div class="msg">
+    <//>
-    Server's corresponding runtime configuration structure:
+  <//>
-    <pre>
+<//>`;
-struct config {
-  int value1;
-  char *value2;
-} s_config;
-    </pre>
-  </div>
-</div>`;
 };
 
-const ChangeSettings = function(props) {
+function Sidebar({url, show}) {
-  const [value1, setValue1] = useState('');
+  const NavLink = ({title, icon, href, url}) => html`
-  const [value2, setValue2] = useState('');
+  <div>
-  useEffect(() => {
+    <a href="#${href}" class="${href == url ? 'bg-slate-50 text-blue-600 group' : 'text-gray-700 hover:text-blue-600 hover:bg-gray-50 group'} flex gap-x-3 rounded-md p-2 text-sm leading-6 font-semibold">
-    setValue1(props.config.value1);
+      <${icon} class="w-6 h-6"/>
-    setValue2(props.config.value2);
+      ${title}
-  }, [props.config.value1, props.config.value2])
+    <///>
-  const update = (name, val) => fetch('/api/config/set', {
+  <//>`;
-                                  method: 'post',
-                                  body: `${name}=${encodeURIComponent(val)}`
-                                }).catch(err => err);
-  const updatevalue1 = ev => update('value1', value1);
-  const updatevalue2 = ev => update('value2', value2);
   return html`
-<div style="margin: 0 0.3em;">
+<div class="bg-violet-100 hs-overlay hs-overlay-open:translate-x-0
-  <h3 style="background: #c03434; color: #fff; padding: 0.4em;">
+            -translate-x-full transition-all duration-300 transform
-    Change configuration</h3>
+            fixed top-0 left-0 bottom-0 z-[60] w-72 bg-white border-r
-  <div style="margin: 0.5em 0;">
+            border-gray-200 overflow-y-auto scrollbar-y
-    <span class="addon">value1:</span>
+            ${show && 'translate-x-0'} right-auto bottom-0">
-    <input type="text" value=${value1} onchange=${updatevalue1}
+  <div class="flex flex-col m-4 gap-y-6">
-          oninput=${ev => setValue1(ev.target.value)} />
+    <div class="flex h-10 shrink-0 items-center gap-x-4 font-bold text-xl text-slate-500">
-    <button class="btn" disabled=${!value1} onclick=${updatevalue1}
+      <${Logo} class="h-full"/> Your Brand
-      style="margin-left: 1em; background: #8aa;">Update</button>
+    <//>
-  </div>
+    <div class="flex flex-1 flex-col">
-  <div style="margin: 0.5em 0;">
+      <${NavLink} title="Dashboard" icon=${Icons.home} href="/" url=${url} />
-    <span class="addon">value2:</span>
+      <${NavLink} title="Settings" icon=${Icons.cog} href="/settings" url=${url} />
-    <input type="text" value=${value2} onchange=${updatevalue2}
+      <${NavLink} title="Firmware Update" icon=${Icons.download} href="/update" url=${url} />
-          oninput=${ev => setValue2(ev.target.value)} />
+      <${NavLink} title="Events" icon=${Icons.alert} href="/events" url=${url} />
-    <button class="btn" disabled=${!value2} onclick=${updatevalue2}
+    <//>
-      style="margin-left: 1em; background: #8aa;">Update</button>
+  <//>
-  </div>
+<//>`;
-  <div class="msg">
-    As soon as administrator updates configuration, 
-    server iterates over all connected clients and sends update
-    notifications to all of them - so they update automatically.
-  </div>
-</div>`;
 };
 
-const Login = function(props) {
+function Events({}) {
-  const [user, setUser] = useState('');
+  const [events, setEvents] = useState([]);
-  const [pass, setPass] = useState('');
+  const [page, setPage] = useState(1);
-  const login = ev =>
-      fetch(
-          '/api/login',
-          {headers: {Authorization: 'Basic ' + btoa(user + ':' + pass)}})
-          .then(r => r.json())
-          .then(r => r && props.login(r))
-          .catch(err => err);
-  return html`
-<div class="rounded border" style="max-width: 480px; margin: 0 auto; margin-top: 5em; background: #eee; ">
-  <div style="padding: 2em; ">
-    <h1 style="color: #666;">Device Dashboard Login </h1>
-    <div style="margin: 0.5em 0;">
-      <input type='text' placeholder='Name' style="width: 100%;"
-        oninput=${ev => setUser(ev.target.value)} value=${user} />
-    </div>
-    <div style="margin: 0.5em 0;">
-      <input type="password" placeholder="Password" style="width: 100%;"
-        oninput=${ev => setPass(ev.target.value)} value=${pass}
-        onchange=${login} />
-    </div>
-    <div style="margin: 1em 0;">
-      <button class="btn" style="width: 100%; background: #8aa;"
-        disabled=${!user || !pass} onclick=${login}> Login </button>
-    </div>
-    <div style="color: #777; margin-top: 2em;">
-      Valid logins: admin:pass0, user1:pass1, user2:pass2
-    </div>
-  </div>
-</div>`;
-};
 
-const Message = text => html`<div style="margin: 0.5em 0;">${text}</div>`;
+  const refresh = () =>
+    fetch('api/events/get', {
+        method: 'POST', body: JSON.stringify({page: page}),
+      }).then(r => r.json())
+        .then(r => setEvents(r));
 
-const Chat = function(props) {
+  useEffect(refresh, [page]);
-  const [message, setMessage] = useState('');
-  const sendmessage = ev => fetch('/api/message/send', {
-                              method: 'post',
-                              body: `message=${encodeURIComponent(message)}`
-                            }).then(r => setMessage(''));
-
-  const messages = props.messages.map(
-      text => html`<div style="margin: 0.5em 0;">${text}</div>`);
-  return html`
-<div style="margin: 0 0.3em;">
-  <h3 style="background: #30c040; color: #fff; padding: 0.4em;">User chat</h3>
-  <div style="height: 10em; overflow: auto; padding: 0.5em; " class="border">
-    ${messages}
-  </div>
-  <div style="margin: 0.5em 0;">
-    <input placeholder="type message..." style="width: 100%" value=${message}
-      onchange=${sendmessage}
-      oninput=${ev => setMessage(ev.target.value)} />
-  </div>
-  <div class="msg">
-    Chat demonsrates
-    real-time bidirectional data exchange between many clients and a server.
-  </div>
-</div>`;
-};
-
-const App = function(props) {
-  const [messages, setMessages] = useState([]);
-  const [user, setUser] = useState('');
-  const [config, setConfig] = useState({});
-
-  const refresh = () => fetch('/api/config/get', {headers: {Authorization: ''}})
-                            .then(r => r.json())
-                            .then(r => setConfig(r));
-
-  const login = function(u) {
-    document.cookie = `access_token=${u.token};path=/;max-age=3600`;
-    setUser(u.user);
-    refresh();
-  };
-
-  const logout = ev => {
-    document.cookie = `access_token=;path=/;max-age=0`;
-    setUser('');
-  };
-
-  const watch = function() {
-    var f = function(reader) {
-      return reader.read().then(function(result) {
-        var data = String.fromCharCode.apply(null, result.value);
-        var notification = JSON.parse(data);
-        if (notification.name == 'config') refresh();
-        if (notification.name == 'message') {
-          setMessages(m => m.concat([notification.data]))
-        }
-        // console.log(notification);
-        if (!result.done) return f(reader);
-      });
-    };
-    fetch('/api/watch', {headers: {Authorization: ''}})
-        .then(r => r.body.getReader())
-        .then(f)
-        .catch(e => setTimeout(watch, 1000));
-  };
 
   useEffect(() => {
-    fetch('/api/login', {headers: {Authorization: ''}})
+    setPage(JSON.parse(localStorage.getItem('page')));
-        .then(r => r.json())
+      }, []);
-        .then(r => login(r))
-        .catch(err => setUser(''));
-    refresh();
-    watch();
-  }, []);
 
-  if (!user) return html`<${Login} login=${login} />`;
+  useEffect(() => {
-  const admin = user == 'admin';
+    localStorage.setItem('page', page.toString());
-  const colsize = admin ? 'c4' : 'c6';
+  }, [page]);
-  const cs = admin ? html`<${ChangeSettings} config=${config} />` : '';
+
+  const Th = props => html`<th scope="col" class="sticky top-0 z-10 border-b border-slate-300 bg-white bg-opacity-75 py-1.5 px-4 text-left text-sm font-semibold text-slate-900 backdrop-blur backdrop-filter">${props.title}</th>`;
+  const Td = props => html`<td class="whitespace-nowrap border-b border-slate-200 py-2 px-4 pr-3 text-sm text-slate-900">${props.text}</td>`;
+  const Prio = ({prio}) => {
+    const text = ['high', 'medium', 'low'][prio];
+    const colors = [tipColors.red, tipColors.yellow, tipColors.green][prio];
+    return html`<${Colored} colors=${colors} text=${text} />`;
+  };
+
+  const Event = ({e}) => html`
+<tr>
+  <${Td} text=${['power', 'hardware', 'tier3', 'tier4'][e.type]} />
+  <${Td} text=${html`<${Prio} prio=${e.prio}/>`} />
+  <${Td} text=${e.time ? (new Date(e.time * 1000)).toLocaleString() : '1970-01-01'} />
+  <${Td} text=${e.text} />
+<//>`;
+
+return html`
+<div class="m-4 divide-y divide-gray-200 overflow-auto rounded bg-white">
+  <div class="font-semibold flex items-center text-gray-600 px-3 justify-between whitespace-nowrap">
+    <div class="font-semibold flex items-center text-gray-600">
+      <div class="mr-4">EVENT LOG</div>
+    </div>
+    <${Pagination} currentPage=${page} setPageFn=${setPage} totalItems=400 itemsPerPage=20 />
+  <//>
+  <div class="inline-block min-w-full align-middle" style="max-height: 82vh; overflow: auto;">
+    <table class="min-w-full border-separate border-spacing-0">
+      <thead>
+        <tr>
+          <${Th} title="Type" />
+          <${Th} title="Prio" />
+          <${Th} title="Time" />
+          <${Th} title="Description" />
+        </tr>
+      </thead>
+      <tbody>
+        ${(events.arr ? events.arr : []).map(e => h(Event, {e}))}
+      </tbody>
+    </table>
+  <//>
+<//>`;
+};
+
+function Chart({data}) {
+  const n = data.length /* entries */, w = 20 /* entry width */, ls = 15/* left space */;
+  const h = 100 /* graph height */, yticks = 5 /* Y axis ticks */, bs = 10 /* bottom space */;
+  const ymax = 25;
+  const yt = i => (h - bs) / yticks * (i + 1);
+  const bh = p => (h - bs) * p / 100; // Bar height
+  const by = p => (h - bs) - bh(p);
+  const range = (start, size, step) => Array.from({length: size}, (_, i) => i * (step || 1) + start);
+  // console.log(ds);
   return html`
-<${Nav} user=${user} logout=${logout} />
+<div class="my-4 divide-y divide-gray-200 overflow-auto rounded bg-white">
-<div class="container">
+  <div class="font-light uppercase flex items-center text-gray-600 px-4 py-2">
-  <${Hero} />
+  Temperature, last 24h
-  <div class="row">
+  <//>
-    <div class="col ${colsize}"><${ShowSettings} config=${config} /></div>
+  <div class="relative">
-    <div class="col ${colsize}">${cs}</div>
+    <svg class="bg-yellow-x50 w-full p-4" viewBox="0 0 ${n*w+ls} ${h}">
-    <div class="col ${colsize}"><${Chat} messages=${messages} /></div>
+      ${range(0, yticks).map(i => html`
-  </div>
+        <line x1=0 y1=${yt(i)} x2=${ls+n*w} y2=${yt(i)} stroke-width=0.3 class="stroke-slate-300" stroke-dasharray="1,1" />
-  <${Footer} />
+        <text x=0 y=${yt(i)-2} class="text-[6px] fill-slate-400">${ymax-ymax/yticks*(i+1)}<//>
-</div>`;
+      `)}
+      ${range(0, n).map(x => html`
+        <rect x=${ls+x*w} y=${by(data[x]*100/ymax)} width=12 height=${bh(data[x]*100/ymax)} rx=2 class="fill-cyan-500" />
+        <text x=${ls+x*w} y=100 class="text-[6px] fill-slate-400">${x*2}:00<//>
+      `)}
+    <//>
+  <//>
+<//>`;
+};
+
+function DeveloperNote({text, children}) {
+  return html`
+<div class="flex p-4 gap-2">
+  <div class="text-sm text-slate-500">
+    <div class="flex items-center">
+      <${Icons.info} class="self-start basis-[30px] grow-0 shrink-0 text-green-600 mr-2" />
+      <div class="font-semibold">Developer Note<//>
+    <//>
+    ${(text || '').split('.').map(v => html` <p class="my-2 ">${v}<//>`)}
+    ${children}
+  <//>
+<//>`;
+};
+
+function Main({}) {
+  const [stats, setStats] = useState(null);
+  const refresh = () => fetch('api/stats/get').then(r => r.json()).then(r => setStats(r));
+  useEffect(refresh, []);
+  if (!stats) return '';
+  return html`
+<div class="p-2">
+  <div class="p-4 sm:p-2 mx-auto grid grid-cols-2 lg:grid-cols-4 gap-4">
+    <${Stat} title="Temperature" text="${stats.temperature} °C" tipText="good" tipIcon=${Icons.ok} tipColors=${tipColors.green} />
+    <${Stat} title="Humidity" text="${stats.humidity} %" tipText="warn" tipIcon=${Icons.warn} tipColors=${tipColors.yellow} />
+    <div class="bg-white col-span-2 border rounded-md shadow-lg" role="alert">
+      <${DeveloperNote} text="Stats data is received from the Mongoose backend" />
+    <//>
+  <//>
+  <div class="p-4 sm:p-2 mx-auto grid grid-cols-1 lg:grid-cols-2 gap-4">
+
+    <${Chart} data=${stats.points} />
+
+    <div class="my-4 hx-24 bg-white border rounded-md shadow-lg" role="alert">
+      <${DeveloperNote}
+        text="This chart is an SVG image, generated on the fly from the
+        data returned by the api/stats/get API call" />
+    <//>
+  <//>
+<//>`;
+};
+
+function FirmwareStatus({title, info, children}) {
+  const state = ['UNAVAILABLE', 'FIRST_BOOT', 'NOT_COMMITTED', 'COMMITTED'][(info.status || 0) % 4];
+  const valid = info.status > 0;
+  return html`
+<div class="bg-white py-1 divide-y border rounded">
+  <div class="font-light uppercase flex items-center text-gray-600 px-4 py-2">
+    ${title}
+  <//>
+  <div class="px-4 py-2 relative">
+    <div class="my-1">Status: ${state}<//>
+    <div class="my-1">CRC32: ${valid ? info.crc32.toString(16) : 'n/a'}<//>
+    <div class="my-1">Size: ${valid ? info.size : 'n/a'}<//>
+    <div class="my-1">Flashed at: ${valid ? new Date(info.timestamp * 1000).toLocaleString() : 'n/a'}<//>
+    ${children}
+  <//>
+<//>`;
+};
+
+
+function FirmwareUpdate({}) {
+  const [info, setInfo] = useState([{}, {}]);
+  const refresh = () => fetch('api/firmware/status').then(r => r.json()).then(r => setInfo(r));
+  useEffect(refresh, []);
+  const oncommit = ev => fetch('api/firmware/commit')
+    .then(r => r.json())
+    .then(refresh);
+  const onreboot = ev => fetch('api/device/reset')
+    .then(r => r.json())
+    .then(r => new Promise(r => setTimeout(ev => { refresh(); r(); }, 3000)));
+  const onrollback = ev => fetch('api/firmware/rollback')
+    .then(onreboot);
+  const onerase = ev => fetch('api/device/eraselast').then(refresh);
+  const onupload = function(ok, name, size) {
+    if (!ok) return false;
+    return new Promise(r => setTimeout(ev => { refresh(); r(); }, 3000));
+  };
+  return html`
+<div class="m-4 gap-4 grid grid-cols-1 lg:grid-cols-3">
+  <${FirmwareStatus} title="Current firmware image" info=${info[0]}>
+    <div class="flex flex-wrap gap-2">
+      <${Button} title="Commit this firmware" onclick=${oncommit}
+        icon=${Icons.thumbUp} disabled=${info[0].status == 3} cls="w-full" />
+    <//>
+  <//>
+  <${FirmwareStatus} title="Previous firmware image" info=${info[1]}>
+    <${Button} title="Rollback to this firmware" onclick=${onrollback}
+      icon=${Icons.backward} disabled=${info[1].status == 0} cls="w-full" />
+  <//>
+  <div class="bg-white xm-4 divide-y border rounded flex flex-col">
+    <div class="font-light uppercase flex items-center text-gray-600 px-4 py-2">
+      Device control
+    <//>
+    <div class="px-4 py-3 flex flex-col gap-2 grow">
+      <${UploadFileButton}
+        title="Upload new firmware .bin file" onupload=${onupload}
+      url="api/firmware/upload" accept=".bin,.uf2" />
+      <div class="grow"><//>
+      <${Button} title="Reboot device" onclick=${onreboot} icon=${Icons.refresh} cls="w-full" />
+      <${Button} title="Erase last sector" onclick=${onerase} icon=${Icons.doc} cls="w-full hidden" />
+    <//>
+  <//>
+<//>
+
+
+<div class="m-4 gap-4 grid grid-cols-1 lg:grid-cols-2">
+  <div class="bg-white border shadow-lg">
+    <${DeveloperNote}>
+      <div class="my-2">
+        Firmware status and other information is stored in the last sector
+        of flash
+      <//>
+      <div class="my-2">
+        Firmware status can be FIRST_BOOT, UNCOMMITTED or COMMITTED. If no
+        information is available, it is UNAVAILABLE.
+      <//>
+      <div class="my-2">  
+        This GUI loads a firmware file and sends it chunk by chunk to the
+        device, passing current chunk offset, total firmware size and a file name:
+        api/firmware/upload?offset=X&total=Y&name=Z
+      <//>
+    <//>
+  <//>
+
+  <div class="bg-white border shadow-lg">
+    <${DeveloperNote}>
+      <div>
+        Firmware update mechanism defines 3 API functions that the target
+        device must implement: mg_ota_begin(), mg_ota_write() and mg_ota_end()
+      <//>
+      <div class="my-2">  
+        RESTful API handlers use ota_xxx() API to save firmware to flash.
+        The last 0-length chunk triggers ota_end() which performs firmware
+        update using saved firmware image
+      <//>
+      <div class="my-2">  
+        <a class="link text-blue-600 underline" 
+          href="https://mongoose.ws/webinars/">Join our free webinar</a> to
+        get detailed explanations about possible firmware updates strategies
+        and implementation demo
+      <//>
+    <//>
+  <//>
+
+<//>`;
+};
+
+function Settings({}) {
+  const [settings, setSettings] = useState(null);
+  const [saveResult, setSaveResult] = useState(null);
+  const refresh = () => fetch('api/settings/get')
+    .then(r => r.json())
+    .then(r => setSettings(r));
+  useEffect(refresh, []);
+
+  const mksetfn = k => (v => setSettings(x => Object.assign({}, x, {[k]: v}))); 
+  const onsave = ev => fetch('api/settings/set', {
+    method: 'post', body: JSON.stringify(settings) 
+  }).then(r => r.json())
+    .then(r => setSaveResult(r))
+    .then(refresh);
+
+  if (!settings) return '';
+  const logOptions = [[0, 'Disable'], [1, 'Error'], [2, 'Info'], [3, 'Debug']];
+  return html`
+<div class="m-4 grid grid-cols-1 gap-4 md:grid-cols-2">
+
+  <div class="py-1 divide-y border rounded bg-white flex flex-col">
+    <div class="font-light uppercase flex items-center text-gray-600 px-4 py-2">
+      Device Settings
+    <//>
+    <div class="py-2 px-5 flex-1 flex flex-col relative">
+      ${saveResult && html`<${Notification} ok=${saveResult.status}
+        text=${saveResult.message} close=${() => setSaveResult(null)} />`}
+
+      <${Setting} title="Enable Logs" value=${settings.log_enabled} setfn=${mksetfn('log_enabled')} type="switch" />
+      <${Setting} title="Log Level" value=${settings.log_level} setfn=${mksetfn('log_level')} type="select" addonLeft="0-3" disabled=${!settings.log_enabled} options=${logOptions}/>
+      <${Setting} title="Brightness" value=${settings.brightness} setfn=${mksetfn('brightness')} type="number" addonRight="%" />
+      <${Setting} title="Device Name" value=${settings.device_name} setfn=${mksetfn('device_name')} type="" />
+      <div class="mb-1 mt-3 flex place-content-end"><${Button} icon=${Icons.save} onclick=${onsave} title="Save Settings" /><//>
+    <//>
+  <//>
+
+  <div class="bg-white border rounded-md text-ellipsis overflow-auto" role="alert">
+    <${DeveloperNote}
+        text="A variety of controls are pre-defined to ease the development:
+          toggle button, dropdown select, input field with left and right
+          addons. Device settings are received by calling
+          api/settings/get API call, which returns settings JSON object.
+          Clicking on the save button calls api/settings/set
+          API call" />
+  <//>
+
+<//>`;
+};
+
+const App = function({}) {
+  const [loading, setLoading] = useState(true);
+  const [url, setUrl] = useState('/');
+  const [user, setUser] = useState('');
+  const [showSidebar, setShowSidebar] = useState(true);
+
+  const logout = () => fetch('api/logout').then(r => setUser(''));
+  const login = r => !r.ok ? setLoading(false) && setUser(null) : r.json()
+      .then(r => setUser(r.user))
+      .finally(r => setLoading(false));
+
+  useEffect(() => fetch('api/login').then(login), []);
+
+  if (loading) return '';  // Show blank page on initial load
+  if (!user) return html`<${Login} loginFn=${login} logoIcon=${Logo}
+    title="Device Dashboard Login" 
+    tipText="To login, use: admin/admin, user1/user1, user2/user2" />`; // If not logged in, show login screen
+
+  return html`
+<div class="min-h-screen bg-slate-100">
+  <${Sidebar} url=${url} show=${showSidebar} />
+  <${Header} logout=${logout} user=${user} showSidebar=${showSidebar} setShowSidebar=${setShowSidebar} />
+  <div class="${showSidebar && 'pl-72'} transition-all duration-300 transform">
+    <${Router} onChange=${ev => setUrl(ev.url)} history=${History.createHashHistory()} >
+      <${Main} default=${true} />
+      <${Settings} path="settings" />
+      <${FirmwareUpdate} path="update" />
+      <${Events} path="events" />
+    <//>
+  <//>
+<//>`;
 };
 
 window.onload = () => render(h(App), document.body);

examples/embedded-filesystem/Makefile

@@ -0,0 +1,51 @@
+PROG ?= example                   # Program we are building
+DELETE = rm -rf                   # Command to remove files
+OUT ?= -o $(PROG)                 # Compiler argument for output file
+SOURCES = main.c mongoose.c packed_fs.c      # Source code files
+CFLAGS = -W -Wall -Wextra -g -I.  # Build options
+PACK = ./pack             # Utility to pack files into a packed filesystem
+
+# Mongoose build options. See https://mongoose.ws/documentation/#build-options
+CFLAGS_MONGOOSE += -DMG_ENABLE_PACKED_FS=1
+
+FILES_TO_EMBED ?= $(wildcard web_root/*)
+
+ifeq ($(OS),Windows_NT)   # Windows settings. Assume MinGW compiler. To use VC: make CC=cl CFLAGS=/MD OUT=/Feprog.exe
+  PROG ?= example.exe           # Use .exe suffix for the binary
+  CC = gcc                      # Use MinGW gcc compiler
+  CFLAGS += -lws2_32            # Link against Winsock library
+  DELETE = cmd /C del /Q /F /S  # Command prompt command to delete files
+  OUT ?= -o $(PROG)             # Build output
+  PACK = pack.exe
+endif
+
+all: $(PROG)              # Default target. Build and run program
+	$(RUN) ./$(PROG) $(ARGS)
+
+$(PROG): $(SOURCES) $(FILES_TO_EMBED)       # Build program from sources
+	$(CC) ../../test/pack.c -o $(PACK)
+	$(PACK) $(FILES_TO_EMBED) > packed_fs.c
+	$(CC) $(SOURCES) $(CFLAGS) $(CFLAGS_MONGOOSE) $(CFLAGS_EXTRA) $(OUT)
+
+clean:                    # Cleanup. Delete built program and all build artifacts
+	$(DELETE) $(PROG) *.dSYM $(PACK)
+
+.PHONY: compress expand gzipped plain all
+
+# See tutorial at https://mongoose.ws/tutorials/embedded-filesystem/#build-and-try
+gzipped: compress
+	$(MAKE) all
+
+plain: expand
+	$(MAKE) all
+
+compress:
+	for file in $(FILES_TO_EMBED) ; do \
+		gzip -q $$file ; \
+	done
+
+expand:
+	for file in $(FILES_TO_EMBED) ; do \
+		gunzip -q $$file ; \
+	done
+

examples/embedded-filesystem/README.md

@@ -0,0 +1 @@
+See detailed tutorial at https://mongoose.ws/tutorials/embedded-filesystem/

examples/embedded-filesystem/main.c

@@ -0,0 +1,27 @@
+// Copyright (c) 2022 Cesanta Software Limited
+// All rights reserved
+
+#include "mongoose.h"
+
+const char *s_listening_url = "http://0.0.0.0:8000";
+
+// HTTP request handler function
+void fn(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_HTTP_MSG) {
+    struct mg_http_serve_opts opts = {
+        .root_dir = "/web_root",
+        .fs = &mg_fs_packed
+      };
+    mg_http_serve_dir(c, ev_data, &opts);
+  }
+}
+
+int main(void) {
+  struct mg_mgr mgr;
+  mg_log_set(MG_LL_INFO);
+  mg_mgr_init(&mgr);
+  mg_http_listen(&mgr, s_listening_url, fn, NULL);
+  while (true) mg_mgr_poll(&mgr, 500);
+  mg_mgr_free(&mgr);
+  return 0;
+}

examples/embedded-filesystem/mongoose.c

@@ -0,0 +1 @@
+../../mongoose.c

examples/embedded-filesystem/mongoose.h

@@ -0,0 +1 @@
+../../mongoose.h

examples/embedded-filesystem/web_root/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta name="description" content="Mongoose Embedded Filesytem example" />
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+        <title>Mongoose Embedded Filesytem example</title>
+    <link rel="stylesheet" href="style.css" />
+  </head>
+  <body></body>
+  <script type="module" src="main.js"></script>
+</html>

examples/embedded-filesystem/web_root/main.js

@@ -0,0 +1,88 @@
+'use strict';
+import { h, html, render } from './preact.min.js';
+
+
+const X = function () {
+
+  return html`
+  <div class="container">
+    <h2 class="section">ABOUT US</h2>
+    <div class="row">
+      <div class="col-7">
+        <p>      
+          Cesanta Software Ltd. is headquartered in Dublin, Republic of Ireland.
+        </p>
+        <p></p>
+        Our story roots back to 2004, when Mongoose Web Server Library development started. <br>
+
+        As Mongoose Web Server grew in popularity and matured over the following years, in 2013 Cesanta was established to continue its development and 
+        provide support to our valued customers.
+        </p>
+        <p>We are proud to have among our customers many <i>Fortune 500</i> companies as well as medium and small size businesses.
+          Security and quality of our solutions is a paramount for us and the fact that Mongoose Web Server is used by NASA aboard the International Space Station is 
+          the best confirmation to it.</p>
+          <p>Since 2013, Cesanta has expanded its product portfolio. We develop and distribute embedded software and hardware with focus on connected products and the Internet of Things.</p>
+
+      </div>
+    </div>
+  </div>
+`;
+};
+
+const Y = function () {
+
+  return html`
+  <div class="container">
+    <h3 class="section">Among our products are:</h3>
+    <div class="row">
+      <div class="col-7">
+       <ul>
+         <li>
+           <a href="https://mongoose.ws/">Mongoose Web Server</a>
+           - an embedded web server and networking library
+         </li>
+         <li>
+           <a href="https://vcon.io/">VCON.io</a>
+           - Arduino-compatible boards with built-in firmware OTA updates
+           and management dashboard
+         </li>
+         <li>
+           <a href="https://mdash.net/">mDash.net</a>
+           - an all-in-one IoT Platform
+         </li>
+         <li>
+           <a href="https://mongoose-os.com">Mongoose OS</a>
+           - an operating system for low-power microcontrollers
+         </li>
+
+         <li>
+           <a href="https://github.com/cesanta/mjs">mJS</a>
+           - an embedded JavaScript engine for C/C++
+         </li>
+       </ul>
+      </div>
+      <div class="col-6">
+        <p><b>Our solutions are:</b></p>
+        <ul>
+          <li>integrated into thousands of commercial products</li>
+          <li>deployed to hundreds of millions devices in production environments</li>
+        </ul>
+      </div>
+    </div>
+  </div>
+`;
+};
+
+const App = function (props) {
+
+  return html`
+<h1>Basic Embedded Filesystem demo</h1>
+<div>
+  ${h(X)}
+</div>
+<div>
+  ${h(Y)}
+</div>`;
+};
+
+window.onload = () => render(h(App), document.body);

examples/embedded-filesystem/web_root/style.css

@@ -4,7 +4,7 @@ select, input, label::before, textarea { outline: none; box-shadow:none !importa
 code, pre { color: #373; font-family: monospace; font-weight: bolder; font-size: smaller; background: #ddd; padding: 0.1em 0.3em; border-radius: 0.2em; }
 textarea, input, .addon { font-size: 15px; border: 1px solid #ccc; padding: 0.5em; }
 a, a:visited, a:active { color: #55f; }
-.addon { background: #eee; }
+.addon { background: #eee;  min-width: 9em;}
 .btn {
   background: #ccc; border-radius: 0.3em; border: 0; color: #fff; cursor: pointer;
   display: inline-block; padding: 0.6em 2em; font-weight: bolder;
@@ -16,21 +16,28 @@ a, a:visited, a:active { color: #55f; }
 .d-none { display: none; }
 .border { border: 1px solid #ddd; }
 .rounded { border-radius: 0.5em; }
-.msg { background: #def; border-left: 5px solid #59d; padding: 1em; margin: 1em 0; }
+.nowrap { white-space: nowrap; }
-.row { margin: 1% 0; overflow: auto; }
+.msg { background: #def; border-left: 5px solid #59d; padding: 0.5em; font-size: 90%; margin: 1em 0; }
-.col { float: left; }
+.section { margin: 0 1em; }
-.table, .c12 { width: 100%; }
+.topic, .data, .qos {  padding: 0.2em 0.5em; border-radius: 0.4em; margin-right: 0.5em;  }
-.c11 { width: 91.66%; }
+.qos { background: #efa; }
-.c10 { width: 83.33%; }
+.topic { background: #fea; }
-.c9 { width: 75%; }
+.data { background: #aef; }
-.c8 { width: 66.66%; }
-.c7 { width: 58.33%; }
-.c6 { width: 50%; }
-.c5 { width: 41.66%; }
-.c4 { width: 33.33%; }
-.c3 { width: 25%; }
-.c2 { width: 16.66%; }
-.c1 { width: 8.33%; }
 
+/* Grid */
+.row { display: flex; flex-wrap: wrap; }
+.col { margin: 0; padding: 0; overflow: auto; }
+.col-12 { width: 100%; }
+.col-11 { width: 91.66%; }
+.col-10 { width: 83.33%; }
+.col-9 { width: 75%; }
+.col-8 { width: 66.66%; }
+.col-7 { width: 58.33%; }
+.col-6 { width: 50%; }
+.col-5 { width: 41.66%; }
+.col-4 { width: 33.33%; }
+.col-3 { width: 25%; }
+.col-2 { width: 16.66%; }
+.col-1 { width: 8.33%; }
 @media (min-width: 1310px) { .container { margin: auto; width: 1270px; } }
-@media (max-width: 870px) { .row .col { width: 100%; } }
+@media (max-width: 920px) { .row .col { width: 100%; } }

examples/esp32/Makefile

@@ -1,18 +0,0 @@
-THISDIR = $(realpath $(CURDIR))
-ROOTDIR = $(realpath $(CURDIR)/../..)
-
-all: example
-
-example:
-	true
-
-build: main/main.c Makefile
-	docker run --rm -v $(ROOTDIR):$(ROOTDIR) -w $(THISDIR) espressif/idf idf.py build
-
-COMPORT ?= /dev/cu.SLAB_USBtoUART
-ESPTOOL ?= esptool.py
-flash:
-	cd build && $(ESPTOOL) --chip esp32 -p $(COMPORT) -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 2MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x100000 mongoose-esp32-example.bin
-
-clean:
-	rm -rf build

examples/esp32/README.md

@@ -1 +0,0 @@
-See detailed tutorial at https://mongoose.ws/tutorials/esp32/

examples/esp32/device-dashboard/Makefile

@@ -0,0 +1,38 @@
+THISDIR = $(realpath $(CURDIR))
+ROOTDIR = $(realpath $(CURDIR)/../../..)
+DOCKER ?= docker run --rm $(DA) -v $(ROOTDIR):$(ROOTDIR) -w $(THISDIR) espressif/idf
+CMD ?= idf.py build
+PORT ?= /dev/ttyUSB0
+
+all: example
+
+example:
+	true
+
+build: Makefile $(wildcard main/*)
+	$(DOCKER) $(CMD)
+
+flash:
+flash: CMD = idf.py flash
+flash: DA = --device $(PORT)
+flash: build
+
+.PHONY: build
+
+dashboard.hex: build
+	esputil mkhex \
+		0x8000 build/partition_table/partition-table.bin \
+		0x1000 build/bootloader/bootloader.bin \
+		0x100000 build/mongoose-esp32-example.bin > $@
+
+flash2: dashboard.hex
+	esputil -p $(PORT) -b 921600 -fp 0x220 flash dashboard.hex
+	esputil -p $(PORT) monitor
+
+ESPTOOL ?= esptool.py
+
+flash3:
+	cd build && $(ESPTOOL) --chip esp32 -p $(PORT) -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 40m --flash_size 2MB 0x8000 partition_table/partition-table.bin 0x1000 bootloader/bootloader.bin 0x100000 mongoose-esp32-example.bin
+
+clean:
+	test -d build && $(DOCKER) rm -rf build sdkconfig || true

examples/esp32/device-dashboard/README.md

@@ -0,0 +1 @@
+See detailed tutorial at https://mongoose.ws/tutorials/esp32/device-dashboard

examples/esp32/device-dashboard/main/CMakeLists.txt

@@ -0,0 +1,10 @@
+idf_component_register(SRCS "main.c"
+                            "wifi.c"
+                            "net.c"
+                            "packed_fs.c"
+                            "mongoose.c")
+component_compile_options(-DMG_ENABLE_LINES)
+component_compile_options(-DMG_ENABLE_PACKED_FS)
+component_compile_options(-DHTTP_URL="http://0.0.0.0:80")
+component_compile_options(-DHTTPS_URL="https://0.0.0.0:443")
+component_compile_options(-DMG_TLS=MG_TLS_NONE) # change to 'MG_TLS_MBED' to enable TLS

examples/esp32/device-dashboard/main/main.c

@@ -0,0 +1,37 @@
+// Copyright (c) 2020 Cesanta Software Limited
+// All rights reserved
+
+#include "esp_spiffs.h"
+#include "mongoose.h"
+#include "net.h"
+
+#define WIFI_SSID "YOUR_WIFI_NETWORK_NAME"  // SET THIS!
+#define WIFI_PASS "YOUR_WIFI_PASSWORD"      // SET THIS!
+#define FS_ROOT "/spiffs"
+
+void app_main(void) {
+  // Mount filesystem
+  esp_vfs_spiffs_conf_t conf = {
+      .base_path = FS_ROOT, .max_files = 20, .format_if_mount_failed = true};
+  int res = esp_vfs_spiffs_register(&conf);
+  MG_INFO(("FS %s, %d", conf.base_path, res));
+  mg_file_printf(&mg_fs_posix, FS_ROOT "/hello.txt", "%s", "hello from ESP");
+
+  // Setup wifi. This function is implemented in wifi.c
+  // It blocks until connected to the configured WiFi network
+  void wifi_init(const char *ssid, const char *pass);
+  wifi_init(WIFI_SSID, WIFI_PASS);
+
+  // Connected to WiFi, now start HTTP server
+  struct mg_mgr mgr;
+  mg_log_set(MG_LL_DEBUG);  // Set log level
+  mg_mgr_init(&mgr);
+  MG_INFO(("Mongoose version : v%s", MG_VERSION));
+  MG_INFO(("Listening on     : %s", HTTP_URL));
+#if MG_ENABLE_MBEDTLS
+  MG_INFO(("Listening on     : %s", HTTPS_URL));
+#endif
+
+  web_init(&mgr);
+  for (;;) mg_mgr_poll(&mgr, 1000);  // Infinite event loop
+}

examples/esp32/device-dashboard/main/mongoose.h

@@ -0,0 +1 @@
+../../../../mongoose.h

examples/esp32/device-dashboard/main/net.c

@@ -0,0 +1 @@
+../../../device-dashboard/net.c

examples/esp32/device-dashboard/main/net.h

@@ -0,0 +1 @@
+../../../device-dashboard/net.h

examples/esp32/device-dashboard/main/packed_fs.c

@@ -0,0 +1 @@
+../../../device-dashboard/packed_fs.c

examples/esp32/device-dashboard/main/wifi.c

@@ -42,7 +42,7 @@ static void event_handler(void *arg, esp_event_base_t event_base,
     MG_ERROR(("connect to the AP fail"));
   } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
     ip_event_got_ip_t *event = (ip_event_got_ip_t *) event_data;
-    MG_INFO(("got ip:" IPSTR, IP2STR(&event->ip_info.ip)));
+    MG_INFO(("IP ADDRESS:" IPSTR, IP2STR(&event->ip_info.ip)));
     s_retry_num = 0;
     xEventGroupSetBits(s_wifi_event_group, WIFI_CONNECTED_BIT);
   }