update version

free ifp on mgr_free

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/issue.md

@@ -1,3 +1,11 @@
+---
+name: Issue template
+about: Please fill this issue template for reporting Mongoose issues
+#title: 
+#labels: 
+#assignees: 
+---
+
 - My goal is: _describe_
 - My actions were: _describe_
 - My expectation was: _describe_
@@ -10,3 +18,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@v4
+      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'
@@ -19,8 +29,8 @@ jobs:
         dry-run: false
         language: c++
     - name: Upload Crash
-      uses: actions/upload-artifact@v1
+      uses: actions/upload-artifact@v4
-      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 23 * * *' # run at 11:30 PM 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@v4
+      with: { fetch-depth: 2 }
+
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: cpp
+    - run: |
+        make -C test test CC=gcc ASAN= ASAN_OPTIONS=
+        ./test/setup_ga_network.sh && make -C test mip_test CC=gcc ASAN= ASAN_OPTIONS=
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

.github/workflows/fuzz.yml

@@ -0,0 +1,20 @@
+name: Fuzz
+on:
+  schedule:
+    - cron: '0 21 * * *' # run at 9 PM UTC
+  # Allow manual runs
+  workflow_dispatch:
+env:
+  CC: clang
+jobs:
+  fuzz:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [fuzz, fuzz_tls]
+    name: ${{ matrix.target }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: make -C test ${{ matrix.target }}

.github/workflows/nightly.yml

@@ -0,0 +1,579 @@
+name: Full build and test
+on:
+  schedule:
+    - cron: '0 22 * * *' # run at 10 PM 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]
+        ssl: ["", BUILTIN, MBEDTLS, OPENSSL, WOLFSSL]
+        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"
+        - ssl: WOLFSSL
+          select: "-DMG_ENABLE_POLL=0 -DMG_ENABLE_EPOLL=0"
+        - ssl: WOLFSSL
+          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@v4
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install libmbedtls-dev libwolfssl-dev && make -C test ${{ matrix.target }}
+  mip:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        cc: [gcc, clang, g++, clang++]
+        target: [mip_test, mip_tap_test]
+        ssl: ["", BUILTIN, MBEDTLS, OPENSSL, WOLFSSL]
+    name: ${{ matrix.target }} CC=${{ matrix.cc }} SSL=${{ matrix.ssl }}
+    env:
+      CC: ${{ matrix.cc }}
+      SSL: ${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: if [ "${{ matrix.target }}" == "mip_tap_test" ]; then ./test/setup_ga_network.sh ; fi && sudo apt -y update ; sudo apt -y install libmbedtls-dev libwolfssl-dev && make -C test ${{ matrix.target }} IPV6=0
+  s390:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN]
+    name: S390 SSL=${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make -C test s390 SSL=${{ matrix.ssl }}
+  armhf:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN]
+    name: ArmHF SSL=${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make -C test armhf SSL=${{ matrix.ssl }}
+  unamalgamated-mg_prefix:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN, MBEDTLS, OPENSSL, WOLFSSL]
+    name: unamalgamated-mg_prefix SSL=${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install libmbedtls-dev libwolfssl-dev
+    - run: make -C test unamalgamated && make -C test mg_prefix
+  valgrind:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN, MBEDTLS, OPENSSL, WOLFSSL]
+    name: Valgrind SSL=${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: sudo apt -y update ; sudo apt -y install libmbedtls-dev libwolfssl-dev valgrind
+    - run: make -C test valgrind SSL=${{ matrix.ssl }}
+  macos:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN, MBEDTLS, OPENSSL, WOLFSSL]
+        select: [-DMG_ENABLE_POLL=0, -DMG_ENABLE_POLL=1]
+        exclude:
+        - ssl: MBEDTLS
+          select: -DMG_ENABLE_POLL=0
+        - ssl: OPENSSL
+          select: -DMG_ENABLE_POLL=0
+        - ssl: WOLFSSL
+          select: -DMG_ENABLE_POLL=0
+    name: macos SSL=${{ matrix.ssl }} TFLAGS=${{ matrix.select }}
+    env:
+      SSL: ${{ matrix.ssl }}
+      TFLAGS: ${{ matrix.select }} -Wno-sign-conversion # Workaround for MbedTLS 3.5.0
+      HOMEBREW_NO_AUTO_UPDATE: 1
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: brew install mbedtls wolfssl # jq openssl already pre-installed
+    - run: make -C test test ASAN_OPTIONS= MBEDTLS=$(echo $(brew --cellar)/mbedtls*/*) OPENSSL=$(echo $(brew --cellar)/openssl*/*) WOLFSSL=$(echo $(brew --cellar)/wolfssl*/*)
+  windows:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      max-parallel: 1   # no parallel runs, to minimize MQTT errors
+      matrix:
+        target: [vc98, vc17, vc22, mingw, mingw++]
+        ssl: ["", BUILTIN]
+        select: [-DMG_ENABLE_POLL=0, -DMG_ENABLE_POLL=1]
+        exclude:
+        - target: vc98
+          select: -DMG_ENABLE_POLL=1
+    name: windows ${{ matrix.target }} SSL=${{ matrix.ssl }} TFLAGS=${{ matrix.select }}
+    env:
+      SSL: SSL=${{ matrix.ssl }}
+      TFLAGS: ${{ matrix.select }}
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: make -C test ${{ matrix.target }} 
+  arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN]
+    name: Arm SSL=${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test arm SSL=${{ matrix.ssl }}
+  riscv:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN]
+    name: RISC-V SSL=${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test riscv SSL=${{ matrix.ssl }}
+
+  tutorials:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: [-DMG_TLS=MG_TLS_NONE, -DMG_TLS=MG_TLS_BUILTIN]
+    name: tutorials ${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+    - run: sudo apt -y install libpcap-dev
+    - run: make -C test tutorials CFLAGS_EXTRA="${{ matrix.ssl }}"
+    - run: make -C test clean_tutorials
+  tutorials_win:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: [-DMG_TLS=MG_TLS_NONE, -DMG_TLS=MG_TLS_BUILTIN]
+    name: tutorials_win ${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+#    - uses: egor-tensin/setup-mingw@v2
+#      with:
+#        platform: x64
+    - name: test they build
+      run: make -C test tutorials_win CFLAGS_EXTRA="${{ matrix.ssl }}"
+      shell: cmd
+    - name: test they clean
+      run: make -C test clean_tutorials_win
+      shell: cmd
+  tutorials_mac:
+    runs-on: macos-latest
+    env: { HOMEBREW_NO_AUTO_UPDATE: 1 }
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: [-DMG_TLS=MG_TLS_NONE, -DMG_TLS=MG_TLS_BUILTIN]
+    name: tutorials_mac ${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test tutorials_mac CFLAGS_EXTRA="${{ matrix.ssl }}"
+    - run: make -C test clean_tutorials_mac
+
+
+  arduino:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - run: echo # nothing specific to install or do
+    - run: make -C test/arduino
+    - run: make -C test/arduino cleanall
+
+
+#  wizard_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: esp32/esp32-idf
+#    name: ${{ matrix.example.path }}
+#    env:
+#      GO: 0
+#    steps:
+#      - uses: actions/checkout@v4
+#        with: { fetch-depth: 2 }
+#      - run: echo # nothing specific to install or do
+#          fi
+#      - run: make -C tutorials/${{ matrix.example.path }} build
+
+  wizard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: infineon/xmc47_relax-make-baremetal-builtin
+          - path: infineon/xmc_plt2go_4400-make-baremetal-builtin
+          - path: infineon/xmc72_evk-make-baremetal-builtin
+          - path: nxp/frdm-mcxn947-make-baremetal-builtin
+          - path: nxp/frdm-mcxn947-make-freertos-builtin
+          - path: nxp/rt1020-evk-make-baremetal-builtin
+          - path: nxp/rt1060-evk-make-baremetal-builtin
+          - path: nxp/rt1170-evk-make-baremetal-builtin
+          - path: pico-sdk/pico-w-picosdk-baremetal-builtin
+          - path: pico-sdk/pico-2-w-picosdk-baremetal-builtin
+          - path: pico-sdk/w5500-evb-pico-picosdk-baremetal-builtin
+          - path: pico-sdk/w5500-evb-pico2-picosdk-baremetal-builtin
+          - 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-h563zi-make-baremetal-builtin
+          - path: stm32/nucleo-h563zi-make-freertos-builtin
+          - path: stm32/nucleo-h723zg-make-baremetal-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@v4
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C tutorials/${{ matrix.example.path }} build
+
+
+  generic_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: micropython/esp32
+          - path: http/uart-bridge/esp32
+          - path: http/http-client/esp8266/http-client-server
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: echo # nothing specific to install or do
+      - run: make -C tutorials/${{ matrix.example.path }} build
+  
+  generic_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: mqtt/mqtt-client/microchip/same54-xpro
+          - 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: pico-sdk/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@v4
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C tutorials/${{ matrix.example.path }} build
+
+  device_dashboard_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: echo # nothing specific to install or do
+      - run: make -C tutorials/http/device-dashboard/${{ matrix.example.path }} build
+
+
+  device_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", -DMG_TLS=MG_TLS_BUILTIN]
+        example:
+          - path: tutorials/http/device-dashboard/microchip/same54-xpro
+          - path: nxp/rt1020-evk-make-freertos-builtin
+          - path: nxp/rt1060-evk-make-freertos-builtin
+          - path: nxp/rt1170-evk-make-freertos-builtin
+          - path: renesas/ek-ra6m4-make-baremetal-builtin
+          - path: pico-sdk/pico-rndis-dashboard
+          - path: pico-sdk/pico-w-picosdk-freertos-lwip
+          - path: pico-sdk/pico-2-w-picosdk-freertos-lwip
+          - path: stm32/nucleo-f746zg-make-freertos-tcp
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-cmsis_driver
+    name: ${{ matrix.example.path }} ${{ matrix.ssl }}
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C tutorials/${{ matrix.example.path }} build CFLAGS_EXTRA="${{ matrix.ssl }}"
+
+#  mqtt_dashboard_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: 
+#    name: ${{ matrix.example.path }}
+#    steps:
+#      - uses: actions/checkout@v4
+#        with: { fetch-depth: 2 }
+#      - run: echo # nothing specific to install or do
+#      - run: make -C tutorials/${{ matrix.example.path }} build
+      
+  mqtt_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: pico-sdk/pico-rndis-device
+    name: ${{ matrix.example.path }}
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C tutorials/${{ 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@v4
+#        with: { fetch-depth: 2 }
+#      - run: echo # nothing specific to install or do
+#      - run: make -C tutorials/${{ matrix.example.path }} device_dashboard
+#      - run: make -C tutorials/${{ matrix.example.path }} mqtt_dashboard
+
+  cube_examples:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: sudo pip install yq
+      - run: cd test/cube && make
+
+  zephyr_examples:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+      - run: make -C tutorials/zephyr init REPO=zephyrprojectrtos/ci:v0.26.14 # "no space left on device" with newers
+      - 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))' tutorials/zephyr/zephyrproject/zephyr/west.yml
+      - run: make -C tutorials/zephyr update
+      - run: make -C tutorials/zephyr/device-dashboard build
+      - run: make -C tutorials/zephyr/http-client build
+      - run: make -C tutorials/zephyr/http-server build
+      - run: make -C tutorials/zephyr/mqtt-aws-client build
+      - run: make -C tutorials/zephyr/websocket-server build
+
+  test_f7:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/stm32/nucleo-f746zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/stm32/nucleo-f746zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/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=../../tutorials/stm32/nucleo-f746zg-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5
+#    - run: make -C test/cube test PROJECTS=../../tutorials/stm32/nucleo-f746zg-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=5    
+    - run: make -C test/cube test PROJECTS=../../tutorials/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@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/stm32/nucleo-f429zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/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=../../tutorials/stm32/nucleo-f429zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+#    - run: make -C test/cube test PROJECTS=../../tutorials/stm32/nucleo-f429zi-cube-freertos-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=2
+    - run: make -C test/cube test PROJECTS=../../tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/stm32/nucleo-h743zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/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=../../tutorials/stm32/nucleo-h743zi-cube-baremetal-builtin VCON_API_KEY=${{secrets.VCON_API_KEY}} DEVICE=6
+#    - run: make -C test/cube test PROJECTS=../../tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/stm32/nucleo-h723zg-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/stm32/nucleo-h723zg-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    
+  test_h5:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/stm32/nucleo-h563zi-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/stm32/nucleo-h563zi-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_rt1020:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/nxp/rt1020-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/nxp/rt1020-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_rt1060:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/nxp/rt1060-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/nxp/rt1060-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_rt1170:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/nxp/rt1170-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run: make -C tutorials/nxp/rt1170-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_ra6m4:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run: make -C tutorials/renesas/ek-ra6m4-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+#    - run: make -C tutorials/renesas/ek-ra6m4-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_tm4c:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run:  make -C tutorials/ti/ek-tm4c1294xl-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run:  make -C tutorials/ti/ek-tm4c1294xl-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_same54:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run:  make -C tutorials/http/device-dashboard/microchip/same54-xpro test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+    - run:  make -C tutorials/mqtt/mqtt-client/microchip/same54-xpro test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+
+  test_pico_w5500:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - name: SDK
+      run: sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+    - run:  make -C tutorials/pico-sdk/w5500-evb-pico-picosdk-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+

.github/workflows/quicktest.yml

@@ -0,0 +1,694 @@
+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: ["", BUILTIN]
+    name: linux ${{ matrix.target }} CC=${{ matrix.cc }} SSL=${{ matrix.ssl }}
+    env:
+      CC: ${{ matrix.cc }}
+      SSL: ${{ matrix.ssl }}
+    steps:
+    - uses: actions/checkout@v4
+      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 -C test ${{ matrix.target }}
+  s390:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      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 binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make -C test s390
+  armhf:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      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 binfmt-support qemu-user-static && docker run --rm --privileged multiarch/qemu-user-static --reset -p yes && make -C test armhf
+  unamalgamated-mg_prefix:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      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 -C test unamalgamated && make -C test mg_prefix
+  macos:
+    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ssl: ["", BUILTIN]
+    name: macos SSL=${{ matrix.ssl }}
+    env:
+      SSL: ${{ matrix.ssl }}
+      #TFLAGS: -DNO_SNTP_CHECK
+      HOMEBREW_NO_AUTO_UPDATE: 1
+    steps:
+    - uses: actions/checkout@v4
+      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 -C test test ASAN_OPTIONS=
+  windows:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        target: [vc98, vc22, mingw++]
+    name: windows ${{ matrix.target }}
+    steps:
+    - uses: actions/checkout@v4
+      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 -C test ${{ matrix.target }} 
+  arm:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test arm
+  riscv:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test riscv
+
+  tutorials:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test tutorials_essential
+    - run: make -C test clean_tutorials_essential
+  tutorials_win:
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v4
+#    - uses: egor-tensin/setup-mingw@v2
+#      with:
+#        platform: x64
+    - name: test they build
+      run: make -C test tutorials_win
+      shell: cmd
+    - name: test they clean
+      run: make -C test clean_tutorials_win
+      shell: cmd
+  tutorials_mac:
+    runs-on: macos-latest
+    env: { HOMEBREW_NO_AUTO_UPDATE: 1 }
+    steps:
+    - uses: actions/checkout@v4
+    - run: make -C test tutorials_mac
+    - run: make -C test clean_tutorials_mac
+
+
+#  wizard_examples:
+#    runs-on: ubuntu-latest
+#    strategy:
+#      fail-fast: false
+#      matrix:
+#        example:
+#          - path: esp32/esp32-idf
+#    name: ${{ matrix.example.path }}
+#    env:
+#      GO: 0
+#    steps:
+#      - uses: actions/checkout@v4
+#        with: { fetch-depth: 2 }
+#      - run: |
+#          if ./test/match_changed_files.sh '^src'; then
+#            echo GO=1 >> $GITHUB_ENV
+#            # nothing specific to install or do
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: make -C tutorials/${{ matrix.example.path }} build
+
+  wizard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: infineon/xmc47_relax-make-baremetal-builtin
+          - path: infineon/xmc_plt2go_4400-make-baremetal-builtin
+          - path: infineon/xmc72_evk-make-baremetal-builtin
+          - path: nxp/frdm-mcxn947-make-baremetal-builtin
+          - path: nxp/frdm-mcxn947-make-freertos-builtin
+          - path: nxp/rt1020-evk-make-baremetal-builtin
+          - path: nxp/rt1060-evk-make-baremetal-builtin
+          - path: nxp/rt1170-evk-make-baremetal-builtin
+          - path: pico-sdk/pico-w-picosdk-baremetal-builtin
+          - path: pico-sdk/pico-2-w-picosdk-baremetal-builtin
+          - path: pico-sdk/w5500-evb-pico-picosdk-baremetal-builtin
+          - path: pico-sdk/w5500-evb-pico2-picosdk-baremetal-builtin
+          - 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-h563zi-make-baremetal-builtin
+          - path: stm32/nucleo-h563zi-make-freertos-builtin
+          - path: stm32/nucleo-h723zg-make-baremetal-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@v4
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src'; 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 tutorials/${{ matrix.example.path }} build
+
+
+  generic_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: http/uart-bridge/esp32
+          - path: http/http-client/esp8266/http-client-server
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: if ./test/match_changed_files.sh '^src|^tutorials/http/uart-bridge|^tutorials/${{ 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 tutorials/${{ matrix.example.path }} build
+  
+  generic_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: stm32/nucleo-g031-make-baremetal-builtin
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: if ./test/match_changed_files.sh '^src|^tutorials/${{ 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 tutorials/${{ matrix.example.path }} build
+
+  device_dashboard_examples:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: esp32
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard'; then
+            echo GO=1 >> $GITHUB_ENV
+            # nothing specific to install or do
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: make -C tutorials/http/device-dashboard/${{ matrix.example.path }} build
+
+  device_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: http/device-dashboard/microchip/same54-xpro
+          - path: nxp/rt1020-evk-make-freertos-builtin
+          - path: nxp/rt1060-evk-make-freertos-builtin
+          - path: nxp/rt1170-evk-make-freertos-builtin
+          - path: renesas/ek-ra6m4-make-baremetal-builtin
+          - path: pico-sdk/pico-rndis-dashboard
+          - path: pico-sdk/pico-w-picosdk-freertos-lwip
+          - path: pico-sdk/pico-2-w-picosdk-freertos-lwip
+          - path: stm32/nucleo-f746zg-make-freertos-tcp
+          - path: stm32/nucleo-f746zg-make-baremetal-builtin-cmsis_driver
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|^tutorials/${{ 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 tutorials/${{ 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@v4
+#        with: { fetch-depth: 2 }
+#      - run: |
+#          if ./test/match_changed_files.sh '^src|tutorials/mqtt/mqtt-dashboard/device|^tutorials/${{ matrix.example.path }}'; then
+#            echo GO=1 >> $GITHUB_ENV
+#            # nothing specific to install or do
+#          fi
+#      - if: ${{ env.GO == 1 }}
+#        run: make -C tutorials/${{ matrix.example.path }} build
+      
+  mqtt_dashboard_examples_arm:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        example:
+          - path: pico-sdk/pico-rndis-device
+    name: ${{ matrix.example.path }}
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|tutorials/mqtt/mqtt-dashboard/device|^tutorials/${{ 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 tutorials/${{ matrix.example.path }} build
+      
+  cube_examples:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - run: |
+          if ./test/match_changed_files.sh '^src|tutorials/stm32/nucleo-*-cube-*'; then
+            echo GO=1 >> $GITHUB_ENV
+            sudo pip install yq
+          fi
+      - if: ${{ env.GO == 1 }}
+        run: cd test/cube && make
+
+  test_f7:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/stm32/nucleo-f7.*-make-" ; 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 }}
+      continue-on-error: true   # continue so next test has a chance to re-flash and exit from collisions and flash failures
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/stm32/nucleo-f746zg-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/stm32/nucleo-f746zg-make-freertos-builtin'; then
+          make -C tutorials/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 'tutorials/stm32/nucleo-f746zg-make-freertos-tcp'; then
+          make -C tutorials/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 'tutorials/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 'tutorials/stm32/nucleo-f746zg-cube-baremetal-builtin'; then
+#          make -C test/cube test PROJECTS=../../tutorials/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 'tutorials/stm32/nucleo-f746zg-cube-freertos-builtin'; then
+#          make -C test/cube test PROJECTS=../../tutorials/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 'tutorials/stm32/nucleo-f746zg-cube-freertos-lwip'; then
+          make -C test/cube test PROJECTS=../../tutorials/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@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/stm32/nucleo-f429zi-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/stm32/nucleo-f429zi-make-freertos-builtin'; then
+          make -C tutorials/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 'tutorials/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 'tutorials/stm32/nucleo-f429zi-cube-baremetal-builtin'; then
+#          make -C test/cube test PROJECTS=../../tutorials/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 'tutorials/stm32/nucleo-f429zi-cube-freertos-builtin'; then
+#          make -C test/cube test PROJECTS=../../tutorials/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 'tutorials/stm32/nucleo-f429zi-cube-freertos-lwip'; then
+          make -C test/cube test PROJECTS=../../tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/stm32/nucleo-h743zi-make-baremetal-builtin'; then
+        make -C tutorials/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 'tutorials/stm32/nucleo-h743zi-make-freertos-builtin'; then
+          make -C tutorials/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 'tutorials/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 'tutorials/stm32/nucleo-h743zi-cube-baremetal-builtin'; then
+#          make -C test/cube test PROJECTS=../../tutorials/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 'tutorials/stm32/nucleo-h743zi-cube-freertos-builtin'; then
+#          make -C test/cube test PROJECTS=../../tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/stm32/nucleo-h723zg-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/stm32/nucleo-h723zg-make-freertos-builtin'; then
+          make -C tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/stm32/nucleo-h563zi-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/stm32/nucleo-h563zi-make-freertos-builtin'; then
+          make -C tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/nxp/rt1020-evk-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/nxp/rt1020-evk-make-freertos-builtin'; then
+          make -C tutorials/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@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/nxp/rt1060-evk-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/nxp/rt1060-evk-make-freertos-builtin'; then
+          make -C tutorials/nxp/rt1060-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_rt1170:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/nxp/rt1170.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/nxp/rt1170-evk-make-baremetal-builtin'; then
+          make -C tutorials/nxp/rt1170-evk-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh 'tutorials/nxp/rt1170-evk-make-freertos-builtin'; then
+          make -C tutorials/nxp/rt1170-evk-make-freertos-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_ra6m4:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 3 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/renesas/ek-ra6m4.*-make-" ; then
+          echo GO=1 >> $GITHUB_ENV
+          sudo apt -y update && sudo apt -y install gcc-arm-none-eabi
+        fi
+    - if: ${{ env.GO == 1 }}
+      continue-on-error: true
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/http/device-dashboard|tutorials/renesas/ek-ra6m4-make-baremetal-builtin'; then
+          make -C tutorials/renesas/ek-ra6m4-make-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+#    - if: ${{ env.GO == 1 }}
+#      run: |
+#        if ./test/match_changed_files.sh 'tutorials/renesas/ek-ra6m4-make-freertos-builtin'; then
+#          make -C tutorials/renesas/ek-ra6m4-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@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/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|tutorials/http/device-dashboard|tutorials/ti/ek-tm4c1294xl-make-baremetal-builtin'; then
+          make -C tutorials/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 'tutorials/ti/ek-tm4c1294xl-make-freertos-builtin'; then
+          make -C tutorials/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@v4
+      with: { fetch-depth: 2 }
+    - name: baremetal
+      run: |
+        if ./test/match_changed_files.sh "^src|tutorials/http/device-dashboard|tutorials/mqtt/mqtt-client" ; 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|tutorials/http/device-dashboard'; then
+          make -C tutorials/http/device-dashboard/microchip/same54-xpro test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+    - if: ${{ env.GO == 1 }}
+      run: |
+        if ./test/match_changed_files.sh '^src|tutorials/mqtt/mqtt-client'; then
+          make -C tutorials/mqtt/mqtt-client/microchip/same54-xpro test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+        fi
+
+  test_pico_w5500:
+    runs-on: ubuntu-latest
+    env:
+      GO: 0
+    steps:
+    - uses: actions/checkout@v4
+      with: { fetch-depth: 2 }
+    - name: SDK
+      run: |
+        if ./test/match_changed_files.sh "^src" ; 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 tutorials/pico-sdk/w5500-evb-pico-picosdk-baremetal-builtin test VCON_API_KEY=${{secrets.VCON_API_KEY}}
+

.github/workflows/test.yml

@@ -1,128 +1,740 @@
-name: build
+name: original workflow, outdated # *** YES, OUTDATED *** kept for hystorical/reference purposes, attachment, etc.
-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
-    - run: sudo apt-get install libmbedtls-dev libpcap-dev
+      with: { fetch-depth: 2 }
-    - run: make clean examples
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - run: make clean test IPV6=0 MG_ENABLE_POLL=1
+    - 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, 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
-    - run: HOMEBREW_NO_AUTO_UPDATE=1 brew install jq mbedtls openssl
+      with: { fetch-depth: 2 }
-    - run: make test++ upload-coverage IPV6=0 ASAN_OPTIONS=
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - run: make test SSL=OPENSSL IPV6=0 ASAN_OPTIONS= OPENSSL=`echo /usr/local/Cellar/openssl*/*`
+    - if: ${{ env.GO == 1 }}
-    - run: make mg_prefix
+      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
-    - run: make vc98
+      with: { fetch-depth: 2 }
-    - run: make vc17
+    - run: if ./test/match_changed_files.sh '^test|^src/.*.[ch]' ; then echo GO=1 >> $GITHUB_ENV ; fi
-    - run: make vc22
+    - if: ${{ env.GO == 1 }}
-    - run: make mingw
+      run: make ${{ matrix.target }} 
-    - run: make mingw++
   arm:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
     - run: make arm
-  matrix_examples:
+  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:
-          - name: esp32/device-dashboard
+          - path: esp32/uart-bridge
-            path: esp32/device-dashboard
+          - 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: stm32-nucleo-f746zg-baremetal
-            path: stm32/nucleo-f746zg-baremetal
-          - 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: 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-2025 Cesanta Software Limited
 All rights reserved
 
 This software is dual-licensed: you can redistribute it and/or modify

Makefile

@@ -1,164 +0,0 @@
-SRCS = mongoose.c test/unit_test.c test/packed_fs.c
-HDRS = $(wildcard src/*.h) $(wildcard mip/*.h)
-DEFS ?= -DMG_MAX_HTTP_HEADERS=7 -DMG_ENABLE_LINES -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_SSI=1
-C_WARN ?= -Wmissing-prototypes -Wstrict-prototypes
-WARN ?= -pedantic -W -Wall -Werror -Wshadow -Wdouble-promotion -fno-common -Wconversion -Wundef $(C_WARN)
-OPTS ?= -O3 -g3
-VALGRIND_OPTS ?= -O0 -g3
-INCS ?= -Isrc -I.
-SSL ?= MBEDTLS
-CWD ?= $(realpath $(CURDIR))
-ENV ?=  -e Tmp=. -e WINEDEBUG=-all 
-DOCKER ?= docker 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_OPTIONS ?= detect_leaks=1
-EXAMPLES := $(dir $(wildcard examples/*/Makefile)) examples/stm32/nucleo-f746zg-baremetal
-PREFIX ?= /usr/local
-VERSION ?= $(shell cut -d'"' -f2 src/version.h)
-COMMON_CFLAGS ?= $(WARN) $(INCS) $(DEFS) -DMG_ENABLE_IPV6=$(IPV6) $(TFLAGS)
-CFLAGS ?= $(OPTS) $(ASAN) $(COMMON_CFLAGS)
-VALGRIND_CFLAGS ?= $(VALGRIND_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
-.PHONY: examples test valgrind
-
-ifeq "$(SSL)" "MBEDTLS"
-MBEDTLS ?= /usr/local
-CFLAGS  += -DMG_ENABLE_MBEDTLS=1 -I$(MBEDTLS)/include -I/usr/include
-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++ arm examples vc98 vc17 vc22 mingw mingw++ linux linux++ fuzz
-
-examples:
-	@for X in $(EXAMPLES); do test -f $$X/Makefile || continue; $(MAKE) -C $$X example || exit 1; done
-
-test/packed_fs.c: Makefile src/ssi.h test/fuzz.c test/data/a.txt
-	$(CC) $(CFLAGS) test/pack.c -o pack
-	$(RUN) ./pack Makefile src/ssi.h test/fuzz.c test/data/a.txt test/data/range.txt > $@
-
-DIR ?= test/data/
-OUT ?= fs_packed.c
-mkfs:
-	$(CC) $(CFLAGS) test/pack.c -o pack
-	$(RUN) ./pack -s $(DIR) `find $(DIR) -type f` > $(OUT)
-#	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
-
-# C++ build
-test++: test
-test++: CC = g++
-test++: C_WARN = -std=c++2a -Wno-vla -Wno-shadow -Wno-missing-field-initializers -Wno-deprecated
-
-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
-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:
-	$(CC) -I. mongoose.c test/unit_test.c -o $@
-
-fuzzer: mongoose.c mongoose.h Makefile test/fuzz.c
-	clang++ mongoose.c test/fuzz.c $(WARN) $(INCS) $(TFLAGS) -DMG_ENABLE_LINES -fsanitize=fuzzer,signed-integer-overflow,address -Wno-deprecated -Wno-vla-extension -o $@
-
-fuzz: fuzzer
-	$(RUN) ./fuzzer
-
-unit_test: Makefile mongoose.h $(SRCS)
-	$(CC) $(SRCS) $(CFLAGS) $(LDFLAGS) -g -o unit_test
-
-# make CC=/usr/local/opt/llvm\@8/bin/clang ASAN_OPTIONS=detect_leaks=1
-test: 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
-
-upload-coverage: coverage
-	curl -s https://codecov.io/bash | /bin/bash
-
-valgrind_unit_test: Makefile mongoose.h $(SRCS)
-	$(CC) $(SRCS) $(VALGRIND_CFLAGS) $(LDFLAGS) -g -o valgrind_unit_test
-
-valgrind: valgrind_unit_test
-	$(VALGRIND_RUN) ./valgrind_unit_test
-
-infer:
-	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
-
-arm: DEFS += -DMG_ENABLE_FILE=0 -DMG_ENABLE_MIP=1 -DMG_ARCH=MG_ARCH_NEWLIB 
-arm: mongoose.h $(SRCS)
-	$(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_FILE=0 -DMG_ENABLE_MIP=1 -DMG_ARCH=MG_ARCH_NEWLIB 
-riscv: mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/riscv riscv-none-elf-gcc -march=rv32imc -mabi=ilp32 $(SRCS) $(OPTS) $(WARN) $(INCS) $(DEFS) $(TFLAGS) -o unit_test
-
-vc98: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/vc98 wine cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
-	$(DOCKER) mdashnet/vc98 wine $@.exe
-
-# vc17: DEFS += -DMG_ENABLE_IPV6=1
-vc17: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/vc17 wine64 cl $(SRCS) $(VCFLAGS) ws2_32.lib /Fe$@.exe
-	$(DOCKER) mdashnet/vc17 wine64 $@.exe
-
-# vc22: DEFS += -DMG_ENABLE_IPV6=$(IPV6)
-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 x86_64-w64-mingw32-gcc $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o $@.exe
-	$(DOCKER) mdashnet/mingw wine64 $@.exe
-
-mingw++: Makefile mongoose.h $(SRCS)
-	$(DOCKER) mdashnet/mingw x86_64-w64-mingw32-g++ $(SRCS) -W -Wall -Werror -I. $(DEFS) -lwsock32 -o $@.exe
-
-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: 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
-	ln -s libmongoose.so.$(VERSION) $(DESTDIR)$(PREFIX)/lib/libmongoose.so
-	install -Dm644 mongoose.h $(DESTDIR)$(PREFIX)/include/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
-
-mongoose.c: Makefile $(wildcard src/*) $(wildcard mip/*.c)
-	(cat src/license.h; echo; echo '#include "mongoose.h"' ; (for F in src/*.c mip/*.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/fmt.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/json.h src/rpc.h mip/mip.h | sed -e 's,#include ".*,,' -e 's,^#pragma once,,'; echo; echo '#ifdef __cplusplus'; echo '}'; echo '#endif'; echo '#endif  // MONGOOSE_H')> $@
-
-clean:
-	rm -rf $(PROG) *.exe *.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

@@ -1,31 +1,137 @@
-# Mongoose - Embedded Web Server / Embedded Networking Library
+# Mongoose - Embedded Web Server / Embedded Network Library
 
 [![License: GPLv2/Commercial](https://img.shields.io/badge/License-GPLv2%20or%20Commercial-green.svg)](https://opensource.org/licenses/gpl-2.0.php)
 [![Build Status]( https://github.com/cesanta/mongoose/workflows/build/badge.svg)](https://github.com/cesanta/mongoose/actions)
 [![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)
+[![Gurubase](https://img.shields.io/badge/Gurubase-Ask%20Mongoose%20Guru-006BFF)](https://gurubase.io/g/mongoose)
 
-Mongoose is a networking library for C/C++. It implements event-driven
+Mongoose is a network library for C/C++.  It provides event-driven non-blocking
-non-blocking APIs for TCP, UDP, HTTP, WebSocket, MQTT.  It is designed for
+APIs for TCP, UDP, HTTP, WebSocket, MQTT, and other protocols.  It is designed
-connecting devices and bringing them online. On the market since 2004, used by
+for connecting devices and bringing them online. On the market since 2004, used
-vast number of open source and commercial products - it even runs on the
+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 ST, NXP, ESP32, Nordic, TI, Microchip, Infineon, Renesas and other chips
-- 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, and other
 - 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
+- Easy to integrate: just copy [mongoose.c](https://raw.githubusercontent.com/cesanta/mongoose/master/mongoose.c)
-- Very easy to integrate: just copy `mongoose.c` and `mongoose.h` files to your build tree
+  and [mongoose.h](https://raw.githubusercontent.com/cesanta/mongoose/master/mongoose.h) files to your source tree
-- Detailed [documentation](https://mongoose.ws/documentation/) and
+- Built-in TCP/IP stack with drivers for bare metal or RTOS systems
-  [tutorials](https://mongoose.ws/tutorials/)
+   - Available drivers: STM32F, STM32H; NXP RT1xxx; TI TM4C; Microchip SAME54; Wiznet W5500
+   - A complete Web device dashboard on bare metal ST Nucleo boards is only 6 files
+   - For comparison, a CubeIDE generated HTTP example is 400+ files
+- Can run on top of an existing TCP/IP stack with BSD API, e.g. lwIP, Zephyr, Azure, etc
+- Built-in TLS 1.3 ECC stack. Also can use external TLS libraries - mbedTLS, OpenSSL, or other
+- Does not depend on any other software to implement networking
+- Built-in firmware updates for STM32 H5, STM32 H7
 
+See https://mongoose.ws/ for complete documentation, videos, case studies, etc.
 
-# Commercial use
+## Usage Examples
+
+Below are quick snippets that should give an idea how simple the API is and
+how easy it is to create applications with it.
+
+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"   // To build, run: cc main.c mongoose.c
+
+// HTTP server event handler function
+void ev_handler(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);
+  }
+}
+
+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", ev_handler, NULL);  // Setup listener
+  for (;;) {          // Run an infinite event loop
+    mg_mgr_poll(&mgr, 1000);
+  }
+  return 0;
+}
+```
+
+HTTP server implements a REST API that returns current time. JSON formatting:
+```c
+static void ev_handler(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_match(hm->uri, mg_str("/api/time/get"), NULL)) {
+      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 `device1/rx` and
+echoes incoming messages to `device1/tx`:
+
+```c
+#include "mongoose.h"
+
+static const char *s_mqtt_url = "mqtt://broker.hivemq.com:1883";
+static struct mg_connection *s_mqtt_conn = NULL;
+
+// MQTT connection event handler function
+static void ev_handler(struct mg_connection *c, int ev, void *ev_data) {
+  if (ev == MG_EV_OPEN) {
+    MG_INFO(("%lu created, connecting to %s ...", c->id, s_mqtt_url));
+  } else if (ev == MG_EV_MQTT_OPEN) {
+    struct mg_mqtt_opts opts = {.qos = 1, .topic = mg_str("device1/rx")};
+    mg_mqtt_sub(c, &opts);
+    MG_INFO(("%lu connected, subscribing to %s", c->id, opts.topic.buf));
+  } else if (ev == MG_EV_MQTT_MSG) {
+    char response[100];
+    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
+    struct mg_mqtt_opts opts = {.qos = 1, .topic = mg_str("device1/tx")};
+    mg_snprintf(response, sizeof(response), "Received [%.*s] / [%.*s]",
+                mm->topic.len, mm->topic.buf, mm->data.len, mm->data.buf);
+    opts.message = mg_str(response);
+    mg_mqtt_pub(c, &opts);
+  } else if (ev == MG_EV_CLOSE) {
+    MG_INFO(("%u closing", c->id));
+    s_mqtt_conn = NULL;
+  }
+}
+
+// Reconnection timer function. If we get disconnected, reconnect again
+static void timer_fn(void *arg) {
+  struct mg_mgr *mgr = (struct mg_mgr *) arg;
+  if (s_mqtt_conn == NULL) {
+    struct mg_mqtt_opts opts = {.clean = true};
+    s_mqtt_conn = mg_mqtt_connect(mgr, s_mqtt_url, &opts, ev_handler, NULL);
+  }
+}
+
+int main() {
+  struct mg_mgr mgr;  // Mongoose event manager. Holds all connections
+  mg_mgr_init(&mgr);  // Initialise event manager
+  mg_timer_add(&mgr, 3000, MG_TIMER_REPEAT | MG_TIMER_RUN_NOW, timer_fn, &mgr);
+  for (;;) {
+    mg_mgr_poll(&mgr, 1000);  // Infinite event loop
+  }
+  return 0;
+}
+```
+
+## 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 +141,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
@@ -65,7 +171,15 @@ We take security seriously:
   of which we get notified and in case of any issue, act similar to (3).
 
 
-# Contributions
+## Articles
+
+Technical guides and deep dives into embedded web servers, WebUI integration and embedded networking technologies:
+- [Embedded Web Server: A Comprehensive Guide for Modern Connected Devices](https://mongoose.ws/articles/embedded-web-server-a-comprehensive-guide-for-modern-connected-devices/)
+- [Building Embedded Web Device Dashboards](https://mongoose.ws/articles/building-embedded-web-device-dashboard/)
+- [ESP32 Device Dashboard: A Step-by-Step Guide for Developers](https://mongoose.ws/articles/esp32-device-dashboard/)
+
+
+## Contributions
 
 Contributions are welcome! Please follow the guidelines below:
 

docs/images/mg_commalist.svg

@@ -1,97 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 1034 239" style="enable-background:new 0 0 1034 239;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#576174;}
-	.st1{fill:#FFFFFF;}
-	.st2{font-family:'Courier-Bold';}
-	.st3{font-size:16.7604px;}
-	.st4{fill:#00983A;}
-	.st5{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st6{fill:#45CFFF;}
-	.st7{fill:none;stroke:#A000FF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st8{fill:#A000FF;}
-	.st9{fill:none;stroke:#FFDE00;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st10{fill:#FFDE00;}
-	.st11{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st12{fill:#EA5B0C;}
-</style>
-<g>
-	<path class="st0" d="M485.3,224.22H8.5c-4.7,0-8.5-3.8-8.5-8.5V27.22c0-4.7,3.8-8.5,8.5-8.5h476.8c4.7,0,8.5,3.8,8.5,8.5v188.5
-		C493.8,220.32,490,224.22,485.3,224.22z"/>
-	<g>
-		<g>
-			<g>
-				<text transform="matrix(1 0 0 1 21.294 60.1267)" class="st1 st2 st3">struct mg_str k,v,s = mg_str(”a=333, b=777”);</text>
-			</g>
-		</g>
-		<g>
-			<g>
-				<text transform="matrix(1 0 0 1 21.294 136.2499)" class="st1 st2 st3">mg_commalist(&amp;s, &amp;k, &amp;v); </text>
-			</g>
-		</g>
-		<g>
-			<g>
-				<text transform="matrix(1 0 0 1 21.294 197.1485)" class="st1 st2 st3">mg_commalist(&amp;s, &amp;k, &amp;v); </text>
-			</g>
-		</g>
-		<g>
-			<g>
-				<text transform="matrix(1 0 0 1 291.5096 140.18)" class="st4 st2 st3">// 1st call</text>
-				<text transform="matrix(1 0 0 1 291.5096 199.8101)" class="st4 st2 st3">// 2nd call</text>
-			</g>
-		</g>
-	</g>
-	<g>
-		<polyline class="st5" points="336.4,64.52 336.4,68.52 317.8,68.52 317.8,64.52 		"/>
-		<g>
-			<path class="st5" d="M122.3,59.62"/>
-			<g>
-				<polyline class="st5" points="327.5,76.82 327.6,94.02 203.3,94.02 203.3,116.12 				"/>
-				<path class="st6" d="M331,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C329.5,74.42,331,75.92,331,77.62z"/>
-			</g>
-		</g>
-		<path class="st6" d="M203.2,114.92c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C206.5,116.32,205,114.92,203.2,114.92z"/>
-	</g>
-	<g>
-		<polyline class="st7" points="407.4,64.52 407.4,68.52 388.8,68.52 388.8,64.52 		"/>
-		<g>
-			<path class="st5" d="M193.4,59.62"/>
-			<g>
-				<polyline class="st7" points="398.6,76.82 398.6,149.02 203.4,149.02 203.4,177.12 				"/>
-				<path class="st8" d="M402,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C400.6,74.42,402,75.92,402,77.62z"/>
-			</g>
-		</g>
-		<path class="st8" d="M203.2,175.42c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C206.5,176.82,205,175.42,203.2,175.42z"/>
-	</g>
-	<g>
-		<polyline class="st9" points="440.8,64.52 440.8,68.52 414.2,68.52 414.2,64.52 		"/>
-		<g>
-			<path class="st5" d="M218.8,59.62"/>
-			<g>
-				<polyline class="st9" points="428,76.82 428,163.02 245.7,163.02 245.7,176.12 				"/>
-				<path class="st10" d="M431.4,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C430,74.42,431.4,75.92,431.4,77.62z"/>
-			</g>
-		</g>
-		<path class="st10" d="M245.4,175.42c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C248.7,176.82,247.2,175.42,245.4,175.42z
-			"/>
-	</g>
-	<g>
-		<polyline class="st11" points="372.8,64.52 372.8,68.52 343.2,68.52 343.2,64.52 		"/>
-		<g>
-			<path class="st5" d="M164.7,59.62"/>
-			<g>
-				<polyline class="st11" points="358.3,76.62 358.3,104.82 245.7,105.02 245.7,116.12 				"/>
-				<path class="st12" d="M361.4,77.62c0,1.8-1.4,3.2-3.2,3.3c-1.8,0.1-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C359.9,74.42,361.4,75.92,361.4,77.62z"/>
-			</g>
-		</g>
-		<path class="st12" d="M245.7,114.92c-1.8,0-3.2,1.3-3.3,3s1.4,3,3.2,3s3.2-1.3,3.3-3l0,0C248.9,116.32,247.4,114.92,245.7,114.92z
-			"/>
-	</g>
-</g>
-</svg>

docs/images/mg_http_get_request_len.svg

@@ -1,48 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 1034 158.07" style="enable-background:new 0 0 1034 158.07;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#67748A;}
-	.st1{fill:#FFFFFF;}
-	.st2{font-family:'Courier-Bold';}
-	.st3{font-size:16.7604px;}
-	.st4{fill:none;stroke:#45CFFF;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st5{fill:#45CFFF;}
-	.st6{font-family:'Arial-BoldMT';}
-</style>
-<g>
-	<path class="st0" d="M516.7,39.8v56.33c0,4.17-3.8,7.54-8.5,7.54H14.6H8.5c-4.7,0-8.5-3.37-8.5-7.54V39.8c0-4.17,3.8-7.54,8.5-7.54
-		h499.7C512.9,32.26,516.7,35.63,516.7,39.8z"/>
-	<text transform="matrix(1 0 0 1 51.0379 69.3318)" class="st1 st2 st3">GET /test \n\nGET /test \n\nGET test \n\n</text>
-	<g>
-		<polyline class="st4" points="189.5,76.47 189.5,80.47 51.8,80.47 51.8,76.47 		"/>
-		<polyline class="st4" points="331.3,76.47 331.3,80.47 195.6,80.47 195.6,76.47 		"/>
-		<polyline class="st4" points="462.7,76.47 462.7,80.47 336.9,80.47 336.9,76.47 		"/>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 78.8909 148.8896)" class="st5 st6 st3">1st request</text>
-		<g>
-			<line class="st4" x1="120.2" y1="93.57" x2="120.3" y2="129.57"/>
-			<path class="st5" d="M117.1,92.57c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-				C118.5,95.77,117.1,94.37,117.1,92.57z"/>
-		</g>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 217.3594 148.8891)" class="st5 st6 st3">2nd request </text>
-		<g>
-			<line class="st4" x1="263.8" y1="93.57" x2="263.9" y2="129.57"/>
-			<path class="st5" d="M260.7,92.57c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-				C262.1,95.77,260.7,94.37,260.7,92.57z"/>
-		</g>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 354.7297 148.8896)" class="st5 st6 st3">3rd request </text>
-		<g>
-			<line class="st4" x1="399.4" y1="93.57" x2="399.4" y2="129.57"/>
-			<path class="st5" d="M396.2,92.57c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-				C397.7,95.77,396.2,94.37,396.2,92.57z"/>
-		</g>
-	</g>
-</g>
-</svg>

docs/images/mg_http_message.svg

@@ -1,113 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 1035.4 429.9" style="enable-background:new 0 0 1035.4 429.9;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#576174;}
-	.st1{fill:#67748A;}
-	.st2{fill:none;stroke:#87005B;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st3{fill:#87005B;}
-	.st4{fill:#FFFFFF;}
-	.st5{font-family:'Courier-Bold';}
-	.st6{font-size:16.7604px;}
-	.st7{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st8{fill:#EA5B0C;}
-	.st9{fill:none;stroke:#CA70FF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st10{fill:#CA70FF;}
-	.st11{fill:none;stroke:#FFDE00;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st12{fill:#FFDE00;}
-	.st13{fill:none;stroke:#00CF4F;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st14{fill:#00CF4F;}
-	.st15{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st16{fill:none;stroke:#EA5B0C;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st17{font-family:'Arial-BoldMT';}
-	.st18{font-size:24px;}
-	.st19{fill:#45CFFF;}
-</style>
-<g>
-	<path class="st0" d="M755.8,391.8H8.5c-4.7,0-8.5-3.8-8.5-8.5v-153c0-4.7,3.8-8.5,8.5-8.5h747.3c4.7,0,8.5,3.8,8.5,8.5v153
-		C764.3,388,760.5,391.8,755.8,391.8z"/>
-	<path class="st1" d="M996.9,261.5h-427c-4.7,0-8.5-3.8-8.5-8.5V81.2c0-4.7,3.8-8.5,8.5-8.5h427c4.7,0,8.5,3.8,8.5,8.5V253
-		C1005.4,257.7,1001.5,261.5,996.9,261.5z"/>
-	<g>
-		<polyline class="st2" points="598.1,238.2 598.1,242.3 787.7,242.3 787.7,238.2 		"/>
-		<g>
-			<line class="st2" x1="689.3" y1="342.2" x2="276.4" y2="343.3"/>
-			<g>
-				<line class="st2" x1="689.4" y1="253.3" x2="689.4" y2="342.1"/>
-				<path class="st3" d="M689.4,249.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2l0,0
-					C686.1,250.7,687.6,249.3,689.4,249.3z"/>
-			</g>
-		</g>
-		<path class="st3" d="M274.2,340.4c1.8,0,3.2,1.4,3.3,3.2s-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2l0,0
-			C270.9,341.8,272.4,340.4,274.2,340.4z"/>
-	</g>
-	<text transform="matrix(1 0 0 1 26.0923 262.5192)" class="st4 st5 st6">struct mg_http_message {</text>
-	<text transform="matrix(1 0 0 1 45.542 286.2874)" class="st4 st5 st6">struct mg_str method; uri, query, proto; </text>
-	<text transform="matrix(1 0 0 1 45.542 306.3874)" class="st4 st5 st6">struct mg_http_header headers[MG_MAX_HTTP_HEADERS];</text>
-	<text transform="matrix(1 0 0 1 45.542 326.4874)" class="st4 st5 st6">struct mg_str body;</text>
-	<text transform="matrix(1 0 0 1 45.542 346.5874)" class="st4 st5 st6">struct mg_str message; </text>
-	<g>
-		<g>
-			<polyline class="st7" points="621.1,89.6 621.1,78.6 215.4,79.7 215.3,269.4 			"/>
-			<path class="st8" d="M624.3,90.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-				C622.8,87.4,624.3,88.8,624.3,90.6z"/>
-		</g>
-		<path class="st8" d="M212.3,269.4c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-			C213.7,272.6,212.3,271.2,212.3,269.4z"/>
-	</g>
-	<g>
-		<polyline class="st9" points="597.2,183.6 593.1,183.6 593.1,127.8 597.2,127.8 		"/>
-		<g>
-			<polyline class="st9" points="582.4,156.2 575.2,156.2 575,302.8 563.4,302.8 			"/>
-			<path class="st10" d="M586.1,156.2c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
-				C584.7,159.4,586.1,158,586.1,156.2z"/>
-			<path class="st10" d="M564.2,303c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2s1.4,3.2,3.2,3.3l0,0
-				C562.7,306.2,564.2,304.7,564.2,303z"/>
-		</g>
-	</g>
-	<text transform="matrix(1 0 0 1 601.1215 118.1291)" class="st4 st5 st6">POST /foo/bar/baz?aa=b&amp;cc=ddd HTTP/1.1</text>
-	<text transform="matrix(1 0 0 1 601.1215 138.2291)" class="st4 st5 st6">Content-Type: application/json</text>
-	<text transform="matrix(1 0 0 1 601.1215 158.3291)" class="st4 st5 st6">Content-Length: 19</text>
-	<text transform="matrix(1 0 0 1 601.1215 178.4291)" class="st4 st5 st6">Host: reqbin.com</text>
-	<g>
-		<g>
-			<g>
-				<polyline class="st11" points="712.3,90.6 712.4,67.6 277.8,67.6 279.7,269.3 				"/>
-				<path class="st12" d="M715.6,90.8c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C714.1,87.6,715.6,89.1,715.6,90.8z"/>
-			</g>
-			<path class="st12" d="M276.5,269.4c0-1.8,1.4-3.2,3.2-3.3s3.2,1.4,3.3,3.2s-1.4,3.2-3.2,3.3l0,0
-				C278,272.6,276.5,271.2,276.5,269.4z"/>
-		</g>
-		<polyline class="st11" points="771.5,104.3 771.5,100.3 652.7,100.3 652.7,104.3 		"/>
-	</g>
-	<g>
-		<g>
-			<g>
-				<polyline class="st13" points="836.3,90.6 836.3,56.6 342.8,56.6 344.7,268.3 				"/>
-				<path class="st14" d="M839.5,90.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C838,87.4,839.5,88.9,839.5,90.6z"/>
-			</g>
-			<path class="st14" d="M341.4,269.3c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-				C342.9,272.5,341.4,271.1,341.4,269.3z"/>
-		</g>
-		<polyline class="st15" points="981.4,104.2 981.4,100.2 902.6,100.2 902.6,104.2 		"/>
-	</g>
-	<text transform="matrix(1 0 0 1 596.891 232.3658)" class="st4 st5 st6">{&quot;success&quot;: &quot;true&quot;}</text>
-	<polyline class="st16" points="643.1,104.4 643.1,100.4 599.3,100.4 599.3,104.4 	"/>
-	<text transform="matrix(1 0 0 1 9.5506 207.5157)" class="st17 st18">Source Code</text>
-	<text transform="matrix(1 0 0 1 797.0799 32.3923)" class="st17 st18">HTTP message</text>
-	<text transform="matrix(1 0 0 1 26.0924 359.209)" class="st4 st5 st6">};</text>
-	<polyline class="st13" points="894.2,104.2 894.2,100.2 774.4,100.2 774.4,104.2 	"/>
-	<g>
-		<g>
-			<polyline class="st15" points="941.3,90.6 941.3,45.6 412.8,45.6 414.7,268.3 			"/>
-			<path class="st19" d="M944.5,90.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-				C943,87.4,944.5,88.9,944.5,90.6z"/>
-		</g>
-		<path class="st19" d="M411.4,269.3c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-			C412.9,272.5,411.4,271.1,411.4,269.3z"/>
-	</g>
-</g>
-</svg>

docs/images/mg_http_next_multipart.svg

@@ -1,109 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 1034 663.54" style="enable-background:new 0 0 1034 663.54;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st1{fill:#45CFFF;}
-	.st2{fill:#576174;}
-	.st3{fill:#FFFFFF;}
-	.st4{font-family:'Courier-Bold';}
-	.st5{font-size:16.7604px;}
-	.st6{font-family:'Arial-BoldMT';}
-	.st7{font-size:24px;}
-	.st8{fill:#67748A;}
-	.st9{fill:#8B9CBA;}
-	.st10{fill:none;stroke:#00CF4F;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st11{fill:#00CF4F;}
-	.st12{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st13{fill:#EA5B0C;}
-	.st14{fill:#414857;}
-</style>
-<g>
-	<g>
-		<polyline class="st0" points="498.5,624.21 498.5,628.21 447.9,628.21 447.9,624.21 		"/>
-		<g>
-			<path class="st0" d="M491.8,844.81"/>
-			<g>
-				<path class="st1" d="M473.8,636.11c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-					C477.1,637.61,475.6,636.11,473.8,636.11z"/>
-			</g>
-		</g>
-		<path class="st1" d="M296.7,852.71c-1.8,0-3.2,1.3-3.3,3c0,1.7,1.4,3,3.2,3c1.8,0,3.2-1.3,3.3-3l0,0
-			C299.9,854.01,298.5,852.71,296.7,852.71z"/>
-	</g>
-	<g>
-		<path class="st2" d="M584.6,199.01H8.5c-4.7,0-8.5-3.8-8.5-8.5V60.71c0-4.7,3.8-8.5,8.5-8.5h576.1c4.7,0,8.5,3.8,8.5,8.5v129.8
-			C593.1,195.21,589.3,199.01,584.6,199.01z"/>
-		<g>
-			<g>
-				<g>
-					<text transform="matrix(1 0 0 1 28.7 90.8107)" class="st3 st4 st5">struct mg_http_part part;</text>
-					<text transform="matrix(1 0 0 1 28.7 110.9108)" class="st3 st4 st5">size_t pos = 0;</text>
-					<text transform="matrix(1 0 0 1 28.7 151.1107)" class="st3 st4 st5">pos = mg_http_next_multipart(&amp;hm-&gt;body, pos, &amp;part);</text>
-					<text transform="matrix(1 0 0 1 28.7 171.3107)" class="st3 st4 st5">pos = mg_http_next_multipart(&amp;hm-&gt;body, pos, &amp;part);</text>
-				</g>
-			</g>
-		</g>
-		<text transform="matrix(1 0 0 1 1.3738 40.559)" class="st6 st7">Source Code</text>
-	</g>
-	<g>
-		<g>
-			<path class="st8" d="M685.5,646.41H8.5c-4.7,0-8.5-3.8-8.5-8.5v-362.9c0-4.7,3.8-8.5,8.5-8.5h677c4.7,0,8.5,3.8,8.5,8.5v362.9
-				C694,642.61,690.2,646.41,685.5,646.41z"/>
-		</g>
-		<path class="st9" d="M640.2,629.41H26.3c-4.7,0-8.5-3.8-8.5-8.5v-106.5c0-4.7,3.8-8.5,8.5-8.5h613.9c4.7,0,8.5,3.8,8.5,8.5v106.5
-			C648.7,625.61,644.8,629.41,640.2,629.41z"/>
-		<path class="st9" d="M644,490.91H30.1c-4.7,0-8.5-3.8-8.5-8.5v-106.5c0-4.7,3.8-8.5,8.5-8.5H644c4.7,0,8.5,3.8,8.5,8.5v106.5
-			C652.5,487.11,648.7,490.91,644,490.91z"/>
-		<g>
-			<text transform="matrix(1 0 0 1 0.0299 253.0343)" class="st6 st7">HTTP message</text>
-		</g>
-		<g>
-			<text transform="matrix(1 0 0 1 28.7 302.8107)" class="st3 st4 st5">POST /upload HTTP/1.1 </text>
-			<text transform="matrix(1 0 0 1 28.7 322.9107)" class="st3 st4 st5">Content-Type: multipart/form-data; boundary=&quot;--xyz&quot;</text>
-			<text transform="matrix(1 0 0 1 28.7 363.1107)" class="st3 st4 st5">--xyz</text>
-			<text transform="matrix(1 0 0 1 28.7 383.3107)" class="st3 st4 st5">Content-Disposition: form-data; name=&quot;foo&quot;; filename=&quot;a.txt&quot;</text>
-			<text transform="matrix(1 0 0 1 28.7 403.4107)" class="st3 st4 st5">Content-Type: text/plain</text>
-			<text transform="matrix(1 0 0 1 28.7 443.6107)" class="st3 st4 st5">hello world</text>
-			<text transform="matrix(1 0 0 1 28.7 483.8107)" class="st3 st4 st5">--xyz---</text>
-			<text transform="matrix(1 0 0 1 28.7 524.0107)" class="st3 st4 st5">Content-Disposition: form-data; name=&quot;bar&quot;; filename=&quot;b.txt&quot;</text>
-			<text transform="matrix(1 0 0 1 28.7 544.2108)" class="st3 st4 st5">Content-Type: text/plain</text>
-			<text transform="matrix(1 0 0 1 28.7 584.4108)" class="st3 st4 st5">hello world again</text>
-			<text transform="matrix(1 0 0 1 28.7 624.6107)" class="st3 st4 st5">--xyz--</text>
-		</g>
-	</g>
-	<g>
-		<g>
-			<polyline class="st10" points="569.5,162.51 574.5,162.51 574.5,176.11 569.5,176.11 			"/>
-			<g>
-				<path class="st0" d="M726.8,392.91"/>
-				<g>
-					<polyline class="st10" points="587.3,169.71 726.7,169.71 726.6,569.31 684.3,569.31 					"/>
-					<path class="st11" d="M585,166.41c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-						C588.2,167.91,586.8,166.41,585,166.41z"/>
-				</g>
-			</g>
-			<path class="st11" d="M685,566.31c-1.7,0-3,1.3-3,3s1.3,3,3,3s3-1.3,3-3l0,0C688,567.61,686.6,566.31,685,566.31z"/>
-		</g>
-		<polyline class="st10" points="657.9,501.61 673.9,501.61 673.9,634.21 657.9,634.21 		"/>
-	</g>
-	<g>
-		<g>
-			<polyline class="st12" points="569.5,143.21 574.5,143.21 574.5,156.81 569.5,156.81 			"/>
-			<g>
-				<path class="st0" d="M726.8,254.61"/>
-				<g>
-					<polyline class="st12" points="587.3,150.41 710.7,150.41 710.6,431.01 684.3,431.01 					"/>
-					<path class="st13" d="M585,147.11c-1.8,0-3.2,1.4-3.3,3.2s1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-						C588.2,148.61,586.8,147.11,585,147.11z"/>
-				</g>
-			</g>
-			<path class="st13" d="M685,428.01c-1.7,0-3,1.3-3,3s1.3,3,3,3s3-1.3,3-3l0,0C688,429.31,686.6,428.01,685,428.01z"/>
-		</g>
-		<polyline class="st12" points="657.9,363.31 673.9,363.31 673.9,495.91 657.9,495.91 		"/>
-	</g>
-	<text transform="matrix(1 0 0 1 537.9671 462.1467)" class="st14 st6 st7">Part 1</text>
-	<text transform="matrix(1 0 0 1 537.9671 600.4373)" class="st14 st6 st7">Part 2</text>
-</g>
-</svg>

docs/images/mg_http_part.svg

@@ -1,94 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 1034 480.6" style="enable-background:new 0 0 1034 480.6;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#67748A;}
-	.st1{fill:#8B9CBA;}
-	.st2{fill:#FFFFFF;}
-	.st3{font-family:'Courier-Bold';}
-	.st4{font-size:16.7604px;}
-	.st5{fill:#414857;}
-	.st6{font-family:'Arial-BoldMT';}
-	.st7{font-size:30px;}
-	.st8{font-size:24px;}
-	.st9{fill:#576174;}
-	.st10{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st11{fill:#45CFFF;}
-	.st12{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st13{fill:#EA5B0C;}
-	.st14{fill:none;stroke:#EA5B0C;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st15{fill:none;stroke:#FFDE00;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st16{fill:#FFDE00;}
-</style>
-<g>
-	<g>
-		<path class="st0" d="M908.4,454.9H272c-4.7,0-8.5-3.8-8.5-8.5V216c0-4.7,3.8-8.5,8.5-8.5h636.4c4.7,0,8.5,3.8,8.5,8.5v230.4
-			C916.9,451.1,913.1,454.9,908.4,454.9z"/>
-		<g>
-			<path class="st1" d="M898.6,430.8H284.7c-4.7,0-8.5-3.8-8.5-8.5V315.9c0-4.7,3.8-8.5,8.5-8.5h613.9c4.7,0,8.5,3.8,8.5,8.5v106.5
-				C907.1,427,903.3,430.8,898.6,430.8z"/>
-			<text transform="matrix(1 0 0 1 295.3688 243.086)" class="st2 st3 st4">POST /upload HTTP/1.1 </text>
-			<text transform="matrix(1 0 0 1 295.3688 263.186)" class="st2 st3 st4">Content-Type: multipart/form-data: boundary=&quot;--xyz&quot;</text>
-			<text transform="matrix(1 0 0 1 295.3688 303.386)" class="st2 st3 st4">--xyz</text>
-			<text transform="matrix(1 0 0 1 295.3688 323.586)" class="st2 st3 st4">Content-Disposition: form-data; name=&quot;foo&quot;; filename=&quot;a.txt&quot;</text>
-			<text transform="matrix(1 0 0 1 295.3688 343.686)" class="st2 st3 st4">Content-Type: text/plain</text>
-			<text transform="matrix(1 0 0 1 295.3688 383.886)" class="st2 st3 st4">hello world</text>
-			<text transform="matrix(1 0 0 1 295.3688 424.086)" class="st2 st3 st4">--xyz---</text>
-		</g>
-	</g>
-	<text transform="matrix(1 0 0 1 739.2766 414.2906)" class="st5 st6 st7">HTTP part</text>
-	<text transform="matrix(1 0 0 1 739.2764 193.4305)" class="st6 st8">HTTP message</text>
-	<path class="st9" d="M304.9,198H8.5c-4.7,0-8.5-3.8-8.5-8.5V64.8c0-4.7,3.8-8.5,8.5-8.5H305c4.7,0,8.5,3.8,8.5,8.5v124.7
-		C313.4,194.2,309.6,198,304.9,198z"/>
-	<g>
-		<g>
-			<text transform="matrix(1 0 0 1 25.2409 91.1617)" class="st2 st3 st4">struct mg_http_part {</text>
-			<text transform="matrix(1 0 0 1 47.0734 113.7079)" class="st2 st3 st4">struct mg_str name;</text>
-			<text transform="matrix(1 0 0 1 47.0734 133.8079)" class="st2 st3 st4">strucy mg_str filename;</text>
-			<text transform="matrix(1 0 0 1 47.0734 153.9079)" class="st2 st3 st4">struct mg_str body;</text>
-		</g>
-	</g>
-	<g>
-		<polyline class="st10" points="237.4,159 237.4,163 185.8,163 185.8,159 		"/>
-		<g>
-			<polyline class="st10" points="211.7,348.3 349.5,348.4 349.5,355.6 			"/>
-			<g>
-				<line class="st10" x1="211.6" y1="174.4" x2="211.6" y2="348.1"/>
-				<path class="st11" d="M211.6,170.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-					C214.8,171.8,213.4,170.3,211.6,170.3z"/>
-			</g>
-		</g>
-		<path class="st11" d="M349.6,353.6c-1.8,0-3.2,1.4-3.3,3.2s1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-			C352.8,355.1,351.4,353.6,349.6,353.6z"/>
-		<polyline class="st10" points="237.4,159 237.4,163 185.8,163 185.8,159 		"/>
-		<polyline class="st10" points="407.3,371.1 407.3,367.1 293.3,367.1 293.3,371.1 		"/>
-	</g>
-	<g>
-		<g>
-			<g>
-				<polyline class="st12" points="693.7,291.6 693.7,277.7 280.7,278.8 280.5,109.4 248.3,109.4 				"/>
-				<path class="st13" d="M696.9,293.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C695.4,290.4,696.9,291.9,696.9,293.6z"/>
-			</g>
-			<path class="st13" d="M243.9,109.5c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-				C245.3,112.7,243.9,111.3,243.9,109.5z"/>
-		</g>
-		<polyline class="st14" points="707.6,309.2 707.6,305.2 679.9,305.2 679.9,309.2 		"/>
-	</g>
-	<text transform="matrix(1 0 0 1 0.8627 37.8099)" class="st6 st8">Source Code</text>
-	<text transform="matrix(1 0 0 1 25.2408 177.7241)" class="st2 st3 st4">};</text>
-	<g>
-		<g>
-			<g>
-				<polyline class="st15" points="863.8,291.5 863.7,218.6 329.7,218.7 329.6,130.3 298.4,130.3 				"/>
-				<path class="st16" d="M867.1,293.6c0,1.8-1.4,3.2-3.2,3.3c-1.8,0-3.2-1.4-3.3-3.2c0-1.8,1.4-3.2,3.2-3.3l0,0
-					C865.6,290.3,867.1,291.8,867.1,293.6z"/>
-			</g>
-			<path class="st16" d="M293,130.1c0-1.8,1.4-3.2,3.2-3.3c1.8,0,3.2,1.4,3.3,3.2c0,1.8-1.4,3.2-3.2,3.3l0,0
-				C294.4,133.3,293,131.9,293,130.1z"/>
-		</g>
-		<polyline class="st15" points="888.7,309.1 888.7,305.1 838.9,305.1 838.9,309.1 		"/>
-	</g>
-</g>
-</svg>

docs/images/mg_http_reply.svg

@@ -1,84 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 1034 331.2" style="enable-background:new 0 0 1034 331.2;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#576174;}
-	.st1{fill:#67748A;}
-	.st2{fill:#FFFFFF;}
-	.st3{font-family:'Courier-Bold';}
-	.st4{font-size:16.7604px;}
-	.st5{font-family:'Arial-BoldMT';}
-	.st6{font-size:24px;}
-	.st7{fill:none;stroke:#45CFFF;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st8{fill:#45CFFF;}
-	.st9{fill:none;stroke:#EA5B0C;stroke-width:2.793;stroke-linecap:round;stroke-linejoin:round;}
-	.st10{fill:#EA5B0C;}
-	.st11{fill:none;stroke:#EA5B0C;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st12{fill:none;stroke:#00CF4F;stroke-width:2.7934;stroke-linecap:round;stroke-linejoin:round;}
-	.st13{fill:#00CF4F;}
-</style>
-<g>
-	<path class="st0" d="M541.43,184.2H8.53c-4.7,0-8.5-3.8-8.5-8.5V54.8c0-4.7,3.8-8.5,8.5-8.5h532.9c4.7,0,8.5,3.8,8.5,8.5v120.9
-		C549.93,180.4,546.13,184.2,541.43,184.2z"/>
-	<g>
-		<path class="st1" d="M829.23,315.5h-370c-4.7,0-8.5-3.8-8.5-8.5V157c0-4.7,3.8-8.5,8.5-8.5h370c4.7,0,8.5,3.8,8.5,8.5v150
-			C837.83,311.7,833.93,315.5,829.23,315.5z"/>
-		<g>
-			<text transform="matrix(1 0 0 1 490.6096 184.0905)" class="st2 st3 st4">HTTP/1.1 200 OK</text>
-			<text transform="matrix(1 0 0 1 490.6096 204.1905)" class="st2 st3 st4">Content-Length; 13</text>
-			<text transform="matrix(1 0 0 1 490.6096 224.2905)" class="st2 st3 st4">X-Header-1: additional value 1</text>
-			<text transform="matrix(1 0 0 1 490.6096 244.3905)" class="st2 st3 st4">X-Header-2: additional value 2</text>
-			<text transform="matrix(1 0 0 1 490.8657 293.1559)" class="st2 st3 st4">Hello, world!</text>
-		</g>
-	</g>
-	<text transform="matrix(1 0 0 1 660.5036 137.3383)" class="st5 st6">HTTP message</text>
-	<g>
-		<g>
-			<text transform="matrix(1 0 0 1 20.7331 85.1617)" class="st2 st3 st4">mg_http_reply(c, 200</text>
-			<text transform="matrix(1 0 0 1 159.5657 113.7079)" class="st2 st3 st4">&quot;X-Header-1: additional value 1\r\n&quot;</text>
-			<text transform="matrix(1 0 0 1 159.5657 133.8079)" class="st2 st3 st4">&quot;X-Header-2: additional value 2\r\n&quot;,</text>
-			<text transform="matrix(1 0 0 1 159.5657 153.9079)" class="st2 st3 st4">&quot;Hello, %s!&quot;, &quot;world&quot;);</text>
-		</g>
-	</g>
-	<g>
-		<polyline class="st7" points="362.93,159 362.93,163 167.33,163 167.33,159 		"/>
-		<g>
-			<polyline class="st7" points="265.93,256.6 552.13,256.7 552.13,264.4 			"/>
-			<g>
-				<line class="st7" x1="265.83" y1="174.4" x2="265.83" y2="256.6"/>
-				<path class="st8" d="M265.83,170.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-					C269.03,171.8,267.53,170.3,265.83,170.3z"/>
-			</g>
-		</g>
-		<path class="st8" d="M552.23,261.6c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2l0,0
-			C555.43,263.1,554.03,261.6,552.23,261.6z"/>
-	</g>
-	<g>
-		<g>
-			<g>
-				<polyline class="st9" points="206.33,53.6 206.43,37.6 596.43,38.7 596.53,161.3 				"/>
-				<path class="st10" d="M203.23,54.6c0,1.8,1.4,3.2,3.2,3.3c1.8,0,3.2-1.4,3.3-3.2c0-1.8-1.4-3.2-3.2-3.3l0,0
-					C204.63,51.4,203.23,52.8,203.23,54.6z"/>
-			</g>
-			<path class="st10" d="M599.83,164c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
-				C598.33,167.2,599.83,165.8,599.83,164z"/>
-		</g>
-		<polyline class="st11" points="192.43,69.2 192.43,65.2 220.23,65.2 220.23,69.2 		"/>
-	</g>
-	<text transform="matrix(1 0 0 1 -1.917133e-04 35.0037)" class="st5 st6">Source Code</text>
-	<g>
-		<polyline class="st12" points="160.13,135.9 156.03,135.9 156.03,100.1 160.13,100.1 		"/>
-		<g>
-			<line class="st12" x1="123.93" y1="231" x2="469.73" y2="231"/>
-			<polyline class="st12" points="144.73,117.2 123.83,117.2 123.73,230.8 			"/>
-			<path class="st13" d="M147.83,117.2c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
-				C146.33,120.4,147.83,119,147.83,117.2z"/>
-			<path class="st13" d="M474.83,230.8c0-1.8-1.4-3.2-3.2-3.3c-1.8,0-3.2,1.4-3.3,3.2c0,1.8,1.4,3.2,3.2,3.3l0,0
-				C473.43,234,474.83,232.5,474.83,230.8z"/>
-		</g>
-	</g>
-	<polyline class="st7" points="489.03,279.6 489.03,275.6 620.63,275.6 620.63,279.6 	"/>
-	<polyline class="st12" points="487.63,248.3 483.63,248.3 483.63,211.5 487.63,211.5 	"/>
-</g>
-</svg>

docs/images/mg_iobuf.svg

@@ -1,124 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 869.6 185.67" style="enable-background:new 0 0 869.6 185.67;" xml:space="preserve">
-<style type="text/css">
-	.st0{font-family:'Arial-BoldMT';}
-	.st1{font-size:24px;}
-	.st2{opacity:0.2;fill:#00983A;enable-background:new    ;}
-	.st3{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st4{fill:#00983A;}
-	.st5{fill:none;stroke:#576174;stroke-miterlimit:10;}
-	.st6{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st7{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st8{font-family:'Courier-Bold';}
-	.st9{font-size:16.7604px;}
-	.st10{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
-	.st11{fill:#576174;}
-	.st12{font-family:'Courier';}
-	.st13{fill:none;}
-	.st14{fill:#7A8387;}
-</style>
-<g>
-	<text transform="matrix(1 0 0 1 1.0956 32.4549)" class="st0 st1">Memory</text>
-	<polyline class="st2" points="424.58,115.4 219.88,115.4 219.88,90.7 424.58,90.7 	"/>
-	<g>
-		<g>
-			<g>
-				<polyline class="st3" points="458.98,115.4 218.98,115.4 218.98,90.7 458.98,90.7 				"/>
-				<polyline class="st4" points="219.18,115.1 2.98,115.1 2.98,91.3 219.18,91.3 				"/>
-				<line class="st3" x1="2.98" y1="69.2" x2="2.98" y2="130.4"/>
-				<line class="st5" x1="219.78" y1="69.2" x2="219.78" y2="130.4"/>
-				<line class="st5" x1="425.28" y1="69.2" x2="425.28" y2="130.4"/>
-				<path class="st6" d="M458.98,115.4"/>
-				<path class="st7" d="M33.98,114.6"/>
-				<path class="st7" d="M33.98,90.9"/>
-				<path class="st7" d="M2.98,90.7h216.8v24.9l-216.8-0.2C2.98,115.4,3.18,90.7,2.98,90.7z"/>
-				<line class="st3" x1="425.18" y1="90.8" x2="425.18" y2="115.3"/>
-				<path class="st6" d="M251.98,115.6"/>
-				<path class="st6" d="M251.98,91.9"/>
-			</g>
-			<g>
-				<text transform="matrix(1 0 0 1 -2.290726e-04 175.3858)" class="st4 st8 st9">buf</text>
-			</g>
-			<g>
-				<g>
-					<line class="st10" x1="2.68" y1="158.2" x2="2.68" y2="137.2"/>
-					<g>
-						<polygon class="st4" points="0.28,137.6 5.08,137.6 2.68,135.1 						"/>
-					</g>
-				</g>
-			</g>
-			<g>
-				<g>
-					<text transform="matrix(1 0 0 1 214.6515 175.3858)" class="st4 st8 st9">len</text>
-				</g>
-			</g>
-			<g>
-				<g>
-					<line class="st10" x1="219.78" y1="158.2" x2="219.78" y2="137.2"/>
-					<g>
-						<polygon class="st4" points="217.38,137.6 222.18,137.6 219.78,135.1 						"/>
-					</g>
-				</g>
-			</g>
-			<g>
-				<g>
-					<text transform="matrix(1 0 0 1 421.6186 175.3858)" class="st4 st8 st9">size</text>
-				</g>
-			</g>
-			<g>
-				<g>
-					<line class="st10" x1="425.38" y1="158.2" x2="425.38" y2="137.2"/>
-					<g>
-						<polygon class="st4" points="422.98,137.6 427.78,137.6 425.38,135.1 						"/>
-					</g>
-				</g>
-			</g>
-			<g>
-				<g>
-					<text transform="matrix(1 0 0 1 93.1143 69.4458)" class="st11 st12 st9">data</text>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 273.8231 69.4458)" class="st11 st12 st9">free space</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<line class="st5" x1="132.98" y1="76.3" x2="13.98" y2="76.3"/>
-						<g>
-							<polygon class="st11" points="14.28,78.7 14.28,73.8 11.88,76.3 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<line class="st13" x1="123.88" y1="76.3" x2="210.88" y2="76.3"/>
-					<g>
-						<line class="st5" x1="123.88" y1="76.3" x2="208.78" y2="76.3"/>
-						<g>
-							<polygon class="st11" points="208.48,73.8 208.48,78.7 210.88,76.3 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<line class="st5" x1="320.38" y1="76.3" x2="414.28" y2="76.3"/>
-						<g>
-							<polygon class="st14" points="413.98,73.8 413.98,78.7 416.38,76.3 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<line class="st5" x1="322.28" y1="76.3" x2="233.28" y2="76.3"/>
-						<g>
-							<polygon class="st14" points="233.68,78.7 233.68,73.8 231.18,76.3 							"/>
-						</g>
-					</g>
-				</g>
-			</g>
-		</g>
-	</g>
-</g>
-</svg>

docs/images/mg_iobuf_add1.svg

@@ -1,52 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 869 124.66" style="enable-background:new 0 0 869 124.66;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st1{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st2{fill:#00983A;}
-	.st3{font-family:'Courier-Bold';}
-	.st4{font-size:16.7604px;}
-	.st5{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
-	.st6{fill:#7A8387;}
-</style>
-<g>
-	<g>
-		<g>
-			<polyline class="st0" points="830.92,78.4 5.52,78.4 5.52,53.7 830.92,53.6 			"/>
-			<line class="st1" x1="5.52" y1="32.2" x2="5.52" y2="93.4"/>
-			<path class="st0" d="M830.92,78.4"/>
-			<line class="st1" x1="36.52" y1="53.9" x2="36.52" y2="77.6"/>
-			<line class="st1" x1="68.92" y1="53.9" x2="68.92" y2="77.6"/>
-			<line class="st1" x1="101.42" y1="53.9" x2="101.42" y2="77.6"/>
-			<line class="st1" x1="133.72" y1="53.9" x2="133.72" y2="77.6"/>
-			<line class="st1" x1="166.22" y1="53.9" x2="166.22" y2="77.6"/>
-			<line class="st1" x1="198.52" y1="54.6" x2="198.52" y2="78.3"/>
-			<line class="st1" x1="230.92" y1="54.6" x2="230.92" y2="78.3"/>
-		</g>
-		<g>
-			<text transform="matrix(1 0 0 1 59.1908 40.8585)" class="st2 st3 st4">buf=NULL, len=0, size=0 </text>
-		</g>
-		<g>
-			<text transform="matrix(1 0 0 1 -1.811981e-04 109.9024)" class="st2 st3 st4">0</text>
-		</g>
-		<g>
-			<g>
-				<g>
-					<line class="st5" x1="46.72" y1="37.7" x2="17.72" y2="37.7"/>
-					<g>
-						<polygon class="st2" points="18.12,40.1 18.12,35.2 15.62,37.7 						"/>
-					</g>
-				</g>
-			</g>
-		</g>
-		<g>
-			<path class="st6" d="M511.52,66.4c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S511.52,65.5,511.52,66.4z"/>
-			<path class="st6" d="M525.32,66.4c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S525.32,65.5,525.32,66.4z"/>
-			<path class="st6" d="M539.02,66.4c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S539.02,65.5,539.02,66.4z"/>
-			<path class="st6" d="M552.82,66.4c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6s0.7-1.6,1.6-1.6S552.82,65.5,552.82,66.4z"/>
-		</g>
-	</g>
-</g>
-</svg>

docs/images/mg_iobuf_add2.svg

@@ -1,185 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 869.6 127.5" style="enable-background:new 0 0 869.6 127.5;" xml:space="preserve">
-<style type="text/css">
-	.st0{opacity:0.2;fill:#00983A;enable-background:new    ;}
-	.st1{fill:#F2F3F3;}
-	.st2{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st3{fill:#00983A;}
-	.st4{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st5{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st6{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:square;stroke-linejoin:round;}
-	.st7{font-family:'Courier-Bold';}
-	.st8{font-size:16.7604px;}
-	.st9{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
-	.st10{fill:#7A8387;}
-	.st11{fill:#576174;}
-	.st12{fill:none;stroke:#576174;stroke-linecap:round;stroke-linejoin:round;}
-	.st13{fill:none;stroke:#7A8387;stroke-linecap:round;stroke-linejoin:round;}
-	.st14{fill:#333A45;}
-</style>
-<g>
-	<g>
-		<polyline class="st0" points="577.2,72.8 282.4,72.8 282.4,48 577.2,48 		"/>
-		<g>
-			<g>
-				<g>
-					<polyline class="st1" points="122.6,72.8 5.9,72.8 5.9,48 122.6,48 					"/>
-					<polyline class="st2" points="831.51,72.8 5.5,72.8 5.5,48 831.51,48 					"/>
-					<polyline class="st3" points="282.7,72.5 122.5,72.5 122.5,47.7 282.7,47.7 					"/>
-					<line class="st2" x1="122.5" y1="26.6" x2="122.5" y2="87.8"/>
-					<line class="st2" x1="283.3" y1="26.6" x2="283.3" y2="87.8"/>
-					<line class="st2" x1="576.8" y1="26.6" x2="576.8" y2="87.8"/>
-					<path class="st4" d="M831.51,72.8"/>
-					<line class="st5" x1="153.5" y1="48.3" x2="153.5" y2="72"/>
-					<line class="st2" x1="36.5" y1="48.3" x2="36.5" y2="72"/>
-					<line class="st2" x1="67.6" y1="48.3" x2="67.6" y2="72"/>
-					<line class="st5" x1="186" y1="48.3" x2="186" y2="72"/>
-					<line class="st5" x1="218.4" y1="48.3" x2="218.4" y2="72"/>
-					<line class="st5" x1="250.9" y1="48.3" x2="250.9" y2="72"/>
-					<line class="st2" x1="315.9" y1="48.3" x2="315.9" y2="72"/>
-					<line class="st2" x1="348.4" y1="48.3" x2="348.4" y2="72"/>
-					<line class="st2" x1="381.2" y1="48.3" x2="381.2" y2="72"/>
-					<line class="st2" x1="413.8" y1="48.3" x2="413.8" y2="72"/>
-					<line class="st2" x1="446.3" y1="48.3" x2="446.3" y2="72"/>
-					<line class="st2" x1="478.9" y1="48.3" x2="478.9" y2="72"/>
-					<line class="st5" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
-					<line class="st2" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
-					<line class="st5" x1="544.01" y1="48.3" x2="544.01" y2="72"/>
-					<line class="st2" x1="544.1" y1="48.3" x2="544.1" y2="72"/>
-					<line class="st6" x1="283.3" y1="73" x2="122.5" y2="72.8"/>
-					<line class="st6" x1="122.5" y1="48" x2="283.3" y2="48.1"/>
-					<path class="st4" d="M385.5,73"/>
-					<path class="st4" d="M385.5,49.3"/>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 127.5176 105.8013)" class="st3 st7 st8">buf</text>
-				</g>
-				<g>
-					<g>
-						<line class="st9" x1="122.2" y1="105.6" x2="122.2" y2="94.6"/>
-						<g>
-							<polygon class="st3" points="119.8,94.9 124.6,94.9 122.2,92.5 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 286.6495 105.8008)" class="st3 st7 st8">len=5</text>
-				</g>
-				<g>
-					<g>
-						<line class="st9" x1="283.3" y1="105.6" x2="283.3" y2="94.6"/>
-						<g>
-							<polygon class="st3" points="280.9,94.9 285.8,94.9 283.3,92.5 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 581.4624 105.8013)" class="st3 st7 st8">size=16</text>
-				</g>
-				<g>
-					<g>
-						<line class="st9" x1="576.9" y1="105.6" x2="576.9" y2="94.6"/>
-						<g>
-							<polygon class="st3" points="574.51,94.9 579.4,94.9 576.9,92.5 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<path class="st10" d="M687.51,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S687.51,59.9,687.51,60.7z"/>
-					<path class="st10" d="M701.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S701.2,59.9,701.2,60.7z"/>
-					<path class="st10" d="M714.9,60.7c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						C714.2,59.1,714.9,59.9,714.9,60.7z"/>
-					<path class="st10" d="M728.7,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						C728.01,59.1,728.7,59.9,728.7,60.7z"/>
-				</g>
-				<g>
-					<path class="st10" d="M82.8,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S82.8,59.9,82.8,60.7z"/>
-					<path class="st10" d="M96.5,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6C95.8,59.1,96.5,59.9,96.5,60.7
-						z"/>
-					<path class="st10" d="M110.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S110.2,59.9,110.2,60.7z"/>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 180.6541 26.8123)" class="st11 st7 st8">data</text>
-					</g>
-					<g>
-						<text transform="matrix(1 0 0 1 387.363 26.8123)" class="st10 st7 st8">free space</text>
-					</g>
-					<g>
-						<g>
-							<line class="st12" x1="272.2" y1="33.6" x2="133.5" y2="33.6"/>
-							<g>
-								<polygon class="st11" points="271.9,36.2 273.5,33.6 271.9,31.1 271.8,31.1 271.8,36.2 								"/>
-							</g>
-							<g>
-								<polygon class="st11" points="133.8,36.1 133.8,31.2 131.4,33.6 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<g>
-							<line class="st13" x1="563.7" y1="33.6" x2="295.9" y2="33.6"/>
-							<g>
-								<polygon class="st10" points="563.4,36.1 563.4,31.2 565.8,33.6 								"/>
-							</g>
-							<g>
-								<polygon class="st10" points="296.2,36.1 296.2,31.2 293.7,33.6 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<text transform="matrix(1 0 0 1 615.4679 25.1898)" class="st10 st7 st8">non-allocated space</text>
-					</g>
-					<g>
-						<g>
-							<line class="st13" x1="593.7" y1="33.6" x2="829.7" y2="33.6"/>
-							<g>
-								<polygon class="st10" points="829.4,31.2 829.4,36.1 831.8,33.6 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<g>
-							<line class="st13" x1="678.7" y1="33.6" x2="589.7" y2="33.6"/>
-							<g>
-								<polygon class="st10" points="590.01,36.1 590.01,31.2 587.6,33.6 								"/>
-							</g>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 133.1212 64.9593)" class="st14 st7 st8">h</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 165.1564 64.9593)" class="st14 st7 st8">e</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 196.8744 64.9593)" class="st14 st7 st8">l</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 229.8611 64.9593)" class="st14 st7 st8">l</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 262.2135 64.9593)" class="st14 st7 st8">o</text>
-					</g>
-				</g>
-			</g>
-		</g>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 1.811981e-04 105.8011)" class="st3 st7 st8">0</text>
-	</g>
-	<line class="st2" x1="5.5" y1="26.4" x2="5.5" y2="87.6"/>
-</g>
-</svg>

docs/images/mg_iobuf_del.svg

@@ -1,347 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 26.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 869.6 247.73" style="enable-background:new 0 0 869.6 247.73;" xml:space="preserve">
-<style type="text/css">
-	.st0{opacity:0.2;fill:#00983A;enable-background:new    ;}
-	.st1{fill:#00983A;}
-	.st2{fill:#FF80A4;}
-	.st3{fill:#F2F3F3;}
-	.st4{fill:none;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st5{fill:#F2F3F3;stroke:#7A8387;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st6{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:round;stroke-linejoin:round;}
-	.st7{fill:none;stroke:#576174;stroke-width:1.2;stroke-linejoin:round;}
-	.st8{fill:none;stroke:#576174;stroke-width:1.2;stroke-linecap:square;stroke-linejoin:round;}
-	.st9{font-family:'Courier-Bold';}
-	.st10{font-size:16.7604px;}
-	.st11{fill:none;stroke:#00983A;stroke-linecap:round;stroke-linejoin:round;}
-	.st12{fill:#7A8387;}
-	.st13{fill:#576174;}
-	.st14{fill:none;stroke:#576174;stroke-linecap:round;stroke-linejoin:round;}
-	.st15{fill:none;stroke:#7A8387;stroke-linecap:round;stroke-linejoin:round;}
-	.st16{fill:#333A45;}
-</style>
-<g>
-	<g>
-		<polyline class="st0" points="577.2,72.8 282.4,72.8 282.4,48 577.2,48 		"/>
-		<g>
-			<g>
-				<g>
-					<rect x="250.9" y="47.7" class="st1" width="32.4" height="24.8"/>
-					<rect x="153.5" y="47.7" class="st2" width="97.3" height="24.8"/>
-					<polyline class="st3" points="122.6,72.8 5.9,72.8 5.9,48 122.6,48 					"/>
-					<polyline class="st4" points="831.51,72.8 5.5,72.8 5.5,48 831.51,48 					"/>
-					<rect x="122.5" y="47.7" class="st1" width="31" height="24.8"/>
-					<line class="st4" x1="122.5" y1="26.6" x2="122.5" y2="87.8"/>
-					<line class="st4" x1="576.8" y1="26.6" x2="576.8" y2="87.8"/>
-					<path class="st5" d="M831.51,72.8"/>
-					<line class="st6" x1="153.5" y1="48.3" x2="153.5" y2="72"/>
-					<line class="st4" x1="36.5" y1="48.3" x2="36.5" y2="72"/>
-					<line class="st4" x1="67.6" y1="48.3" x2="67.6" y2="72"/>
-					<line class="st6" x1="186" y1="48.3" x2="186" y2="72"/>
-					<line class="st6" x1="218.4" y1="48.3" x2="218.4" y2="72"/>
-					<line class="st7" x1="250.9" y1="73" x2="250.81" y2="47.7"/>
-					<line class="st4" x1="315.9" y1="48.3" x2="315.9" y2="72"/>
-					<line class="st4" x1="348.4" y1="48.3" x2="348.4" y2="72"/>
-					<line class="st4" x1="381.2" y1="48.3" x2="381.2" y2="72"/>
-					<line class="st4" x1="413.8" y1="48.3" x2="413.8" y2="72"/>
-					<line class="st4" x1="446.3" y1="48.3" x2="446.3" y2="72"/>
-					<line class="st4" x1="478.9" y1="48.3" x2="478.9" y2="72"/>
-					<line class="st6" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
-					<line class="st4" x1="511.51" y1="48.3" x2="511.51" y2="72"/>
-					<line class="st6" x1="544.01" y1="48.3" x2="544.01" y2="72"/>
-					<line class="st4" x1="544.1" y1="48.3" x2="544.1" y2="72"/>
-					<line class="st8" x1="283.3" y1="73" x2="122.5" y2="72.8"/>
-					<line class="st8" x1="122.5" y1="48" x2="283.3" y2="48.1"/>
-					<path class="st5" d="M385.5,73"/>
-					<path class="st5" d="M385.5,49.3"/>
-					<line class="st4" x1="283.3" y1="26.6" x2="283.3" y2="87.8"/>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 127.5176 105.8013)" class="st1 st9 st10">buf</text>
-				</g>
-				<g>
-					<g>
-						<line class="st11" x1="122.2" y1="105.6" x2="122.2" y2="94.6"/>
-						<g>
-							<polygon class="st1" points="119.8,94.9 124.6,94.9 122.2,92.5 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 286.6495 105.8008)" class="st1 st9 st10">len=5</text>
-				</g>
-				<g>
-					<g>
-						<line class="st11" x1="283.3" y1="105.6" x2="283.3" y2="94.6"/>
-						<g>
-							<polygon class="st1" points="280.9,94.9 285.8,94.9 283.3,92.5 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 581.4624 105.8013)" class="st1 st9 st10">size=16</text>
-				</g>
-				<g>
-					<g>
-						<line class="st11" x1="576.9" y1="105.6" x2="576.9" y2="94.6"/>
-						<g>
-							<polygon class="st1" points="574.51,94.9 579.4,94.9 576.9,92.5 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<path class="st12" d="M687.51,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S687.51,59.9,687.51,60.7z"/>
-					<path class="st12" d="M701.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S701.2,59.9,701.2,60.7z"/>
-					<path class="st12" d="M714.9,60.7c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						C714.2,59.1,714.9,59.9,714.9,60.7z"/>
-					<path class="st12" d="M728.7,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						C728.01,59.1,728.7,59.9,728.7,60.7z"/>
-				</g>
-				<g>
-					<path class="st12" d="M82.8,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S82.8,59.9,82.8,60.7z"/>
-					<path class="st12" d="M96.5,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6C95.8,59.1,96.5,59.9,96.5,60.7
-						z"/>
-					<path class="st12" d="M110.2,60.7c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S110.2,59.9,110.2,60.7z"/>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 180.6541 26.8123)" class="st13 st9 st10">data</text>
-					</g>
-					<g>
-						<text transform="matrix(1 0 0 1 387.363 26.8123)" class="st12 st9 st10">free space</text>
-					</g>
-					<g>
-						<g>
-							<line class="st14" x1="272.2" y1="33.6" x2="133.5" y2="33.6"/>
-							<g>
-								<polygon class="st13" points="271.9,36.2 273.5,33.6 271.9,31.1 271.8,31.1 271.8,36.2 								"/>
-							</g>
-							<g>
-								<polygon class="st13" points="133.8,36.1 133.8,31.2 131.4,33.6 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<g>
-							<line class="st15" x1="563.7" y1="33.6" x2="295.9" y2="33.6"/>
-							<g>
-								<polygon class="st12" points="563.4,36.1 563.4,31.2 565.8,33.6 								"/>
-							</g>
-							<g>
-								<polygon class="st12" points="296.2,36.1 296.2,31.2 293.7,33.6 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<text transform="matrix(1 0 0 1 615.4679 25.1898)" class="st12 st9 st10">non-allocated space</text>
-					</g>
-					<g>
-						<g>
-							<line class="st15" x1="593.7" y1="33.6" x2="829.7" y2="33.6"/>
-							<g>
-								<polygon class="st12" points="829.4,31.2 829.4,36.1 831.8,33.6 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<g>
-							<line class="st15" x1="678.7" y1="33.6" x2="589.7" y2="33.6"/>
-							<g>
-								<polygon class="st12" points="590.01,36.1 590.01,31.2 587.6,33.6 								"/>
-							</g>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 133.1212 64.9593)" class="st16 st9 st10">h</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<g>
-							<text transform="matrix(1 0 0 1 165.1564 64.9593)" class="st16 st9 st10">e</text>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<g>
-							<text transform="matrix(1 0 0 1 196.8744 64.9593)" class="st16 st9 st10">l</text>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<g>
-							<text transform="matrix(1 0 0 1 229.8611 64.9593)" class="st16 st9 st10">l</text>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 262.2135 64.9593)" class="st16 st9 st10">o</text>
-					</g>
-				</g>
-			</g>
-		</g>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 1.811981e-04 105.8011)" class="st1 st9 st10">0</text>
-	</g>
-	<line class="st4" x1="5.5" y1="26.4" x2="5.5" y2="87.6"/>
-</g>
-<g>
-	<g>
-		<polyline class="st0" points="577.2,207.99 186.3,207.99 186.3,183.19 577.2,183.19 		"/>
-		<g>
-			<g>
-				<g>
-					<polyline class="st3" points="122.6,207.99 5.9,207.99 5.9,183.19 122.6,183.19 					"/>
-					<polyline class="st4" points="831.51,207.99 5.5,207.99 5.5,183.19 831.51,183.19 					"/>
-					<polyline class="st1" points="186.3,207.69 122.5,207.69 122.5,182.89 186.3,182.89 					"/>
-					<line class="st4" x1="122.5" y1="161.79" x2="122.5" y2="222.99"/>
-					<line class="st4" x1="186" y1="161.79" x2="186" y2="222.99"/>
-					<line class="st4" x1="576.8" y1="161.79" x2="576.8" y2="222.99"/>
-					<path class="st5" d="M831.51,207.99"/>
-					<line class="st6" x1="153.5" y1="183.49" x2="153.5" y2="207.19"/>
-					<line class="st4" x1="36.5" y1="183.49" x2="36.5" y2="207.19"/>
-					<line class="st4" x1="67.6" y1="183.49" x2="67.6" y2="207.19"/>
-					<line class="st6" x1="186" y1="183.49" x2="186" y2="207.99"/>
-					<line class="st4" x1="218.4" y1="183.49" x2="218.4" y2="207.19"/>
-					<line class="st4" x1="250.9" y1="183.49" x2="250.9" y2="207.19"/>
-					<line class="st4" x1="283.3" y1="183.49" x2="283.3" y2="207.19"/>
-					<line class="st4" x1="315.9" y1="183.49" x2="315.9" y2="207.19"/>
-					<line class="st4" x1="348.4" y1="183.49" x2="348.4" y2="207.19"/>
-					<line class="st4" x1="381.2" y1="183.49" x2="381.2" y2="207.19"/>
-					<line class="st4" x1="413.8" y1="183.49" x2="413.8" y2="207.19"/>
-					<line class="st4" x1="446.3" y1="183.49" x2="446.3" y2="207.19"/>
-					<line class="st4" x1="478.9" y1="183.49" x2="478.9" y2="207.19"/>
-					<line class="st6" x1="511.51" y1="183.49" x2="511.51" y2="207.19"/>
-					<line class="st4" x1="511.51" y1="183.49" x2="511.51" y2="207.19"/>
-					<line class="st6" x1="544.01" y1="183.49" x2="544.01" y2="207.19"/>
-					<line class="st4" x1="544.1" y1="183.49" x2="544.1" y2="207.19"/>
-					<line class="st8" x1="186" y1="208.19" x2="122.5" y2="207.99"/>
-					<line class="st8" x1="122.5" y1="183.19" x2="186" y2="183.29"/>
-					<path class="st5" d="M385.5,208.19"/>
-					<path class="st5" d="M385.5,184.49"/>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 127.5176 240.9952)" class="st1 st9 st10">buf</text>
-				</g>
-				<g>
-					<g>
-						<line class="st11" x1="122.2" y1="240.79" x2="122.2" y2="229.79"/>
-						<g>
-							<polygon class="st1" points="119.8,230.09 124.6,230.09 122.2,227.69 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 189.2273 240.9947)" class="st1 st9 st10">len=2</text>
-				</g>
-				<g>
-					<g>
-						<line class="st11" x1="185.88" y1="240.79" x2="185.88" y2="229.79"/>
-						<g>
-							<polygon class="st1" points="183.48,230.09 188.38,230.09 185.88,227.69 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<text transform="matrix(1 0 0 1 581.4624 240.9952)" class="st1 st9 st10">size=16</text>
-				</g>
-				<g>
-					<g>
-						<line class="st11" x1="576.9" y1="240.79" x2="576.9" y2="229.79"/>
-						<g>
-							<polygon class="st1" points="574.51,230.09 579.4,230.09 576.9,227.69 							"/>
-						</g>
-					</g>
-				</g>
-				<g>
-					<path class="st12" d="M687.51,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						S687.51,195.09,687.51,195.89z"/>
-					<path class="st12" d="M701.2,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S701.2,195.09,701.2,195.89z
-						"/>
-					<path class="st12" d="M714.9,195.89c0,0.9-0.7,1.6-1.6,1.6c-0.9,0-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						S714.9,195.09,714.9,195.89z"/>
-					<path class="st12" d="M728.7,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						C728.01,194.29,728.7,195.09,728.7,195.89z"/>
-				</g>
-				<g>
-					<path class="st12" d="M82.8,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S82.8,195.09,82.8,195.89z"/>
-					<path class="st12" d="M96.5,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6
-						C95.8,194.29,96.5,195.09,96.5,195.89z"/>
-					<path class="st12" d="M110.2,195.89c0,0.9-0.7,1.6-1.6,1.6s-1.6-0.7-1.6-1.6c0-0.9,0.7-1.6,1.6-1.6S110.2,195.09,110.2,195.89z
-						"/>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 133.6541 162.0062)" class="st13 st9 st10">data</text>
-					</g>
-					<g>
-						<text transform="matrix(1 0 0 1 327.363 162.0062)" class="st12 st9 st10">free space</text>
-					</g>
-					<g>
-						<g>
-							<line class="st14" x1="175.2" y1="168.79" x2="133.5" y2="168.79"/>
-							<g>
-								<polygon class="st13" points="174.9,171.39 176.5,168.79 174.9,166.29 174.8,166.29 174.8,171.39 								"/>
-							</g>
-							<g>
-								<polygon class="st13" points="133.8,171.29 133.8,166.39 131.4,168.79 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<g>
-							<line class="st15" x1="563.7" y1="168.79" x2="197.49" y2="168.79"/>
-							<g>
-								<polygon class="st12" points="563.4,171.29 563.4,166.39 565.8,168.79 								"/>
-							</g>
-							<g>
-								<polygon class="st12" points="197.79,171.29 197.79,166.39 195.29,168.79 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<text transform="matrix(1 0 0 1 615.4679 160.3837)" class="st12 st9 st10">non-allocated space</text>
-					</g>
-					<g>
-						<g>
-							<line class="st15" x1="593.7" y1="168.79" x2="829.7" y2="168.79"/>
-							<g>
-								<polygon class="st12" points="829.4,166.39 829.4,171.29 831.8,168.79 								"/>
-							</g>
-						</g>
-					</g>
-					<g>
-						<g>
-							<line class="st15" x1="678.7" y1="168.79" x2="589.7" y2="168.79"/>
-							<g>
-								<polygon class="st12" points="590.01,171.29 590.01,166.39 587.6,168.79 								"/>
-							</g>
-						</g>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 133.1212 200.1532)" class="st16 st9 st10">h</text>
-					</g>
-				</g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 165.1565 200.1532)" class="st16 st9 st10">o</text>
-					</g>
-				</g>
-			</g>
-		</g>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 1.811981e-04 240.995)" class="st1 st9 st10">0</text>
-	</g>
-	<line class="st4" x1="5.5" y1="161.59" x2="5.5" y2="222.79"/>
-</g>
-</svg>

docs/images/packed.svg

@@ -1,384 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Generator: Adobe Illustrator 25.0.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
-<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
-	 viewBox="0 0 858.5 424.3" style="enable-background:new 0 0 858.5 424.3;" xml:space="preserve">
-<style type="text/css">
-	.st0{fill:#9E9B83;}
-	.st1{fill:#9E8900;}
-	.st2{font-family:Arial;font-weight:bold;}
-	.st3{font-size:11px;}
-	.st4{display:none;fill:#576174;}
-	.st5{fill:#1F5F75;}
-	.st6{clip-path:url(#SVGID_3_);fill:#FFFFFF;fill-opacity:0.1;}
-	.st7{fill:#277691;}
-	.st8{fill:#FFFFFF;}
-	.st9{font-family:Arial;font-weight:bold;}
-	.st10{fill:#004219;}
-	.st11{clip-path:url(#SVGID_6_);fill:#FFFFFF;fill-opacity:0.1;}
-	.st12{fill:#005721;}
-	.st13{fill:url(#SVGID_7_);}
-	.st14{clip-path:url(#XMLID_13_);fill:#FFFFFF;fill-opacity:0.1;}
-	.st15{fill:#752E06;}
-	.st16{fill:#963B08;}
-	.st17{fill:#59008F;}
-	.st18{clip-path:url(#XMLID_15_);fill:#FFFFFF;fill-opacity:0.1;}
-	.st19{fill:#7300B8;}
-	.st20{fill:#FFDE00;}
-	.st21{fill:#576174;}
-	.st22{font-size:13px;}
-	.st23{fill:#8A8C8E;}
-	.st24{font-size:12px;}
-	.st25{opacity:0.69;}
-	.st26{fill:#B3B1B3;}
-	.st27{clip-path:url(#XMLID_17_);fill:#FFFFFF;fill-opacity:0.1;}
-	.st28{fill:#919091;}
-	.st29{fill:#BFBEBF;}
-	.st30{fill:#454445;}
-	.st31{font-size:9px;}
-	.st32{clip-path:url(#XMLID_19_);fill:#FFFFFF;fill-opacity:0.1;}
-	.st33{fill:#8695B3;}
-	.st34{fill:url(#SVGID_8_);}
-	.st35{font-size:18px;}
-	.st36{clip-path:url(#XMLID_20_);fill:#610041;fill-opacity:0.1;}
-	.st37{fill:#610041;}
-	.st38{clip-path:url(#XMLID_22_);fill:url(#SVGID_9_);fill-opacity:0.1;}
-	.st39{fill:none;stroke:#86005B;stroke-width:0.5;stroke-linecap:round;stroke-miterlimit:10;}
-	.st40{fill:none;stroke:#86005B;stroke-width:0.75;stroke-linecap:round;stroke-miterlimit:10;}
-	.st41{fill:url(#SVGID_10_);}
-	.st42{fill:url(#SVGID_11_);}
-	.st43{fill:#610042;}
-	.st44{fill:url(#SVGID_12_);}
-</style>
-<g>
-	<g>
-		<path class="st0" d="M457.9,111.2l0.1,87.3c0,1.4-1.1,2.6-2.5,2.6h-76.3c-4.4-0.2-7.3-3.9-7.3-5.3l4.7-101.8
-			c0-1.4,0.8-7.4,2.2-7.4l54-0.1L457.9,111.2z"/>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 383.2604 149.9447)" class="st1 st2 st3">packed_fs.c</text>
-	</g>
-</g>
-<rect x="84" y="25" class="st4" width="727.7" height="429.8"/>
-<g>
-	<g>
-		<path class="st5" d="M207.5,104.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V84.5c0-1.4,1.1-2.5,2.5-2.5h58
-			L207.5,104.6z"/>
-		<g>
-			<defs>
-				<path id="SVGID_1_" d="M205.5,102.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5V82.5c0-1.4,1.1-2.5,2.5-2.5
-					h58L205.5,102.6z"/>
-			</defs>
-			<linearGradient id="SVGID_2_" gradientUnits="userSpaceOnUse" x1="122.1091" y1="136.2824" x2="205.5191" y2="136.2824">
-				<stop  offset="0" style="stop-color:#45CFFF"/>
-				<stop  offset="1" style="stop-color:#85DDFA"/>
-			</linearGradient>
-			<use xlink:href="#SVGID_1_"  style="overflow:visible;fill:url(#SVGID_2_);"/>
-			<clipPath id="SVGID_3_">
-				<use xlink:href="#SVGID_1_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st6" d="M121.4,101.4c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V101.4z"/>
-		</g>
-		<path class="st5" d="M205.9,104.4l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L205.9,104.4z"/>
-		<path class="st7" d="M205.7,102.8h-20.5c-1.4,0-2.5-1.1-2.5-2.5V79.9l0,0l22.9,22.7L205.7,102.8z"/>
-		<g>
-			<text transform="matrix(1 0 0 1 129.0689 92.8531)" class="st8 st9 st3">filex.y</text>
-		</g>
-	</g>
-	<g>
-		<path class="st10" d="M191.4,121.6V209c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V101.4c0-1.4,1.1-2.5,2.5-2.5h58
-			L191.4,121.6z"/>
-		<g>
-			<defs>
-				<path id="SVGID_4_" d="M189.4,119.6V207c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5V99.4c0-1.4,1.1-2.5,2.5-2.5
-					h58L189.4,119.6z"/>
-			</defs>
-			<linearGradient id="SVGID_5_" gradientUnits="userSpaceOnUse" x1="106.0386" y1="153.2384" x2="189.4486" y2="153.2384">
-				<stop  offset="0" style="stop-color:#00983A"/>
-				<stop  offset="1" style="stop-color:#3A985D"/>
-			</linearGradient>
-			<use xlink:href="#SVGID_4_"  style="overflow:visible;fill:url(#SVGID_5_);"/>
-			<clipPath id="SVGID_6_">
-				<use xlink:href="#SVGID_4_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st11" d="M105.3,118.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V118.3z"/>
-		</g>
-		<path class="st10" d="M189.8,121.3l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L189.8,121.3z"/>
-		<path class="st12" d="M189.6,119.7h-20.5c-1.4,0-2.5-1.1-2.5-2.5V96.9l0,0l22.9,22.7L189.6,119.7z"/>
-		<g>
-			<text transform="matrix(1 0 0 1 113.9984 109.809)" class="st8 st9 st3">main.js</text>
-		</g>
-	</g>
-	<g>
-		<linearGradient id="SVGID_7_" gradientUnits="userSpaceOnUse" x1="93.2369" y1="173.2516" x2="176.6469" y2="173.2516">
-			<stop  offset="0" style="stop-color:#EA5B0C"/>
-			<stop  offset="1" style="stop-color:#EA671E"/>
-		</linearGradient>
-		<path class="st13" d="M176.6,139.6V227c0,1.4-1.1,2.6-2.5,2.6H95.8c-1.4,0-2.5-1.1-2.5-2.6V119.5c0-1.4,1.1-2.5,2.5-2.5h58
-			L176.6,139.6z"/>
-		<g>
-			<defs>
-				<path id="XMLID_2_" d="M174.6,137.6V225c0,1.4-1.1,2.6-2.5,2.6H93.8c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1c0-1.4,1.1-2.5,2.5-2.5
-					h58L174.6,137.6z"/>
-			</defs>
-			<linearGradient id="XMLID_12_" gradientUnits="userSpaceOnUse" x1="91.2369" y1="171.2516" x2="174.6469" y2="171.2516">
-				<stop  offset="0" style="stop-color:#EA5B0C"/>
-				<stop  offset="1" style="stop-color:#EA7B3D"/>
-			</linearGradient>
-			<use xlink:href="#XMLID_2_"  style="overflow:visible;fill:url(#XMLID_12_);"/>
-			<clipPath id="XMLID_13_">
-				<use xlink:href="#XMLID_2_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st14" d="M90.5,136.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V136.3z"/>
-		</g>
-		<path class="st15" d="M175,139.3l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L175,139.3z"/>
-		<path class="st16" d="M174.8,137.7h-20.5c-1.4,0-2.5-1.1-2.5-2.5v-20.3l0,0l22.9,22.7L174.8,137.7z"/>
-		<g>
-			<text transform="matrix(1 0 0 1 97.1967 127.8222)" class="st8 st9 st3">style.css</text>
-		</g>
-	</g>
-	<g>
-		<path class="st17" d="M164.6,157.7v87.4c0,1.4-1.1,2.6-2.5,2.6H83.8c-1.4,0-2.5-1.1-2.5-2.6V137.5c0-1.4,1.1-2.5,2.5-2.5h58
-			L164.6,157.7z"/>
-		<g>
-			<defs>
-				<path id="XMLID_1_" d="M162.6,155.7v87.4c0,1.4-1.1,2.6-2.5,2.6H81.8c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1c0-1.4,1.1-2.5,2.5-2.5
-					h58L162.6,155.7z"/>
-			</defs>
-			<linearGradient id="XMLID_14_" gradientUnits="userSpaceOnUse" x1="79.2009" y1="189.3131" x2="162.6108" y2="189.3131">
-				<stop  offset="0" style="stop-color:#A000FF"/>
-				<stop  offset="1" style="stop-color:#C96EFF"/>
-			</linearGradient>
-			<use xlink:href="#XMLID_1_"  style="overflow:visible;fill:url(#XMLID_14_);"/>
-			<clipPath id="XMLID_15_">
-				<use xlink:href="#XMLID_1_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st18" d="M78.5,154.4c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V154.4z"/>
-		</g>
-		<path class="st17" d="M163,157.4l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L163,157.4z"/>
-		<path class="st19" d="M162.8,155.8h-20.5c-1.4,0-2.5-1.1-2.5-2.5V133l0,0l22.9,22.7L162.8,155.8z"/>
-		<g>
-			<text transform="matrix(1 0 0 1 83.1607 145.8838)" class="st8 st9 st3">index.html</text>
-		</g>
-	</g>
-</g>
-<g>
-	<g>
-		<path class="st20" d="M455.2,108.2v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V88.1c0-1.4,1.1-2.5,2.5-2.5h58
-			L455.2,108.2z"/>
-		<path class="st0" d="M455.3,110.3l-18.4,0c-1.4,0-2.5-1.1-2.5-2.5V87.5l0,0l20.9,20.7L455.3,110.3z"/>
-		<polygon class="st0" points="435.2,109.7 432.9,107.3 436.3,106.9 		"/>
-		<path class="st1" d="M455.4,108.3h-20.5c-1.4,0-2.5-1.1-2.5-2.5V85.5l0,0l22.9,22.7L455.4,108.3z"/>
-	</g>
-	<g>
-		<text transform="matrix(1 0 0 1 379.2604 144.9447)" class="st21 st9 st22">packed_fs.c</text>
-	</g>
-</g>
-<g>
-	<polygon class="st23" points="483.6,195.4 397.3,195.4 394.3,193.4 397.3,162.8 481.5,159.7 483.6,162.8 	"/>
-	<rect x="394.3" y="159.8" class="st21" width="87.3" height="33.7"/>
-	<g>
-		<g>
-			<text transform="matrix(1 0 0 1 400.0845 171.7588)" class="st8 st9 st24">mg_unpack()</text>
-		</g>
-		<g>
-			<text transform="matrix(1 0 0 1 400.0845 186.935)" class="st8 st9 st24">mg_unlist()</text>
-		</g>
-	</g>
-</g>
-<g class="st25">
-	<g>
-		<path class="st26" d="M467.7,256.6V344c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V236.4c0-1.4,1.1-2.5,2.5-2.5h58
-			L467.7,256.6z"/>
-		<g>
-			<defs>
-				<path id="XMLID_9_" d="M465.7,254.6V342c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1c0-1.4,1.1-2.5,2.5-2.5
-					h58L465.7,254.6z"/>
-			</defs>
-			<linearGradient id="XMLID_16_" gradientUnits="userSpaceOnUse" x1="382.3115" y1="288.2073" x2="465.7215" y2="288.2073">
-				<stop  offset="0" style="stop-color:#D6D4D6"/>
-				<stop  offset="1" style="stop-color:#FFFDFE"/>
-			</linearGradient>
-			<use xlink:href="#XMLID_9_"  style="overflow:visible;fill:url(#XMLID_16_);"/>
-			<clipPath id="XMLID_17_">
-				<use xlink:href="#XMLID_9_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st27" d="M381.6,253.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V253.3z"/>
-		</g>
-		<path class="st28" d="M466.1,256.3l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L466.1,256.3z"/>
-		<path class="st29" d="M465.9,254.7h-20.5c-1.4,0-2.5-1.1-2.5-2.5v-20.3l0,0l22.9,22.7L465.9,254.7z"/>
-		<text transform="matrix(1 0 0 1 386.2713 244.7779)" class="st30 st9 st31">mongoose.c</text>
-	</g>
-	<g>
-		<path class="st26" d="M455.7,276.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6V256.5c0-1.4,1.1-2.5,2.5-2.5h58
-			L455.7,276.6z"/>
-		<g>
-			<defs>
-				<path id="XMLID_8_" d="M453.7,274.6v87.4c0,1.4-1.1,2.6-2.5,2.6h-78.3c-1.4,0-2.5-1.1-2.5-2.6v-57.5v-50.1
-					c0-1.4,1.1-2.5,2.5-2.5h58L453.7,274.6z"/>
-			</defs>
-			<linearGradient id="XMLID_18_" gradientUnits="userSpaceOnUse" x1="370.2755" y1="308.2689" x2="453.6855" y2="308.2689">
-				<stop  offset="0" style="stop-color:#D6D4D6"/>
-				<stop  offset="1" style="stop-color:#FFFDFE"/>
-			</linearGradient>
-			<use xlink:href="#XMLID_8_"  style="overflow:visible;fill:url(#XMLID_18_);"/>
-			<clipPath id="XMLID_19_">
-				<use xlink:href="#XMLID_8_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st32" d="M369.6,273.3c9.4,0.7,36.6,1.5,53.2,14.7c25,20,31.2,47.1,31.2,47.1l0.4,35.3l-84.8,0.2V273.3z"/>
-			<use xlink:href="#XMLID_8_"  style="overflow:visible;fill:none;stroke:#FFFDFE;stroke-width:0.25;stroke-miterlimit:10;"/>
-		</g>
-		<path class="st28" d="M454,276.4l-20.6,0c-1.4,0-2.6-1.2-2.6-2.6l0-21.8l22.9,22.7L454,276.4z"/>
-		<path class="st29" d="M453.8,274.8h-20.5c-1.4,0-2.5-1.1-2.5-2.5v-20.3l0,0l22.9,22.7L453.8,274.8z"/>
-		<text transform="matrix(1 0 0 1 379.2353 264.8395)" class="st30 st9 st31">app.c</text>
-	</g>
-</g>
-<g>
-	<polygon class="st33" points="342.3,123.3 351.1,141.7 342.3,160.7 234.8,160.9 234.8,122.6 	"/>
-	<path class="st23" d="M347.4,145.4"/>
-	<linearGradient id="SVGID_8_" gradientUnits="userSpaceOnUse" x1="233.6667" y1="139.4088" x2="350.0318" y2="139.4088">
-		<stop  offset="0" style="stop-color:#C1D5FF"/>
-		<stop  offset="0.1995" style="stop-color:#BACDF6"/>
-		<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
-		<stop  offset="1" style="stop-color:#ADC0E6"/>
-	</linearGradient>
-	<polygon class="st34" points="341.2,120.9 350,139.3 341.2,158.3 233.7,158.5 233.7,120.3 	"/>
-	<text transform="matrix(1 0 0 1 262.9869 146.2633)" class="st8 st9 st35">PACK</text>
-	<polygon class="st33" points="234.8,160.9 233.7,158.5 238,158.7 	"/>
-</g>
-<g>
-	<path class="st23" d="M634.9,144.6L634.9,144.6z"/>
-</g>
-<g>
-	<polygon class="st33" points="619.6,139.3 619.6,139.3 618.7,137.4 618.7,137.4 	"/>
-	<path class="st23" d="M623.1,168.2L623.1,168.2z"/>
-</g>
-<g>
-	<polygon class="st33" points="619.6,288.1 618.7,290 618.7,290 619.6,288.1 	"/>
-	<path class="st23" d="M623.1,259.2L623.1,259.2z"/>
-</g>
-<g>
-	<path class="st23" d="M617,282L617,282z"/>
-</g>
-<g>
-	<g>
-		<g>
-			<defs>
-				<path id="XMLID_10_" d="M722.7,276.5h-71.2c-11.6,0-21.1-9.4-21.1-21.1v-71.2c0-11.6,9.4-21.1,21.1-21.1h71.2
-					c11.6,0,21.1,9.4,21.1,21.1v71.2C743.8,267,734.4,276.5,722.7,276.5z"/>
-			</defs>
-			<use xlink:href="#XMLID_10_"  style="overflow:visible;fill:#610041;"/>
-			<clipPath id="XMLID_20_">
-				<use xlink:href="#XMLID_10_"  style="overflow:visible;"/>
-			</clipPath>
-			<path class="st36" d="M754.3,172.5c-2.7,8-17.3,30.9-65.8,30.8c-24.5,0-48.4-7.4-65.7-24.7l-12.1-12l69.3-64.6L754.3,172.5z"/>
-		</g>
-		<polygon class="st37" points="637.6,271.2 632.5,266.1 640.3,269.4 		"/>
-		<polygon class="st37" points="738.3,169.9 734.6,166.2 736.4,171 		"/>
-		<g>
-			<defs>
-				<path id="XMLID_5_" d="M719.7,273.5h-71.2c-11.6,0-21.1-9.4-21.1-21.1v-71.2c0-11.6,9.4-21.1,21.1-21.1h71.2
-					c11.6,0,21.1,9.4,21.1,21.1v71.2C740.8,264,731.4,273.5,719.7,273.5z"/>
-			</defs>
-			<radialGradient id="XMLID_21_" cx="684.119" cy="216.7761" r="56.6929" gradientUnits="userSpaceOnUse">
-				<stop  offset="0" style="stop-color:#8B005D;stop-opacity:0.7"/>
-				<stop  offset="1" style="stop-color:#8B005D"/>
-			</radialGradient>
-			<use xlink:href="#XMLID_5_"  style="overflow:visible;fill:url(#XMLID_21_);"/>
-			<clipPath id="XMLID_22_">
-				<use xlink:href="#XMLID_5_"  style="overflow:visible;"/>
-			</clipPath>
-			<radialGradient id="SVGID_9_" cx="678.486" cy="148.5836" r="90.2195" gradientUnits="userSpaceOnUse">
-				<stop  offset="0" style="stop-color:#8B005D"/>
-				<stop  offset="1" style="stop-color:#FFFFFF"/>
-			</radialGradient>
-			<path class="st38" d="M750.3,168.5c-2.7,8-17.3,30.9-65.8,30.8c-24.5,0-48.4-7.4-65.7-24.7l-12.1-12L676,97.9L750.3,168.5z"/>
-		</g>
-		<g>
-			<g>
-				<g>
-					<g>
-						<text transform="matrix(1 0 0 1 646.3768 216.49)" class="st8 st9 st35">APP.EXE</text>
-					</g>
-				</g>
-			</g>
-		</g>
-	</g>
-	<g>
-		<g>
-			<g>
-				<path class="st8" d="M732,240.1c-0.3-1.4-0.8-2.7-1.4-3.9l1.7-2.3c-0.3-0.5-0.6-0.9-1-1.4c-0.3-0.5-0.7-0.9-1.1-1.3l-2.7,1
-					c-1-1-2.2-1.8-3.4-2.4l0-2.9c-1-0.4-2.1-0.8-3.2-1l-1.5,2.4c-1.4-0.2-2.8-0.2-4.1,0l-1.7-2.4c-1.1,0.2-2.1,0.6-3.1,1.1l0.2,2.9
-					c-0.6,0.3-1.2,0.7-1.7,1.1c-0.6,0.4-1.1,0.9-1.5,1.4l-2.7-0.9l-1.9,2.7l1.8,2.3c-0.6,1.3-1,2.6-1.1,4l-2.7,0.9
-					c-0.1,1.1,0,2.2,0.1,3.3l2.8,0.8c0.3,1.3,0.8,2.7,1.4,3.9l-1.7,2.3c0.3,0.5,0.6,0.9,1,1.4c0.3,0.4,0.7,0.9,1.1,1.3l2.7-1
-					c1,1,2.2,1.8,3.4,2.4l0,2.9c1,0.4,2.1,0.8,3.2,1l1.5-2.4c1.4,0.2,2.8,0.2,4.1,0l1.7,2.4c1.1-0.3,2.1-0.6,3.1-1.1l-0.2-2.9
-					c0.6-0.3,1.2-0.7,1.7-1.1c0.6-0.4,1.1-0.9,1.5-1.4l2.8,0.9c0.7-0.8,1.3-1.8,1.9-2.7L731,249c0.6-1.3,1-2.6,1.1-4l2.7-0.9
-					c0.1-1.1,0-2.2-0.1-3.3L732,240.1z M724,251c-4.6,3.5-11.1,2.6-14.6-2c-3.5-4.6-2.6-11.1,2-14.6s11.1-2.6,14.6,2
-					C729.5,241,728.6,247.5,724,251z"/>
-			</g>
-		</g>
-		<g>
-			<g>
-				<path class="st8" d="M700.5,249.3c-0.2-0.8-0.5-1.6-0.8-2.4l1-1.4c-0.2-0.3-0.4-0.6-0.6-0.8c-0.2-0.3-0.4-0.5-0.7-0.8l-1.6,0.6
-					c-0.6-0.6-1.3-1.1-2.1-1.4l0-1.7c-0.6-0.3-1.3-0.5-1.9-0.6l-0.9,1.4c-0.8-0.1-1.7-0.1-2.5,0l-1-1.4c-0.6,0.1-1.3,0.4-1.9,0.6
-					l0.1,1.7c-0.4,0.2-0.7,0.4-1,0.7c-0.3,0.3-0.6,0.5-0.9,0.8l-1.6-0.6l-1.1,1.6l1.1,1.4c-0.3,0.8-0.6,1.6-0.7,2.4l-1.6,0.5
-					c0,0.7,0,1.3,0.1,2l1.7,0.5c0.2,0.8,0.4,1.6,0.9,2.4l-1,1.4c0.2,0.3,0.4,0.6,0.6,0.8c0.2,0.3,0.4,0.5,0.7,0.8l1.6-0.6
-					c0.6,0.6,1.3,1.1,2.1,1.4l0,1.7c0.6,0.3,1.3,0.5,1.9,0.6l0.9-1.4c0.8,0.1,1.7,0.1,2.5,0l1,1.4c0.6-0.2,1.3-0.4,1.9-0.6l-0.1-1.7
-					c0.4-0.2,0.7-0.4,1-0.7c0.3-0.3,0.6-0.5,0.9-0.8l1.6,0.6c0.4-0.5,0.8-1.1,1.1-1.6l-1.1-1.4c0.3-0.8,0.6-1.6,0.7-2.4l1.6-0.5
-					c0-0.7,0-1.3-0.1-2L700.5,249.3z M694.5,254.2c-1.8,1.4-4.5,1-5.9-0.8c-1.4-1.8-1-4.5,0.8-5.9c1.8-1.4,4.5-1,5.9,0.8
-					C696.8,250.2,696.4,252.8,694.5,254.2z"/>
-			</g>
-		</g>
-		<path class="st39" d="M708.9,234.5"/>
-		<path class="st39" d="M706.7,237.9"/>
-		<path class="st40" d="M705.7,242.7c0-1.7,0.4-3.4,1-4.9"/>
-		<path class="st40" d="M708.9,234.5c2.2-2.4,5.3-3.8,8.8-3.8"/>
-		<path class="st40" d="M687.4,247.3c1.1-1.4,2.7-2.2,4.6-2.2"/>
-		<path class="st39" d="M686.4,249.5"/>
-		<path class="st40" d="M686.2,250.9c0-0.5,0.1-1,0.2-1.4"/>
-		<path class="st39" d="M686.7,253.2"/>
-	</g>
-</g>
-<g>
-	<path class="st33" d="M611.7,174.2l-23,3.3l-13.1-9.6c-6.3-4.6-13.9-7.1-21.7-7l-55.5,0.1l-1.1-2.4h1.1l64.2-0.2h0.1l3.9,0h0.1
-		l3.2,2.4l19.2,14l0.2,0.2l23.4-3.3L611.7,174.2z"/>
-	<path class="st23" d="M595.9,145.5L595.9,145.5z"/>
-	<linearGradient id="SVGID_10_" gradientUnits="userSpaceOnUse" x1="497.2089" y1="147.636" x2="612.739" y2="147.636">
-		<stop  offset="0" style="stop-color:#C1D5FF"/>
-		<stop  offset="0.1995" style="stop-color:#BACDF6"/>
-		<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
-		<stop  offset="1" style="stop-color:#ADC0E6"/>
-	</linearGradient>
-	<path class="st41" d="M612.7,171.7l-3,0.4l-20.3,2.8l-0.2-0.1l-13.6-9.9l0,0c-3.7-2.7-8.7-4.4-12.9-5.4c-2.9-0.7-6-1-9-1l-35.5,0.1
-		l-19.8,0.1h-1.1v-38.3l13.5,0.2l4,0l42.6,0.2l7.9,0c7,0,14,1.6,20.2,4.9c0,0,0,0,0,0c0.8,0.5,1.6,0.9,2.4,1.5l7.5,5.6l0.1,0.1l0,0
-		l15.4,11.3v0l0.1,3.2L612.7,171.7z"/>
-	<linearGradient id="SVGID_11_" gradientUnits="userSpaceOnUse" x1="597.6228" y1="138.4046" x2="598.5728" y2="138.4046">
-		<stop  offset="0" style="stop-color:#C1D5FF"/>
-		<stop  offset="0.1995" style="stop-color:#BACDF6"/>
-		<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
-		<stop  offset="1" style="stop-color:#ADC0E6"/>
-	</linearGradient>
-	<polygon class="st42" points="598.6,139.3 598.6,139.4 597.6,137.4 597.7,137.5 	"/>
-	<text transform="matrix(1 0 0 1 513.7678 146.3103)" class="st8 st9 st35">BUILD</text>
-</g>
-<g>
-	<path class="st33" d="M612.7,258.8l-0.1,2.2l-1.8-0.2l-20.3-2.8l-0.2,0.1l-13.6,9.9l0-0.1c-3.7,2.7-8.7,4.4-12.9,5.4
-		c-2.9,0.7-6,1-9,1l-35.5-0.1l-19.8-0.1h-1.1v35.4l-1.1,0.4l1.1,2.4l13.5-0.2l4,0l42.6-0.2l7.9-0.1c7,0,14-1.6,20.2-4.9c0,0,0,0,0,0
-		c0.8-0.5,1.6-0.9,2.4-1.5l7.5-5.6l0.1-0.1l0,0l15.4-11.3l1-0.9l1.9-26.7L612.7,258.8z"/>
-	<path class="st43" d="M593.5,272.5"/>
-	<g>
-		<path class="st23" d="M598.5,285L598.5,285z"/>
-		
-			<linearGradient id="SVGID_12_" gradientUnits="userSpaceOnUse" x1="497.2089" y1="451.0054" x2="612.739" y2="451.0054" gradientTransform="matrix(1 0 0 -1 0 733.8616)">
-			<stop  offset="0" style="stop-color:#C1D5FF"/>
-			<stop  offset="0.1995" style="stop-color:#BACDF6"/>
-			<stop  offset="0.6001" style="stop-color:#B0C3EA"/>
-			<stop  offset="1" style="stop-color:#ADC0E6"/>
-		</linearGradient>
-		<path class="st44" d="M612.7,258.8l-3-0.4l-20.3-2.8l-0.2,0.1l-13.6,9.9l0,0c-3.7,2.7-8.7,4.4-12.9,5.4c-2.9,0.7-6,1-9,1
-			l-35.5-0.1l-19.8-0.1h-1.1v38.3l13.5-0.2l4,0l42.6-0.2l7.9,0c7,0,14-1.6,20.2-4.9c0,0,0,0,0,0c0.8-0.5,1.6-0.9,2.4-1.5l7.5-5.6
-			l0.1-0.1l0,0l15.4-11.3v0l0.1-3.2L612.7,258.8z"/>
-		<text transform="matrix(1 0 0 1 513.7682 298.0848)" class="st8 st9 st35">BUILD</text>
-	</g>
-</g>
-<path class="st33" d="M619.9,149.1"/>
-</svg>

examples/captive-dns-server/Makefile

@@ -1,11 +0,0 @@
-PROG ?= example
-CFLAGS ?= -DMG_IO_SIZE=8192 -DMG_ENABLE_LINES
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/captive-dns-server/README.md

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

examples/device-dashboard/Makefile

@@ -1,40 +0,0 @@
-PROG ?= example
-SOURCES ?= ../../mongoose.c main.c net.c packed_fs.c
-CFLAGS ?= -I../.. -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_LINES=1 $(EXTRA)
-FILES_TO_EMBED ?= $(wildcard web_root/*)
-ROOT ?= $(realpath $(CURDIR)/../../..)
-DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CURDIR)
-VC98 ?= $(DOCKER) mdashnet/vc98 wine
-MINGW ?= $(DOCKER) mdashnet/mingw
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS  += -DMG_ENABLE_MBEDTLS=1 -I$(MBEDTLS)/include -L$(MBEDTLS)/lib -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS  += -DMG_ENABLE_OPENSSL=1 -I$(OPENSSL)/include -L$(OPENSSL)/lib -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(RUN) ./$(PROG)
-
-$(PROG): $(SOURCES) $(FILES_TO_EMBED)
-	$(CC) ../../test/pack.c -o pack
-	./pack $(FILES_TO_EMBED) > packed_fs.c
-	$(CC) -W -Wall -Wextra -O0 -g3 $(CFLAGS) -o $(PROG) $(SOURCES)
-
-
-mingw: $(SOURCES) $(FILES_TO_EMBED)
-	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) ../../test/pack.c -o pack.exe
-	$(MINGW) wine cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
-	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) $(SOURCES) -lws2_32 -o $(PROG).exe
-	$(MINGW) wine $(PROG).exe
-
-vc98: $(SOURCES) $(FILES_TO_EMBED)
-	$(VC98) cl.exe /nologo $(CFLAGS) ../../test/pack.c /Fepack.exe
-	$(VC98) cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
-	$(VC98) cl.exe /nologo /O2 $(CFLAGS) $(SOURCES) /Fe$(PROG).exe
-	$(VC98) $(PROG).exe
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt pack

examples/device-dashboard/README.md

@@ -1,27 +0,0 @@
-# A complete device dashboard
-
-This example is a demonstration of how Mongoose Library could be integrated
-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)
-- Web UI is fully embedded into the server/firmware binary, and does not
-  need a filesystem to serve it. UI is resilient to FS problems
-- Administrators can change server settings
-- All changes are propagates to all connected clients
-- A device is connected to the external MQTT server
-- Logged in clients can send/receive messages to a device which get
-  forwarded to MQTT
-
-# Screenshots
-
-This is a login screen that prompts for user/password
-
-![](screenshots/login.png)
-
-# Main dashboard
-
-A main dashboard page shows and interactive MQTT console
-
-![](screenshots/dashboard.png)

examples/device-dashboard/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/device-dashboard/main.c

@@ -1,18 +0,0 @@
-// Copyright (c) 2020-2022 Cesanta Software Limited
-// All rights reserved
-
-#include "mongoose.h"
-const char *s_listening_url = "http://0.0.0.0:8000";
-
-void device_dashboard_fn(struct mg_connection *, int, void *, void *);
-
-int main(void) {
-  struct mg_mgr mgr;
-  mg_log_set(MG_LL_DEBUG);  // Set debug log level
-  mg_mgr_init(&mgr);
-  mg_http_listen(&mgr, s_listening_url, device_dashboard_fn, &mgr);
-  MG_INFO(("Listening on %s", s_listening_url));
-  while (mgr.conns != NULL) mg_mgr_poll(&mgr, 500);
-  mg_mgr_free(&mgr);
-  return 0;
-}

examples/device-dashboard/net.c

@@ -1,217 +0,0 @@
-// Copyright (c) 2020-2022 Cesanta Software Limited
-// All rights reserved
-
-#include "mongoose.h"
-
-#define MQTT_SERVER "mqtt://broker.hivemq.com:1883"
-#define MQTT_PUBLISH_TOPIC "mg/my_device"
-#define MQTT_SUBSCRIBE_TOPIC "mg/#"
-
-static time_t s_boot_timestamp = 0;               // Updated by SNTP
-static struct mg_connection *s_sntp_conn = NULL;  // SNTP connection
-
-// Define system time()
-time_t time(time_t *tp) {
-  time_t t = s_boot_timestamp + (time_t) (mg_millis() / 1000);
-  if (tp != NULL) *tp = t;
-  return t;
-}
-
-// 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 {
-  char *url, *pub, *sub;  // MQTT settings
-} s_config;
-
-static struct mg_connection *s_mqtt = NULL;  // MQTT connection
-static bool s_connected = false;             // MQTT connection established
-
-// Try to update a single configuration value
-static void update_config(struct mg_str *body, const char *name, char **value) {
-  char buf[256];
-  if (mg_http_get_var(body, name, buf, sizeof(buf)) > 0) {
-    free(*value);
-    *value = strdup(buf);
-  }
-}
-
-// 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 *fmt, ...) {
-  struct mg_connection *c;
-  for (c = mgr->conns; c != NULL; c = c->next) {
-    if (c->label[0] == 'W') {
-      va_list ap;
-      va_start(ap, fmt);
-      mg_ws_vprintf(c, WEBSOCKET_OP_TEXT, fmt, &ap);
-      va_end(ap);
-    }
-  }
-}
-
-// Send simulated metrics data to the dashboard, for chart rendering
-static void timer_metrics_fn(void *param) {
-  send_notification(param, "{%Q:%Q,%Q:[%lu, %d]}", "name", "metrics", "data",
-                    (unsigned long) time(NULL),
-                    10 + (int) ((double) rand() * 10 / RAND_MAX));
-}
-
-// MQTT event handler function
-static void mqtt_fn(struct mg_connection *c, int ev, void *ev_data, void *fnd) {
-  if (ev == MG_EV_CONNECT && mg_url_is_ssl(s_config.url)) {
-    struct mg_tls_opts opts = {.ca = "ca.pem",
-                               .srvname = mg_url_host(s_config.url)};
-    mg_tls_init(c, &opts);
-  } else if (ev == MG_EV_MQTT_OPEN) {
-    s_connected = true;
-    c->is_hexdumping = 1;
-    mg_mqtt_sub(s_mqtt, mg_str(s_config.sub), 2);
-    send_notification(c->mgr, "{%Q:%Q,%Q:null}", "name", "config", "data");
-  } else if (ev == MG_EV_MQTT_MSG) {
-    struct mg_mqtt_message *mm = ev_data;
-    send_notification(c->mgr, "{%Q:%Q,%Q:{%Q: %.*Q, %Q: %.*Q, %Q: %d}}", "name",
-                      "message", "data", "topic", (int) mm->topic.len,
-                      mm->topic.ptr, "data", (int) mm->data.len, mm->data.ptr,
-                      "qos", (int) mm->qos);
-  } else if (ev == MG_EV_MQTT_CMD) {
-    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
-    MG_DEBUG(("cmd %d qos %d", mm->cmd, mm->qos));
-  } else if (ev == MG_EV_CLOSE) {
-    s_mqtt = NULL;
-    if (s_connected) {
-      s_connected = false;
-      send_notification(c->mgr, "{%Q:%Q,%Q:null}", "name", "config", "data");
-    }
-  }
-  (void) fnd;
-}
-
-// Keep MQTT connection open - reconnect if closed
-static void timer_mqtt_fn(void *param) {
-  struct mg_mgr *mgr = (struct mg_mgr *) param;
-  if (s_mqtt == NULL) {
-    struct mg_mqtt_opts opts = {0};
-    s_mqtt = mg_mqtt_connect(mgr, s_config.url, &opts, mqtt_fn, NULL);
-  }
-}
-
-// 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, void *fn_data) {
-  if (ev == MG_EV_SNTP_TIME) {
-    uint64_t t = *(uint64_t *) ev_data;
-    MG_INFO(("%lu SNTP: %lld ms from epoch", c->id, t));
-    s_boot_timestamp = (time_t) ((t - mg_millis()) / 1000);
-    c->is_closing = 1;
-  } else if (ev == MG_EV_CLOSE) {
-    s_sntp_conn = NULL;
-  }
-  (void) fn_data;
-}
-
-static void timer_sntp_fn(void *param) {  // SNTP timer function. Sync up time
-  struct mg_mgr *mgr = (struct mg_mgr *) param;
-  if (s_sntp_conn == NULL && s_boot_timestamp == 0) {
-    s_sntp_conn = mg_sntp_connect(mgr, NULL, sfn, NULL);
-  }
-}
-
-// HTTP request handler function
-void device_dashboard_fn(struct mg_connection *c, int ev, void *ev_data,
-                         void *fn_data) {
-  if (ev == MG_EV_OPEN && c->is_listening) {
-    mg_timer_add(c->mgr, 1000, MG_TIMER_REPEAT, timer_metrics_fn, c->mgr);
-    mg_timer_add(c->mgr, 1000, MG_TIMER_REPEAT, timer_mqtt_fn, c->mgr);
-    mg_timer_add(c->mgr, 1000, MG_TIMER_REPEAT, timer_sntp_fn, c->mgr);
-    s_config.url = strdup(MQTT_SERVER);
-    s_config.pub = strdup(MQTT_PUBLISH_TOPIC);
-    s_config.sub = strdup(MQTT_SUBSCRIBE_TOPIC);
-  } else 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_http_reply(c, 403, "", "Denied\n");
-    } else if (mg_http_match_uri(hm, "/api/config/get")) {
-      mg_http_reply(c, 200, NULL, "{%Q:%Q,%Q:%Q,%Q:%Q,%Q:%s}\n", "url",
-                    s_config.url, "pub", s_config.pub, "sub", s_config.sub,
-                    "connected", s_connected ? "true" : "false");
-    } else if (mg_http_match_uri(hm, "/api/config/set")) {
-      // Admins only
-      if (strcmp(u->name, "admin") == 0) {
-        update_config(&hm->body, "url", &s_config.url);
-        update_config(&hm->body, "pub", &s_config.pub);
-        update_config(&hm->body, "sub", &s_config.sub);
-        if (s_mqtt) s_mqtt->is_closing = 1;  // Ask to disconnect from MQTT
-        send_notification(fn_data, "{%Q:%Q,%Q:null}", "name", "config", "data");
-        mg_http_reply(c, 200, "", "ok\n");
-      } else {
-        mg_http_reply(c, 403, "", "Denied\n");
-      }
-    } else if (mg_http_match_uri(hm, "/api/message/send")) {
-      char buf[256];
-      if (s_connected &&
-          mg_http_get_var(&hm->body, "message", buf, sizeof(buf)) > 0) {
-        mg_mqtt_pub(s_mqtt, mg_str(s_config.pub), mg_str(buf), 1, false);
-      }
-      mg_http_reply(c, 200, "", "ok\n");
-    } else if (mg_http_match_uri(hm, "/api/watch")) {
-      c->label[0] = 'W';  // Mark ourselves as a event listener
-      mg_ws_upgrade(c, hm, NULL);
-    } else if (mg_http_match_uri(hm, "/api/login")) {
-      mg_http_reply(c, 200, NULL, "{%Q:%Q,%Q:%Q}\n", "user", u->name, "token",
-                    u->token);
-    } 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);
-    }
-    MG_DEBUG(("%.*s %.*s -> %.*s", (int) hm->method.len, hm->method.ptr,
-              (int) hm->uri.len, hm->uri.ptr, (int) 3, &c->send.buf[9]));
-  }
-}

examples/device-dashboard/web_root/main.js

@@ -1,378 +0,0 @@
-'use strict';
-import {Component, h, html, render, useEffect, useState, useRef} from './preact.min.js';
-
-const MaxMetricsDataPoints = 50;
-
-// This simple publish/subscribe is used to pass notifications that were
-// received from the server, to all child components of the app.
-var PubSub = (function() {
-  var handlers = {}, id = 0;
-  return {
-    subscribe: function(fn) {
-      handlers[id++] = fn;
-    },
-    unsubscribe: function(id) {
-      delete handlers[id];
-    },
-    publish: function(data) {
-      for (var k in handlers) handlers[k](data);
-    }
-  };
-})();
-
-const Nav = props => html`
-<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 Hero = props => html`
-<div class="section">
-<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>
-
-  <p>
-  This device dashboard is developed using the modern and compact Preact framework,
-  in order to fit on 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.
-
-  This UI uses the REST API implemented by the device, which you can examine
-  using  <code>curl</code> command-line utility:
-  </p>
-
-  <div><code>curl -u admin:pass0 localhost:8000/api/config/get</code> </div>
-  <div><code>curl -u admin:pass0 localhost:8000/api/config/set -d 'pub=mg/topic'</code> </div>
-  <div><code>curl -u admin:pass0 localhost:8000/api/message/send -d 'message=hello'</code> </div>
-
-  <p>
-  The device can send notifications to this dashboard at anytime. Notifications
-  are sent over WebSocket at URI <code>/api/watch</code> as JSON strings: <code>{"name": "..", "data": ...}</code>
-  <div>Try <code>wscat --auth user1:pass1 --connect ws://localhost:8000/api/watch</code></div>
-  </p>
-</div>
-</div>`;
-
-const Login = function(props) {
-  const [user, setUser] = useState('');
-  const [pass, setPass] = useState('');
-  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 Configuration = function(props) {
-  const [url, setUrl] = useState(props.config.url || '');
-  const [pub, setPub] = useState(props.config.pub || '');
-  const [sub, setSub] = useState(props.config.sub || '');
-
-  useEffect(() => {
-    setUrl(props.config.url);
-    setPub(props.config.pub);
-    setSub(props.config.sub);
-  }, [props.config]);
-
-  const update = (name, val) => fetch('/api/config/set', {
-                                  method: 'post',
-                                  body: `${name}=${encodeURIComponent(val)}`
-                                }).catch(err => err);
-  const updateurl = ev => update('url', url);
-  const updatepub = ev => update('pub', pub);
-  const updatesub = ev => update('sub', sub);
-
-  // console.log(props, [url, pub, sub]);
-  return html`
-<div class="section">
-  <h3 style="background: #c03434; color: #fff; padding: 0.4em;">
-    Device Configuration</h3>
-  <div style="margin: 0.5em 0; display: flex;">
-    <span class="addon nowrap">MQTT server:</span>
-    <input type="text" style="flex: 1 100%;"
-          value=${url} onchange=${updateurl}
-          oninput=${ev => setUrl(ev.target.value)} />
-    <button class="btn" disabled=${!url} onclick=${updateurl}
-      style="margin-left: 1em; background: #8aa;">Update</button>
-  </div>
-  <div style="margin: 0.5em 0; display: flex; ">
-    <span class="addon nowrap">Subscribe topic:</span>
-    <input type="text" style="flex: 1 100%;"
-        value=${sub} onchange=${updatesub}
-        oninput=${ev => setSub(ev.target.value)} />
-    <button class="btn" disabled=${!sub} onclick=${updatesub}
-      style="margin-left: 1em; background: #8aa;">Update</button>
-  </div>
-  <div style="margin: 0.5em 0; display: flex;">
-    <span class="addon nowrap">Publish topic:</span>
-    <input type="text" style="flex: 1 100%;"
-          value=${pub} onchange=${updatepub}
-          oninput=${ev => setPub(ev.target.value)} />
-    <button class="btn" disabled=${!pub} onclick=${updatepub}
-      style="margin-left: 1em; background: #8aa;">Update</button>
-  </div>
-  <div>
-    You can use <a href="http://www.hivemq.com/demos/websocket-client/">
-    HiveMQ Websocket web client</a> to send messages to this console.
-  </div>
-  <div class="msg">
-    The device keeps a persistent connection to the configured MQTT server.
-    Changes to this configuration are propagated to all dashboards: try
-    changing them in this dashboard and observe changes in other opened
-    dashboards.
-  </div><div class="msg">
-    Note: administrators can see this section and can change device
-    configuration, whilst users cannot.
-  </div>
-</div>`;
-};
-
-
-const Message = m => html`<div style="margin: 0.5em 0;">
-  <span class="qos">qos: ${m.message.qos} </span>
-  <span class="topic">topic: ${m.message.topic} </span>
-  <span class="data">data: ${m.message.data}</span>
-</div>`;
-
-const Messages = function(props) {
-  const [messages, setMessages] = useState([]);
-  const [txt, setTxt] = useState('');
-
-  useEffect(() => {
-    const id = PubSub.subscribe(function(msg) {
-      if (msg.name == 'message') setMessages(x => x.concat([msg.data]));
-    });
-    return PubSub.unsubscribe(id);
-  }, []);
-
-  const sendmessage = ev => fetch('/api/message/send', {
-                              method: 'post',
-                              body: `message=${encodeURIComponent(txt)}`
-                            }).then(r => setTxt(''));
-  const connstatus = props.config.connected ? 'connected' : 'disconnected';
-  return html`
-<div class="section">
-  <h3 style="background: #30c040; color: #fff; padding: 0.4em;">MQTT messages</h3>
-  <div>
-    MQTT server status: <b>${connstatus}</b>
-  </div>
-  <div style="height: 10em; overflow: auto; padding: 0.5em; " class="border">
-    ${messages.map(message => h(Message, {message}))}
-  </div>
-  <div style="margin: 0.5em 0; display: flex">
-    <span class="addon nowrap">Publish message:</span>
-    <input placeholder="type and press enter..." style="flex: 1 100%;"
-      value=${txt} onchange=${sendmessage}
-      oninput=${ev => setTxt(ev.target.value)} />
-  </div>
-  <div class="msg">
-    The message gets passed to the device via REST. Then the device sends it to
-    the MQTT server over MQTT. All MQTT messages on a subscribed topic
-    received by the device, are propagated to this dashboard via /api/watch.
-  </div>
-</div>`;
-};
-
-// Expected arguments:
-// data: timeseries, e.g. [ [1654361352, 19], [1654361353, 18], ... ]
-// width, height, yticks, xticks, ymin, ymax, xmin, xmax
-const SVG = function(props) {
-  //            w
-  //   +---------------------+
-  //   |        h1           |
-  //   |    +-----------+    |
-  //   |    |           |    |  h
-  //   | w1 |           | w2 |
-  //   |    +-----------+    |
-  //   |         h2          |
-  //   +---------------------+
-  //
-  let w = props.width, h = props.height, w1 = 30, w2 = 0, h1 = 8, h2 = 18;
-  let yticks = props.yticks || 4, xticks = props.xticks || 5;
-  let data = props.data || [];
-  let ymin = props.ymin || 0;
-  let ymax = props.ymax || Math.max.apply(null, data.map(p => p[1]));
-  let xmin = props.xmin || Math.min.apply(null, data.map(p => p[0]));
-  let xmax = props.xmax || Math.max.apply(null, data.map(p => p[0]));
-
-  // Y-axis tick lines and labels
-  let yta = (new Array(yticks + 1)).fill(0).map((_, i) => i);  // indices
-  let yti = i => h - h2 - (h - h1 - h2) * i / yticks;          // index's Y
-  let ytv = i => (ymax - ymin) * i / yticks;
-  let ytl = y => html`<line x1=${w1} y1=${y} x2=${w} y2=${y} class="tick"/>`;
-  let ytt = (y, v) => html`<text x=0 y=${y + 5} class="label">${v}</text>`;
-
-  // X-axis tick lines and labels
-  let datefmt = unix => (new Date(unix * 1000)).toISOString().substr(14, 5);
-  let xta = (new Array(xticks + 1)).fill(0).map((_, i) => i);  // indices
-  let xti = i => w1 + (w - w1 - w2) * i / xticks;              // index's X
-  let xtv = i => datefmt(xmin + (xmax - xmin) * i / xticks);
-  let xtl = x => html`<path d="M ${x},${h1} L ${x},${h - h2}" class="tick"/>`;
-  let xtt = (x, v) =>
-      html`<text x=${x - 15} y=${h - 2} class="label">${v}</text>`;
-
-  // Transform data points array into coordinate
-  let dx = v => w1 + (v - xmin) / ((xmax - xmin) || 1) * (w - w1 - w2);
-  let dy = v => h - h2 - (v - ymin) / ((ymax - ymin) || 1) * (h - h1 - h2);
-  let dd = data.map(p => [Math.round(dx(p[0])), Math.round(dy(p[1]))]);
-  let ddl = dd.length;
-  // And plot the data as <path> element
-  let begin0 = ddl ? `M ${dd[0][0]},${dd[0][1]}` : `M 0,0`;
-  let begin = `M ${w1},${h - h2}`;  // Initial point
-  let end = ddl ? `L ${dd[ddl - 1][0]},${h - h2}` : `L ${w1},${h - h2}`;
-  let series = ddl ? dd.map(p => `L ${p[0]} ${p[1]}`) : [];
-
-  return html`
-<svg viewBox="0 0 ${w} ${h}">
-  <style>
-    .axis { stroke: #aaa; fill: none; }
-    .label { stroke: #aaa; font-size: 13px; }
-    .tick { stroke: #ccc; fill: none; stroke-dasharray: 5; }
-    .seriesbg { stroke: none; fill: rgba(200,225,255, 0.25)}
-    .series { stroke: #25a; fill: none; }
-  </style>
-  ${yta.map(i => ytl(yti(i)))}
-  ${yta.map(i => ytt(yti(i), ytv(i)))}
-  ${xta.map(i => xtl(xti(i)))}
-  ${data.length ? xta.map(i => xtt(xti(i), xtv(i))) : ''}
-  <path d="${begin} ${series.join(' ')} ${end}" class="seriesbg" />
-  <path d="${begin0} ${series.join(' ')}" class="series" />
-</svg>`;
-};
-
-
-const Chart = function(props) {
-  const [data, setData] = useState([]);
-  useEffect(() => {
-    const id = PubSub.subscribe(function(msg) {
-      if (msg.name != 'metrics') return;
-      setData(x => x.concat([msg.data]).splice(-MaxMetricsDataPoints));
-    });
-    return PubSub.unsubscribe(id);
-  }, []);
-
-  let xmax = 0, missing = MaxMetricsDataPoints - data.length;
-  if (missing > 0) xmax = Math.round(Date.now() / 1000) + missing;
-  return html`
-<div class="section">
-  <h3 style="background: #ec3; color: #fff; padding: 0.4em;">Data Chart</h3>
-  <div style="overflow: auto; padding: 0.5em;" class="">
-    <${SVG} height=240 width=600 ymin=0 ymax=20 xmax=${xmax} data=${data} />
-  </div>
-  <div class="msg">
-    This chart plots live sensor data, sent by the device via /api/watch.
-  </div>
-</div>`;
-};
-
-const App = function(props) {
-  const [user, setUser] = useState('');
-  const [config, setConfig] = useState({});
-
-  const getconfig = () =>
-      fetch('/api/config/get', {headers: {Authorization: ''}})
-          .then(r => r.json())
-          .then(r => setConfig(r))
-          .catch(err => console.log(err));
-
-  // Watch for notifications. As soon as a notification arrives, pass it on
-  // to all subscribed components
-  const watch = function() {
-    var l = window.location, proto = l.protocol.replace('http', 'ws');
-    var tid, wsURI = proto + '//' + l.host + '/api/watch'
-    var reconnect = function() {
-      var ws = new WebSocket(wsURI);
-      // ws.onopen = () => console.log('ws connected');
-      ws.onmessage = function(ev) {
-        try {
-          var msg = JSON.parse(ev.data);
-          PubSub.publish(msg);
-          // if (msg.name != 'metrics') console.log('ws->', msg);
-        } catch (e) {
-          console.log('Invalid ws frame:', ev.data);  // eslint-disable-line
-        }
-      };
-      ws.onclose = function() {
-        clearTimeout(tid);
-        tid = setTimeout(reconnect, 1000);
-        console.log('ws disconnected');
-      };
-    };
-    reconnect();
-  };
-
-  const login = function(u) {
-    document.cookie = `access_token=${u.token}; Secure, HttpOnly; SameSite=Lax; path=/; max-age=3600`;
-    setUser(u.user);
-    watch();
-    return getconfig();
-  };
-
-  const logout = ev => {
-    document.cookie = `access_token=; Secure, HttpOnly; SameSite=Lax; path=/; max-age=0`;
-    setUser('');
-  };
-
-  useEffect(() => {
-    // Called once at init time
-    PubSub.subscribe(msg => msg.name == 'config' && getconfig());
-    fetch('/api/login', {headers: {Authorization: ''}})
-        .then(r => r.json())
-        .then(r => login(r))
-        .catch(err => setUser(''));
-  }, []);
-
-  if (!user) return html`<${Login} login=${login} />`;
-
-  return html`
-<${Nav} user=${user} logout=${logout} />
-<div class="container">
-  <div class="row">
-    <div class="col col-6"><${Hero} /></div>
-    <div class="col col-6"><${Chart} /></div>
-    <div class="col col-6">
-      ${user == 'admin' && h(Configuration, {config})}
-    </div>
-    <div class="col col-6"><${Messages} config=${config} /></div>
-  </div>
-</div>`;
-};
-
-window.onload = () => render(h(App), document.body);

examples/embedded-filesystem/Makefile

@@ -1,51 +0,0 @@
-PROG ?= example
-SOURCES ?= ../../mongoose.c main.c packed_fs.c
-CFLAGS ?= -I../.. -DMG_ENABLE_PACKED_FS=1 -DMG_ENABLE_LINES=1 $(EXTRA)
-FILES_TO_EMBED ?= $(wildcard web_root/*)
-ROOT ?= $(realpath $(CURDIR)/../../..)
-DOCKER ?= docker run --rm -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CURDIR)
-VC98 ?= $(DOCKER) mdashnet/vc98 wine
-MINGW ?= $(DOCKER) mdashnet/mingw
-
-all: $(PROG)
-	$(RUN) ./$(PROG)
-
-$(PROG): $(SOURCES) $(FILES_TO_EMBED)
-	$(CC) ../../test/pack.c -o pack
-	./pack $(FILES_TO_EMBED) > packed_fs.c
-	$(CC) -W -Wall -Wextra -O0 -g3 $(CFLAGS) -o $(PROG) $(SOURCES)
-
-
-mingw: $(SOURCES) $(FILES_TO_EMBED)
-	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) ../../test/pack.c -o pack.exe
-	$(MINGW) wine cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
-	$(MINGW) i686-w64-mingw32-gcc $(CFLAGS) $(SOURCES) -lws2_32 -o $(PROG).exe
-	$(MINGW) wine $(PROG).exe
-
-vc98: $(SOURCES) $(FILES_TO_EMBED)
-	$(VC98) cl.exe /nologo $(CFLAGS) ../../test/pack.c /Fepack.exe
-	$(VC98) cmd /c 'pack.exe $(FILES_TO_EMBED) > packed_fs.c'
-	$(VC98) cl.exe /nologo /O2 $(CFLAGS) $(SOURCES) /Fe$(PROG).exe
-	$(VC98) $(PROG).exe
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt pack
-
-.PHONY: compress expand gzipped plain all
-
-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/esp32/device-dashboard/main/main.c

@@ -1,35 +0,0 @@
-// Copyright (c) 2020 Cesanta Software Limited
-// All rights reserved
-
-#include "esp_spiffs.h"
-//#include "freertos/FreeRTOS.h"
-#include "mongoose.h"
-
-const char *s_listening_url = "http://0.0.0.0:80";
-void device_dashboard_fn(struct mg_connection *, int, void *, void *);
-
-#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 v%s on %s", MG_VERSION, s_listening_url));
-  mg_http_listen(&mgr, s_listening_url, device_dashboard_fn, &mgr);
-  for (;;) mg_mgr_poll(&mgr, 1000);  // Infinite event loop
-}

examples/esp32/uart-bridge/main/net.c

@@ -1 +0,0 @@
-../../../uart-bridge/net.c

examples/esp32/uart-bridge/main/packed_fs.c

@@ -1 +0,0 @@
-../../../uart-bridge/packed_fs.c

examples/esp32/uart-bridge/partitions.csv

@@ -1,5 +0,0 @@
-# Name,   Type, SubType, Offset,  Size, Flags
-nvs,      data, nvs,     0x9000,  0x6000,
-phy_init, data, phy,     0xf000,  0x1000,
-storage,  data, spiffs,  0x10000, 0x10000,
-factory,  app,  factory, 0x100000, 1M,

examples/esp8266/README.md

@@ -1,22 +0,0 @@
-# An example ESP8266 application
-
-To build this application, follow these steps:
-
-1. Make sure you have Docker installed
-2. Clone whole mongoose repository on your machine:
-  ```sh
-  git clone https://github.com/cesanta/mongoose.git
-  ```
-3. Start command line or terminal, and go into the example's directory:
-  ```sh
-  cd mongoose/examples/esp8266
-  ```
-4. Run `make`. This invokes a Docker-based build. A firmware will be built
-  in the `src/build/` directory:
-  ```sh
-  make build
-  ```
-5. Flash your ESP8266. If you have esptool.py installed, the build process will end telling you the command to flash your device. You can just run `make` again to use Docker:
-  ```sh
-  make flash PORT=/your/serial
-  ```

examples/file-upload-html-form/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG)
-
-$(PROG):
-	$(CC) ../../mongoose.c -I../.. $(CFLAGS) $(EXTRA) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt

examples/file-upload-html-form/README.md

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

examples/file-upload-multiple-posts/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG)
-
-$(PROG):
-	$(CC) ../../mongoose.c -I../.. $(CFLAGS) $(EXTRA) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt

examples/file-upload-multiple-posts/README.md

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

examples/file-upload-single-post/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG)
-
-$(PROG):
-	$(CC) ../../mongoose.c -I../.. $(CFLAGS) $(EXTRA) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt

examples/file-upload-single-post/README.md

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

examples/file-upload-single-post/main.c

@@ -1,47 +0,0 @@
-// Copyright (c) 2020 Cesanta Software Limited
-// All rights reserved
-//
-// Streaming upload example. Demonstrates how to use chunked encoding
-// to send large payload in smaller chunks. To test, use curl utility:
-//
-// curl http://localhost:8000/upload?name=a.txt --data-binary @large_file.txt
-
-#include "mongoose.h"
-
-// HTTP request handler function. It implements the following endpoints:
-//   /upload - Saves the next file chunk
-//   all other URI - serves web_root/ directory
-static void cb(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  struct mg_http_message *hm = (struct mg_http_message *) ev_data;
-  if (ev == MG_EV_HTTP_CHUNK && mg_http_match_uri(hm, "/upload")) {
-    MG_INFO(("Got chunk len %lu", (unsigned long) hm->chunk.len));
-    MG_INFO(("Query string: [%.*s]", (int) hm->query.len, hm->query.ptr));
-    // MG_INFO(("Chunk data:\n%.*s", (int) hm->chunk.len, hm->chunk.ptr));
-    mg_http_delete_chunk(c, hm);
-    if (hm->chunk.len == 0) {
-      MG_INFO(("Last chunk received, sending response"));
-      mg_http_reply(c, 200, "", "ok (chunked)\n");
-    }
-  } else if (ev == MG_EV_HTTP_MSG && mg_http_match_uri(hm, "/upload")) {
-    MG_INFO(("Got all %lu bytes!", (unsigned long) hm->body.len));
-    MG_INFO(("Query string: [%.*s]", (int) hm->query.len, hm->query.ptr));
-    // MG_INFO(("Body:\n%.*s", (int) hm->body.len, hm->body.ptr));
-    mg_http_reply(c, 200, "", "ok (%lu)\n", (unsigned long) hm->body.len);
-  } else if (ev == MG_EV_HTTP_MSG) {
-    struct mg_http_serve_opts opts = {.root_dir = "web_root"};
-    mg_http_serve_dir(c, hm, &opts);
-  }
-}
-
-int main(void) {
-  struct mg_mgr mgr;
-
-  mg_mgr_init(&mgr);
-  mg_log_set(MG_LL_DEBUG);  // Set debug log level
-  mg_http_listen(&mgr, "http://localhost:8000", cb, NULL);
-
-  for (;;) mg_mgr_poll(&mgr, 50);
-  mg_mgr_free(&mgr);
-
-  return 0;
-}

examples/http-client/Makefile

@@ -1,41 +0,0 @@
-PROG ?= example
-ROOT ?= $(realpath $(CURDIR)/../..)
-CFLAGS ?= -DMG_ENABLE_LINES $(EXTRA_CFLAGS)
-LIN = docker run -it --rm -v $(ROOT):$(ROOT) -w $(CURDIR) mdashnet/cc2
-SSL = ?
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) -o $(PROG) main.c
-
-linux: all
-linux: CFLAGS += -O2 -g -fsanitize=address,undefined,shift,null,return,bounds,alignment,object-size,bool,enum -static-libasan
-linux: CC = $(LIN) cc
-linux: RUN = $(LIN)
-
-
-ROOT ?= $(realpath $(CURDIR)/../..)
-DOCKER = docker run -it --rm -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CURDIR)
-WDEFS = -DMG_ENABLE_MBEDTLS -DMG_ENABLE_LINES -Imbedtls/include -Imbedtls/library $(EXTRA)
-WFLAGS = /nologo -O2 -I. -I../.. ws2_32.lib advapi32.lib /link /out:$(PROG).exe
-WSRCS = ../../mongoose.c main.c mbedtls/library/*.c
-$(PROG).exe: main.c mbedtls
-	$(DOCKER) mdashnet/vc2017 wine cl $(WSRCS) $(WDEFS) $(WFLAGS)
-vc2017: ARGS = https://cesanta.com
-vc2017: $(PROG).exe
-	$(DOCKER) mdashnet/vc2017 wine $(PROG).exe $(ARGS)
-mbedtls:
-	git clone --depth 1 -b v3.1.0 https://github.com/ARMmbed/mbedtls
-
-clean:
-	rm -rf $(PROG) _CL* *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb mbedtls

examples/http-client/README.md

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

examples/http-client/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/http-proxy-client/Makefile

@@ -1,21 +0,0 @@
-PROG ?= example
-ARGS ?= 167.235.63.238:3128 http://info.cern.ch/
-SSL = ?
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) $(EXTRA_CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/http-proxy-client/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/http-restful-server/Makefile

@@ -1,20 +0,0 @@
-PROG ?= example
-CFLAGS ?= -W -Wall -DMG_ENABLE_LINES=1
-SSL = ?
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. $(CFLAGS) $(EFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/http-restful-server/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/http-restful-server/main.c

@@ -1,68 +0,0 @@
-// Copyright (c) 2020 Cesanta Software Limited
-// All rights reserved
-//
-// HTTP server example. This server serves both static and dynamic content.
-// It opens two ports: plain HTTP on port 8000 and HTTP on port 8443.
-// It implements the following endpoints:
-//    /api/stats - respond with free-formatted stats on current connections
-//    /api/f2/:id - wildcard example, respond with JSON string {"result": "URI"}
-//    any other URI serves static files from s_root_dir
-//
-// To enable SSL/TLS (using self-signed certificates in PEM files),
-//    1. make SSL=OPENSSL or make SSL=MBEDTLS
-//    2. curl -k https://127.0.0.1:8443
-
-#include "mongoose.h"
-
-static const char *s_http_addr = "http://0.0.0.0:8000";    // HTTP port
-static const char *s_https_addr = "https://0.0.0.0:8443";  // HTTPS port
-static const char *s_root_dir = ".";
-
-// We use the same event handler function for HTTP and HTTPS connections
-// fn_data is NULL for plain HTTP, and non-NULL for HTTPS
-static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  if (ev == MG_EV_ACCEPT && fn_data != NULL) {
-    struct mg_tls_opts opts = {
-        //.ca = "ca.pem",         // Uncomment to enable two-way SSL
-        .cert = "server.pem",     // Certificate PEM file
-        .certkey = "server.pem",  // This pem contains both cert and key
-    };
-    mg_tls_init(c, &opts);
-  } else if (ev == MG_EV_HTTP_MSG) {
-    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
-    if (mg_http_match_uri(hm, "/api/stats")) {
-      // Print some statistics about currently established connections
-      mg_printf(c, "HTTP/1.1 200 OK\r\nTransfer-Encoding: chunked\r\n\r\n");
-      mg_http_printf_chunk(c, "ID PROTO TYPE      LOCAL           REMOTE\n");
-      for (struct mg_connection *t = c->mgr->conns; t != NULL; t = t->next) {
-        char loc[40], rem[40];
-        mg_http_printf_chunk(c, "%-3lu %4s %s %-15s %s\n", t->id,
-                             t->is_udp ? "UDP" : "TCP",
-                             t->is_listening  ? "LISTENING"
-                             : t->is_accepted ? "ACCEPTED "
-                                              : "CONNECTED",
-                             mg_straddr(&t->loc, loc, sizeof(loc)),
-                             mg_straddr(&t->rem, rem, sizeof(rem)));
-      }
-      mg_http_printf_chunk(c, "");  // Don't forget the last empty chunk
-    } else if (mg_http_match_uri(hm, "/api/f2/*")) {
-      mg_http_reply(c, 200, "", "{\"result\": \"%.*s\"}\n", (int) hm->uri.len,
-                    hm->uri.ptr);
-    } else {
-      struct mg_http_serve_opts opts = {.root_dir = s_root_dir};
-      mg_http_serve_dir(c, ev_data, &opts);
-    }
-  }
-  (void) fn_data;
-}
-
-int main(void) {
-  struct mg_mgr mgr;                            // Event manager
-  mg_log_set(MG_LL_DEBUG);                      // Set log level
-  mg_mgr_init(&mgr);                            // Initialise event manager
-  mg_http_listen(&mgr, s_http_addr, fn, NULL);  // Create HTTP listener
-  mg_http_listen(&mgr, s_https_addr, fn, (void *) 1);  // HTTPS listener
-  for (;;) mg_mgr_poll(&mgr, 1000);                    // Infinite event loop
-  mg_mgr_free(&mgr);
-  return 0;
-}

examples/http-reverse-proxy/Makefile

@@ -1,21 +0,0 @@
-PROG ?= example
-CFLAGS ?= -DMG_IO_SIZE=128
-SSL = ?
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) $(EXTRA_CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/http-reverse-proxy/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/http-server/Makefile

@@ -1,26 +0,0 @@
-PROG ?= example
-ROOT ?= $(realpath $(CURDIR)/../..)
-DEFS ?= -DMG_ENABLE_LINES=1 -DMG_ENABLE_IPV6=1 -DMG_ENABLE_SSI=1
-CFLAGS ?= -I../.. -W -Wall $(DEFS) $(EXTRA)
-VCFLAGS = /nologo /W3 /O2 /I../.. $(DEFS) $(EXTRA) /link /incremental:no /machine:IX86
-VC98 = docker run -it --rm -e Tmp=. -v $(ROOT):$(ROOT) -w $(CURDIR) mdashnet/vc98
-LIN = docker run -it --rm -v $(ROOT):$(ROOT) -w $(CURDIR) mdashnet/cc2
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c Makefile
-	$(CC) ../../mongoose.c main.c -I../.. $(CFLAGS) -o $@
-
-mongoose.exe: main.c
-	$(VC98) wine cl ../../mongoose.c main.c $(VCFLAGS) ws2_32.lib /out:$@
-
-mingw:
-	gcc ../../mongoose.c main.c -I../.. -W -Wall -DMG_ENABLE_IPV6=1 -DMG_ENABLE_LINES=1 -D_POSIX_C_SOURCE=200000L -lws2_32 -o mongoose.exe
-
-linux: example
-#linux: CFLAGS += -O2 -fsanitize=address,undefined,shift,null,return,bounds,alignment,object-size,bool,enum -static-libasan
-linux: CC = $(LIN) cc
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb mongoose mongoose_* mongoose.*

examples/http-server/README.md

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

examples/http-server/main.c

@@ -1,103 +0,0 @@
-// Copyright (c) 2020 Cesanta Software Limited
-// All rights reserved
-
-#include <signal.h>
-#include "mongoose.h"
-
-static int s_debug_level = MG_LL_INFO;
-static const char *s_root_dir = ".";
-static const char *s_listening_address = "http://0.0.0.0:8000";
-static const char *s_enable_hexdump = "no";
-static const char *s_ssi_pattern = "#.html";
-
-// Handle interrupts, like Ctrl-C
-static int s_signo;
-static void signal_handler(int signo) {
-  s_signo = signo;
-}
-
-// Event handler for the listening connection.
-// Simply serve static files from `s_root_dir`
-static void cb(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  if (ev == MG_EV_HTTP_MSG) {
-    struct mg_http_message *hm = ev_data, tmp = {0};
-    struct mg_str unknown = mg_str_n("?", 1), *cl;
-    struct mg_http_serve_opts opts = {0};
-    opts.root_dir = s_root_dir;
-    opts.ssi_pattern = s_ssi_pattern;
-    mg_http_serve_dir(c, hm, &opts);
-    mg_http_parse((char *) c->send.buf, c->send.len, &tmp);
-    cl = mg_http_get_header(&tmp, "Content-Length");
-    if (cl == NULL) cl = &unknown;
-    MG_INFO(("%.*s %.*s %.*s %.*s", (int) hm->method.len, hm->method.ptr,
-             (int) hm->uri.len, hm->uri.ptr, (int) tmp.uri.len, tmp.uri.ptr,
-             (int) cl->len, cl->ptr));
-  }
-  (void) fn_data;
-}
-
-static void usage(const char *prog) {
-  fprintf(stderr,
-          "Mongoose v.%s\n"
-          "Usage: %s OPTIONS\n"
-          "  -H yes|no - enable traffic hexdump, default: '%s'\n"
-          "  -S PAT    - SSI filename pattern, default: '%s'\n"
-          "  -d DIR    - directory to serve, default: '%s'\n"
-          "  -l ADDR   - listening address, default: '%s'\n"
-          "  -v LEVEL  - debug level, from 0 to 4, default: %d\n",
-          MG_VERSION, prog, s_enable_hexdump, s_ssi_pattern, s_root_dir,
-          s_listening_address, s_debug_level);
-  exit(EXIT_FAILURE);
-}
-
-int main(int argc, char *argv[]) {
-  char path[MG_PATH_MAX] = ".";
-  struct mg_mgr mgr;
-  struct mg_connection *c;
-  int i;
-
-  // Parse command-line flags
-  for (i = 1; i < argc; i++) {
-    if (strcmp(argv[i], "-d") == 0) {
-      s_root_dir = argv[++i];
-    } else if (strcmp(argv[i], "-H") == 0) {
-      s_enable_hexdump = argv[++i];
-    } else if (strcmp(argv[i], "-S") == 0) {
-      s_ssi_pattern = argv[++i];
-    } else if (strcmp(argv[i], "-l") == 0) {
-      s_listening_address = argv[++i];
-    } else if (strcmp(argv[i], "-v") == 0) {
-      s_debug_level = atoi(argv[++i]);
-    } else {
-      usage(argv[0]);
-    }
-  }
-
-  // Root directory must not contain double dots. Make it absolute
-  // Do the conversion only if the root dir spec does not contain overrides
-  if (strchr(s_root_dir, ',') == NULL) {
-    realpath(s_root_dir, path);
-    s_root_dir = path;
-  }
-
-  // Initialise stuff
-  signal(SIGINT, signal_handler);
-  signal(SIGTERM, signal_handler);
-  mg_log_set(s_debug_level);
-  mg_mgr_init(&mgr);
-  if ((c = mg_http_listen(&mgr, s_listening_address, cb, &mgr)) == NULL) {
-    MG_ERROR(("Cannot listen on %s. Use http://ADDR:PORT or :PORT",
-              s_listening_address));
-    exit(EXIT_FAILURE);
-  }
-  if (mg_casecmp(s_enable_hexdump, "yes") == 0) c->is_hexdumping = 1;
-
-  // Start infinite event loop
-  MG_INFO(("Mongoose version : v%s", MG_VERSION));
-  MG_INFO(("Listening on     : %s", s_listening_address));
-  MG_INFO(("Web root         : [%s]", s_root_dir));
-  while (s_signo == 0) mg_mgr_poll(&mgr, 1000);
-  mg_mgr_free(&mgr);
-  MG_INFO(("Exiting on signal %d", s_signo));
-  return 0;
-}

examples/http-streaming-client/Makefile

@@ -1,22 +0,0 @@
-PROG ?= example
-CFLAGS ?= -DMG_ENABLE_LINES $(EXTRA)
-
-ifneq ($(MBEDTLS),)
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -I$(MBEDTLS)/include -I/usr/include
-CFLAGS += -L$(MBEDTLS)/lib -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifneq ($(OPENSSL),)
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -I$(OPENSSL)/include
-CFLAGS += -L$(OPENSSL)/lib -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/http-streaming-client/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/http-streaming-client/main.c

@@ -1,70 +0,0 @@
-// Copyright (c) 2021 Cesanta Software Limited
-// All rights reserved
-//
-// Example HTTP client.
-// Instead of buffering the whole HTTP response in memory and wait for the
-// MG_EV_HTTP_MSG event, this client catches MG_EV_HTTP_CHUNK events and
-// prints them. This is useful to download large content without spooling
-// everything to memory, or catch chunked content.
-//
-// You can change `s_url` from the command line by executing: ./example YOUR_URL
-//
-// To enable SSL/TLS for this client, build it like this:
-//    make MBEDTLS=/path/to/your/mbedtls/installation
-//    make OPENSSL=/path/to/your/openssl/installation
-
-#include "mongoose.h"
-
-// The very first web page in history. You can replace it from command line
-static const char *s_url = "http://info.cern.ch";
-
-// Print HTTP response and signal that we're done
-static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  if (ev == MG_EV_CONNECT) {
-    // Connected to server. Extract host name from URL
-    struct mg_str host = mg_url_host(s_url);
-
-    // If s_url is https://, tell client connection to use TLS
-    if (mg_url_is_ssl(s_url)) {
-      struct mg_tls_opts opts = {.ca = "ca.pem", .srvname = host};
-      mg_tls_init(c, &opts);
-    }
-
-    // Send request
-    mg_printf(c,
-              "GET %s HTTP/1.1\r\n"
-              "Connection: keep-alive\r\n"
-              "Keep-Alive: timeout=60\r\n"
-              "Host: %.*s\r\n"
-              "\r\n",
-              mg_url_uri(s_url), (int) host.len, host.ptr);
-  } else if (ev == MG_EV_HTTP_CHUNK) {
-    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
-    fwrite(hm->chunk.ptr, 1, hm->chunk.len, stdout);
-    // fprintf(stderr, "c %u\n", (unsigned) hm->chunk.len);
-    mg_http_delete_chunk(c, hm);
-    if (hm->chunk.len == 0) *(bool *) fn_data = true;  // Last chunk
-  } else if (ev == MG_EV_HTTP_MSG) {
-    // Response is received. Print it
-    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
-    fwrite(hm->body.ptr, 1, hm->body.len, stdout);
-    c->is_closing = 1;         // Tell mongoose to close this connection
-    *(bool *) fn_data = true;  // Tell event loop to stop
-  } else if (ev == MG_EV_ERROR) {
-    *(bool *) fn_data = true;  // Error, tell event loop to stop
-  }
-}
-
-int main(int argc, char *argv[]) {
-  struct mg_mgr mgr;                        // Event manager
-  bool done = false;                        // Event handler flips it to true
-  const char *log_level = getenv("V");      // Log level
-  if (log_level == NULL) log_level = "3";   // If not set, set to DEBUG
-  mg_log_set(atoi(log_level));              // Set to 0 to disable debug log
-  if (argc > 1) s_url = argv[1];            // Use URL from command line
-  mg_mgr_init(&mgr);                        // Initialise event manager
-  mg_http_connect(&mgr, s_url, fn, &done);  // Create client connection
-  while (!done) mg_mgr_poll(&mgr, 1000);    // Infinite event loop
-  mg_mgr_free(&mgr);                        // Free resources
-  return 0;
-}

examples/huge-response/Makefile

@@ -1,11 +0,0 @@
-PROG ?= example
-CFLAGS ?= -W -Wall -Wextra -O0 -g
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall -DMG_ENABLE_LINES=1 $(CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/infineon/infineon-xmc4700_4800-lwip-rtx-rtos/Makefile

@@ -1,9 +0,0 @@
-NAME ?= $(notdir $(CURDIR))
-
-build:
-	git clone --depth 1 https://github.com/mongoose-examples/$(NAME)
-	cp ./../../../mongoose.[ch] $(NAME)
-	make -C $(NAME) build
-
-clean:
-	rm -rf $(NAME)

examples/json-rpc-over-websocket/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) main.c ../../mongoose.c -I../.. -W -Wall -DMG_ENABLE_LINES=1 $(CFLAGS) -o $(PROG)
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/json-rpc-over-websocket/README.md

@@ -1 +0,0 @@
-See detailed tutorial at https://mongoose.ws/tutorials/json-rpc-over-websocket/

examples/live-log/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG)
-
-$(PROG):
-	$(CC) ../../mongoose.c -I../.. $(CFLAGS) $(EXTRA) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt

examples/mip-pcap/Makefile

@@ -1,13 +0,0 @@
-PROG ?= example
-DEFS ?= -DMG_ENABLE_LINES=1 -DMG_ENABLE_MIP=1 -DMG_ENABLE_SOCKET=0 -DMG_ENABLE_WINSOCK=0 -I../..
-CFLAGS ?= -W -Wall
-LIBS ?= -lpcap
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) main.c ../../mongoose.c $(CFLAGS) $(DEFS) -o $(PROG) $(LIBS)
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/mip-pcap/main.c

@@ -1,132 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-//
-// SNTP example using MIP and pcap driver
-
-#include <pcap.h>
-#include "mongoose.h"
-
-static struct mg_connection *s_sntp_conn = NULL;
-
-static int s_signo;
-void signal_handler(int signo) {
-  s_signo = signo;
-}
-
-// SNTP client callback
-static void sfn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  if (ev == MG_EV_SNTP_TIME) {
-    int64_t t = *(int64_t *) ev_data;
-    MG_INFO(("Got SNTP time: %lld ms from epoch", t));
-  } else if (ev == MG_EV_CLOSE) {
-    s_sntp_conn = NULL;
-  }
-  (void) fn_data, (void) c;
-}
-
-// Called every 5 seconds. Increase that for production case.
-static void timer_fn(void *arg) {
-  struct mg_mgr *mgr = (struct mg_mgr *) arg;
-  if (s_sntp_conn == NULL) s_sntp_conn = mg_sntp_connect(mgr, NULL, sfn, NULL);
-  if (s_sntp_conn != NULL) mg_sntp_request(s_sntp_conn);
-}
-
-static int fail(const char *fmt, ...) {
-  va_list ap;
-  va_start(ap, fmt);
-  vfprintf(stderr, fmt, ap);
-  va_end(ap);
-  return EXIT_FAILURE;
-}
-
-static size_t pcap_tx(const void *data, size_t len, void *userdata) {
-  int res = pcap_inject((pcap_t *) userdata, data, len);
-  if (res == PCAP_ERROR) {
-    MG_ERROR(("pcap_inject: %d", res));
-  }
-  return len;
-}
-
-static bool pcap_status(void *userdata) {
-  return userdata ? true : false;
-}
-
-static size_t pcap_rx(void *buf, size_t len, void *userdata) {
-  size_t received = 0;
-  struct pcap_pkthdr *hdr = NULL;
-  const unsigned char *pkt = NULL;
-  if (pcap_next_ex((pcap_t *) userdata, &hdr, &pkt) == 1) {
-    received = hdr->len < len ? hdr->len : len;
-    memcpy(buf, pkt, received);
-  }
-  return received;
-}
-
-int main(int argc, char *argv[]) {
-  const char *iface = "lo0";              // Network iface
-  const char *mac = "aa:bb:cc:01:02:03";  // MAC address
-  const char *bpf = NULL;  // "host x.x.x.x or ether host ff:ff:ff:ff:ff:ff";
-  char errbuf[PCAP_ERRBUF_SIZE] = "";
-
-  struct mg_mgr mgr;        // Event manager
-  mg_mgr_init(&mgr);        // Initialise event manager
-  mg_log_set(MG_LL_DEBUG);  // Set debug log level
-  mg_timer_add(&mgr, 3000, MG_TIMER_REPEAT | MG_TIMER_RUN_NOW, timer_fn, &mgr);
-
-  // Parse options
-  for (int i = 1; i < argc; i++) {
-    if (strcmp(argv[i], "-i") == 0 && i + 1 < argc) {
-      iface = argv[++i];
-    } else if (strcmp(argv[i], "-mac") == 0 && i + 1 < argc) {
-      mac = argv[++i];
-    } else if (strcmp(argv[i], "-bpf") == 0 && i + 1 < argc) {
-      bpf = argv[++i];
-    } else {
-      return fail("unknown option %s", argv[i]);
-    }
-  }
-
-  // Open network interface
-  pcap_t *ph = pcap_open_live(iface, 0xffff, 1, 1, errbuf);
-  if (ph == NULL) {
-    pcap_if_t *devs, *d;
-    MG_ERROR(("Failed to open interface %s. Available interfaces:", iface));
-    if (pcap_findalldevs(&devs, errbuf) == 0) {
-      for (d = devs; d != NULL; d = d->next) {
-        MG_ERROR(("%s (%s)", d->name, d->description ? d->description : ""));
-      }
-      pcap_freealldevs(devs);
-    }
-    fail("pcap_open_live: %s\n", errbuf);
-  }
-  pcap_setnonblock(ph, 1, errbuf);
-  // Apply BPF to reduce noise. Let in only broadcasts and our own traffic
-  if (bpf != NULL) {
-    struct bpf_program bpfp;
-    if (pcap_compile(ph, &bpfp, bpf, 1, 0)) fail("compile \n");
-    pcap_setfilter(ph, &bpfp);
-    pcap_freecode(&bpfp);
-  }
-  MG_INFO(("Opened interface %s\n", iface));
-
-  signal(SIGINT, signal_handler);
-  signal(SIGTERM, signal_handler);
-
-  struct mip_ipcfg ipcfg = {.ip = 0, .mask = 0, .gw = 0};
-  sscanf(mac, "%hhx:%hhx:%hhx:%hhx:%hhx:%hhx", &ipcfg.mac[0], &ipcfg.mac[1],
-         &ipcfg.mac[2], &ipcfg.mac[3], &ipcfg.mac[4], &ipcfg.mac[5]);
-
-  struct mip_driver driver = {
-      .tx = pcap_tx, .status = pcap_status, .rx = pcap_rx};
-
-  mip_init(&mgr, &ipcfg, &driver, ph);
-  MG_INFO(("Init done, starting main loop"));
-
-  while (s_signo == 0) mg_mgr_poll(&mgr, 1);  // Infinite event loop
-
-  mg_mgr_free(&mgr);
-  pcap_close(ph);
-  printf("Exiting on signal %d\n", s_signo);
-
-  return 0;
-}

examples/mqtt-client-aws-iot/Makefile

@@ -1,20 +0,0 @@
-PROG ?= example
-CFLAGS ?= -W -Wall -Wextra -O2
-SSL ?= MBEDTLS
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509 -L$(MBEDTLS)/lib -I$(MBEDTLS)/include
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto -L$(OPENSSL)/lib -I$(OPENSSL)/include
-endif
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) main.c ../../mongoose.c -I../.. $(CFLAGS) $(EXTRA_CFLAGS) -o $(PROG)
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/mqtt-client-aws-iot/README.md

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

examples/mqtt-client-aws-iot/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/mqtt-client/Makefile

@@ -1,20 +0,0 @@
-PROG ?= example
-SSL = ?
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) $(EXTRA_CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/mqtt-client/README.md

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

examples/mqtt-client/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/mqtt-client/main.c

@@ -1,87 +0,0 @@
-// Copyright (c) 2020 Cesanta Software Limited
-// All rights reserved
-//
-// Example MQTT client. It performs the following steps:
-//    1. Connects to the MQTT server specified by `s_url` variable
-//    2. When connected, subscribes to the topic `s_sub_topic`
-//    3. Publishes message `hello` to the `s_pub_topic`
-//    4. Receives that message back from the subscribed topic and closes
-//    5. Timer-based reconnection logic revives the connection when it is down
-//
-// To enable SSL/TLS, make SSL=OPENSSL or make SSL=MBEDTLS 
-
-#include "mongoose.h"
-
-static const char *s_url = "mqtt://broker.hivemq.com:1883";
-static const char *s_sub_topic = "mg/+/test";
-static const char *s_pub_topic = "mg/clnt/test";
-static int s_qos = 1;
-static struct mg_connection *s_conn;
-
-// Handle interrupts, like Ctrl-C
-static int s_signo;
-static void signal_handler(int signo) {
-  s_signo = signo;
-}
-
-static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  if (ev == MG_EV_OPEN) {
-    MG_INFO(("CREATED"));
-    // c->is_hexdumping = 1;
-  } else if (ev == MG_EV_ERROR) {
-    // On error, log error message
-    MG_ERROR(("%p %s", c->fd, (char *) ev_data));
-  } else if (ev == MG_EV_CONNECT) {
-    // If target URL is SSL/TLS, command client connection to use TLS
-    if (mg_url_is_ssl(s_url)) {
-      struct mg_tls_opts opts = {.ca = "ca.pem"};
-      mg_tls_init(c, &opts);
-    }
-  } else if (ev == MG_EV_MQTT_OPEN) {
-    // MQTT connect is successful
-    struct mg_str subt = mg_str(s_sub_topic);
-    struct mg_str pubt = mg_str(s_pub_topic), data = mg_str("hello");
-    MG_INFO(("CONNECTED to %s", s_url));
-    mg_mqtt_sub(c, subt, s_qos);
-    MG_INFO(("SUBSCRIBED to %.*s", (int) subt.len, subt.ptr));
-
-    mg_mqtt_pub(c, pubt, data, s_qos, false);
-    MG_INFO(("PUBLISHED %.*s -> %.*s", (int) data.len, data.ptr,
-             (int) pubt.len, pubt.ptr));
-  } else if (ev == MG_EV_MQTT_MSG) {
-    // When we get echo response, print it
-    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
-    MG_INFO(("RECEIVED %.*s <- %.*s", (int) mm->data.len, mm->data.ptr,
-             (int) mm->topic.len, mm->topic.ptr));
-    c->is_closing = 1;
-  } else if (ev == MG_EV_CLOSE) {
-    MG_INFO(("CLOSED"));
-    s_conn = NULL;  // Mark that we're closed
-  }
-  (void) fn_data;
-}
-
-// Timer function - recreate client connection if it is closed
-static void timer_fn(void *arg) {
-  struct mg_mgr *mgr = (struct mg_mgr *) arg;
-  struct mg_mqtt_opts opts = {.clean = true,
-                              .will_qos = s_qos,
-                              .will_topic = mg_str(s_pub_topic),
-                              .will_message = mg_str("goodbye")};
-  if (s_conn == NULL) s_conn = mg_mqtt_connect(mgr, s_url, &opts, fn, NULL);
-}
-
-int main(void) {
-  struct mg_mgr mgr;
-  int topts = MG_TIMER_REPEAT | MG_TIMER_RUN_NOW;
-
-  signal(SIGINT, signal_handler);   // Setup signal handlers - exist event
-  signal(SIGTERM, signal_handler);  // manager loop on SIGINT and SIGTERM
-
-  mg_mgr_init(&mgr);                                // Init event manager
-  mg_timer_add(&mgr, 3000, topts, timer_fn, &mgr);  // Init timer
-  while (s_signo == 0) mg_mgr_poll(&mgr, 1000);     // Event loop, 1s timeout
-  mg_mgr_free(&mgr);                                // Finished, cleanup
-
-  return 0;
-}

examples/mqtt-over-ws-client/Makefile

@@ -1,20 +0,0 @@
-PROG ?= example
-SSL = ?
-
-ifeq "$(SSL)" "MBEDTLS"
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-ifeq "$(SSL)" "OPENSSL"
-CFLAGS += -DMG_ENABLE_OPENSSL=1 -lssl -lcrypto
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) $(EXTRA_CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/mqtt-over-ws-client/ca.pem

@@ -1 +0,0 @@
-../../test/data/ca.pem

examples/mqtt-server/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall -DMG_ENABLE_LINES=1 $(CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/mqtt-server/README.md

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

examples/multi-threaded/Makefile

@@ -1,17 +0,0 @@
-PROG ?= example
-ROOT ?= $(realpath $(CURDIR)/../..)
-CWD ?= $(realpath $(CURDIR))
-DOCKER ?= docker run --rm -it -e Tmp=. -e WINEDEBUG=-all -v $(ROOT):$(ROOT) -w $(CWD)
-
-all: $(PROG)
-	$(RUN) ./$(PROG)
-
-$(PROG):
-	$(CC) ../../mongoose.c -I../.. -pthread $(CFLAGS) -o $(PROG) main.c
-
-$(PROG).exe:
-	$(DOCKER) mdashnet/vc98 wine cl ../../mongoose.c main.c -I../.. /MD ws2_32.lib /Fe$@
-	$(DOCKER) mdashnet/vc98 wine $@
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb log.txt

examples/multi-threaded/main.c

@@ -1,102 +0,0 @@
-// Copyright (c) 2020 Cesanta Software Limited
-// All rights reserved
-//
-// Multithreading example.
-// For each incoming request, we spawn a separate thread, that sleeps for
-// some time to simulate long processing time, produces an output and
-// hands over that output to the request handler function.
-//
-
-#include "mongoose.h"
-
-static void start_thread(void (*f)(void *), void *p) {
-#ifdef _WIN32
-  _beginthread((void(__cdecl *)(void *)) f, 0, p);
-#else
-#define closesocket(x) close(x)
-#include <pthread.h>
-  pthread_t thread_id = (pthread_t) 0;
-  pthread_attr_t attr;
-  (void) pthread_attr_init(&attr);
-  (void) pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);
-  pthread_create(&thread_id, &attr, (void *(*) (void *) ) f, p);
-  pthread_attr_destroy(&attr);
-#endif
-}
-
-struct userdata {
-  int sock;  // Paired socket, worker thread owns it
-  struct mg_str
-      body;  // data to be processed
-};
-
-static void thread_function(void *param) {
-  struct userdata *p = (struct userdata *) param;
-  sleep(2);  // Simulate long execution
-  // Respond, wakeup event manager
-  if (p->body.len)
-    send(p->sock, p->body.ptr, p->body.len, 0);  // if there is a body, echo it
-  else
-    send(p->sock, "hi", 2, 0);  // otherwise just respond "hi"
-  close(p->sock);               // Close the connection
-  free((void *) p->body.ptr);   // free body
-  free(p);                      // free userdata
-}
-
-static void link_conns(struct mg_connection *c1, struct mg_connection *c2) {
-  c1->fn_data = c2;
-  c2->fn_data = c1;
-}
-
-static void unlink_conns(struct mg_connection *c1, struct mg_connection *c2) {
-  c1->fn_data = c2->fn_data = NULL;
-}
-
-// Pipe event handler
-static void pcb(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  struct mg_connection *parent = (struct mg_connection *) fn_data;
-  MG_INFO(("%lu %p %d %p", c->id, c->fd, ev, parent));
-  if (parent == NULL) {  // If parent connection closed, close too
-    c->is_closing = 1;
-  } else if (ev == MG_EV_READ) {  // Got data from the worker thread
-    mg_http_reply(parent, 200, "Host: foo.com\r\n", "%.*s\n", c->recv.len,
-                  c->recv.buf);  // Respond!
-    c->recv.len = 0;             // Tell Mongoose we've consumed data
-  } else if (ev == MG_EV_OPEN) {
-    link_conns(c, parent);
-  } else if (ev == MG_EV_CLOSE) {
-    unlink_conns(c, parent);
-  }
-}
-
-// HTTP request callback
-static void 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;
-    if (mg_http_match_uri(hm, "/fast")) {
-      // Single-threaded code path, for performance comparison
-      // The /fast URI responds immediately
-      mg_http_reply(c, 200, "Host: foo.com\r\n", "hi\n");
-    } else {
-      // Multithreading code path
-      struct userdata *data = calloc(1, sizeof(*data));  // worker will free it
-      // parse headers or use request body, duplicate data and pass it to worker
-      // thread
-      data->body = mg_strdup(hm->body);              // worker will free it
-      data->sock = mg_mkpipe(c->mgr, pcb, c, true);  // Create pipe
-      start_thread(thread_function, data);  // Start thread and pass data
-    }
-  } else if (ev == MG_EV_CLOSE) {
-    if (c->fn_data != NULL) unlink_conns(c, c->fn_data);
-  }
-}
-
-int main(void) {
-  struct mg_mgr mgr;
-  mg_mgr_init(&mgr);
-  mg_log_set(MG_LL_DEBUG);  // Set debug log level
-  mg_http_listen(&mgr, "http://localhost:8000", fn, NULL);  // Create listener
-  for (;;) mg_mgr_poll(&mgr, 1000);                         // Event loop
-  mg_mgr_free(&mgr);                                        // Cleanup
-  return 0;
-}

examples/sntp-time-sync/Makefile

@@ -1,10 +0,0 @@
-PROG ?= example
-
-all: $(PROG)
-	$(RUN) ./$(PROG) $(ARGS)
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall -DMG_ENABLE_LINES=1 $(CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/socks5-server/Makefile

@@ -1,19 +0,0 @@
-PROG ?= example
-CFLAGS ?= -DMG_ENABLE_LINES $(CFLAGS_EXTRA)
-MBEDTLS_DIR ?=
-
-ifeq "$(MBEDTLS_DIR)" ""
-else
-CFLAGS += -DMG_ENABLE_MBEDTLS=1 -I$(MBEDTLS_DIR)/include -I/usr/include
-CFLAGS += -L$(MBEDTLS_DIR)/lib -lmbedtls -lmbedcrypto -lmbedx509
-endif
-
-all: $(PROG)
-	$(DEBUGGER) ./$(PROG) $(ARGS)
-
-
-$(PROG): main.c
-	$(CC) ../../mongoose.c -I../.. -W -Wall $(CFLAGS) -o $(PROG) main.c
-
-clean:
-	rm -rf $(PROG) *.o *.dSYM *.gcov *.gcno *.gcda *.obj *.exe *.ilk *.pdb

examples/stm32/nucleo-f746zg-baremetal/Makefile

@@ -1,42 +0,0 @@
-TARGET  = firmware
-ROOT    ?= $(realpath $(CURDIR)/../../..)
-D ?= docker
-DOCKER 	?= $(D) run --rm -v $(ROOT):$(ROOT) -w $(CURDIR) mdashnet/armgcc
-CROSS   ?= arm-none-eabi
-CFLAGS  ?=  -W -Wall -Wextra -Werror -Wundef -Wshadow -Wdouble-promotion \
-						-Wformat-truncation -fno-common -Wconversion \
-						-g3 -Os -ffunction-sections -fdata-sections -I. -I$(ROOT) \
-            -DMG_ARCH=MG_ARCH_NEWLIB -DMIP_DEBUG=1 -DMG_ENABLE_PACKED_FS=1 \
-						-DMG_ENABLE_CUSTOM_MILLIS=1 -DxMG_ENABLE_LINES=1 -DMG_ENABLE_MIP=1 \
-						-mcpu=cortex-m7 -mthumb -mfloat-abi=soft $(EXTRA_CFLAGS)
-LDFLAGS ?= -Tlink.ld -nostartfiles -nostdlib --specs nano.specs -lc -lgcc -Wl,--gc-sections -Wl,-Map=$@.map
-SOURCES = boot.c main.c syscalls.c \
-          $(ROOT)/mongoose.c \
-          $(ROOT)/examples/device-dashboard/packed_fs.c \
-          $(ROOT)/examples/device-dashboard/net.c
-
-all build example: $(TARGET).bin
-
-$(TARGET).bin: $(TARGET).elf
-	$(DOCKER) $(CROSS)-objcopy -O binary $< $@
-
-$(TARGET).elf: $(SOURCES) mcu.h
-	$(DOCKER) $(CROSS)-gcc $(SOURCES) $(CFLAGS) $(LDFLAGS) -o $@
-
-# Build on Windows. Download Win32 Zip from ARM GCC downloads, unzip to c:\armgcc
-ARMGCC ?= c:/armgcc
-windows: $(TARGET).bin
-windows: CROSS = $(ARMGCC)/bin/arm-none-eabi
-windows: DOCKER =
-
-# Show top 10 stack-hungry functions
-su: CFLAGS += -fstack-usage
-su: $(TARGET).elf
-	cat *.su | sort -rnk2 | head -10
-
-# Note: on "unknown chip id" flash error, wire BOOT0 to VDD and st-flash erase
-flash: $(TARGET).bin
-	st-flash --reset write $(TARGET).bin 0x8000000
-
-clean:
-	@rm -rf $(TARGET).* *.su

examples/stm32/nucleo-f746zg-baremetal/README.md

@@ -1,58 +0,0 @@
-# Baremetal webserver on NUCLEO-F746ZG
-
-This firmware uses experimental TCP/IP stack of the Mongoose Network Library,
-which implements the following:
-
-- Implements HTTP server and SNTP time synchronisation
-- No dependencies: no HAL, no CMSIS, no RTOS
-- Hand-written [mcu.h](mcu.h) header based on a [datasheet](https://www.st.com/resource/en/reference_manual/rm0385-stm32f75xxx-and-stm32f74xxx-advanced-armbased-32bit-mcus-stmicroelectronics.pdf)
-- Interrupt-driven [driver_stm32.c](../../../mip/driver_stm32.c) ethernet driver
-- Blue LED blinky, based on SysTick interrupt
-- User button handler, turns off/on green LED, based on EXTI, interrupt-driven 
-- HardFault handler that blinks red LED
-- Debug log on UART3 (st-link)
-
-## Requirements
-
-- GNU make
-- [ARM GCC](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm) toolchain for build
-- [st-link](https://github.com/stlink-org/stlink) for flashing
-
-## Usage
-
-Plugin your Nucleo board into USB, and attach an Ethernet cable.
-To build and flash:
-
-```sh
-$ make clean flash
-```
-
-To see debug log, use any serial monitor program like `picocom` at 115200 bps and configure it to insert carriage returns after line feeds:
-
-```sh
-$ picocom /dev/ttyACM0 -i -b 115200 --imap=lfcrlf
-```
-
-## Benchmark
-
-A quick comparison is made with several other implementations.
-Note: `IP` in the table below is the IP address printed on the console after
-boot. The benchmark command is the same: `siege -c 5 -t 5s http://IP`
-
-|                     | Zephyr   | LWIP sockets | LWIP raw | MIP  |
-| ------------------- | -------- | ------------ | -------- | ---- |
-| Requests per second | 3        | 16           | 286      | 1080 |
-| Firmware size       | 117k (*) | 160k         | 114k     | 28k  |
-
-- Zephyr: uses Zehypr's RTOS and TCP stack, with Mongoose library on top,
-  [source code](https://github.com/cesanta/mongoose/tree/master/examples/zephyr/http-server).
-  (*) By default, Zephyr example is TLS-enabled. To compare sizes, a TLS-disabled
-  build was done by disabling TLS in `prj.conf` and `CMakeLists.txt`
-- LWIP sockets: uses FreeRTOS and LWIP with sockets support, with Mongoose
-  library on top, [source code](https://github.com/mongoose-examples/stm32-nucleo-f746z).
-  built with `#define MG` in `Core/main.c`
-- LWIP raw: uses FreeRTOS and LWIP without sockets, LWIP's httpd server,
-  [source code](https://github.com/mongoose-examples/stm32-nucleo-f746z).
-  built with `#define MG` line commented out in `Core/main.c`
-- MIP: this repository
-

examples/stm32/nucleo-f746zg-baremetal/boot.c

@@ -1,171 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-
-// Startup code
-__attribute__((naked, noreturn)) void _reset(void) {
-  // Init stack
-  asm("ldr sp, = _estack");
-
-  // Initialise memory
-  extern long _sbss, _ebss, _sdata, _edata, _sidata;
-  for (long *src = &_sbss; src < &_ebss; src++) *src = 0;
-  for (long *src = &_sdata, *dst = &_sidata; src < &_edata;) *src++ = *dst++;
-
-  // Call main()
-  extern void main(void);
-  main();
-  for (;;) (void) 0;
-}
-
-void __attribute__((weak)) DefaultIRQHandler(void) {
-  for (;;) (void) 0;
-}
-
-#define WEAK_ALIAS __attribute__((weak, alias("DefaultIRQHandler")))
-
-WEAK_ALIAS void NMI_Handler(void);
-WEAK_ALIAS void HardFault_Handler(void);
-WEAK_ALIAS void MemManage_Handler(void);
-WEAK_ALIAS void BusFault_Handler(void);
-WEAK_ALIAS void UsageFault_Handler(void);
-WEAK_ALIAS void SVC_Handler(void);
-WEAK_ALIAS void DebugMon_Handler(void);
-WEAK_ALIAS void PendSV_Handler(void);
-WEAK_ALIAS void SysTick_Handler(void);
-
-WEAK_ALIAS void WWDG_IRQHandler(void);
-WEAK_ALIAS void PVD_IRQHandler(void);
-WEAK_ALIAS void TAMP_STAMP_IRQHandler(void);
-WEAK_ALIAS void RTC_WKUP_IRQHandler(void);
-WEAK_ALIAS void FLASH_IRQHandler(void);
-WEAK_ALIAS void RCC_IRQHandler(void);
-WEAK_ALIAS void EXTI0_IRQHandler(void);
-WEAK_ALIAS void EXTI1_IRQHandler(void);
-WEAK_ALIAS void EXTI2_IRQHandler(void);
-WEAK_ALIAS void EXTI3_IRQHandler(void);
-WEAK_ALIAS void EXTI4_IRQHandler(void);
-WEAK_ALIAS void EXTI9_5_IRQHandler(void);
-WEAK_ALIAS void EXTI15_10_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream0_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream1_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream2_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream3_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream4_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream5_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream6_IRQHandler(void);
-WEAK_ALIAS void ADC_IRQHandler(void);
-WEAK_ALIAS void CAN1_TX_IRQHandler(void);
-WEAK_ALIAS void CAN1_RX0_IRQHandler(void);
-WEAK_ALIAS void CAN1_RX1_IRQHandler(void);
-WEAK_ALIAS void CAN1_SCE_IRQHandler(void);
-WEAK_ALIAS void TIM1_BRK_TIM9_IRQHandler(void);
-WEAK_ALIAS void TIM1_UP_TIM10_IRQHandler(void);
-WEAK_ALIAS void TIM1_TRG_COM_TIM11_IRQHandler(void);
-WEAK_ALIAS void TIM1_CC_IRQHandler(void);
-WEAK_ALIAS void TIM2_IRQHandler(void);
-WEAK_ALIAS void TIM3_IRQHandler(void);
-WEAK_ALIAS void TIM4_IRQHandler(void);
-WEAK_ALIAS void I2C1_EV_IRQHandler(void);
-WEAK_ALIAS void I2C1_ER_IRQHandler(void);
-WEAK_ALIAS void I2C2_EV_IRQHandler(void);
-WEAK_ALIAS void I2C2_ER_IRQHandler(void);
-WEAK_ALIAS void SPI1_IRQHandler(void);
-WEAK_ALIAS void SPI2_IRQHandler(void);
-WEAK_ALIAS void USART1_IRQHandler(void);
-WEAK_ALIAS void USART2_IRQHandler(void);
-WEAK_ALIAS void USART3_IRQHandler(void);
-WEAK_ALIAS void RTC_Alarm_IRQHandler(void);
-WEAK_ALIAS void OTG_FS_WKUP_IRQHandler(void);
-WEAK_ALIAS void TIM8_BRK_TIM12_IRQHandler(void);
-WEAK_ALIAS void TIM8_UP_TIM13_IRQHandler(void);
-WEAK_ALIAS void TIM8_TRG_COM_TIM14_IRQHandler(void);
-WEAK_ALIAS void TIM8_CC_IRQHandler(void);
-WEAK_ALIAS void DMA1_Stream7_IRQHandler(void);
-WEAK_ALIAS void FMC_IRQHandler(void);
-WEAK_ALIAS void SDMMC1_IRQHandler(void);
-WEAK_ALIAS void TIM5_IRQHandler(void);
-WEAK_ALIAS void SPI3_IRQHandler(void);
-WEAK_ALIAS void UART4_IRQHandler(void);
-WEAK_ALIAS void UART5_IRQHandler(void);
-WEAK_ALIAS void TIM6_DAC_IRQHandler(void);
-WEAK_ALIAS void TIM7_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream0_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream1_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream2_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream3_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream4_IRQHandler(void);
-WEAK_ALIAS void ETH_IRQHandler(void);
-WEAK_ALIAS void ETH_WKUP_IRQHandler(void);
-WEAK_ALIAS void CAN2_TX_IRQHandler(void);
-WEAK_ALIAS void CAN2_RX0_IRQHandler(void);
-WEAK_ALIAS void CAN2_RX1_IRQHandler(void);
-WEAK_ALIAS void CAN2_SCE_IRQHandler(void);
-WEAK_ALIAS void OTG_FS_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream5_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream6_IRQHandler(void);
-WEAK_ALIAS void DMA2_Stream7_IRQHandler(void);
-WEAK_ALIAS void USART6_IRQHandler(void);
-WEAK_ALIAS void I2C3_EV_IRQHandler(void);
-WEAK_ALIAS void I2C3_ER_IRQHandler(void);
-WEAK_ALIAS void OTG_HS_EP1_OUT_IRQHandler(void);
-WEAK_ALIAS void OTG_HS_EP1_IN_IRQHandler(void);
-WEAK_ALIAS void OTG_HS_WKUP_IRQHandler(void);
-WEAK_ALIAS void OTG_HS_IRQHandler(void);
-WEAK_ALIAS void DCMI_IRQHandler(void);
-WEAK_ALIAS void RNG_IRQHandler(void);
-WEAK_ALIAS void FPU_IRQHandler(void);
-WEAK_ALIAS void UART7_IRQHandler(void);
-WEAK_ALIAS void UART8_IRQHandler(void);
-WEAK_ALIAS void SPI4_IRQHandler(void);
-WEAK_ALIAS void SPI5_IRQHandler(void);
-WEAK_ALIAS void SPI6_IRQHandler(void);
-WEAK_ALIAS void SAI1_IRQHandler(void);
-WEAK_ALIAS void LTDC_IRQHandler(void);
-WEAK_ALIAS void LTDC_ER_IRQHandler(void);
-WEAK_ALIAS void DMA2D_IRQHandler(void);
-WEAK_ALIAS void SAI2_IRQHandler(void);
-WEAK_ALIAS void QUADSPI_IRQHandler(void);
-WEAK_ALIAS void LPTIM1_IRQHandler(void);
-WEAK_ALIAS void CEC_IRQHandler(void);
-WEAK_ALIAS void I2C4_EV_IRQHandler(void);
-WEAK_ALIAS void I2C4_ER_IRQHandler(void);
-WEAK_ALIAS void SPDIF_RX_IRQHandler(void);
-
-// IRQ table
-__attribute__((section(".vectors"))) void (*tab[16 + 98])(void) = {
-    // Cortex interrupts
-    0, _reset, NMI_Handler, HardFault_Handler, MemManage_Handler,
-    BusFault_Handler, UsageFault_Handler, 0, 0, 0, 0, SVC_Handler,
-    DebugMon_Handler, 0, PendSV_Handler, SysTick_Handler,
-
-    // Interrupts from peripherals
-    WWDG_IRQHandler, PVD_IRQHandler, TAMP_STAMP_IRQHandler, RTC_WKUP_IRQHandler,
-    FLASH_IRQHandler, RCC_IRQHandler, EXTI0_IRQHandler, EXTI1_IRQHandler,
-    EXTI2_IRQHandler, EXTI3_IRQHandler, EXTI4_IRQHandler,
-    DMA1_Stream0_IRQHandler, DMA1_Stream1_IRQHandler, DMA1_Stream2_IRQHandler,
-    DMA1_Stream3_IRQHandler, DMA1_Stream4_IRQHandler, DMA1_Stream5_IRQHandler,
-    DMA1_Stream6_IRQHandler, ADC_IRQHandler, CAN1_TX_IRQHandler,
-    CAN1_RX0_IRQHandler, CAN1_RX1_IRQHandler, CAN1_SCE_IRQHandler,
-    EXTI9_5_IRQHandler, TIM1_BRK_TIM9_IRQHandler, TIM1_UP_TIM10_IRQHandler,
-    TIM1_TRG_COM_TIM11_IRQHandler, TIM1_CC_IRQHandler, TIM2_IRQHandler,
-    TIM3_IRQHandler, TIM4_IRQHandler, I2C1_EV_IRQHandler, I2C1_ER_IRQHandler,
-    I2C2_EV_IRQHandler, I2C2_ER_IRQHandler, SPI1_IRQHandler, SPI2_IRQHandler,
-    USART1_IRQHandler, USART2_IRQHandler, USART3_IRQHandler,
-    EXTI15_10_IRQHandler, RTC_Alarm_IRQHandler, OTG_FS_WKUP_IRQHandler,
-    TIM8_BRK_TIM12_IRQHandler, TIM8_UP_TIM13_IRQHandler,
-    TIM8_TRG_COM_TIM14_IRQHandler, TIM8_CC_IRQHandler, DMA1_Stream7_IRQHandler,
-    FMC_IRQHandler, SDMMC1_IRQHandler, TIM5_IRQHandler, SPI3_IRQHandler,
-    UART4_IRQHandler, UART5_IRQHandler, TIM6_DAC_IRQHandler, TIM7_IRQHandler,
-    DMA2_Stream0_IRQHandler, DMA2_Stream1_IRQHandler, DMA2_Stream2_IRQHandler,
-    DMA2_Stream3_IRQHandler, DMA2_Stream4_IRQHandler, ETH_IRQHandler,
-    ETH_WKUP_IRQHandler, CAN2_TX_IRQHandler, CAN2_RX0_IRQHandler,
-    CAN2_RX1_IRQHandler, CAN2_SCE_IRQHandler, OTG_FS_IRQHandler,
-    DMA2_Stream5_IRQHandler, DMA2_Stream6_IRQHandler, DMA2_Stream7_IRQHandler,
-    USART6_IRQHandler, I2C3_EV_IRQHandler, I2C3_ER_IRQHandler,
-    OTG_HS_EP1_OUT_IRQHandler, OTG_HS_EP1_IN_IRQHandler, OTG_HS_WKUP_IRQHandler,
-    OTG_HS_IRQHandler, DCMI_IRQHandler, 0, RNG_IRQHandler, FPU_IRQHandler,
-    UART7_IRQHandler, UART8_IRQHandler, SPI4_IRQHandler, SPI5_IRQHandler,
-    SPI6_IRQHandler, SAI1_IRQHandler, LTDC_IRQHandler, LTDC_ER_IRQHandler,
-    DMA2D_IRQHandler, SAI2_IRQHandler, QUADSPI_IRQHandler, LPTIM1_IRQHandler,
-    CEC_IRQHandler, I2C4_EV_IRQHandler, I2C4_ER_IRQHandler,
-    SPDIF_RX_IRQHandler};

examples/stm32/nucleo-f746zg-baremetal/main.c

@@ -1,82 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-
-#include "mcu.h"
-#include "mongoose.h"
-
-#define LED1 PIN('B', 0)   // On-board LED pin (green)
-#define LED2 PIN('B', 7)   // On-board LED pin (blue)
-#define LED3 PIN('B', 14)  // On-board LED pin (red)
-#define BTN1 PIN('C', 13)  // On-board user button
-
-static uint64_t s_ticks, s_exti;  // Counters, increased by IRQ handlers
-
-static void blink_cb(void *arg) {  // Blink periodically
-  // MG_INFO(("ticks: %u", (unsigned) s_ticks));
-  gpio_toggle(LED2);
-  (void) arg;
-}
-
-uint64_t mg_millis(void) {  // Declare our own uptime function
-  return s_ticks;           // Return number of milliseconds since boot
-}
-
-void HardFault_Handler(void) {                // Escalated fault handler
-  gpio_output(LED3);                          // Setup red LED
-  for (;;) spin(2999999), gpio_toggle(LED3);  // Blink LED infinitely
-}
-
-void SysTick_Handler(void) {  // SyStick IRQ handler, triggered every 1ms
-  s_ticks++;
-}
-
-void EXTI15_10_IRQHandler(void) {  // External interrupt handler
-  s_exti++;
-  if (EXTI->PR & BIT(PINNO(BTN1))) EXTI->PR = BIT(PINNO(BTN1));
-  gpio_write(LED1, gpio_read(BTN1));  // No debounce. Turn LED if button pressed
-}
-
-int main(void) {
-  static struct uart *uart = UART3;  // Use UART3 - its attached to debug
-  clock_init();                      // Set clock to 216MHz
-  systick_init(FREQ / 1000);         // Increment s_ticks every ms
-  gpio_output(LED1);                 // Setup green LED
-  gpio_output(LED2);                 // Setup blue LED
-  gpio_input(BTN1);                  // Set button to input
-  irq_exti_attach(BTN1);             // Attach BTN1 to exti
-  uart_init(uart, 115200);           // It is wired to the debug port
-
-  // Initialise Ethernet. Enable MAC GPIO pins, see
-  // https://www.farnell.com/datasheets/2014265.pdf section 6.10
-  uint16_t pins[] = {PIN('A', 1),  PIN('A', 2),  PIN('A', 7),
-                     PIN('B', 13), PIN('C', 1),  PIN('C', 4),
-                     PIN('C', 5),  PIN('G', 11), PIN('G', 13)};
-  for (size_t i = 0; i < sizeof(pins) / sizeof(pins[0]); i++) {
-    gpio_init(pins[i], GPIO_MODE_AF, GPIO_OTYPE_PUSH_PULL, GPIO_SPEED_INSANE,
-              GPIO_PULL_NONE, 11);
-  }
-  nvic_enable_irq(61);                          // Setup Ethernet IRQ handler
-  RCC->APB2ENR |= BIT(14);                      // Enable SYSCFG
-  SYSCFG->PMC |= BIT(23);                       // Use RMII. Goes first!
-  RCC->AHB1ENR |= BIT(25) | BIT(26) | BIT(27);  // Enable Ethernet clocks
-  RCC->AHB1RSTR |= BIT(25);                     // ETHMAC force reset
-  RCC->AHB1RSTR &= ~BIT(25);                    // ETHMAC release reset
-
-  struct mg_mgr mgr;        // Initialise Mongoose event manager
-  mg_mgr_init(&mgr);        // and attach it to the MIP interface
-  mg_log_set(MG_LL_DEBUG);  // Set log level
-  mg_timer_add(&mgr, 500, MG_TIMER_REPEAT, blink_cb, &mgr);
-
-  // Initialise Mongoose network stack
-  // Specify MAC address, and use 0 for IP, mask, GW - i.e. use DHCP
-  // For static configuration, specify IP/mask/GW in network byte order
-  struct mip_ipcfg c = {.mac = {0, 0, 1, 2, 3, 4}, .ip = 0, .mask = 0, .gw = 0};
-  mip_init(&mgr, &c, &mip_driver_stm32, NULL);
-  MG_INFO(("Init done, starting main loop"));
-
-  extern void device_dashboard_fn(struct mg_connection *, int, void *, void *);
-  mg_http_listen(&mgr, "http://0.0.0.0", device_dashboard_fn, &mgr);
-  for (;;) mg_mgr_poll(&mgr, 0);  // Infinite event loop
-
-  return 0;
-}

examples/stm32/nucleo-f746zg-baremetal/mcu.h

@@ -1,212 +0,0 @@
-// Copyright (c) 2022 Cesanta Software Limited
-// All rights reserved
-// https://www.st.com/resource/en/reference_manual/dm00124865-stm32f75xxx-and-stm32f74xxx-advanced-arm-based-32-bit-mcus-stmicroelectronics.pdf
-
-#pragma once
-
-#include <stdbool.h>
-#include <stdint.h>
-#include <stdio.h>
-#include <string.h>
-
-#define BIT(x) (1UL << (x))
-#define SETBITS(R, CLEARMASK, SETMASK) (R) = ((R) & ~(CLEARMASK)) | (SETMASK)
-#define PIN(bank, num) ((((bank) - 'A') << 8) | (num))
-#define PINNO(pin) (pin & 255)
-#define PINBANK(pin) (pin >> 8)
-
-// System clock
-enum { APB1_PRE = 5 /* AHB clock / 4*/, APB2_PRE = 4 /* AHB clock / 2 */ };
-enum { PLL_HSI = 16, PLL_M = 8, PLL_N = 216, PLL_P = 2 };  // Run at 216 Mhz
-//#define PLL_FREQ PLL_HSI
-#define PLL_FREQ (PLL_HSI * PLL_N / PLL_M / PLL_P)
-#define FREQ (PLL_FREQ * 1000000)
-
-static inline void spin(volatile uint32_t count) {
-  while (count--) asm("nop");
-}
-
-struct rcc {
-  volatile uint32_t CR, PLLCFGR, CFGR, CIR, AHB1RSTR, AHB2RSTR, AHB3RSTR,
-      RESERVED0, APB1RSTR, APB2RSTR, RESERVED1[2], AHB1ENR, AHB2ENR, AHB3ENR,
-      RESERVED2, APB1ENR, APB2ENR, RESERVED3[2], AHB1LPENR, AHB2LPENR,
-      AHB3LPENR, RESERVED4, APB1LPENR, APB2LPENR, RESERVED5[2], BDCR, CSR,
-      RESERVED6[2], SSCGR, PLLI2SCFGR, PLLSAICFGR, DCKCFGR1, DCKCFGR2;
-};
-#define RCC ((struct rcc *) 0x40023800)
-
-struct pwr {
-  volatile uint32_t CR1, CSR1, CR2, CSR2;
-};
-#define PWR ((struct pwr *) 0x40007000)
-
-struct nvic {
-  volatile uint32_t ISER[8], RESERVED0[24], ICER[8], RSERVED1[24], ISPR[8],
-      RESERVED2[24], ICPR[8], RESERVED3[24], IABR[8], RESERVED4[56], IP[240],
-      RESERVED5[644], STIR;
-};
-#define NVIC ((struct nvic *) 0xe000e100)
-static inline void nvic_set_prio(int irq, uint32_t prio) {
-  NVIC->IP[irq] = prio << 4;
-}
-static inline void nvic_enable_irq(int irq) {
-  NVIC->ISER[irq >> 5] = (uint32_t) (1 << (irq & 31));
-}
-
-struct systick {
-  volatile uint32_t CTRL, LOAD, VAL, CALIB;
-};
-#define SYSTICK ((struct systick *) 0xe000e010)  // 2.2.2
-static inline void systick_init(uint32_t ticks) {
-  if ((ticks - 1) > 0xffffff) return;  // Systick timer is 24 bit
-  SYSTICK->LOAD = ticks - 1;
-  SYSTICK->VAL = 0;
-  SYSTICK->CTRL = BIT(0) | BIT(1) | BIT(2);  // Enable systick
-  RCC->APB2ENR |= BIT(14);                   // Enable SYSCFG
-}
-
-struct flash {
-  volatile uint32_t ACR, KEYR, OPTKEYR, SR, CR, AR, RESERVED, OBR, WRPR;
-};
-#define FLASH ((struct flash *) 0x40023c00)
-
-struct scb {
-  volatile uint32_t CPUID, ICSR, VTOR, AIRCR, SCR, CCR, SHPR[3], SHCSR, CFSR,
-      HFSR, DFSR, MMFAR, BFAR, AFSR, ID_PFR[2], ID_DFR, ID_AFR, ID_MFR[4],
-      ID_ISAR[5], RESERVED0[1], CLIDR, CTR, CCSIDR, CSSELR, CPACR,
-      RESERVED3[93], STIR, RESERVED4[15], MVFR0, MVFR1, MVFR2, RESERVED5[1],
-      ICIALLU, RESERVED6[1], ICIMVAU, DCIMVAC, DCISW, DCCMVAU, DCCMVAC, DCCSW,
-      DCCIMVAC, DCCISW, RESERVED7[6], ITCMCR, DTCMCR, AHBPCR, CACR, AHBSCR,
-      RESERVED8[1], ABFSR;
-};
-#define SCB ((struct scb *) 0xe000e000)
-
-enum { GPIO_MODE_INPUT, GPIO_MODE_OUTPUT, GPIO_MODE_AF, GPIO_MODE_ANALOG };
-enum { GPIO_OTYPE_PUSH_PULL, GPIO_OTYPE_OPEN_DRAIN };
-enum { GPIO_SPEED_LOW, GPIO_SPEED_MEDIUM, GPIO_SPEED_HIGH, GPIO_SPEED_INSANE };
-enum { GPIO_PULL_NONE, GPIO_PULL_UP, GPIO_PULL_DOWN };
-
-struct gpio {
-  volatile uint32_t MODER, OTYPER, OSPEEDR, PUPDR, IDR, ODR, BSRR, LCKR, AFR[2];
-};
-#define GPIO(N) ((struct gpio *) (0x40020000 + 0x400 * (N)))
-
-static struct gpio *gpio_bank(uint16_t pin) {
-  return GPIO(PINBANK(pin));
-}
-static inline void gpio_toggle(uint16_t pin) {
-  struct gpio *gpio = gpio_bank(pin);
-  uint32_t mask = BIT(PINNO(pin));
-  gpio->BSRR |= mask << (gpio->ODR & mask ? 16 : 0);
-}
-static inline int gpio_read(uint16_t pin) {
-  return gpio_bank(pin)->IDR & BIT(PINNO(pin)) ? 1 : 0;
-}
-static inline void gpio_write(uint16_t pin, bool val) {
-  struct gpio *gpio = gpio_bank(pin);
-  gpio->BSRR |= BIT(PINNO(pin)) << (val ? 0 : 16);
-}
-static inline void gpio_init(uint16_t pin, uint8_t mode, uint8_t type,
-                             uint8_t speed, uint8_t pull, uint8_t af) {
-  struct gpio *gpio = gpio_bank(pin);
-  uint8_t n = (uint8_t) (PINNO(pin));
-  RCC->AHB1ENR |= BIT(PINBANK(pin));  // Enable GPIO clock
-  SETBITS(gpio->OTYPER, 1UL << n, ((uint32_t) type) << n);
-  SETBITS(gpio->OSPEEDR, 3UL << (n * 2), ((uint32_t) speed) << (n * 2));
-  SETBITS(gpio->PUPDR, 3UL << (n * 2), ((uint32_t) pull) << (n * 2));
-  SETBITS(gpio->AFR[n >> 3], 15UL << ((n & 7) * 4),
-          ((uint32_t) af) << ((n & 7) * 4));
-  SETBITS(gpio->MODER, 3UL << (n * 2), ((uint32_t) mode) << (n * 2));
-}
-static inline void gpio_input(uint16_t pin) {
-  gpio_init(pin, GPIO_MODE_INPUT, GPIO_OTYPE_PUSH_PULL, GPIO_SPEED_HIGH,
-            GPIO_PULL_NONE, 0);
-}
-static inline void gpio_output(uint16_t pin) {
-  gpio_init(pin, GPIO_MODE_OUTPUT, GPIO_OTYPE_PUSH_PULL, GPIO_SPEED_HIGH,
-            GPIO_PULL_NONE, 0);
-}
-
-struct syscfg {
-  volatile uint32_t MEMRMP, PMC, EXTICR[4], RESERVED[2], CMPCR;
-};
-#define SYSCFG ((struct syscfg *) 0x40013800)
-
-struct exti {
-  volatile uint32_t IMR, EMR, RTSR, FTSR, SWIER, PR;
-};
-#define EXTI ((struct exti *) 0x40013c00)
-
-static inline void irq_exti_attach(uint16_t pin) {
-  uint8_t bank = (uint8_t) (PINBANK(pin)), n = (uint8_t) (PINNO(pin));
-  RCC->APB2ENR |= BIT(14);  // Enable SYSCFG
-  SYSCFG->EXTICR[n / 4] &= ~(15UL << ((n % 4) * 4));
-  SYSCFG->EXTICR[n / 4] |= (uint32_t) (bank << ((n % 4) * 4));
-  EXTI->IMR |= BIT(n);
-  EXTI->RTSR |= BIT(n);
-  EXTI->FTSR |= BIT(n);
-  int irqvec = n < 5 ? 6 + n : n < 10 ? 23 : 40;  // IRQ vector index, 10.1.2
-  nvic_set_prio(irqvec, 3);
-  nvic_enable_irq(irqvec);
-}
-
-struct uart {
-  volatile uint32_t CR1, CR2, CR3, BRR, GTPR, RTOR, RQR, ISR, ICR, RDR, TDR;
-};
-#define UART1 ((struct uart *) 0x40011000)
-#define UART2 ((struct uart *) 0x40004400)
-#define UART3 ((struct uart *) 0x40004800)
-
-static inline void uart_init(struct uart *uart, unsigned long baud) {
-  // https://www.st.com/resource/en/datasheet/stm32f746zg.pdf
-  uint8_t af = 0;           // Alternate function
-  uint16_t rx = 0, tx = 0;  // pins
-
-  if (uart == UART1) RCC->APB2ENR |= BIT(4);
-  if (uart == UART2) RCC->APB1ENR |= BIT(17);
-  if (uart == UART3) RCC->APB1ENR |= BIT(18);
-
-  if (uart == UART1) af = 4, tx = PIN('A', 9), rx = PIN('A', 10);
-  if (uart == UART2) af = 4, tx = PIN('A', 2), rx = PIN('A', 3);
-  if (uart == UART3) af = 7, tx = PIN('D', 8), rx = PIN('D', 9);
-
-  gpio_init(tx, GPIO_MODE_AF, GPIO_OTYPE_PUSH_PULL, GPIO_SPEED_HIGH, 0, af);
-  gpio_init(rx, GPIO_MODE_AF, GPIO_OTYPE_PUSH_PULL, GPIO_SPEED_HIGH, 0, af);
-  uart->CR1 = 0;                          // Disable this UART
-  uart->BRR = FREQ / APB2_PRE / baud;     // Baud rate. /4 is a PLL prescaler
-  uart->CR1 |= BIT(0) | BIT(2) | BIT(3);  // Set UE, RE, TE
-}
-static inline void uart_write_byte(struct uart *uart, uint8_t byte) {
-  uart->TDR = byte;
-  while ((uart->ISR & BIT(7)) == 0) spin(1);
-}
-static inline void uart_write_buf(struct uart *uart, char *buf, size_t len) {
-  while (len-- > 0) uart_write_byte(uart, *(uint8_t *) buf++);
-}
-static inline int uart_read_ready(struct uart *uart) {
-  return uart->ISR & BIT(5);  // If RXNE bit is set, data is ready
-}
-static inline uint8_t uart_read_byte(struct uart *uart) {
-  return (uint8_t) (uart->RDR & 255);
-}
-
-static inline void clock_init(void) {  // Set clock to 216Mhz
-#if 0
-  RCC->APB1ENR |= BIT(28);                     // Power enable
-  PWR->CR1 |= 3UL << 14;                       // Voltage regulator scale 3
-  PWR->CR1 |= BIT(16);                         // Enable overdrive
-  while ((PWR->CSR1 & BIT(16)) == 0) spin(1);  // Wait until done
-  PWR->CR1 |= BIT(17);                         // Enable overdrive switching
-  while ((PWR->CSR1 & BIT(17)) == 0) spin(1);  // Wait until done
-  SCB->CPACR |= ((3UL << 10 * 2) | (3UL << 11 * 2));  // Enable FPU
-#endif
-  FLASH->ACR |= 7 | BIT(8) | BIT(9);                // Flash latency 7, prefetch
-  RCC->PLLCFGR &= ~((BIT(17) - 1));                 // Clear PLL multipliers
-  RCC->PLLCFGR |= (((PLL_P - 2) / 2) & 3) << 16;    // Set PLL_P
-  RCC->PLLCFGR |= PLL_M | (PLL_N << 6);             // Set PLL_M and PLL_N
-  RCC->CR |= BIT(24);                               // Enable PLL
-  while ((RCC->CR & BIT(25)) == 0) spin(1);         // Wait until done
-  RCC->CFGR = (APB1_PRE << 10) | (APB2_PRE << 13);  // Set prescalers
-  RCC->CFGR |= 2;                                   // Set clock source to PLL
-  while ((RCC->CFGR & 12) == 0) spin(1);            // Wait until done
-}

examples/stm32/stm32-freertos-tcp/HAL/stm32f7xx_hal_conf.h

@@ -1,305 +0,0 @@
-#pragma once
-
-#define HAL_ETH_MODULE_ENABLED
-#define HAL_RCC_MODULE_ENABLED
-#define HAL_CORTEX_MODULE_ENABLED
-#define HAL_GPIO_MODULE_ENABLED
-
-#include "stm32f7xx.h"
-#include "stm32f7xx_hal_cortex.h"
-#include "stm32f7xx_hal_def.h"
-#include "stm32f7xx_hal_rcc.h"
-#include "stm32f7xx_hal_gpio.h"
-
-#define UID_BASE 0x1FF0F420UL
-#define __HAL_FLASH_ART_ENABLE() SET_BIT(FLASH->ACR, FLASH_ACR_ARTEN)
-#define __HAL_FLASH_PREFETCH_BUFFER_ENABLE() (FLASH->ACR |= FLASH_ACR_PRFTEN)
-
-#define assert_param(expr) ((void) 0U)
-
-#define HAL_MODULE_ENABLED
-#define HAL_ADC_MODULE_ENABLED
-#define HAL_CAN_MODULE_ENABLED
-#define HAL_CEC_MODULE_ENABLED
-#define HAL_CRC_MODULE_ENABLED
-#define HAL_CRYP_MODULE_ENABLED
-#define HAL_DAC_MODULE_ENABLED
-#define HAL_DCMI_MODULE_ENABLED
-#define HAL_DMA_MODULE_ENABLED
-#define HAL_DMA2D_MODULE_ENABLED
-#define HAL_ETH_MODULE_ENABLED
-#define HAL_FLASH_MODULE_ENABLED
-//#define HAL_NAND_MODULE_ENABLED
-#define HAL_NOR_MODULE_ENABLED
-#define HAL_SRAM_MODULE_ENABLED
-#define HAL_SDRAM_MODULE_ENABLED
-#define HAL_HASH_MODULE_ENABLED
-#define HAL_GPIO_MODULE_ENABLED
-#define HAL_I2C_MODULE_ENABLED
-//#define HAL_I2S_MODULE_ENABLED
-//#define HAL_IWDG_MODULE_ENABLED
-#define HAL_LPTIM_MODULE_ENABLED
-#define HAL_LTDC_MODULE_ENABLED
-#define HAL_PWR_MODULE_ENABLED
-#define HAL_QSPI_MODULE_ENABLED
-#define HAL_RCC_MODULE_ENABLED
-#define HAL_RNG_MODULE_ENABLED
-#define HAL_RTC_MODULE_ENABLED
-//#define HAL_SAI_MODULE_ENABLED
-#define HAL_SD_MODULE_ENABLED
-#define HAL_SPI_MODULE_ENABLED
-#define HAL_TIM_MODULE_ENABLED
-#define HAL_UART_MODULE_ENABLED
-#define HAL_USART_MODULE_ENABLED
-#define HAL_IRDA_MODULE_ENABLED
-#define HAL_SMARTCARD_MODULE_ENABLED
-//#define HAL_WWDG_MODULE_ENABLED
-#define HAL_CORTEX_MODULE_ENABLED
-//#define HAL_PCD_MODULE_ENABLED
-//#define HAL_HCD_MODULE_ENABLED
-
-/* ########################## HSE/HSI Values adaptation ##################### */
-/**
- * @brief Adjust the value of External High Speed oscillator (HSE) used in your
- * application. This value is used by the RCC HAL module to compute the system
- * frequency (when HSE is used as system clock source, directly or through the
- * PLL).
- */
-#if !defined(HSE_VALUE)
-#define HSE_VALUE \
-  ((uint32_t) 25000000) /*!< Value of the External oscillator in Hz */
-#endif                  /* HSE_VALUE */
-
-#if !defined(HSE_STARTUP_TIMEOUT)
-#define HSE_STARTUP_TIMEOUT \
-  ((uint32_t) 5000) /*!< Time out for HSE start up, in ms */
-#endif              /* HSE_STARTUP_TIMEOUT */
-
-/**
- * @brief Internal High Speed oscillator (HSI) value.
- *        This value is used by the RCC HAL module to compute the system
- * frequency (when HSI is used as system clock source, directly or through the
- * PLL).
- */
-#if !defined(HSI_VALUE)
-#define HSI_VALUE \
-  ((uint32_t) 16000000) /*!< Value of the Internal oscillator in Hz*/
-#endif                  /* HSI_VALUE */
-
-/**
- * @brief Internal Low Speed oscillator (LSI) value.
- */
-#if !defined(LSI_VALUE)
-#define LSI_VALUE ((uint32_t) 40000)
-#endif /* LSI_VALUE */ /*!< Value of the Internal Low Speed oscillator in Hz \
-                        The real value may vary depending on the variations  \
-                        in voltage and temperature.  */
-/**
- * @brief External Low Speed oscillator (LSE) value.
- */
-#if !defined(LSE_VALUE)
-#define LSE_VALUE \
-  ((uint32_t) 32768) /*!< Value of the External Low Speed oscillator in Hz */
-#endif               /* LSE_VALUE */
-
-/**
- * @brief External clock source for I2S peripheral
- *        This value is used by the I2S HAL module to compute the I2S clock
- * source frequency, this source is inserted directly through I2S_CKIN pad.
- */
-#if !defined(EXTERNAL_CLOCK_VALUE)
-#define EXTERNAL_CLOCK_VALUE \
-  ((uint32_t) 12288000) /*!< Value of the Internal oscillator in Hz*/
-#endif                  /* EXTERNAL_CLOCK_VALUE */
-
-/* Tip: To avoid modifying this file each time you need to use different HSE,
-   ===  you can define the HSE value in your toolchain compiler preprocessor. */
-
-/* ########################### System Configuration ######################### */
-/**
- * @brief This is the HAL system configuration section
- */
-#define VDD_VALUE ((uint32_t) 3300)         /*!< Value of VDD in mv */
-#define TICK_INT_PRIORITY ((uint32_t) 0x0F) /*!< tick interrupt priority */
-#define USE_RTOS 0
-#define ART_ACCLERATOR_ENABLE 1 /* To enable instruction cache and prefetch */
-
-/* ########################## Assert Selection ############################## */
-/**
- * @brief Uncomment the line below to expanse the "assert_param" macro in the
- *        HAL drivers code
- */
-/* #define USE_FULL_ASSERT    1 */
-
-/* ################## Ethernet peripheral configuration ##################### */
-
-/* Section 1 : Ethernet peripheral configuration */
-
-/* MAC ADDRESS: MAC_ADDR0:MAC_ADDR1:MAC_ADDR2:MAC_ADDR3:MAC_ADDR4:MAC_ADDR5 */
-#define MAC_ADDR0 2
-#define MAC_ADDR1 0
-#define MAC_ADDR2 0
-#define MAC_ADDR3 0
-#define MAC_ADDR4 0
-#define MAC_ADDR5 0
-
-/* Definition of the Ethernet driver buffers size and count */
-#define ETH_RX_BUF_SIZE \
-  ETH_MAX_PACKET_SIZE /* buffer size for receive               */
-#define ETH_TX_BUF_SIZE \
-  ETH_MAX_PACKET_SIZE              /* buffer size for transmit              */
-#define ETH_RXBUFNB ((uint32_t) 8) /* 8 Rx buffers of size ETH_RX_BUF_SIZE  */
-#define ETH_TXBUFNB ((uint32_t) 4) /* 4 Tx buffers of size ETH_TX_BUF_SIZE  */
-
-/* Section 2: PHY configuration section */
-
-/* DP83848 PHY Address*/
-#define DP83848_PHY_ADDRESS 0x01
-/* PHY Reset delay these values are based on a 1 ms Systick interrupt*/
-#define PHY_RESET_DELAY ((uint32_t) 0x000000FF)
-/* PHY Configuration delay */
-#define PHY_CONFIG_DELAY ((uint32_t) 0x00000FFF)
-
-#define PHY_READ_TO ((uint32_t) 0x0000FFFF)
-#define PHY_WRITE_TO ((uint32_t) 0x0000FFFF)
-
-/* Section 3: Common PHY Registers */
-
-#define PHY_BCR ((uint16_t) 0x00) /*!< Transceiver Basic Control Register   */
-#define PHY_BSR ((uint16_t) 0x01) /*!< Transceiver Basic Status Register    */
-
-#define PHY_RESET ((uint16_t) 0x8000)    /*!< PHY Reset */
-#define PHY_LOOPBACK ((uint16_t) 0x4000) /*!< Select loop-back mode */
-#define PHY_FULLDUPLEX_100M \
-  ((uint16_t) 0x2100) /*!< Set the full-duplex mode at 100 Mb/s */
-#define PHY_HALFDUPLEX_100M \
-  ((uint16_t) 0x2000) /*!< Set the half-duplex mode at 100 Mb/s */
-#define PHY_FULLDUPLEX_10M \
-  ((uint16_t) 0x0100) /*!< Set the full-duplex mode at 10 Mb/s  */
-#define PHY_HALFDUPLEX_10M \
-  ((uint16_t) 0x0000) /*!< Set the half-duplex mode at 10 Mb/s  */
-#define PHY_AUTONEGOTIATION \
-  ((uint16_t) 0x1000) /*!< Enable auto-negotiation function     */
-#define PHY_RESTART_AUTONEGOTIATION \
-  ((uint16_t) 0x0200) /*!< Restart auto-negotiation function    */
-#define PHY_POWERDOWN \
-  ((uint16_t) 0x0800) /*!< Select the power down mode           */
-#define PHY_ISOLATE \
-  ((uint16_t) 0x0400) /*!< Isolate PHY from MII                 */
-
-#define PHY_AUTONEGO_COMPLETE \
-  ((uint16_t) 0x0020) /*!< Auto-Negotiation process completed   */
-#define PHY_LINKED_STATUS \
-  ((uint16_t) 0x0004) /*!< Valid link established               */
-#define PHY_JABBER_DETECTION \
-  ((uint16_t) 0x0002) /*!< Jabber condition detected            */
-
-/* Section 4: Extended PHY Registers */
-
-#define PHY_SR \
-  ((uint16_t) 0x10) /*!< PHY status register Offset                      */
-#define PHY_MICR \
-  ((uint16_t) 0x11) /*!< MII Interrupt Control Register                  */
-#define PHY_MISR \
-  ((uint16_t) 0x12) /*!< MII Interrupt Status and Misc. Control Register */
-
-#define PHY_LINK_STATUS \
-  ((uint16_t) 0x0001) /*!< PHY Link mask                                   */
-#define PHY_SPEED_STATUS \
-  ((uint16_t) 0x0002) /*!< PHY Speed mask                                  */
-#define PHY_DUPLEX_STATUS \
-  ((uint16_t) 0x0004) /*!< PHY Duplex mask                                 */
-
-#define PHY_MICR_INT_EN \
-  ((uint16_t) 0x0002) /*!< PHY Enable interrupts                           */
-#define PHY_MICR_INT_OE \
-  ((uint16_t) 0x0001) /*!< PHY Enable output interrupt events              */
-
-#define PHY_MISR_LINK_INT_EN \
-  ((uint16_t) 0x0020) /*!< Enable Interrupt on change of link status       */
-#define PHY_LINK_INTERRUPT \
-  ((uint16_t) 0x2000) /*!< PHY link status interrupt mask                  */
-
-#if 0
-#define HAL_ETH_MODULE_ENABLED
-#define HAL_RCC_MODULE_ENABLED
-#define HAL_CORTEX_MODULE_ENABLED
-#define HAL_GPIO_MODULE_ENABLED
-
-#include "stm32f7xx.h"
-#include "stm32f7xx_hal_cortex.h"
-#include "stm32f7xx_hal_def.h"
-#include "stm32f7xx_hal_rcc.h"
-
-#define UID_BASE 0x1FF0F420UL
-#define __HAL_FLASH_ART_ENABLE() SET_BIT(FLASH->ACR, FLASH_ACR_ARTEN)
-#define __HAL_FLASH_PREFETCH_BUFFER_ENABLE() (FLASH->ACR |= FLASH_ACR_PRFTEN)
-
-#define ETH_RXBUFNB 3
-#define ETH_TXBUFNB 2
-#define ETH_RX_BUF_SIZE (ipconfigNETWORK_MTU + 36)
-#define ETH_TX_BUF_SIZE (ipconfigNETWORK_MTU + 36)
-
-#define assert_param(expr) ((void) 0U)
-
-#define LAN8742A_PHY_ADDRESS            0x00
-#define PHY_RESET_DELAY                 ((uint32_t)0x00000FFF)
-#define PHY_CONFIG_DELAY                ((uint32_t)0x00000FFF)
-#define PHY_READ_TO                     ((uint32_t)0x0000FFFF)
-#define PHY_WRITE_TO                    ((uint32_t)0x0000FFFF)
-#define PHY_BCR                         ((uint16_t)0x00)    /*!< Transceiver Basic Control Register   */
-#define PHY_BSR                         ((uint16_t)0x01)    /*!< Transceiver Basic Status Register    */
-#define PHY_RESET                       ((uint16_t)0x8000)  /*!< PHY Reset */
-#define PHY_LOOPBACK                    ((uint16_t)0x4000)  /*!< Select loop-back mode */
-#define PHY_FULLDUPLEX_100M             ((uint16_t)0x2100)  /*!< Set the full-duplex mode at 100 Mb/s */
-#define PHY_HALFDUPLEX_100M             ((uint16_t)0x2000)  /*!< Set the half-duplex mode at 100 Mb/s */
-#define PHY_FULLDUPLEX_10M              ((uint16_t)0x0100)  /*!< Set the full-duplex mode at 10 Mb/s  */
-#define PHY_HALFDUPLEX_10M              ((uint16_t)0x0000)  /*!< Set the half-duplex mode at 10 Mb/s  */
-#define PHY_AUTONEGOTIATION             ((uint16_t)0x1000)  /*!< Enable auto-negotiation function     */
-#define PHY_RESTART_AUTONEGOTIATION     ((uint16_t)0x0200)  /*!< Restart auto-negotiation function    */
-#define PHY_POWERDOWN                   ((uint16_t)0x0800)  /*!< Select the power down mode           */
-#define PHY_ISOLATE                     ((uint16_t)0x0400)  /*!< Isolate PHY from MII                 */
-#define PHY_AUTONEGO_COMPLETE           ((uint16_t)0x0020)  /*!< Auto-Negotiation process completed   */
-#define PHY_LINKED_STATUS               ((uint16_t)0x0004)  /*!< Valid link established               */
-#define PHY_JABBER_DETECTION            ((uint16_t)0x0002)  /*!< Jabber condition detected            */
-#define PHY_SR                          ((uint16_t)0x1F)    /*!< PHY special control/ status register Offset     */
-#define PHY_SPEED_STATUS                ((uint16_t)0x0004)  /*!< PHY Speed mask                                  */
-#define PHY_DUPLEX_STATUS               ((uint16_t)0x0010)  /*!< PHY Duplex mask                                 */
-#define PHY_ISFR                        ((uint16_t)0x1D)    /*!< PHY Interrupt Source Flag register Offset       */
-#define PHY_ISFR_INT4                   ((uint16_t)0x0010)  /*!< PHY Link down inturrupt                         */
-
-#if !defined(HSE_VALUE)
-#define HSE_VALUE \
-  ((uint32_t) 8000000U) /*!< Value of the External oscillator in Hz */
-#endif                  /* HSE_VALUE */
-#if !defined(HSE_STARTUP_TIMEOUT)
-#define HSE_STARTUP_TIMEOUT \
-  ((uint32_t) 100U) /*!< Time out for HSE start up, in ms */
-#endif              /* HSE_STARTUP_TIMEOUT */
-#if !defined(HSI_VALUE)
-#define HSI_VALUE \
-  ((uint32_t) 16000000U) /*!< Value of the Internal oscillator in Hz*/
-#endif                   /* HSI_VALUE */
-#if !defined(LSI_VALUE)
-#define LSI_VALUE ((uint32_t) 32000U) /*!< LSI Typical Value in Hz*/
-#endif
-#if !defined(LSE_VALUE)
-#define LSE_VALUE \
-  ((uint32_t) 32768U) /*!< Value of the External Low Speed oscillator in Hz */
-#endif                /* LSE_VALUE */
-#if !defined(LSE_STARTUP_TIMEOUT)
-#define LSE_STARTUP_TIMEOUT \
-  ((uint32_t) 5000U) /*!< Time out for LSE start up, in ms */
-#endif               /* LSE_STARTUP_TIMEOUT */
-#if !defined(EXTERNAL_CLOCK_VALUE)
-#define EXTERNAL_CLOCK_VALUE \
-  ((uint32_t) 12288000U) /*!< Value of the Internal oscillator in Hz*/
-#endif                   /* EXTERNAL_CLOCK_VALUE */
-#define VDD_VALUE ((uint32_t) 3300U)         /*!< Value of VDD in mv */
-#define TICK_INT_PRIORITY ((uint32_t) 0x0FU) /*!< tick interrupt priority */
-#define USE_RTOS 0U
-#define PREFETCH_ENABLE 1U
-#define ART_ACCLERATOR_ENABLE 1U /* To enable instruction cache and prefetch \
-                                  */
-
-#endif

examples/stm32/stm32-freertos-tcp/Makefile

@@ -1,89 +0,0 @@
-# FreeRTOS/{FreeRTOS-Kernel V10.4.3,FreeRTOS-Plus-TCP V2.3.2}
-PROG = firmware
-ARCH = stm32f7
-PROJECT_ROOT_PATH = $(realpath $(CURDIR)/../../..)
-DOCKER ?= docker run --rm -v $(PROJECT_ROOT_PATH):$(PROJECT_ROOT_PATH) -w $(CURDIR) mdashnet/armgcc
-FREERTOS_KERNEL_PATH ?= $(PROJECT_ROOT_PATH)/test/freertos-kernel
-FREERTOS_PLUS_TCP_PATH ?= $(PROJECT_ROOT_PATH)/test/freertos-tcp
-
-MONGOOSE_FLAGS = -DMG_ARCH=MG_ARCH_FREERTOS_TCP
-MCU_FLAGS = -mcpu=cortex-m7 -mthumb -mfloat-abi=softfp -mfpu=vfpv4
-#-mcpu=cortex-m7 -mthumb -mfpu=fpv5-sp-d16 -mfloat-abi=hard
-
-INCLUDES = -I$(PROJECT_ROOT_PATH) -I$(ARCH) -I$(FREERTOS_KERNEL_PATH)/include -I$(FREERTOS_PLUS_TCP_PATH)/include
-INCLUDES += -I$(FREERTOS_PLUS_TCP_PATH)/tools/tcp_utilities/include
-INCLUDES += -I$(FREERTOS_PLUS_TCP_PATH)/../Utilities/include
-#INCLUDES += -IH2
-#INCLUDES += -I/Users/lsm/src/htibosch/plus/stm32F7/ST_Library/include
-INCLUDES += -IHAL
-INCLUDES += -I$(FREERTOS_PLUS_TCP_PATH)/portable/Compiler/GCC
-INCLUDES += -I$(FREERTOS_PLUS_TCP_PATH)/portable/NetworkInterface/STM32Fxx
-INCLUDES += -I$(FREERTOS_PLUS_TCP_PATH)/portable/NetworkInterface/include
-NETFLAGS = -DSTM32F7xx -DSTM32F746xx -Wno-sign-compare -Wno-unused-function #-Wno-cpp
-
-CFLAGS = -g3 -O0 -W -Wall $(MCU_FLAGS)
-CFLAGS += $(INCLUDES) $(MONGOOSE_FLAGS) $(NETFLAGS) $(EXTRA)
-
-LINKFLAGS = -T$(ARCH)/link.ld -mcpu=cortex-m7 -mthumb -nostartfiles --specs rdimon.specs -Wl,--gc-sections
-
-SOURCES = main.c $(PROJECT_ROOT_PATH)/mongoose.c
-SOURCES += $(wildcard HAL/*.c)
-#SOURCES += -I$(realpath $(FREERTOS_KERNEL_PATH)/../../stm32F7/ST_Library/sources)/
-
-# FreeRTOS kernel sources
-SOURCES += $(wildcard $(FREERTOS_KERNEL_PATH)/*.c)
-SOURCES += $(FREERTOS_KERNEL_PATH)/portable/MemMang/heap_5.c
-SOURCES += $(FREERTOS_KERNEL_PATH)/portable/GCC/ARM_CM7/r0p1/port.c
-
-# FreeRTOS TCP stack sources
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_ARP.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_DHCP.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_DNS.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_IP.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_Sockets.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_Stream_Buffer.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_TCP_IP.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_TCP_WIN.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/FreeRTOS_UDP_IP.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/portable/NetworkInterface/Common/phyHandling.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/portable/BufferManagement/BufferAllocation_1.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/portable/NetworkInterface/STM32Fxx/NetworkInterface.c
-SOURCES += $(FREERTOS_PLUS_TCP_PATH)/portable/NetworkInterface/STM32Fxx/stm32fxx_hal_eth.c
-
-example:
-	true
-
-build: $(PROG).hex
-
-$(PROG).bin: $(PROG).elf
-	$(DOCKER) arm-none-eabi-objcopy -O binary $< $@
-
-$(PROG).hex: $(PROG).bin
-	$(DOCKER) arm-none-eabi-objcopy -I binary -O ihex --change-address 0x8000000 $< $@
-
-$(PROG).elf: Makefile
-	@mkdir -p $(dir $@)
-	$(DOCKER) arm-none-eabi-gcc $(SOURCES) $(ARCH)/boot.s $(CFLAGS) $(LINKFLAGS) -o $@
-	$(DOCKER) arm-none-eabi-size -A $@
-
-flash: $(PROG).bin
-	st-flash --reset write $< 0x8000000
-
-openocd:
-	openocd -f openocd.cfg
-
-ELF ?= $(PROG).elf
-gdb: #$(PROG).elf
-	arm-none-eabi-gdb \
-		-ex 'set confirm off' \
-        -ex 'target extended-remote :3333' \
-        -ex 'monitor arm semihosting enable' \
-        -ex 'monitor reset halt' \
-        -ex 'load' \
-        -ex 'monitor reset init' \
-        -ex '$(GDBCMD)' \
-        -ex 'r' \
-        $(ELF)
-
-clean:
-	@rm -rf firmware.*

examples/stm32/stm32-freertos-tcp/README.md

@@ -1,3 +0,0 @@
-# Mongoose with STM32, FreeRTOS kernel and FreeRTOS-TCP network stack
-
-The `-DMG_ARCH=MG_ARCH_FREERTOS_TCP` compilation flag enables FreeRTOS+TCP support.

examples/stm32/stm32-freertos-tcp/main.c

@@ -1,139 +0,0 @@
-// Copyright (c) 2021 Cesanta Software Limited
-// All rights reserved
-
-#include "device.h"
-#include "mongoose.h"
-
-static int s_debug_level = MG_LL_VERBOSE;
-static const char *s_listening_address = "http://0.0.0.0:80";
-
-// Event handler for the listening connection.
-static void cb(struct mg_connection *c, int ev, void *ev_data, void *fn_data) {
-  if (ev == MG_EV_HTTP_MSG) {
-    mg_http_reply(c, 200, "", "hello, %s!\n", "world");
-  }
-  (void) fn_data;
-  (void) ev_data;
-}
-
-static void server(void *args) {
-  struct mg_mgr mgr;
-  mg_log_set(s_debug_level);
-  mg_mgr_init(&mgr);
-  MG_INFO(("Starting Mongoose v%s", MG_VERSION));       // Tell the world
-  mg_http_listen(&mgr, s_listening_address, cb, &mgr);  // Web listener
-  while (args == NULL) mg_mgr_poll(&mgr, 1000);         // Infinite event loop
-  mg_mgr_free(&mgr);                                    // Unreachable
-}
-
-static void blinker(void *args) {
-  uint16_t pin = ((char *) args)[0] == '1' ? LED2 : LED3;
-  int ms = pin == LED2 ? 3750 : 5130;
-  for (;;) {
-    gpio_toggle(pin);
-    vTaskDelay(pdMS_TO_TICKS(ms));
-    MG_INFO(("blink %s,  RAM: %u", (char *) args, xPortGetFreeHeapSize()));
-  }
-}
-
-// Start Mongoose server when network is ready
-void vApplicationIPNetworkEventHook(eIPCallbackEvent_t ev) {
-  static bool mongoose_started = false;
-  MG_INFO(("FreeRTOS net event %d, up: %d", ev, eNetworkUp));
-  if (ev == eNetworkUp && mongoose_started == false) {
-    xTaskCreate(server, "server", 8192, NULL, configMAX_PRIORITIES - 1, NULL);
-    mongoose_started = true;
-  }
-}
-
-static void init_heap(void) {
-  extern uint32_t _end, _estack;
-  uint8_t *ptr = (uint8_t *) ((((uint32_t) &_end) + 7) & ~7U);
-  uint32_t len = (uint32_t) ((char *) &_estack - (char *) &_end);
-  HeapRegion_t regions[] = {{ptr, len}, {NULL, 0}};
-  vPortDefineHeapRegions(regions);
-}
-
-int main(void) {
-  init_hardware();
-  init_heap();
-
-  // Initialise networking task. Can be done before scheduler is started
-  static const uint8_t macaddr[6] = {0x00, 0x11, 0x22, 0x33, 0x44, 0x55};
-  static const uint8_t ipaddr[4] = {192, 168, 0, 77};
-  static const uint8_t netmask[4] = {255, 255, 255, 0};
-  static const uint8_t dnsaddr[4] = {8, 8, 8, 8};
-  static const uint8_t gwaddr[4] = {192, 168, 0, 1};
-  FreeRTOS_IPInit(ipaddr, netmask, gwaddr, dnsaddr, macaddr);
-
-  xTaskCreate(blinker, "blinker", 512, "1", configMAX_PRIORITIES - 1, NULL);
-  xTaskCreate(blinker, "blinker", 512, "2", configMAX_PRIORITIES - 1, NULL);
-  vTaskStartScheduler();  // This blocks
-  return 0;               // Unreachable
-}
-
-// Stubs for FreeRTOS-TCP network interface
-uint32_t ulApplicationGetNextSequenceNumber(uint32_t a, uint16_t b, uint32_t c,
-                                            uint16_t d) {
-  return a ^ b ^ c ^ d;
-}
-
-BaseType_t xApplicationGetRandomNumber(uint32_t *p) {
-  *p = 0;
-  return 1;
-}
-
-uint32_t SystemCoreClock = 216000000;
-uint32_t HAL_RCC_GetHCLKFreq(void) {
-  return SystemCoreClock;
-}
-
-uint32_t HAL_GetTick(void) {
-  return configTICK_RATE_HZ;
-}
-
-#include "stm32f7xx_hal_conf.h"
-#include "stm32fxx_hal_eth.h"
-void HAL_ETH_MspInit(ETH_HandleTypeDef *heth) {
-  GPIO_InitTypeDef GPIO_InitStructure;
-  if (heth->Instance == ETH) {
-    __HAL_RCC_GPIOA_CLK_ENABLE();
-    __HAL_RCC_GPIOC_CLK_ENABLE();
-    __HAL_RCC_GPIOG_CLK_ENABLE();
-
-    GPIO_InitStructure.Speed = GPIO_SPEED_HIGH;
-    GPIO_InitStructure.Mode = GPIO_MODE_AF_PP;
-    GPIO_InitStructure.Pull = GPIO_NOPULL;
-    GPIO_InitStructure.Alternate = GPIO_AF11_ETH;
-    GPIO_InitStructure.Pin = GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_7;
-    HAL_GPIO_Init(GPIOA, &GPIO_InitStructure);
-
-    GPIO_InitStructure.Pin = GPIO_PIN_1 | GPIO_PIN_4 | GPIO_PIN_5;
-    HAL_GPIO_Init(GPIOC, &GPIO_InitStructure);
-
-    GPIO_InitStructure.Pin =
-        GPIO_PIN_2 | GPIO_PIN_11 | GPIO_PIN_13 | GPIO_PIN_14;
-    HAL_GPIO_Init(GPIOG, &GPIO_InitStructure);
-
-    HAL_NVIC_SetPriority(ETH_IRQn, 0x7, 0);
-    HAL_NVIC_EnableIRQ(ETH_IRQn);
-
-    __HAL_RCC_ETH_CLK_ENABLE();
-    HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
-  }
-}
-
-int vLoggingPrintf(const char *fmt, ...) {
-  va_list ap;
-  va_start(ap, fmt);
-  char buf[100];
-  int n = vsnprintf(buf, sizeof(buf), fmt, ap);
-  va_end(ap);
-  write(1, buf, n);
-  return n;
-}
-
-void *_sbrk(ptrdiff_t incr) {
-  (void) incr;
-  return NULL;
-}

examples/stm32/stm32-freertos-tcp/openocd.cfg

@@ -1,4 +0,0 @@
-source [find interface/stlink-v2-1.cfg]
-transport select hla_swd
-source [find target/stm32f7x.cfg]
-reset_config srst_only srst_nogate

examples/stm32/stm32-freertos-tcp/stm32f7/FreeRTOSConfig.h

@@ -1,68 +0,0 @@
-#pragma once
-
-#define configUSE_PREEMPTION 1
-#define configUSE_PORT_OPTIMISED_TASK_SELECTION 1
-#define configCPU_CLOCK_HZ ((unsigned long) 216000000)
-#define configSYSTICK_CLOCK_HZ (configCPU_CLOCK_HZ / 8)
-#define configTICK_RATE_HZ 250
-#define configMAX_PRIORITIES 5
-#define configMINIMAL_STACK_SIZE 512
-#define configMAX_TASK_NAME_LEN 16
-#define configUSE_16_BIT_TICKS 0
-#define configIDLE_SHOULD_YIELD 1
-#define configUSE_TASK_NOTIFICATIONS 1
-#define configUSE_MUTEXES 1
-#define configUSE_RECURSIVE_MUTEXES 1
-#define configUSE_COUNTING_SEMAPHORES 1
-#define configQUEUE_REGISTRY_SIZE 8
-
-#define configSUPPORT_STATIC_ALLOCATION 0
-#define configSUPPORT_DYNAMIC_ALLOCATION 1
-
-#define configUSE_IDLE_HOOK 0
-#define configUSE_TICK_HOOK 0
-#define configCHECK_FOR_STACK_OVERFLOW 0
-#define configUSE_MALLOC_FAILED_HOOK 0
-#define configUSE_DAEMON_TASK_STARTUP_HOOK 0
-
-#define configGENERATE_RUN_TIME_STATS 0
-#define configUSE_TRACE_FACILITY 0
-#define configUSE_STATS_FORMATTING_FUNCTIONS 0
-
-#define configUSE_CO_ROUTINES 0
-#define configMAX_CO_ROUTINE_PRIORITIES 1
-
-#define configUSE_TIMERS 0
-#define configTIMER_TASK_PRIORITY (configMAX_PRIORITIES - 1)
-#define configTIMER_QUEUE_LENGTH 10
-#define configTIMER_TASK_STACK_DEPTH configMINIMAL_STACK_SIZE
-
-#ifdef __NVIC_PRIO_BITS
-#define configPRIO_BITS __NVIC_PRIO_BITS
-#else
-#define configPRIO_BITS 4
-#endif
-#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY 15
-#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 4
-#define configKERNEL_INTERRUPT_PRIORITY \
-  (configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))
-#define configMAX_SYSCALL_INTERRUPT_PRIORITY \
-  (configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS))
-
-#define configINCLUDE_APPLICATION_DEFINED_PRIVILEGED_FUNCTIONS 0
-
-#define INCLUDE_vTaskPrioritySet        1
-#define INCLUDE_uxTaskPriorityGet       1
-#define INCLUDE_vTaskDelete           1
-#define INCLUDE_vTaskCleanUpResources     0
-#define INCLUDE_vTaskSuspend          1
-#define INCLUDE_vTaskDelayUntil         0
-#define INCLUDE_vTaskDelay            1
-#define INCLUDE_xTimerPendFunctionCall      0
-#define INCLUDE_eTaskGetState         1
-#define INCLUDE_pcTaskGetTaskName       1
-#define INCLUDE_xTaskGetSchedulerState      1
-
-#define vPortSVCHandler SVC_Handler
-#define xPortPendSVHandler PendSV_Handler
-#define xPortSysTickHandler SysTick_Handler

examples/stm32/stm32-freertos-tcp/stm32f7/FreeRTOSIPConfig.h

@@ -1,45 +0,0 @@
-#pragma once
-#define FREERTOS_IP_CONFIG_H
-
-#ifndef ipconfigHAS_DEBUG_PRINTF
-#define ipconfigHAS_DEBUG_PRINTF 1
-#endif
-#if (ipconfigHAS_DEBUG_PRINTF == 1)
-#define FreeRTOS_debug_printf(X) vLoggingPrintf X
-#endif
-#ifndef ipconfigHAS_PRINTF
-#define ipconfigHAS_PRINTF 1
-#endif
-#if (ipconfigHAS_PRINTF == 1)
-#define FreeRTOS_printf(X) vLoggingPrintf X
-#endif
-
-#define ipconfigBYTE_ORDER pdFREERTOS_LITTLE_ENDIAN
-#define ipconfigREPLY_TO_INCOMING_PINGS       1
-#define ipconfigDRIVER_INCLUDED_TX_IP_CHECKSUM (1)
-#define ipconfigDRIVER_INCLUDED_RX_IP_CHECKSUM (1)
-#define ipconfigZERO_COPY_RX_DRIVER (1)
-#define ipconfigZERO_COPY_TX_DRIVER (1)
-#define ipconfigIP_TASK_PRIORITY 4
-#define niEMAC_HANDLER_TASK_PRIORITY 5
-#define ipconfigIPERF_PRIORITY_IPERF_TASK 6
-#define ipconfigIP_TASK_STACK_SIZE_WORDS (configMINIMAL_STACK_SIZE * 5)
-extern UBaseType_t uxRand();
-#define ipconfigRAND32() uxRand()
-#define ipconfigUSE_NETWORK_EVENT_HOOK 1
-#define ipconfigUSE_DHCP 0
-#define ipconfigDHCP_REGISTER_HOSTNAME 0
-#define ipconfigDHCP_USES_UNICAST 1
-#define ipconfigMAXIMUM_DISCOVER_TX_PERIOD (pdMS_TO_TICKS(30000))
-#define ipconfigARP_CACHE_ENTRIES 6
-#define ipconfigMAX_ARP_RETRANSMISSIONS (5)
-#define ipconfigMAX_ARP_AGE 150
-#define ipconfigINCLUDE_FULL_INET_ADDR 0
-#define ipconfigNUM_NETWORK_BUFFER_DESCRIPTORS 20
-#define ipconfigEVENT_QUEUE_LENGTH (ipconfigNUM_NETWORK_BUFFER_DESCRIPTORS + 5)
-#define ipconfigUDP_TIME_TO_LIVE 128
-#define ipconfigTCP_TIME_TO_LIVE 128
-#define ipconfigUSE_TCP 1
-#define ipconfigSUPPORT_SELECT_FUNCTION 1
-#define ipconfigUSE_TCP_WIN 0
-#define ipconfigNETWORK_MTU 1500

examples/stm32/stm32-freertos-tcp/stm32f7/boot.s

@@ -1,44 +0,0 @@
-.cpu cortex-m7
-.fpu softvfp
-.syntax unified
-.thumb
-
-.section .vectortab,"a",%progbits
-                             //       Cortex-M7 interrupt handlers
-.word   _estack              // 0 Stack top address
-.word   _reset               // 1 Reset
-.word   pass                 // 2 NMI
-.word   halt                 // 3 Hard Fault
-.word   halt                 // 4 MM Fault
-.word   halt                 // 5 Bus Fault
-.word   halt                 // 6 Usage Fault
-.word   0                    // 7 RESERVED
-.word   0                    // 8 RESERVED
-.word   0                    // 9 RESERVED
-.word   0                    // 10 RESERVED
-.word   SVC_Handler          // 11 SV call
-.word   halt                 // 12 Debug reserved
-.word   0                    // 13 RESERVED
-.word   PendSV_Handler       // 14 PendSV
-.word   SysTick_Handler      // 15 SysTick
-                             //         98 STM32 handlers
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,ETH_IRQHandler,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt,halt,halt
-.word   halt,halt,halt,halt,halt,halt,halt,halt
-
-.section .text
-.global _reset
-_reset:
-  ldr sp, =_estack
-  bl main
-  b .
-
-halt:   b .
-pass:   bx lr

examples/stm32/stm32-freertos-tcp/stm32f7/core_cmFunc.h

@@ -1,87 +0,0 @@
-/**************************************************************************//**
- * @file     core_cmFunc.h
- * @brief    CMSIS Cortex-M Core Function Access Header File
- * @version  V4.30
- * @date     20. October 2015
- ******************************************************************************/
-/* Copyright (c) 2009 - 2015 ARM LIMITED
-
-   All rights reserved.
-   Redistribution and use in source and binary forms, with or without
-   modification, are permitted provided that the following conditions are met:
-   - Redistributions of source code must retain the above copyright
-     notice, this list of conditions and the following disclaimer.
-   - Redistributions in binary form must reproduce the above copyright
-     notice, this list of conditions and the following disclaimer in the
-     documentation and/or other materials provided with the distribution.
-   - Neither the name of ARM nor the names of its contributors may be used
-     to endorse or promote products derived from this software without
-     specific prior written permission.
-   *
-   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-   ARE DISCLAIMED. IN NO EVENT SHALL COPYRIGHT HOLDERS AND CONTRIBUTORS BE
-   LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-   CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-   SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-   INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-   ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-   POSSIBILITY OF SUCH DAMAGE.
-   ---------------------------------------------------------------------------*/
-
-
-#if   defined ( __ICCARM__ )
- #pragma system_include         /* treat file as system include file for MISRA check */
-#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)
-  #pragma clang system_header   /* treat file as system include file */
-#endif
-
-#ifndef __CORE_CMFUNC_H
-#define __CORE_CMFUNC_H
-
-
-/* ###########################  Core Function Access  ########################### */
-/** \ingroup  CMSIS_Core_FunctionInterface
-    \defgroup CMSIS_Core_RegAccFunctions CMSIS Core Register Access Functions
-  @{
-*/
-
-/*------------------ RealView Compiler -----------------*/
-#if   defined ( __CC_ARM )
-  #include "cmsis_armcc.h"
-
-/*------------------ ARM Compiler V6 -------------------*/
-#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050)
-  #include "cmsis_armcc_V6.h"
-
-/*------------------ GNU Compiler ----------------------*/
-#elif defined ( __GNUC__ )
-  #include "cmsis_gcc.h"
-
-/*------------------ ICC Compiler ----------------------*/
-#elif defined ( __ICCARM__ )
-  #include <cmsis_iar.h>
-
-/*------------------ TI CCS Compiler -------------------*/
-#elif defined ( __TMS470__ )
-  #include <cmsis_ccs.h>
-
-/*------------------ TASKING Compiler ------------------*/
-#elif defined ( __TASKING__ )
-  /*
-   * The CMSIS functions have been implemented as intrinsics in the compiler.
-   * Please use "carm -?i" to get an up to date list of all intrinsics,
-   * Including the CMSIS ones.
-   */
-
-/*------------------ COSMIC Compiler -------------------*/
-#elif defined ( __CSMC__ )
-  #include <cmsis_csm.h>
-
-#endif
-
-/*@} end of CMSIS_Core_RegAccFunctions */
-
-#endif /* __CORE_CMFUNC_H */