Merge pull request #1803 from fengzeroz/v2.7

version: 2.7.1
2026-10-31 00:19:15 +08:00 · 2024-01-05 10:02:33 +08:00 · 2024-01-05 02:01:49 +00:00 · 2024-01-05 09:48:49 +08:00 · 2024-01-05 01:48:11 +00:00 · 2024-01-04 16:20:41 +08:00
541 changed files with 450245 additions and 205157 deletions
@@ -1,68 +0,0 @@
-# Security Policy
-
-We take the security of EMQX Neuron and NeuronEX seriously and appreciate the
-efforts of security researchers who help keep our users safe.
-
-## Reporting a Vulnerability
-
-**Please do not report security vulnerabilities through public GitHub issues,
-discussions, or pull requests.** Public disclosure before a fix is available puts
-users at risk.
-
-Instead, report privately through GitHub's **Private Vulnerability Reporting**:
-
-1. Go to the **[Security](https://github.com/emqx/neuron/security)** tab of this
-   repository.
-2. Click **Report a vulnerability**.
-3. Fill in the advisory form with the details below.
-
-This opens a private channel visible only to the maintainers.
-
-### What to include
-
-A good report helps us triage quickly. Where possible, please provide:
-
- The affected product and version(s) (e.g. Neuron 2.15.0, NeuronEX 3.9.0), and
-  the commit or image digest you tested.
- The component / code path (file and function, if known).
- A clear description of the vulnerability and its impact.
- Step-by-step reproduction instructions, a proof-of-concept, or the exact
-  payloads. A reproduction package is welcome.
- The exact configuration required to trigger it (network binding, TLS mode,
-  broker setup, plugins/nodes configured, etc.), and any conditions under which
-  the issue does **not** occur.
- Your assessment of severity, if you have one (e.g. a CVSS vector).
-
-## Supported Versions
-
-Security fixes are provided for the active release tracks. Older versions should
-be upgraded to a fixed release.
-
-| Product        | Supported tracks |
-|----------------|------------------|
-| EMQX Neuron    | 2.12.x, 2.13.x, 2.14.x, 2.15.x |
-| EMQX NeuronEX  | 3.6.x, 3.7.x, 3.8.x, 3.9.x |
-
-## Our Process
-
-1. **Acknowledgement** — we aim to acknowledge your report within a few business
-   days.
-2. **Assessment** — we validate the issue and assess severity (CVSS for the
-   published advisory, plus our internal reward tiering where applicable).
-3. **Fix** — we develop and backport the fix across the affected supported tracks.
-4. **Advisory & CVE** — we publish a GitHub Security Advisory (GHSA) and request a
-   CVE identifier.
-5. **Disclosure** — to give users time to upgrade, we generally publish the
-   advisory **90 days** after the fixed releases are available. We are happy to
-   coordinate the disclosure timeline with you.
-6. **Credit** — we credit reporters in the advisory by their preferred name or
-   GitHub handle, unless you prefer to remain anonymous.
-
-## Scope
-
-Vulnerabilities in the Neuron / NeuronEX code and its official plugins are in
-scope. When assessing impact we consider the intended deployment model (for
-example, control-plane and broker interfaces are typically deployed on private,
-trusted networks); please describe the exposure your report assumes.
-
-Thank you for helping make the Neuron ecosystem safer.
@@ -9,25 +9,24 @@ on:

 jobs:
  clang_format_check:
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-20.04

    steps:
      # checkout
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v4
        with:
          submodules: recursive

      - name: Run clang-format style check for C/C++ programs.
-        uses: DoozyX/clang-format-lint-action@v0.18
+        uses: DoozyX/clang-format-lint-action@v0.12
        with:
          source: 'src plugins include tests'
-          exclude: 'include/neuron/utils/uthash.h include/neuron/utils/utarray.h include/neuron/utils/utlist.h include/neuron/utils/zlog.h src/otel/trace.pb-c.h src/otel/trace.pb-c.c src/otel/resource.pb-c.h src/otel/resource.pb-c.c src/otel/common.pb-c.c src/otel/common.pb-c.h plugins/mqtt/ptformat.pb-c.h plugins/mqtt/ptformat.pb-c.c' 
-          style: file
+          exclude: 'include/neuron/utils/uthash.h include/neuron/utils/utarray.h include/neuron/utils/utlist.h include/neuron/utils/zlog.h'
          clangFormatVersion: 10
+          style: file

  cppcheck:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main
+    runs-on: ubuntu-20.04

    steps:
      - uses: actions/checkout@v4
@@ -36,25 +35,14 @@ jobs:
      
      - name: cppcheck
        run: |
-          sudo apt install -y cppcheck
-          cppcheck --enable=all  --error-exitcode=2 --inline-suppr --suppress=missingInclude --suppress=unusedFunction --suppress=*:src/otel/trace.pb-c.c --suppress=*:src/otel/common.pb-c.c --suppress=*:src/otel/resource.pb-c.c  ./plugins ./src
-          cppcheck --enable=all  --error-exitcode=2 --inline-suppr --suppress=missingInclude  --suppress=variableScope ./simulator
+          sudo apt install cppcheck
+          cppcheck --enable=all  --error-exitcode=2 --inline-suppr --suppress=missingInclude --suppress=unusedFunction ./plugins ./src
+          cppcheck --enable=all  --error-exitcode=2 --inline-suppr --suppress=missingInclude --suppress=unusedFunction --suppress=variableScope ./simulator

-  flawfinder:
-    name: Flawfinder Scan
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
+  ut:
+    runs-on: ubuntu-20.04
+    container: ghcr.io/neugates/build:x86_64-v2.7

-      - name: flawfinder_scan
-        uses: david-a-wheeler/flawfinder@2.0.20
-        with:
-          arguments: '--minlevel=3 .'
-
-  build:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main

    steps:
      - uses: actions/checkout@v4
@@ -66,60 +54,66 @@ jobs:
          git config --global --add safe.directory $(pwd)
          mkdir -p build && cd build
          cmake -DUSE_GCOV=1 .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
-          make -j4  
+          make -j4

-      - uses: actions/upload-artifact@v4
+      - name: unit test
+        run: |
+          cd build
+          sudo apt-get update
+          sudo apt install -y lcov
+          ctest --output-on-failure -O tests/ut/reports/ut.log --output-junit tests/ut/reports/output.xml
+          lcov --capture --directory . --output-file  testneuron.info --test-name testneuron
+          genhtml -o result testneuron.info
+
+      - uses: actions/upload-artifact@v3
        with:
-          name: neuron-build
+          name: ut_result
          path: |
-            build
+            build/tests/ut/reports/ut.log
+            build/tests/ut/reports/output.xml
+            build/result/index.html
+            build/neuron.log

-
-  ut:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main
-    needs: [build]
+  ft:
+    runs-on: ubuntu-20.04
+    container: ghcr.io/neugates/build:x86_64-v2.7

    steps:
      - uses: actions/checkout@v4
        with:
          submodules: recursive
-
-      - uses: actions/download-artifact@v4
-        with:
-          name: neuron-build
-          path: ./build
-
-      - name: unit test
+      
+      - name: compile
        run: |
-          chmod -R +x ./build/
-          cd build
+          git config --global --add safe.directory $(pwd)
+          mkdir -p build && cd build
          cmake -DUSE_GCOV=1 .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
-          ctest --output-on-failure
+          make -j4

-      - name: create cov report
+      - name: function test
        run: |
-            sudo apt-get update
-            sudo apt-get -y install lcov
-            mkdir -p cov_report
-            ./create_cov_report.sh ut
+          sudo apt-get install -y mosquitto
+          mosquitto -v &
+          python3 -m pip install -U pip
+          python3 -m pip install -r ft/requirements.txt
+          python3 -m robot --maxerrorlines=600 -P ft/ -d ft/reports ft

-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4
+      - uses: actions/upload-artifact@v3
        with:
-          verbose: true
-          fail_ci_if_error: true
-          token: ${{ secrets.CODECOV_TOKEN }}
-          directory: ./cov_report/
-          files: ./cov_report/cov-ut.info
+          name: ft_result
+          path: |
+            ft/reports/log.html
+            ft/reports/output.xml
+            ft/reports/report.html
+            build/neuron.log

  pft:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main
-    needs: [build]
+    runs-on: ubuntu-20.04
+    container: ghcr.io/neugates/build:x86_64-v2.7
    strategy:
      matrix:
-        plugin: [core, ekuiper, modbus, mqtt, metrics]
+        plugin: [core, modbus, mqtt, metrics]
+
    steps:
      - uses: actions/checkout@v4
        with:
@@ -127,34 +121,26 @@ jobs:

      - name: setup dependencies
        run: |
-          sudo apt-get install -y mosquitto
-          pip install -U pytest requests prometheus-client gmqtt pynng sniffio
-          sudo apt-get install -y socat
+          if [ "${{ matrix.plugin }}" = "mqtt" ]; then
+            sudo apt-get install -y mosquitto
+            pip install -U gmqtt
+          fi
+          pip install -U pytest requests prometheus-client

-      - uses: actions/download-artifact@v4
-        with:
-          name: neuron-build
-          path: ./build
+      - name: compile
+        run: |
+          git config --global --add safe.directory $(pwd)
+          mkdir -p build && cd build
+          cmake -DUSE_GCOV=1 .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
+          make -j4

      - name: function test
        run: |
-          chmod -R +x ./build/
-          cd build
-          cmake -DUSE_GCOV=1 .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
-          cd ..        
          if [ "${{ matrix.plugin }}" = "core" ]; then
            pytest -s -v tests/ft \
-              --ignore=tests/ft/app/test_ekuiper.py          \
              --ignore=tests/ft/app/test_mqtt.py             \
-              --ignore=tests/ft/app/test_azure.py            \
-              --ignore=tests/ft/app/test_kafka.py            \
              --ignore=tests/ft/driver/test_modbus.py        \
-              --ignore=tests/ft/metrics/test_metrics.py      \
-              --ignore=tests/ft/login/test_launch.py         \
-              --ignore=tests/ft/login/test_filter_error.py   \
-              --ignore=tests/ft/login/test_login.py
-          elif [ "${{ matrix.plugin }}" = "ekuiper" ]; then
-            pytest -s -v tests/ft/app/"test_ekuiper.py"
+              --ignore=tests/ft/metrics/test_metrics.py
          elif [ "${{ matrix.plugin }}" = "modbus" ]; then
            pytest -s -v tests/ft/driver/"test_modbus.py"
          elif [ "${{ matrix.plugin }}" = "mqtt" ]; then
@@ -162,107 +148,3 @@ jobs:
          else
            pytest -s -v tests/ft/metrics/"test_metrics.py"          
          fi
-
-      - name: create cov report
-        run: |
-            sudo apt-get update
-            sudo apt-get -y install lcov
-            mkdir -p cov_report
-            ./create_cov_report.sh ${{ matrix.plugin }}
-
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4
-        with:
-          verbose: true
-          fail_ci_if_error: true
-          token: ${{ secrets.CODECOV_TOKEN }}
-          directory: ./cov_report/
-          files: ./cov_report/cov-${{ matrix.plugin }}.info
-
-  pft_kafka:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main
-    needs: [build]
-    services:
-      kafka:
-        image: apache/kafka:3.7.0
-        env:
-          KAFKA_NODE_ID: "1"
-          KAFKA_PROCESS_ROLES: broker,controller
-          KAFKA_LISTENERS: PLAINTEXT://:9092,CONTROLLER://:9093
-          KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092
-          KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: CONTROLLER:PLAINTEXT,PLAINTEXT:PLAINTEXT
-          KAFKA_CONTROLLER_QUORUM_VOTERS: 1@localhost:9093
-          KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER
-          KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: "1"
-          KAFKA_GROUP_INITIAL_REBALANCE_DELAY_MS: "0"
-          CLUSTER_ID: MkU3OEVBNTcwNTJENDM2Qk
-        ports:
-          - 9092:9092
-        options: >-
-          --health-cmd "bash -c 'echo > /dev/tcp/localhost/9092'"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 10
-          --health-start-period 30s
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-
-      - name: setup dependencies
-        run: |
-          python3 -m pip install --upgrade pip
-          pip install -U pytest requests confluent-kafka==2.3.0
-
-      - uses: actions/download-artifact@v4
-        with:
-          name: neuron-build
-          path: ./build
-
-      - name: debug kafka plugin deps
-        run: |
-          echo "=== libs in staging prefix ==="
-          ls -la /home/neuron/main/libs/x86_64-linux-gnu/lib/librdkafka* || echo "no librdkafka"
-          ls -la /home/neuron/main/libs/x86_64-linux-gnu/lib/libzstd* || echo "no libzstd"
-          ls -la /home/neuron/main/libs/x86_64-linux-gnu/lib/libsasl2* || echo "no libsasl2"
-          echo "=== libs in /usr/local/lib ==="
-          ls -la /usr/local/lib/librdkafka* /usr/local/lib/libzstd* /usr/local/lib/libsasl2* 2>/dev/null || echo "none yet"
-          echo "=== ldd librdkafka from staging ==="
-          ldd /home/neuron/main/libs/x86_64-linux-gnu/lib/librdkafka.so.1 || true
-          echo "=== ldd plugin-kafka from build ==="
-          chmod -R +x ./build/ 2>/dev/null || true
-          ldd ./build/plugins/libplugin-kafka.so || true
-
-      - name: function test
-        env:
-          KAFKA_BROKER: kafka:9092
-        run: |
-          chmod -R +x ./build/
-          cd build
-          cmake -DUSE_GCOV=1 .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
-          cd ..
-          ldconfig
-          echo "=== post-ldconfig ldd check ==="
-          ldd ./build/plugins/libplugin-kafka.so || true
-          ldd /usr/local/lib/librdkafka.so.1 || true
-          echo "=== try manual dlopen ==="
-          python3 -c "import ctypes; ctypes.CDLL('./build/plugins/libplugin-kafka.so')" 2>&1 || true
-          pytest -s -v tests/ft/app/test_kafka.py
-
-      - name: create cov report
-        run: |
-            sudo apt-get update
-            sudo apt-get -y install lcov
-            mkdir -p cov_report
-            ./create_cov_report.sh kafka
-
-      - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v4
-        with:
-          verbose: true
-          fail_ci_if_error: true
-          token: ${{ secrets.CODECOV_TOKEN }}
-          directory: ./cov_report/
-          files: ./cov_report/cov-kafka.info
@@ -8,18 +8,20 @@ on:
      - published

 env:
-  VERSION: 2.15.0
-  UI_VERSION: 2.6.1
-  BRANCH: main
+  VERSION: 2.7.1
+  UI_VERSION: 2.6.3
+  BRANCH: v2.7

 jobs:
  cross-build:
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-20.04
    strategy:
      matrix:
        arch:
+          - [aarch64-linux-gnu, aarch64, arm64]
+          - [arm-linux-gnueabihf, armv4, armhf]
          - [x86_64-linux-gnu, x86_64, amd64]
-    container: ghcr.io/neugates/build:${{ matrix.arch[1] }}-main
+    container: ghcr.io/neugates/build:${{ matrix.arch[1] }}-v2.7

    steps:
      - uses: actions/checkout@v4
@@ -50,19 +52,19 @@ jobs:
        run: |
          ./package-sdk.sh -p ${{ matrix.arch[2] }} -n neuron-sdk-$VERSION

-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v3
        with:
-          name: neuron-sdk-${{ matrix.arch[2] }}
+          name: neuron-sdk
          path: |
            neuron-sdk-*.tar.gz

  build-debug-sdk:
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-20.04
    strategy:
      matrix:
        arch:
          - [x86_64-linux-gnu, x86_64, amd64]
-    container: ghcr.io/neugates/build:${{ matrix.arch[1] }}-main
+    container: ghcr.io/neugates/build:${{ matrix.arch[1] }}-v2.7

    steps:
      - uses: actions/checkout@v4
@@ -81,9 +83,9 @@ jobs:
        run: |
          ./package-sdk.sh -p ${{ matrix.arch[2] }} -n neuron-sdk-debug-$VERSION

-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v3
        with:
-          name: neuron-sdk-debug
+          name: neuron-sdk
          path: |
            neuron-sdk-debug-*.tar.gz
  
@@ -100,13 +102,9 @@ jobs:
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v3
        with:
-          name: neuron-sdk-debug
-
-      - uses: actions/download-artifact@v4
-        with:
-          name: neuron-sdk-amd64
+          name: neuron-sdk
      
      - uses: softprops/action-gh-release@v1
        env:
@@ -1,22 +0,0 @@
-name: Translate Issue from Chinese to English
-
-on:
-  workflow_dispatch:
-    inputs:
-      issue_number:
-        description: 'The issue number to translate'
-        required: true
-        type: string
-  issues:
-    types: [opened]
-
-jobs:
-  translate:
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write # Grant permission to edit issues
-    steps:
-    - uses: emqx/translate-issue-action@ee63ec619dfc5808ee2093dba93dfd7ac3beb437 # v1.0.2
-      with:
-        issue_number: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.issue_number || github.event.issue.number }}
-        gemini_api_key: ${{ secrets.GEMINI_API_KEY }}
@@ -1,71 +0,0 @@
-name: manual check
-
-on:
-  workflow_dispatch:
-    inputs:
-      plugins:
-        description: 'Comma separated list of plugins to test (default: all unused plugins)'
-        required: false
-        default: 'azure,launch'
-
-jobs:
-  build:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-      
-      - name: compile
-        run: |
-          git config --global --add safe.directory $(pwd)
-          mkdir -p build && cd build
-          cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
-          make -j4  
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: neuron-build-unused-plugins
-          path: |
-            build
-
-  unused_plugins_test:
-    runs-on: ubuntu-24.04
-    container: ghcr.io/neugates/build:x86_64-main
-    needs: [build]
-    strategy:
-      matrix:
-        plugin: [azure, launch]
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          submodules: recursive
-
-      - name: setup dependencies
-        run: |
-          sudo apt-get install -y mosquitto
-          pip install -U pytest requests prometheus-client gmqtt pynng sniffio
-          sudo apt-get install -y socat
-
-      - uses: actions/download-artifact@v4
-        with:
-          name: neuron-build-unused-plugins
-          path: ./build
-
-      - name: function test
-        run: |
-          chmod -R +x ./build/
-          cd build
-          cmake .. -DCMAKE_TOOLCHAIN_FILE=../cmake/x86_64-linux-gnu.cmake
-          cd ..        
-          if [ "${{ matrix.plugin }}" = "azure" ]; then
-            pytest -s -v tests/ft/app/"test_azure.py"
-          elif [ "${{ matrix.plugin }}" = "launch" ]; then
-            pytest -s -v tests/ft/login
-          fi
-
-      - name: Test completed
-        run: |
-          echo "Testing for ${{ matrix.plugin }} completed successfully"
@@ -19,5 +19,4 @@ neuron-sdk
 .vscode
 log.html
 output.xml
-report.html
-*.cache
+report.html
@@ -1,50 +0,0 @@
-# Neuron Engineering and Review Guide
-
-## Repository context
-
-Neuron is the open-source C gateway/core and built-in plugin repository. `plugins/restful/` contains management handlers; `plugins/mqtt/` handles broker interactions; `src/utils/`, `src/adapter/`, `src/core/`, and `src/persist/` contain shared decoding, runtime, plugin, and storage logic. This guide covers code maintained in this repository.
-
-Read [the threat model](docs/threat-model.md) and [security policy](SECURITY.md). Preserve more specific directory instructions and generated-file workflows. Match existing naming, ownership conventions, and error handling. Do not manually edit generated parsers when their generation workflow is authoritative.
-
-## Code Review Rules
-
-### Establish the actual security boundary
-
- Establish the effective management binding, authentication configuration, and access path. The checked-in loopback/auth defaults are configurable. When a reverse proxy is present, inspect forwarding and authorization without assuming it preserves the gateway's security boundary. Trace the reachable transport before claiming or excluding remote exposure.
- For each finding, identify attacker-controlled input, privileges, enabling configuration, changed lines, sink, and concrete effect. Review introduced regressions and impacted callers, not merely suspicious API names. Separate verified behavior from assumptions about releases or packaging.
- An authenticated caller is not automatically authorized for user management, credential changes, plugin operations, or device writes. Check each operation's actual identity policy and alternate route/method. Derive roles and authority from Neuron's own supported identity model.
-
-### Fail closed at authentication and trust boundaries
-
- Require appropriate JWT signature, algorithm, issuer/key association, audience, time, and identity validation. External tokens and missing claims must not gain authority through an undocumented fallback. Handle all validation errors, not one named mismatch case.
- Account deletion, password change, and token revocation are separate mechanisms. Test the intended behavior without assuming signed tokens instantly disappear.
- Treat configured credentials and key material as secrets. Validate TLS peer identity and certificate trust; never admit a shared production private key merely because it ships with the application.
-
-### Validate memory and lifetime at the consuming boundary
-
- Check actual source bytes and destination capacity separately. Validate counts/types, arithmetic, signedness, narrowing, termination, and allocation/iteration agreement before copying or dereferencing. Include singular/batch, malformed, empty, partial, and oversized inputs.
- Trace ownership across message queues, callbacks, reconnection, configuration replacement, and shutdown. Retain/copy borrowed data as needed; stop callbacks before releasing state. Include allocation and partial-failure cleanup.
- Configuration, imports, restored databases and protocol files remain parsing inputs. Constrain paths and symlinks, preserve valid state on failure, and avoid secrets in errors/logs/exports. UI/schema validation is not sufficient runtime validation.
-
-### Review intended capabilities accurately
-
- Metrics intentionally permits unauthenticated Prometheus scraping. Report added sensitive disclosure, control behavior, or resource abuse—not simply the documented lack of JWT enforcement.
- Native plugins share service-process privileges. Authorized extension loading is not itself host escape. Lower-trust access to loading or memory corruption still warrants review. Prove actual privileges and distinguish service execution, container-root execution, and host compromise.
- Broker ACLs and device-write rights are independent from REST authentication. Follow publish/subscribe directions and configured write targets; do not infer arbitrary downstream takeover from a scoped action.
- Supervision is deployment-dependent. Recovery may shorten a crash but does not eliminate repeated DoS, persistent corruption, or RCE. Do not infer RCE from an unweaponized crash or assume historical binary hardening still applies.
-
-### Findings and regression evidence
-
-State prerequisites and unaffected cases. Cite the narrow code location and reachable call chain; avoid generic severity boilerplate. A safe fix should cover shared helpers and sibling paths, not just the reported route. Add targeted boundary/negative tests, including failure branches and ownership during teardown. Keep private reports, unpublished exploit details, customer data, credentials and reward discussions out of public review comments and repository documentation.
-
-## Build and validation
-
-Use the documented supported build environment and dependencies. From the repository root, a normal CMake build can use:
-
-```sh
-cmake -S . -B build
-cmake --build build -j4
-ctest --test-dir build --output-on-failure
-```
-
-Check `CMakeLists.txt` and CI for the target toolchain and options. Current Debug builds enable ASan unless disabled; do not assume Release does. Functional pytest suites under `tests/ft/` require gateway/broker/simulator dependencies and change runtime state. Run only targeted authorized lab tests; never point them at production OT equipment. Report commands actually run and any missing prerequisites rather than claiming validation from source inspection alone.
@@ -9,11 +9,6 @@ set(CMAKE_CXX_STANDARD 17)

 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)

-# Datalayers is no longer part of the default NeuronEX package. Keep the
-# implementation available for standalone/legacy builds, but avoid pulling in
-# Apache Arrow unless it is explicitly requested.
-option(ENABLE_DATALAYERS "Build the Datalayers northbound plugin" OFF)
-
 if(NOT CMAKE_BUILD_TYPE)
  set(CMAKE_BUILD_TYPE "Debug")
 endif()
@@ -45,13 +40,8 @@ if(USE_GCOV)
  SET(CMAKE_EXE_LINKER_FLAGS "${CMAKE_LINKER_FLAGS} ${GCC_COVERAGE_LINK_FLAGS}")
 endif(USE_GCOV)

-set(CMAKE_POSITION_INDEPENDENT_CODE ON)
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -g")
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wno-error=format-truncation")
 set(CMAKE_C_FLAGS_RELEASE "${CMAKE_C_FLAGS} -O0")
-add_compile_options(-fstack-protector-strong)
-add_link_options(-fstack-protector-strong)
-add_link_options(-pie -Wl,-z,relro,-z,now)

 if(NOT DISABLE_ASAN)
  set(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS} -fsanitize=address")
@@ -64,38 +54,28 @@ add_custom_target(neuron-version
          ${CMAKE_CURRENT_SOURCE_DIR}/cmake/neuron-version.cmake)

 find_package(nng CONFIG REQUIRED)
-find_package(LibXml2 REQUIRED)
 find_package(Threads)
-set(OPENSSL_USE_STATIC_LIBS TRUE)
-find_package(OpenSSL REQUIRED)

 if (CMAKE_STAGING_PREFIX)
  include_directories(${CMAKE_STAGING_PREFIX}/include)
  link_directories(${CMAKE_STAGING_PREFIX}/lib)
-  include_directories(${CMAKE_STAGING_PREFIX}/include/libxml2)
 else()
  include_directories(/usr/local/include)
  link_directories(/usr/local/lib)
-  include_directories(/usr/local/include/libxml2)
 endif()

 set(PERSIST_SOURCES
    src/persist/persist.c
-    src/persist/sqlite.c
    src/persist/json/persist_json_plugin.c)
 aux_source_directory(src/parser NEURON_SRC_PARSE)
-aux_source_directory(src/otel NEURON_SRC_OTEL)
-if(NOT ENABLE_DATALAYERS)
-  list(FILTER NEURON_SRC_PARSE EXCLUDE REGEX "neu_json_datalayers\\.c$")
-endif()
 set(NEURON_BASE_SOURCES
-    src/base/property.c
    src/base/tag.c
    src/base/neu_plugin_common.c
    src/base/tag_sort.c
    src/base/group.c
    src/base/metrics.c
    src/base/msg.c
+    src/base/template.c
    src/connection/connection.c
    src/connection/connection_eth.c
    src/connection/mqtt_client.c
@@ -105,14 +85,11 @@ set(NEURON_BASE_SOURCES
    src/utils/json.c
    src/utils/http.c
    src/utils/http_handler.c
+    src/utils/http_proxy.c
    src/utils/neu_jwt.c
    src/utils/base64.c
    src/utils/async_queue.c
    src/utils/log.c
-    src/utils/cid.c
-    src/utils/ede.c
-    src/utils/tpy.c
-    src/utils/neu_path.c
    ${PERSIST_SOURCES})
  
 if (SMART_LINK) 
@@ -127,24 +104,13 @@ if (CLIB)
 endif()


-if (USE_MQTT_SM)
-  message(STATUS "use mqtt sm")
-  add_definitions(-DNEU_USE_MQTT_SM)
-endif()
-
-if(CMAKE_BUILD_TYPE STREQUAL "Release")
-    message(STATUS "build release")
-    add_definitions(-DNEU_RELEASE)
-endif()
-
-
 add_library(neuron-base SHARED)
-target_sources(neuron-base PRIVATE ${NEURON_BASE_SOURCES} ${NEURON_SRC_PARSE} ${NEURON_SRC_OTEL}) 
+target_sources(neuron-base PRIVATE ${NEURON_BASE_SOURCES} ${NEURON_SRC_PARSE}) 
 target_include_directories(neuron-base
                           PRIVATE include/neuron src)
-target_link_libraries(neuron-base OpenSSL::SSL OpenSSL::Crypto)
-target_link_libraries(neuron-base nng libzlog.so jansson jwt xml2
-                      ${CMAKE_THREAD_LIBS_INIT} -lm protobuf-c)
+target_link_libraries(neuron-base libssl.a libcrypto.a)
+target_link_libraries(neuron-base nng libzlog.so jansson jwt
+                      ${CMAKE_THREAD_LIBS_INIT})
 add_dependencies(neuron-base neuron-version)

 # dependency imposed by nng
@@ -160,55 +126,44 @@ set(NEURON_SOURCES
    src/core/subscribe.c
    src/core/plugin_manager.c
    src/core/node_manager.c
+    src/core/template_manager.c
    src/core/storage.c
    src/adapter/msg_q.c
    src/adapter/storage.c
    src/adapter/adapter.c
    src/adapter/driver/cache.c
    src/adapter/driver/driver.c
-    plugins/restful/cert_handle.c
    plugins/restful/handle.c
    plugins/restful/log_handle.c
    plugins/restful/metric_handle.c
    plugins/restful/normal_handle.c
    plugins/restful/rw_handle.c
    plugins/restful/adapter_handle.c
+    plugins/restful/ndriver_handle.c
    plugins/restful/datatag_handle.c
    plugins/restful/global_config_handle.c
    plugins/restful/group_config_handle.c
    plugins/restful/plugin_handle.c
+    plugins/restful/template_handle.c
    plugins/restful/version_handle.c
-    plugins/restful/scan_handle.c
-    plugins/restful/otel_handle.c
-    plugins/restful/cid_handle.c
-    plugins/restful/ede_handle.c
-    plugins/restful/tpy_handle.c
    plugins/restful/rest.c
-    plugins/restful/user.c
-    plugins/restful/simulator_handle.c
-    simulator/modbus_tcp_simulator.c)
-
-if(ENABLE_DATALAYERS)
-  list(APPEND NEURON_SOURCES plugins/restful/datalayers_handle.c)
-endif()
+    plugins/restful/user.c)

 set(CMAKE_BUILD_RPATH ./)
 add_executable(neuron)
 target_sources(neuron PRIVATE ${NEURON_SOURCES}) 
 target_include_directories(neuron PRIVATE include/neuron src plugins)
-target_link_libraries(neuron dl neuron-base sqlite3 -lm xml2)
+target_link_libraries(neuron dl neuron-base sqlite3 -lm)
 target_link_options(neuron PRIVATE "LINKER:--dynamic-list-data")

-if(ENABLE_DATALAYERS)
-  target_compile_definitions(neuron PRIVATE NEU_ENABLE_DATALAYERS)
-endif()
-
 #copy file for run
 file(COPY ${CMAKE_SOURCE_DIR}/zlog.conf DESTINATION ${CMAKE_BINARY_DIR}/config)
 file(COPY ${CMAKE_SOURCE_DIR}/dev.conf DESTINATION ${CMAKE_BINARY_DIR}/config)
 file(COPY ${CMAKE_SOURCE_DIR}/neuron.json DESTINATION ${CMAKE_BINARY_DIR}/config)
 file(COPY ${CMAKE_SOURCE_DIR}/.gitkeep DESTINATION ${CMAKE_BINARY_DIR}/logs)
 file(COPY ${CMAKE_SOURCE_DIR}/.gitkeep DESTINATION ${CMAKE_BINARY_DIR}/persistence)
+file(COPY ${CMAKE_SOURCE_DIR}/neuron.key DESTINATION ${CMAKE_BINARY_DIR}/config)
+file(COPY ${CMAKE_SOURCE_DIR}/neuron.pem DESTINATION ${CMAKE_BINARY_DIR}/config)
 file(GLOB SQL_SCHEMAS ${CMAKE_SOURCE_DIR}/persistence/*.sql)
 file(COPY ${SQL_SCHEMAS} DESTINATION ${CMAKE_BINARY_DIR}/config)
 file(COPY ${CMAKE_SOURCE_DIR}/default_plugins.json DESTINATION ${CMAKE_BINARY_DIR}/config)
@@ -216,12 +171,6 @@ file(COPY ${CMAKE_SOURCE_DIR}/default_plugins.json DESTINATION ${CMAKE_BINARY_DI
 add_subdirectory(plugins/modbus)
 add_subdirectory(plugins/mqtt)
 add_subdirectory(plugins/ekuiper)
-add_subdirectory(plugins/file)
-add_subdirectory(plugins/monitor)
-if(ENABLE_DATALAYERS)
-  add_subdirectory(plugins/datalayers)
-endif()
-add_subdirectory(plugins/kafka)

 add_subdirectory(simulator)

@@ -232,7 +181,6 @@ endif()
 add_subdirectory(tests/plugins/c1)
 add_subdirectory(tests/plugins/s1)
 add_subdirectory(tests/plugins/sc1)
-add_subdirectory(tests/plugins/demo_app)

 # Set sane defaults for multi-lib linux systems
 include(GNUInstallDirs)
@@ -28,7 +28,7 @@ $ cmake -DUSE_SHARED_MBEDTLS_LIBRARY=OFF -DENABLE_TESTING=OFF -DCMAKE_POSITION_I

 [NanoSDK](https://github.com/neugates/NanoSDK.git)
 ```shell
-$ git clone https://github.com/neugates/NanoSDK.git
+$ git clone -b neuron https://github.com/neugates/NanoSDK.git
 $ cd NanoSDK && mkdir build && cd build
 $ cmake -DBUILD_SHARED_LIBS=OFF -DNNG_TESTS=OFF -DNNG_ENABLE_SQLITE=ON -DNNG_ENABLE_TLS=ON .. && make && sudo make install
 ```
@@ -55,74 +55,3 @@ $ tar xzf sqlite3.tar.gz --strip-components=1 -C sqlite3
 $ cd sqlite3
 $ ./configure CFLAGS=-fPIC && make && sudo make install
 ```
-
-[protobuf](https://github.com/protocolbuffers/protobuf)
-```shell
-$ wget --no-check-certificate --content-disposition https://github.com/protocolbuffers/protobuf/releases/download/v3.20.1/protobuf-cpp-3.20.1.tar.gz
-$ tar -xzvf protobuf-cpp-3.20.1.tar.gz
-$ cd protobuf-3.20.1
-$ ./configure --enable-shared=no CFLAGS=-fPIC CXXFLAGS=-fPIC
-$ make && sudo make install
-```
-
-[protobuf-c](https://github.com/protobuf-c/protobuf-c.git)
-```shell
-$ git clone -b v1.4.0 https://github.com/protobuf-c/protobuf-c.git
-$ cd protobuf-c
-$ ./autogen.sh
-$ ./configure  --disable-protoc --enable-shared=no CFLAGS=-fPIC CXXFLAGS=-fPIC 
-$ make && sudo make install
-```
-
-[cyrus-sasl](https://github.com/cyrusimap/cyrus-sasl.git)
-```shell
-$ git clone -b cyrus-sasl-2.1.28 https://github.com/cyrusimap/cyrus-sasl.git
-$ cd cyrus-sasl
-$ autoreconf -fi
-$ ./configure --enable-shared --disable-static --disable-sample \
-    --disable-checkapop --disable-cram --disable-digest --disable-otp \
-    --disable-srp --disable-gssapi --disable-sql \
-    --enable-plain --enable-scram --enable-login \
-    --with-dblib=none --without-saslauthd --without-authdaemond
-$ make && sudo make install
-```
-
-[zstd](https://github.com/facebook/zstd.git)
-```shell
-$ git clone -b v1.5.6 https://github.com/facebook/zstd.git
-$ cd zstd/build/cmake && mkdir builddir && cd builddir
-$ cmake -DZSTD_BUILD_PROGRAMS=OFF -DZSTD_BUILD_TESTS=OFF -DZSTD_BUILD_SHARED=ON -DZSTD_BUILD_STATIC=OFF -DCMAKE_BUILD_TYPE=Release .. && make && sudo make install
-```
-
-[librdkafka](https://github.com/confluentinc/librdkafka.git)
-```shell
-$ git clone -b v2.6.1 https://github.com/confluentinc/librdkafka.git
-$ cd librdkafka && mkdir build && cd build
-$ cmake -DRDKAFKA_BUILD_STATIC=OFF -DRDKAFKA_BUILD_EXAMPLES=OFF -DRDKAFKA_BUILD_TESTS=OFF -DWITH_SSL=ON -DWITH_ZLIB=ON -DWITH_SASL=ON -DWITH_ZSTD=ON -DWITH_CURL=OFF -DCMAKE_BUILD_TYPE=Release .. && make && sudo make install
-```
-
-[libxml2](https://github.com/GNOME/libxml2.git)
-```shell
-$ git clone -b v2.9.14 https://github.com/GNOME/libxml2.git
-$ cd libxml2
-$ ./autogen.sh
-$ ./configure --enable-shared=no CFLAGS=-fPIC CXXFLAGS=-fPIC
-$ make && sudo make install
-```
-
-[arrow](https://github.com/apache/arrow)
-
-To build Apache Arrow C++ for the datalayers plugin, please refer to the [official Arrow](https://github.com/apache/arrow) for the most up-to-date information on dependencies, configuration, and build steps.
-
-You must enable the following features at a minimum for the datalayers plugin:
-
-```cmake
-DARROW_FLIGHT=ON \
-DARROW_FLIGHT_SQL=ON
-```
-
-Required Dependencies:
-When enabling DARROW_FLIGHT and DARROW_FLIGHT_SQL, you must ensure the following dependencies are installed on your system at least: \
-gRPC \
-Boost \
-Thrift
@@ -0,0 +1,146 @@
+# Neuron
+
+[![GitHub Release](https://img.shields.io/github/release/neugates/neuron?color=brightgreen&label=Release)](https://github.com/neugates/neuron/releases)
+[![Docker Pulls](https://img.shields.io/docker/pulls/emqx/neuron?label=Docker%20Pulls)](https://hub.docker.com/r/emqx/neuron)
+[![Slack](https://img.shields.io/badge/Slack-Neuron-39AE85?logo=slack)](https://slack-invite.emqx.io/)
+[![Discord](https://img.shields.io/discord/931086341838622751?label=Discord&logo=discord)](https://discord.gg/xYGf3fQnES)
+[![Twitter](https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)
+[![YouTube](https://img.shields.io/badge/Subscribe-EMQ-FF0000?logo=youtube)](https://www.youtube.com/channel/UC5FjR77ErAxvZENEWzQaO5Q)
+
+
+
+[English](https://github.com/neugates/neuron/blob/main/README.md) | 简体中文
+
+Neuron 是一款开源的、轻量级工业协议网关软件，支持数十种工业协议的一站式设备连接、数据接入、MQTT 协议转换，为工业设备赋予工业 4.0 时代关键的物联网连接能力。
+
+![neuron-overview](docs/pictures/neuron-final.png)
+
+以下是 Neuron 的一些重要特性：
+
+- 具有实时能力的边缘原生应用程序可以利用边缘端的低延迟网络。
+- 松耦合模块化 [架构设计](https://neugates.io/docs/zh/latest/introduction/architecture/architecture.html) 通过可插拔模块扩展更多功能服务。
+- 支持可以在运行时更新设备和应用程序模块的热插件。
+- 支持多种工业设备协议，包括 Modbus、OPCUA、Ethernet/IP、IEC104、BACnet 等 [更多协议](https://neugates.io/docs/zh/latest/configuration/south-devices/south-devices.html)。
+- 支持同时连接大量不同协议的工业设备。
+- 结合[eKuiper](https://www.lfedge.org/projects/ekuiper)提供的规则引擎功能，快速实现基于规则的设备控制或 AI/ML 分析。
+- 通过 [SparkplugB](https://neugates.io/docs/zh/latest/use-cases/use_cases.html#mqtt-sparkplugb-%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88) 解决方案支持对工业应用程序的数据访问，例如 MES 或 ERP、SCADA、historian 和数据分析软件。
+- 具有非常低的内存占用，小于 10M 的内存占用和 CPU 使用率，可以在 ARM、x86 和 RISC-V 等资源有限的硬件上运行。
+- 支持在本地安装可执行文件或部署在容器化环境中。
+- 控制工业设备，通过[HTTP API](https://neugates.io/docs/zh/latest/http-api/http-api.html)和[MQTT API](https://neugates.io/docs/en/latest/north-apps/mqtt/api.html) 服务更改参数和数据标签。
+- 与其他 EMQ 产品高度集成，包括  [EMQX](https://www.emqx.com/zh/products/emqx)、[NanoMQ](https://nanomq.io/zh)、[eKuiper](https://ekuiper.org/zh)。
+- 核心框架和 Modbus、MQTT 和 eKuiper 的代码在 LGPLv3 的许可下开源。商业模块需要 [EMQ 许可证](https://neugates.io/docs/zh/latest/introduction/license-describe.html) 才能运行。
+
+获取更多信息，请访问 [Neuron 官网](https://neugates.io/zh)。
+
+## 快速开始
+
+#### 使用 Docker 运行 Neuron
+
+```
+docker run -d --name neuron -p 7000:7000 -p 7001:7001 -p 9081:9081 --privileged=true --restart=always emqx/neuron:latest
+```
+
+接下来请参考 [快速入门](https://neugates.io/docs/zh/latest/quick-start/hardware-specifications.html) 开启您的 Neuron 之旅。
+
+> **提示**
+>
+> Neuron 开源版只包含 Modbus 和 MQTT 驱动。
+>
+> 您可以[免费申请 15 天试用期限的 License](https://www.emqx.com/zh/apply-licenses/neuron)，加载所有的驱动。
+
+#### 更多安装方式
+
+您可以从 [neugates.io/zh/downloads?os=Linux](https://neugates.io/zh/downloads?os=Linux) 下载不同格式的 Neuron 安装包进行手动安装。
+
+也可以直接访问 [Neuron 安装文档](https://neugates.io/docs/zh/latest/installation/installation.html) 查看不同安装方式的操作步骤。
+
+## 文档
+
+Neuron 文档地址：[https://neugates.io/docs/zh/latest/](https://neugates.io/docs/zh/latest/)。
+
+## 社区
+
+- 访问 [Neuron 论坛](https://askemq.com/c/neuron/8) 以获取帮助，也可以分享您的想法或项目。
+- 添加小助手微信号 `emqmkt`，加入 Neuron 微信技术交流群。
+- 加入我们的 [Discord](https://discord.gg/xYGf3fQnES)，参于实时讨论。
+- 关注我们的 [bilibili](https://space.bilibili.com/522222081)，获取最新物联网技术分享。
+- 关注我们的 [微博](https://weibo.com/emqtt) 或 [Twitter](https://twitter.com/EMQTech)，获取 Neuron 最新资讯。
+
+## 从源码构建
+
+**安装依赖**
+
+请参考 [Install-dependencies](https://github.com/emqx/neuron/blob/main/Install-dependencies.md)
+
+**编译**
+
+```
+$ git clone https://github.com/emqx/neuron
+$ cd neuron
+$ mkdir build && cd build
+$ cmake .. && make
+```
+
+**安装 Dashboard**
+
+在 [neuron-dashboard](https://github.com/emqx/neuron-dashboard/releases) 页面下载最新的 `neuron-dashboard.zip`，解压后放到 Neuron 可执行目录下的 dist 目录中。
+
+**运行**
+
+```
+$ cd build
+$ ./neuron
+```
+
+>**修改日志级别**
+>
+>在 zlog.conf 文件的规则中更改日志级别。可用的日志级别包括 INFO，DEBUG，NOTICE，WARN，ERROR 和 FATAL。
+
+## 测试
+
+### 单元测试
+
+运行所有的单元测试
+
+```shell
+$ cd build
+$ ctest --output-on-failure
+```
+
+### 功能测试
+
+运行所有的功能测试
+
+```shell
+$ sudo apt-get install -y mosquitto
+$ mosquitto -v &
+$ python3 -m pip install -U pip
+$ python3 -m pip install -r ft/requirements.txt
+$ python3 -m robot --maxerroelines=600 -P ft/ -d ft/reports ft
+```
+
+### 压力测试
+
+在目录`ft/data/persistence/`中有压力测试的数据集。
+
+运行压力测试
+
+```shell
+# 安装依赖
+$ pip3 install -r ft/requirements.txt
+
+# 使用http接口在数据集total-10k上进行测试
+$ python3 -m robot -P ft/ --variable neuron_api:http --variable dataset:total-10k -d ft/http-total-10k ft/pressure.test
+# 使用http接口在数据集total-50k上进行测试
+$ python3 -m robot -P ft/ --variable neuron_api:http --variable dataset:total-50k -d ft/http-total-50k ft/pressure.test
+
+# 如果使用mqtt接口则需要MQTT服务器，此例为mosquitto
+$ mosquitto -v &
+
+# 使用mqtt接口在数据集simple-1k上进行测试
+$ python3 -m robot -P ft/ --variable neuron_api:mqtt --variable dataset:simple-1k -d ft/mqtt-simple-1k ft/pressure.test
+```
+
+## 开源许可
+
+详见 [LICENSE](./LICENSE)。
@@ -8,140 +8,90 @@
 [![Twitter](https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=twitter)](https://twitter.com/EMQTech)
 [![YouTube](https://img.shields.io/badge/Subscribe-EMQ-FF0000?logo=youtube)](https://www.youtube.com/channel/UC5FjR77ErAxvZENEWzQaO5Q)

-Neuron is an Industrial IoT (IIoT) connectivity server that bridges industrial devices and modern data platforms. It supports dozens of industrial protocols and converts them into MQTT for seamless integration between IIoT platforms and shop-floor devices.
+Neuron is an Industrial IoT (IIoT) connectivity server for modern big data and AI/ML technology to leverage the power of Industrial 4.0. It supports one-stop access to dozens of industrial protocols and converts them into MQTT protocol and realize the interconnection between IIoT platforms and various industrial devices.

 ![neuron-overview](docs/pictures/neuron-final.png)

-Key features:
+The following are some important features of Neuron:

- Edge-native application with real-time capability and low latency at the edge.
- Loosely coupled modular architecture with pluggable modules for easy extension.
- Hot-pluggable plugins: update device and application modules at runtime.
- Broad protocol support: Modbus, OPC UA, Ethernet/IP, IEC 60870-5-104, BACnet, and more.
- High concurrency: connect many devices with heterogeneous protocols simultaneously.
- Built-in stream processing via [eKuiper](https://www.lfedge.org/projects/ekuiper) for rules and AI/ML analytics.
- Northbound access for MES/ERP, SCADA, historians, and analytics via Sparkplug B.
- Tiny footprint (<10 MB) and low CPU usage; runs on ARM, x86, and RISC-V.
- Flexible deployments: native binaries or containers.
- Manage devices and tags via [HTTP API](docs/api/english/http.md) and [MQTT API](docs/api/english/mqtt.md).
- Works well with [EMQX](https://www.emqx.com/en/products/emqx), [NanoMQ](https://nanomq.io/), and [eKuiper](https://ekuiper.org/).
- Core framework and Modbus/MQTT/eKuiper plugins are available under LGPLv3.
+- Edge native application with real-time capability to leverage the low latency network of edge side.
+- Loosely-coupled modularity [architecture design](https://neugates.io/docs/en/latest/introduction/architecture/architecture.html) for extending more functional services by pluggable modules.
+- Support hot plugins that can update device and application modules during runtime.
+- Support numerous protocols for industrial devices, including Modbus, OPCUA, Ethernet/IP, IEC104, BACnet and [more](https://neugates.io/docs/en/latest/configuration/south-devices/south-devices.html).
+- Support simultaneous connection of a large number of industrial devices with different protocols.
+- Combine with the rule engine function provided by [eKuiper](https://www.lfedge.org/projects/ekuiper) to quickly implement rule-based device control or AI/ML analytics.
+- Support data access to industrial applications, such as MES or ERP, SCADA, historian and data analytics software via [SparkplugB](https://neugates.io/docs/en/latest/use-cases/use_cases.html#mqtt-sparkplugb-solution) solution.
+- Has very low memory footprint, less than 10M, and CPU usage, can run on limited resource hardware like ARM, x86 and RISC-V.
+- Support installation of native executable or deployed in containerized enviornment.
+- Control industrial devices, and make changes to the parameters and data tags through [HTTP API](https://neugates.io/docs/en/latest/http-api/http-api.html) and [MQTT API](https://neugates.io/docs/en/latest/configuration/north-apps/mqtt/api.html) services.
+- Highly integrated with other EMQ products, including [EMQX](https://www.emqx.com/en/products/emqx), [NanoMQ](https://nanomq.io/), [eKuiper](https://ekuiper.org/).
+- The code of the core framework and Modbus, MQTT and eKuiper are licensed under open source LGPLv3. Commercial modules require a [EMQ License](https://neugates.io/docs/en/latest/installation/license-install/license-install.html) to run.

-## About NeuronEX
+For more information, please visit [Neuron homepage](https://neugates.io/).

-[NeuronEX](https://www.emqx.com/en/products/emqx-neuron) is the commercial distribution of Neuron, offering extended capabilities and professional support. Compared to the open-source Neuron:
+## Get Started

- **Extended protocol support**: Additional industrial protocols (e.g., OPC UA, Siemens S7, Ethernet/IP, etc.)
- **Advanced dashboard**: Full-featured web UI with enhanced visualization and management capabilities
- **Enterprise plugins**: More southbound device adapters, northbound application connectors, and rule engines
- **Cloud integration**: Direct connectors for major cloud platforms (AWS, Azure, Google Cloud, etc.)
- **Data security**: Enhanced encryption, auditing, and compliance features
+#### Run Neuron using Docker

-For more details, visit the [NeuronEX documentation](https://docs.emqx.com/en/neuronex/latest/).
-
-## Table of Contents
-
- [Quick Start](#quick-start)
- [Installation](#installation)
-	- [Binaries](#binaries)
-	- [Build from Source](#build-from-source)
- [Configuration](#configuration)
- [Documentation](#documentation)
- [Dashboard](#dashboard)
- [Community](#community)
- [Contributing](#contributing)
- [Security](#security)
- [License](#license)
-
-## Quick Start
-
-Default credentials: username `admin`, password `0000`.
-
-### Download
-
-You can download from [Release](https://github.com/emqx/neuron/releases).
-
-```bash
-$ tar xvf neuron-{version}-linux-amd64.tar.gz
-$ cd neuron
-$ ./neuron --log
+```
+docker run -d --name neuron -p 7000:7000 -p 7001:7001 -p 9081:9081 --privileged=true --restart=always emqx/neuron:latest
 ```

-Open a browser and navigate to `http://localhost:7000` to access the Neuron web interface.
+Next, please follow the [getting started guide](https://neugates.io/docs/en/latest/quick-start/hardware-specifications.html) to tour the Neuron features.

-## Installation
+> **Limitations**
+>
+> Neuron open source edition only includes Modbus and MQTT drivers.
+>
+> [Apply for a 15-day trial license](https://www.emqx.com/en/apply-licenses/neuron) to load all drivers.

-### Binaries
+#### More installation options

-Download the latest release from [Releases](https://github.com/emqx/neuron/releases), then extract and run as shown above.
+If you prefer to install and manage Neuron yourself, you can download the latest version from [neugates.io/downloads?os=Linux](https://neugates.io/downloads?os=Linux).

-### Build from Source
-
-1. [Install Dependencies](./Install-dependencies.md)
-
-2. Build Neuron
-```bash
-$ git clone https://github.com/emqx/neuron
-$ cd neuron && mkdir build && cd build
-$ cmake .. && make
-```
-
-3. Download and Unzip Dashboard
-```bash
-$ wget https://github.com/emqx/neuron-dashboard/releases/download/2.6.3/neuron-dashboard.zip
-
-# Unzip neuron-dashboard.zip to the build directory
-$ unzip neuron-dashboard.zip
-```
-
-4. Run Neuron
-```bash
-$ ./neuron --log
-```
-
-On the first startup, Neuron will automatically generate `neuron.key` and `neuron.key.pub` in the config directory if they do not exist yet.
-
-If you want to pre-generate the key pair manually, you can still run:
-
-```bash
-$ bash ./generate_rsa_keypair.sh ./build/config
-```
-
-5. Open a browser and navigate to `http://localhost:7000` to access the Neuron web interface.
-
-## Configuration
-
- Web UI: `http://localhost:7000` (default credentials above)
- Main config: `neuron.conf`
- Default plugins: `default_plugins.json`
- Logging: `zlog.conf` / `sdk-zlog.conf`
-
-See the quick start for a hands-on walkthrough.
+For more installation options, see the [Neuron installation documentation](https://neugates.io/docs/en/latest/installation/installation.html).

 ## Documentation

- Quick start: [Modbus TCP collection and MQTT publishing](./docs/quick_start/quick_start.md)
- APIs: [HTTP](docs/api/english/http.md), [MQTT](docs/api/english/mqtt.md)
+The Neuron documentation is available at [neugates.io/docs/en/latest/](https://neugates.io/docs/en/latest/).

-## Dashboard
-
-The open-source version of the [Dashboard](https://github.com/emqx/neuron-dashboard) is currently at version 2.6.3, which has been suspended for development and maintenance. This version is also the one integrated by default with Neuron. For a more complete and professional Dashboard, please use [NeuronEX](https://www.emqx.com/en/products/neuronex).
-
-## Community
+## Get Involved

 - Follow [@EMQTech on Twitter](https://twitter.com/EMQTech).
 - If you have a specific question, check out our [discussion forums](https://github.com/emqx/neuron/discussions).
 - For general discussions, join us on the [official Discord](https://discord.gg/xYGf3fQnES) team.
 - Keep updated on [EMQ YouTube](https://www.youtube.com/channel/UC5FjR77ErAxvZENEWzQaO5Q) by subscribing.

-## Contributing
+## Build From Source

-Contributions are welcome! Feel free to open issues and pull requests to improve Neuron. If you plan a larger change, please start a discussion first to align on direction.
+**Install required dependencies**

-## Security
+[Install-dependencies](https://github.com/emqx/neuron/blob/main/Install-dependencies.md)

-If you believe you have found a security vulnerability, please avoid creating a public issue. Instead, contact the maintainers privately (e.g., via GitHub Security Advisories) so we can investigate and fix it responsibly.
+**Build**

+```
+$ git clone https://github.com/emqx/neuron
+$ cd neuron
+$ mkdir build && cd build
+$ cmake .. && make
+```
+
+**Install Dashboard**
+
+Download the latest `neuron-dashboard.zip` from the [neuron-dashboard](https://github.com/emqx/neuron-dashboard/releases) page, unzip it and put it to the `dist` directory under the Neuron executable directory.
+
+**Run**
+
+```
+$ cd build
+$ ./neuron
+```
+
+>**Log level**
+>
+>Change the log level in the rules in the zlog.conf file. Available levels include INFO, DEBUG, NOTICE, WARN, ERROR and FATAL.
+>

 ## License

@@ -1,23 +0,0 @@
-# Security Policy
-
-## Private reporting
-
-The canonical [Neuron security policy](.github/SECURITY.md) governs vulnerability reporting, supported release tracks, and coordinated disclosure. This page adds reporting context for the open-source Neuron code maintained in this repository; it does not establish a separate support or reward policy.
-
-**Do not disclose vulnerabilities through public issues, discussions, or pull requests.** Open the [Neuron Security tab](https://github.com/emqx/neuron/security) and select **Report a vulnerability** to report privately.
-
-## Neuron report context
-
-Include the affected version/commit or image digest, component, safe reproduction, observed impact, and affected/unaffected conditions. In particular, specify:
-
- Neuron deployment/package and whether access is direct or through an operator-managed reverse proxy.
- Effective management binding, authentication/token configuration, and direct or proxied access path.
- Attacker identity/permissions and controlled input: REST request, device response, broker message, import, file, or other source.
- Relevant plugin, transport/TLS mode, broker topic/direction ACLs, and device-write prerequisites.
- Whether the demonstrated effect is disclosure, denied/unauthorized action, crash, persistent availability loss, memory corruption, or execution. Distinguish observed effects from downstream hypotheses.
-
-Use synthetic credentials and isolated services/simulators. Do not test customer systems or real equipment without authorization, and transmit sensitive evidence only in the private report.
-
-The [threat model](docs/threat-model.md) explains deployment boundaries and intended capabilities. Loopback/private networking and authenticated peers are assessment context, not blanket exclusions. Anonymous metrics and authorized native extensions have intended uses; report a concrete confidentiality, integrity, availability, or authorization violation rather than the capability alone.
-
-Maintainers and automated reviewers should also follow [AGENTS.md](AGENTS.md). Do not place private vulnerability details in public review comments.
@@ -1,7 +1,7 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(COMPILER_PREFIX aarch64-linux-gnu)
 set(CMAKE_SYSTEM_PROCESSOR aarch64)
-set(LIBRARY_DIR /home/neuron/main/libs)
+set(LIBRARY_DIR /home/neuron/v2.7/libs)

 set(CMAKE_C_COMPILER ${COMPILER_PREFIX}-gcc)
 set(CMAKE_CXX_COMPILER ${COMPILER_PREFIX}-g++)
@@ -21,9 +21,4 @@ set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
 set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
 link_directories(${CMAKE_STAGING_PREFIX})

-file(COPY ${CMAKE_STAGING_PREFIX}/lib/libzlog.so.1.2 DESTINATION /usr/local/lib)
-file(COPY ${CMAKE_STAGING_PREFIX}/lib/librdkafka.so.1 DESTINATION /usr/local/lib)
-file(GLOB ZSTD_LIBS "${CMAKE_STAGING_PREFIX}/lib/libzstd.so*")
-file(COPY ${ZSTD_LIBS} DESTINATION /usr/local/lib)
-file(GLOB SASL_LIBS "${CMAKE_STAGING_PREFIX}/lib/libsasl2.so*")
-file(COPY ${SASL_LIBS} DESTINATION /usr/local/lib)
+file(COPY ${CMAKE_STAGING_PREFIX}/lib/libzlog.so.1.2 DESTINATION /usr/local/lib)
@@ -1,7 +1,7 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(COMPILER_PREFIX arm-linux-gnueabi)
 set(CMAKE_SYSTEM_PROCESSOR armv5tejl)
-set(LIBRARY_DIR /home/neuron/main/libs)
+set(LIBRARY_DIR /home/neuron/v2.7/libs)

 set(CMAKE_C_COMPILER ${COMPILER_PREFIX}-gcc)
 set(CMAKE_CXX_COMPILER ${COMPILER_PREFIX}-g++)
@@ -22,8 +22,3 @@ set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
 link_directories(${CMAKE_STAGING_PREFIX})

 file(COPY ${CMAKE_STAGING_PREFIX}/lib/libzlog.so.1.2 DESTINATION /usr/local/lib)
-file(COPY ${CMAKE_STAGING_PREFIX}/lib/librdkafka.so.1 DESTINATION /usr/local/lib)
-file(GLOB ZSTD_LIBS "${CMAKE_STAGING_PREFIX}/lib/libzstd.so*")
-file(COPY ${ZSTD_LIBS} DESTINATION /usr/local/lib)
-file(GLOB SASL_LIBS "${CMAKE_STAGING_PREFIX}/lib/libsasl2.so*")
-file(COPY ${SASL_LIBS} DESTINATION /usr/local/lib)
@@ -1,7 +1,7 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(COMPILER_PREFIX arm-linux-gnueabihf)
 set(CMAKE_SYSTEM_PROCESSOR armv7l)
-set(LIBRARY_DIR /home/neuron/main/libs)
+set(LIBRARY_DIR /home/neuron/v2.7/libs)

 set(CMAKE_C_COMPILER ${COMPILER_PREFIX}-gcc)
 set(CMAKE_CXX_COMPILER ${COMPILER_PREFIX}-g++)
@@ -21,9 +21,4 @@ set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
 set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
 link_directories(${CMAKE_STAGING_PREFIX})

-file(COPY ${CMAKE_STAGING_PREFIX}/lib/libzlog.so.1.2 DESTINATION /usr/local/lib)
-file(COPY ${CMAKE_STAGING_PREFIX}/lib/librdkafka.so.1 DESTINATION /usr/local/lib)
-file(GLOB ZSTD_LIBS "${CMAKE_STAGING_PREFIX}/lib/libzstd.so*")
-file(COPY ${ZSTD_LIBS} DESTINATION /usr/local/lib)
-file(GLOB SASL_LIBS "${CMAKE_STAGING_PREFIX}/lib/libsasl2.so*")
-file(COPY ${SASL_LIBS} DESTINATION /usr/local/lib)
+file(COPY ${CMAKE_STAGING_PREFIX}/lib/libzlog.so.1.2 DESTINATION /usr/local/lib)
@@ -21,10 +21,3 @@ link_directories(${CMAKE_STAGING_PREFIX})
 if(CMAKE_SYSTEM_PROCESSOR MATCHES "mips32")
 	link_libraries(atomic)
 endif()
-
-if(CMAKE_SYSTEM_PROCESSOR MATCHES "riscv64")
-	link_libraries(atomic)
-endif()
-if(CMAKE_SYSTEM_PROCESSOR MATCHES "loongarch64")
-        link_libraries(atomic)
-endif()
@@ -1,7 +1,7 @@
 set(CMAKE_SYSTEM_NAME Linux)
 set(COMPILER_PREFIX x86_64-linux-gnu)
 set(CMAKE_SYSTEM_PROCESSOR x86_64)
-set(LIBRARY_DIR /home/neuron/main/libs)
+set(LIBRARY_DIR /home/neuron/v2.7/libs)

 set(CMAKE_C_COMPILER ${COMPILER_PREFIX}-gcc)
 set(CMAKE_CXX_COMPILER ${COMPILER_PREFIX}-g++)
@@ -13,11 +13,6 @@ set(CMAKE_RANLIB ${COMPILER_PREFIX}-ranlib)
 set(CMAKE_STAGING_PREFIX ${LIBRARY_DIR}/${COMPILER_PREFIX})
 set(CMAKE_PREFIX_PATH ${CMAKE_STAGING_PREFIX})

-set(CMAKE_INTERPROCEDURAL_OPTIMIZATION OFF)
-
-set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fno-lto")
-set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fno-lto")
-
 include_directories(SYSTEM ${CMAKE_STAGING_PREFIX}/include)
 include_directories(SYSTEM ${CMAKE_STAGING_PREFIX}/openssl/include)
 set(CMAKE_FIND_ROOT_PATH ${CMAKE_STAGING_PREFIX})
@@ -27,8 +22,3 @@ set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
 link_directories(${CMAKE_STAGING_PREFIX})

 file(COPY ${CMAKE_STAGING_PREFIX}/lib/libzlog.so.1.2 DESTINATION /usr/local/lib)
-file(COPY ${CMAKE_STAGING_PREFIX}/lib/librdkafka.so.1 DESTINATION /usr/local/lib)
-file(GLOB ZSTD_LIBS "${CMAKE_STAGING_PREFIX}/lib/libzstd.so*")
-file(COPY ${ZSTD_LIBS} DESTINATION /usr/local/lib)
-file(GLOB SASL_LIBS "${CMAKE_STAGING_PREFIX}/lib/libsasl2.so*")
-file(COPY ${SASL_LIBS} DESTINATION /usr/local/lib)
@@ -1,9 +0,0 @@
-ignore:
-  - "src/otel/*.pb-c.c"
-  - "plugins/mqtt/azure_iot_plugin.c"
-coverage:
-  status:
-    project:
-      default:
-        target: auto    # the required coverage value
-        threshold: 0.1%  # the leniency in hitting the target
@@ -11,24 +11,6 @@ function gen_trace () {
 }

 case $1 in
-    (ut)
-        rm -f cov_report/cov-neuron.info cov_report/cov-restful.info
-        for dir in build/tests/ut/CMakeFiles/*_test.dir; do
-            test_name=$(basename ${dir} "_test.dir")
-            lcov -c -d ${dir} -o "cov_report/cov-${test_name}_test.info"
-        done
-        cd cov_report
-        lcov $(for file in cov-*.info; do echo "-a $file "; done) -a cov-neuron-base.info -o cov-ut.info;;
-    (ft)
-        lcov -c -d build/plugins/mqtt/CMakeFiles/plugin-mqtt.dir -o cov_report/cov-mqtt.info
-        lcov -c -d build/plugins/modbus/CMakeFiles/plugin-modbus-rtu.dir -o cov_report/cov-modbus-rtu.info
-        lcov -c -d build/plugins/modbus/CMakeFiles/plugin-modbus-tcp.dir -o cov_report/cov-modbus-tcp.info
-        cd cov_report
-        gen_trace -a cov-mqtt.info -a cov-modbus-rtu.info -a cov-modbus-tcp.info -o cov-ft.info;;
-    (ekuiper)
-        lcov -c -d build/plugins/ekuiper/CMakeFiles/plugin-ekuiper.dir -o cov_report/cov-ekuiper.info
-        cd cov_report
-        gen_trace -a cov-ekuiper.info -o cov-ekuiper.info;;
    (modbus)
        lcov -c -d build/plugins/modbus/CMakeFiles/plugin-modbus-rtu.dir -o cov_report/cov-modbus-rtu.info
        lcov -c -d build/plugins/modbus/CMakeFiles/plugin-modbus-tcp.dir -o cov_report/cov-modbus-tcp.info
@@ -39,10 +21,6 @@ case $1 in
        lcov -c -d build/plugins/mqtt/CMakeFiles/plugin-mqtt.dir -o cov_report/cov-mqtt.info
        cd cov_report
        gen_trace -a cov-mqtt.info -o cov-mqtt.info;;
-    (azure)
-        lcov -c -d build/plugins/mqtt/CMakeFiles/plugin-azure-iot.dir -o cov_report/cov-azure.info
-        cd cov_report
-        gen_trace -a cov-azure.info -o cov-azure.info;;
    (core)
        cd cov_report
        gen_trace -o cov-core.info;;
@@ -1,12 +1,8 @@
 {
 	"plugins": [
 		"libplugin-mqtt.so",
-		"libplugin-aws-iot.so",
-		"libplugin-azure-iot.so",
 		"libplugin-ekuiper.so",
 		"libplugin-modbus-tcp.so",
-		"libplugin-modbus-rtu.so",
-		"libplugin-file.so",
-		"libplugin-kafka.so"
+		"libplugin-modbus-rtu.so"
 	]
-}
+}
@@ -6,7 +6,10 @@ file perms = 666

 stdout_format = "%d:%ms [%V] [%c] %f:%L %m%n"
 file_format = "%d:%ms [%V] %f:%L %m%n"
+syslog = "<P>%d(%Y-%m-%dT%T%z) %H neuron[%p]: level=%v msg="[%c] %m" file="%f:%L"%n"
+
 [rules]

-*.*     "./logs/%c.log", 50MB * 2 ~ "./logs/%c.#2r.log"; file_format
+*.*     "./logs/%c.log", 25MB * 1 ~ "./logs/%c.#2r.log"; file_format
 *.*    	>stdout; stdout_format
+*.*     $remote_syslog,"%V"; syslog
@@ -1,482 +0,0 @@
-# 数据上下行格式
-
-以下内容描述 MQTT 插件如何上报采集的数据，以及如何通过 MQTT 插件实现读写点位数据。
-
-
-## 数据上报
-
-MQTT 插件将采集到的数据以 JSON 形式发布到指定的主题。
-上报数据的具体格式由**上报数据格式**参数指定，有[**Values-format 格式**](#values-format-格式)、[**Tags-format 格式**](#tags-format-格式)、[**ECP-format 格式**](#ecp-format-格式)、[**Custom 自定义格式**](#custom-自定义格式)多种格式可选。
-
-### 上报主题
-
-上报主题在北向节点订阅中指定，其默认值为 **/neuron/{MQTT driver name}** ，见下图
-
-### Values-format 格式
-
-在 **Values-format** 格式中， 上报的数据由以下字段构成：
-* `timestamp` : 数据采集时的 UNIX 时间戳。
-* `node` : 被采集的南向节点的名字。
-* `group` : 被采集的南向节点的点位组的名字。
-* `values` : 存储采集成功的点位值的字典。
-* `errors` : 存储采集失败的错误码的字典。
-* `metas` : 驱动相关的元数据信息。
-
-以下为使用 **values-format** 格式的数据样例，采集成功的点位数据值存放在`values`键中，采集失败的点位错误码存放在`errors`键中。
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus",
-    "group": "grp",
-    "values":
-    {
-        "tag0": 123
-    },
-    "errors":
-    {
-        "tag1": 2014
-    },
-    "metas":{}
-}
-```
-
-::: tip 注意
-
-当点位采集成功时，返回采集到的数据。当点位采集发生错误时，返回错误码，不再返回数值。
-
-当 MQTT 插件配置项 **上报点位错误码** 为 **False** 时，不上报点位错误码。
-:::
-
-### Tags-format 格式
-
-在 **Tags-format** 格式中， 上报的数据由以下字段构成：
-* `timestamp` : 数据采集时的 UNIX 时间戳。
-* `node` : 被采集的南向节点的名字。
-* `group` : 被采集的南向节点的点位组的名字。
-* `tags` : 点位数据数组，每个元素对应一个点位。
-* `name` : 具体的点位名称字段。
-* `value` : 具体点位对应的值。
-* `error` : 具体点位对应的错误码。
-
-以下为使用 **Tags-format** 格式的数据样例，其中所有点位数据存放在一个数组中，每个数组元素包含点位的名字，采集成功时的数据值或者采集失败时的错误码。
-
-```json
-{
-  "timestamp": 1647497389075,
-  "node": "modbus",
-  "group": "grp",
-  "tags": [
-    {
-      "name": "tag0",
-      "value": 123,
-    },
-    {
-      "name": "tag1",
-      "error": 2014
-    }
-  ]
-}
-```
-
-::: tip 注意
-
-当点位采集成功时，返回采集到的数据。当点位采集发生错误时，返回错误码，不再返回数值。
-
-当 MQTT 插件配置项 **上报点位错误码** 为 **False** 时，不上报点位错误码。
-:::
-
-### ECP-format 格式
-
-在 **ECP-format** 格式中， 上报的数据由以下字段构成：
-* `timestamp` : 数据采集时的 UNIX 时间戳。
-* `node` : 被采集的南向节点的名字。
-* `group` : 被采集的南向节点的点位组的名字。
-* `tags` : 点位数据数组，每个元素对应一个点位。
-* `name` : 具体的点位名称字段。
-* `value` : 具体点位对应的值。
-* `type` : 具体点位对应的数据类型，共包含布尔、整型、浮点型、字符串四种数据类型。
-
-
-以下为使用 *ECP-format* 格式的数据样例，其中所有点位数据存放在一个数组中，每个数组元素包含点位的名字，点位的数据类型和采集成功时的数据值，不包含采集失败的点位。
-数据类分为布尔、整型、浮点型、字符串四种。
-* type = 1 布尔
-* type = 2 整型
-* type = 3 浮点型
-* type = 4 字符串
-
-```json
-{
-  "timestamp": 1647497389075,
-  "node": "modbus",
-  "group": "grp",
-  "tags": [
-    {
-      "name": "tag_boolean",
-      "value": true,
-      "type": 1,
-    },
-    {
-      "name": "tag_int32_",
-      "value": 123,
-      "type": 2,
-    },
-    {
-      "name": "tag_float",
-      "value": 1.23,
-      "type": 3,
-    },
-    {
-      "name": "tag_string",
-      "value": "abcd",
-      "type": 4,
-    }
-  ]
-}
-```
-
-::: tip 注意
-ECP-format 格式不支持上报点位错误码。
-不管 MQTT 插件配置项 **上报点位错误码** 为 **False** 或为 **True** ，都不上报点位错误码。
-:::
-
-### Custom 自定义格式
-
-在自定义格式中，可以使用内置支持的变量自定义数据上报格式。
-
-![custom-format](./assets/custom-format.png)
-
-#### 内置变量
-
-| **变量名称** | **说明** |
-| ------------------ | ---------------------- | 
-| `${timestamp}` | 数据采集时的 UNIX 时间戳。 |
-| `${node}` | 南向采集点位所属的南向驱动名称。<br> 示例：`modbus` |
-| `${group}` | 南向采集点位所属的南向驱动的采集组的名称。<br> 示例：`group` |
-| `${tags}` | 南向采集点位有效值的数组集合。<br> 示例：`[{"name": "tag1", "value": 123}, {"name": "tag2", "value": 456}]` |
-| `${tag_values}` | 南向采集点位有效值的Json集合。<br> 示例：`{"tag1": 123, "tag2": 456}` |
-| `${tag_errors}` | 南向采集点位报错值的数组集合。<br> 示例：`[{"name": "tag3", "error": 2014}, {"name": "tag4", "error": 2015}]` |
-| `${tag_error_values}` | 南向采集点位报错值的Json集合。<br> 示例：`{"tag3": 2014, "tag4": 2015}` |
-| `${static_tags}` | 订阅采集组时，自定义配置的静态点位的数组集合。<br> 示例： `[{"name": "static_tag1", "value": "abc"}, {"name": "static_tag2", "value": "def"}]` <br> 详见 [静态点位](#静态点位)|
-| `${static_tag_values}` | 订阅采集组时，自定义配置的静态点位的Json集合。<br> 示例： `{"static_tag1": "abc", "static_tag2": "def"}`<br> 详见 [静态点位](#静态点位) |
-
-::: tip 注意
-`${tags}` 和 `${tag_values}` 是采集数据点的2种不同格式，`${tags}` 是数组格式，`${tag_values}` 是Json格式。一般在构建自定义数据上报格式时，使用 `${tags}` 或 `${tag_values}` 中的一种即可。
-
-`${static_tags}` 和 `${static_tag_values}`、`${tag_errors}`和`${tag_error_values}` 同理，使用其中一种即可。
-
- MQTT 插件配置项 **上报点位错误码** 为 **False** 时，即使配置了`${tag_errors}` 和或 `${tag_error_values}`，也不上报点位错误码信息。
-
-:::
-
-
-
-上表中示例部分，原始南向驱动`modbus1`采集组`group1`下，包含4个点位，其中`tag1`和`tag2`的点位采集数据正常，`tag3`和`tag4`的点位采集数据异常。在北向节点订阅时，自定义配置的静态点位为`static_tag1`和`static_tag2`，其值分别为`abc`和`def`。
-
-以上配置，以 Values-format 数据格式上报时，内容如下：
-
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus1",
-    "group": "group1",
-    "values": {"tag1": 123, "tag2": 456, "static_tag1": "abc", "static_tag2": "def"},
-    "errors": {"tag3": 2014, "tag4": 2015},
-    "metas":{}
-}
-```
-
-以下示例通过设定不同的 Custom 配置，将上面 Json 报文输出为不同的数据上报格式。
-#### 示例一
-
-将数据点位转换为数组格式，并自定义Json 键名。
-
-```json
-{
-    "timestamp": "${timestamp}",
-    "node": "${node}",
-    "group": "${group}",
-    "custom_tag_name": "${tags}",
-    "custom_tag_errors": "${tag_errors}",
-}
-```
-
-实际输出结果如下：
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus1",
-    "group": "group1",
-    "custom_tag_name": [{"name": "tag1", "value": 123}, {"name": "tag2", "value": 456}],
-    "custom_tag_errors": [{"name": "tag3", "error": 2014}, {"name": "tag4", "error": 2015}]
-}
-```
-
-#### 示例二
-
-通过自定义数据格式，添加全局静态点位。该静态点位在所有驱动采集组上报数据时，均会携带。如 NeuronEX 部署在一个物理网关上，可将网关的SN号、IP地址、位置信息等信息，添加到所有驱动采集组中。
-
-```json
-{
-    "timestamp": "${timestamp}",
-    "node": "${node}",
-    "group": "${group}",
-    "values": "${tag_values}",
-    "gateway_info": {
-      "ip": "192.168.1.100",
-      "sn": "SN123456789",
-      "location": "shanghai"
-    }
-}
-```
-实际输出结果如下：
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus1",
-    "group": "group1",
-    "values": {"tag1": 123, "tag2": 456},
-    "gateway_info": {
-      "ip": "192.168.1.100",
-      "sn": "SN123456789",
-      "location": "shanghai"
-    }
-}
-```
-
-#### 示例三
-
-将采集数据点位、静态点位、驱动、采集组信息放入 Json 子节点中，可自定义 Json 节点名称。目前自定义数据结构做多支持三层子层级。
-
-```json
-{
-    "timestamp": "${timestamp}",
-    "data": {
-      "child_node": {
-        "node": "${node}",
-        "group": "${group}",
-        "tag_values": "${tag_values}",
-        "static_tag_values": "${static_tag_values}",
-        "tag_error_values": "${tag_error_values}"
-      }
-    }
-}
-```
-
-数据上报的格式为：
-```json
-{
-    "timestamp": 1650006388943,
-    "data": {
-      "child_node": {
-        "node": "modbus",
-        "group": "group",
-        "tag_values": {"tag1": 123, "tag2": 456},
-        "static_tag_values": {"static_tag1": "abc", "static_tag2": "def"},
-        "tag_error_values": {"tag3": 2014, "tag4": 2015}
-      }
-    }
-}
-```
-
-
-## 静态点位
-
-静态点位功能，支持在南向驱动数据上报时，由用户在**北向应用组列表**页面手动配置静态点位，在数据上报时，将静态点位数据一并上报。
-
-![static-tags](./assets/static-tags.png)
-
-静态点位配置，需输入标准JSON格式内容，每个静态点位均为JSON对象中的键值对。静态点位将根据配置的数据上报格式（Values-format、Tags-format、ECP-format）与采集组数据一并上报。
-
-```json
-  {
-      "location": "sh",
-      "sn_number": "123456"
-  }
-
-```
-
-每个南向采集组，可分别配置不同静态点位。表示该采集组代表的物理设备，具有哪些静态属性信息。
-
-静态点位功能支持布尔、整型、浮点型、字符串四种数据类型。复杂数据类型，如数组、结构体等，将以字符串形式上报。
-
-如果添加的静态点位，为 NeuronEX 实例中所有采集组共用，既可以勾选**所有采集组**，添加静态点位，也可以在 Custom 自定义格式中，统一添加静态点位，参考 [自定义格式：示例二](#自定义格式)。
-
-::: tip 注意
-静态点位命名，不能和南向驱动采集的点位名称相同。
-
-如命名相同，则如果选择`Values-format`上报数据时，静态点位数据将覆盖南向驱动采集的点位数据.
-
-如果选择`Tags-format`、`ECP-format`或`Custom`上报数据时，静态点位数据将和南向驱动采集的点位数据一起重复上报。
-:::
-
-## 读 Tags
-
-### 请求
-
-通过发送 JSON 形式的请求到 MQTT 主题 **/neuron/{node_name}/read/req**，您可以读取一组点位数据。
-
-#### 请求体
-
-读请求体由以下字段构成：
-* `uuid` : 唯一的标志，会在响应中原样返回用以区分对应的请求。
-* `node` : 某个南向节点名字。
-* `group` : 南向节点的某个组的名字。
-
-以下为一个读请求样例：
-
-```json
-{
-    "uuid": "bca54fe7-a2b1-43e2-a4b4-1da715d28eab",
-    "node": "modbus",
-    "group": "grp"
-}
-```
-
-### 响应
-
-读响应会发布到 MQTT 主题 **/neuron/{node_name}/read/resp** 。
-
-#### 响应体
-
-读响应体由以下字段构成：
-* `uuid` : 对应请求中所设置的唯一标志。
-* `tags` : 点位数据数组，和 [tags 格式](#tags-格式)中的表示方法一样。
-
-以下为一个读响应样例：
-
-```json
-{
-  "uuid": "bca54fe7-a2b1-43e2-a4b4-1da715d28eab",
-  "tags": [
-    {
-      "name": "tag0",
-      "value": 4,
-    },
-    {
-      "name": "tag1",
-      "error": 2014
-    }
-  ]
-}
-```
-
-::: tip
-当点位采集成功时，返回采集到的数据。当点位采集发生错误时，返回错误码，不再返回数值。
-:::
-
-## 写 Tag
-
-### 请求
-
-通过发送 JSON 形式的请求到**写请求主题**参数指定的 MQTT 主题，您可以写一个点位数据。可在 MQTT 参数配置中配置写请求的主题，默认为为 **/neuron/{random_str}/write/req**。
-
-
-#### 请求体
-
-#### 写一个 Tag
-
-写请求体由以下字段构成：
-* `uuid` : 唯一的标志，会在响应中原样返回用以区分对应的请求。
-* `node` : 某个南向节点名字。
-* `group` : 南向节点的某个组的名字。
-* `tag` : 要写入的点位名字。
-* `value` : 要写入的数据值。
-
-以下为一个写请求样例：
-
-```json
-{
-    "uuid": "cd32be1b-c8b1-3257-94af-77f847b1ed3e",
-    "node": "modbus",
-    "group": "grp",
-    "tag": "tag0",
-    "value": 1234
-}
-```
-
-#### 写多个 Tag
-
-Neuron 提供了对多点位写入的支持。要在一次请求中可以写入多个点位数据, 写请求体应由以下字段构成：
-* `uuid` : 唯一的标志，会在响应中原样返回用以区分对应的请求。
-* `node` : 某个南向节点名字。
-* `group` : 南向节点的某个组的名字。
-* `tags` : 点位数据数组，每个元素对应一个点位。
-
-以下为一个写请求样例：
-
-```json
-{
-    "uuid": "cd32be1b-c8b1-3257-94af-77f847b1ed3e",
-    "node": "modbus",
-    "group": "grp",
-    "tags": [
-      {
-        "tag": "tag0",
-        "value": 1234
-      },
-      {
-        "tag": "tag1",
-        "value": 5678
-      }
-    ]
-}
-```
-
-### 响应
-
-写响应会发布到**写响应主题**参数指定的 MQTT 主题。默认**写响应主题**参数为 **/neuron/{random_str}//write/resp**。
-
-#### 响应体
-
-写响应体由以下字段构成：
-* `uuid` : 对应请求中所设置的唯一标志。
-* `error` : 错误码。0 代表成功，非零代表失败。
-
-以下为一个读响应样例：
-```json
-{
-  "uuid": "cd32be1b-c8b1-3257-94af-77f847b1ed3e",
-  "error": 0
-}
-```
-
-## 驱动状态上报
-
-上报所有南向驱动状态到指定的 MQTT 主题。
-
-### 状态上报主题
-
-上报主题在北向节点配置中指定，其默认值为 **/neuron/{random_str}/state/update** 
-
-### 状态上报间隔
-
-状态上报间隔在北向节点配置中指定，指每条消息之间间隔的秒数，其默认值为 1，允许的范围为 1-3600。
-
-### 上报消息格式
-
-上报的数据由以下字段构成：
-* `timestamp` : 数据采集时的 UNIX 时间戳。
-* `states` : 节点状态信息的数组。
-
-以下是一个驱动状态上报消息样例。
-
-```json
-{
-  "timestamp": 1658134132237,
-  "states": [
-    {
-      "node": "modbus-tcp",
-      "link": 1,
-      "running": 3
-    },
-    {
-      "node": "modbus-rtu",
-      "link": 1,
-      "running": 3
-    }
-  ]
-}
-```
@@ -1,492 +0,0 @@
-# Upstream/Downstream Data Format
-
-The following contents describe how MQTT plugin publishes collected data, and how to read or write data through MQTT plugin.
-
-## Data Upload
-
-The MQTT plugin publishes collected data in JSON format to some user-defined topics. The exact format of the data reported is controlled by the **Upload Format** parameter. There are four formats, [**Values-format**](#values-format), [**Tags-format**](#tags-format),  [**ECP-format**](#ecp-format), and [**Custom**](#custom-format).
-
-### Upload Topic
-
-The upload topic is specified by the **upload-topic** parameter, and the default one set through the dashboard is **/neuron/{MQTT driver name}**.
-
-### Values Format
-
-In **Values-format**, the upload data has the following fields:
-* `timestamp`: the Unix timestamp when the data was collected
-* `node`: name of the south node from which data was collected
-* `group`: name of the south node group that the tags belong to
-* `values`: dictionary storing tags with successfully collected values
-* `errors`: dictionary storing tags with encountered error codes
-* `metas`: driver related metadata information
-
-The following example is in **Values-format**, where tag values collected successfully are stored in a dictionary, while error codes in another.
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus",
-    "group": "grp",
-    "values":
-    {
-        "tag0": 123
-    },
-    "errors":
-    {
-        "tag1": 2014
-    },
-    "metas":{}
-}
-```
-
-::: tip
-When a tag is collected successfully, the collected data is returned. When a tag collection fails, the error code is returned instead of the value.
-
-When the **Upload Tag Error Code** parameter is set to **False**, the error code is not reported.
-:::
-
-### Tags Format
-
-In **Tags-format**, the upload data has the following fields:
-* `timestamp`: the Unix timestamp when the data was collected
-* `node`: name of the south node from which data was collected
-* `group`: name of the south node group that the tags belong to
-* `tags`: tags data array where each element corresponds to one tag in the group
-* `name`: the name of the tag
-* `value`: the value of the tag
-* `error`: the error code of the tag
-
-The following example is in **Tags-format**, where tag data are stored in an array. Each element has the name of the tag, and the tag value or error code if something went wrong.
-
-```json
-{
-  "timestamp": 1647497389075,
-  "node": "modbus",
-  "group": "grp",
-  "tags": [
-    {
-      "name": "tag0",
-      "value": 123,
-    },
-    {
-      "name": "tag1",
-      "error": 2014
-    }
-  ]
-}
-```
-
-::: tip
-Tag value is returned only when the tag is read successfully. If something goes wrong when reading a tag, the error code is returned.
-
-When the **Upload Tag Error Code** parameter is set to **False**, the error code is not reported.
-:::
-
-### ECP Format
-
-In **ECP-format**, the upload data has the following fields:
-* `timestamp`: the Unix timestamp when the data was collected
-* `node`: name of the south node from which data was collected
-* `group`: name of the south node group that the tags belong to
-* `tags`: tags data array where each element corresponds to one tag in the group
-* `name`: the name of the tag
-* `value`: the value of the tag
-* `type`: the type of the tag, which can be Boolean, Integer, Float, or String
-
-The following example data is in **ECP-format**, where tag data are stored in an array. Each element has the name of the tag, the tag type and the tag value, excluding tags where collection failed.
-
-Data classes are divided into four types: Boolean, Integer, Float, and String.
-* type = 1 Boolean
-* type = 2 Integer
-* type = 3 Float
-* type = 4 String
-
-```json
-{
-  "timestamp": 1647497389075,
-  "node": "modbus",
-  "group": "grp",
-  "tags": [
-    {
-      "name": "tag_boolean",
-      "value": true,
-      "type": 1,
-    },
-    {
-      "name": "tag_int32_",
-      "value": 123,
-      "type": 2,
-    },
-    {
-      "name": "tag_float",
-      "value": 1.23,
-      "type": 3,
-    },
-    {
-      "name": "tag_string",
-      "value": "abcd",
-      "type": 4,
-    }
-  ]
-}
-```
-
-::: tip
-ECP-format does not support reporting tag error codes.
-
-Regardless of whether the **Upload Tag Error Code** parameter is set to **False** or **True**, tag error codes are not reported.
-:::
-
-### Custom Format
-
-In the custom format, use built-in variables to define the data upload format.
-
-![custom-format](./assets/custom-format-en.png)
-
-#### Variables
-
-| *variable* | *description* |
-| ------------------ | ---------------------- | 
-| `${timestamp}` | The UNIX timestamp when the data was read. |
-| `${node}` | The name of the southbound node. <br> Example: `modbus` |
-| `${group}` | The name of the group. <br> Example: `group` |
-| `${tags}` | The array of valid tag values. <br> Example: `[{"name": "tag1", "value": 123}, {"name": "tag2", "value": 456}]` |
-| `${tag_values}` | The array of valid tag values, Value Format <br> Example: `{"tag1": 123, "tag2": 456}` |
-| `${tag_errors}` | The array of error codes. <br> Example: `[{"name": "tag3", "error": 2014}, {"name": "tag4", "error": 2015}]` |
-| `${tag_error_values}` | The array of error codes, Value Format <br> Example: `{"tag3": 2014, "tag4": 2015}`   |
-| `${static_tags}` | The array of static tags. <br> Example: `[{"name": "static_tag1", "value": "abc"}, {"name": "static_tag2", "value": "def"}]` <br> See [Static Tags](#static-tags) |
-| `${static_tag_values}` | The array of static tags, Value Format <br> Example: `{"static_tag1": "abc", "static_tag2": "def"}` <br> See [Static Tags](#static-tags) |
-
-::: tip
-`${tags}` and `${tag_values}` are two different formats for tag values. `${tags}` is an Array format, and `${tag_values}` is a JSON format. In most cases, use one of them.
-
-`${static_tags}` and `${static_tag_values}`, `${tag_errors}` and `${tag_error_values}` are similar. Use one of them.
-
-When the **Upload Tag Error Code** parameter is set to **False**, even if `${tag_errors}` and `${tag_error_values}` are configured, tag error codes are not reported.
-:::
-
-The example above is based on the original southbound driver `modbus1` and group `group1`, which contains 4 tags. `tag1` and `tag2` are collected successfully, while `tag3` and `tag4` are collected with errors. When subscribing to the northbound node, the static tags are configured as `static_tag1` and `static_tag2`, with values of `abc` and `def` respectively.
-
-The above configuration, when reported in **Values-format** data format, is as follows:
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus1",
-    "group": "group1",
-    "values": {"tag1": 123, "tag2": 456, "static_tag1": "abc", "static_tag2": "def"},
-    "errors": {"tag3": 2014, "tag4": 2015},
-    "metas":{}
-}
-```
-
-The following example shows how to output the above JSON message in different data reporting formats by setting different **Custom** configurations.
-
-
-#### Example One
-
-Convert tag data to array format and customize the Json key name.
-
-```json
-{
-    "timestamp": "${timestamp}",
-    "node": "${node}",
-    "group": "${group}",
-    "custom_tag_name": "${tags}",
-    "custom_tag_errors": "${tag_errors}",
-}
-```
-
-The actual output result is as follows:
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus1",
-    "group": "group1",
-    "custom_tag_name": [{"name": "tag1", "value": 123}, {"name": "tag2", "value": 456}],
-    "custom_tag_errors": [{"name": "tag3", "error": 2014}, {"name": "tag4", "error": 2015}]
-}
-```
-
-#### Example Two
-
-Add global static tags through custom data format. These static tags will be carried in all driver group data reporting. For example, if NeuronEX is deployed on a gateway hardware, you can add the gateway's SN number, IP address, and location information to all driver groups.
-
-```json
-{
-    "timestamp": "${timestamp}",
-    "node": "${node}",
-    "group": "${group}",
-    "values": "${tag_values}",
-    "gateway_info": {
-      "ip": "192.168.1.100",
-      "sn": "SN123456789",
-      "location": "shanghai"
-    }
-}
-```
-The actual output result is as follows:
-
-```json
-{
-    "timestamp": 1650006388943,
-    "node": "modbus1",
-    "group": "group1",
-    "values": {"tag1": 123, "tag2": 456},
-    "gateway_info": {
-      "ip": "192.168.1.100",
-      "sn": "SN123456789",
-      "location": "shanghai"
-    }
-}
-```
-
-#### Example Three
-
-Put tag data, static tags, driver, and group information into a Json sub-node, and customize the Json node name. Currently, the custom data structure supports up to three sub-levels.
-
-```json
-{
-    "timestamp": "${timestamp}",
-    "data": {
-      "child_node": {
-        "node": "${node}",
-        "group": "${group}",
-        "tag_values": "${tag_values}",
-        "static_tag_values": "${static_tag_values}",
-        "tag_error_values": "${tag_error_values}"
-      }
-    }
-}
-```
-
-The data reporting format is as follows:
-```json
-{
-    "timestamp": 1650006388943,
-    "data": {
-      "child_node": {
-        "node": "modbus",
-        "group": "group",
-        "tag_values": {"tag1": 123, "tag2": 456},
-        "static_tag_values": {"static_tag1": "abc", "static_tag2": "def"},
-        "tag_error_values": {"tag3": 2014, "tag4": 2015}
-      }
-    }
-}
-```
-
-
-## Static Tags
-
-The static tag feature supports configuring static tags manually in the **North Application Group List** page, and reporting static tag data together with the collected data.
-
-![static-tags](./assets/static-tags-en.png)
-
-Static tag configuration requires inputting standard JSON format content, where each static tag is a key-value pair in the JSON object. Static tags will be reported together with the collected data according to the configured data reporting format (Values-format, Tags-format, ECP-format).
-
-```json
-  {
-      "location": "sh",
-      "sn_number": "123456"
-  }
-
-```
-
-Each southbound collection group can configure different static tags. This represents the physical device represented by the collection group, with which static attribute information.
-
-Static tag feature supports **Boolean**, **Integer**, **Float**, and **String** data types. Complex data types, such as arrays and structures, will be reported as **String**.
-
-If the static tags added are shared by all collection groups in the NeuronEX instance, you can select **All Collection Groups** to add static tags, or add static tags in the **Custom** custom format, as shown in [Custom Format: Example Two](#example-two).
-
-::: tip
-Static tag names must not be the same as the tag names collected by the southbound driver.
-
-If the names are the same:
- When using `Values-format` for data upload, the static tag data will overwrite the tag data collected by the southbound driver.
- When using `Tags-format`, `ECP-format`, or `Custom` for data upload, both the static tag data and the southbound driver collected tag data will be reported together (resulting in duplicate reporting).
-
-:::
-
-
-
-## Read Tag
-
-### Request
-
-You can read a group of tags by sending requests in JSON to the MQTT topic **/neuron/{node_name}/read/req**.
-
-#### Body
-
-The read request body should have the following fields:
-* `uuid`: a unique identifier, which will be echoed back in the response to help identify the corresponding request
-* `node`: the name of a southbound node
-* `group`: the name of a group to read
-
-Below is an example read request:
-
-```json
-{
-    "uuid": "bca54fe7-a2b1-43e2-a4b4-1da715d28eab",
-    "node": "modbus",
-    "group": "grp"
-}
-```
-
-### Response
-
-Read response will be published to the MQTT topic **/neuron/{node_name}/read/resp**.
-
-#### Body
-
-The read response body has the following fields:
-* `uuid`: the same unique identifier which is set by the corresponding request
-* `tags`: tags data array, same as that in [tags format](#tags-format)
-
-Below is an example read response:
-
-```json
-{
-  "uuid": "bca54fe7-a2b1-43e2-a4b4-1da715d28eab",
-  "tags": [
-    {
-      "name": "tag0",
-      "value": 4,
-    },
-    {
-      "name": "tag1",
-      "error": 2014
-    }
-  ]
-}
-```
-
-::: tip
-Tag value is returned only when the tag is read successfully. If something goes wrong when reading a tag, the error code is returned.
-:::
-
-## Write Tag
-
-### Request
-
-You could write a tag by sending requests in JSON to the MQTT topic designated by the **Write Request Topic** parameter.
-
-::: tip
-Before Neuron version 2.4.5, the write request topic was hard-coded to **/neuron/{random_str}/write/req**.
-:::
-
-#### Body
-
-#### Write one tag
-
-The write request body should have the following fields:
-* `uuid`: a unique identifier, which will be echoed back in the response to help identify the corresponding request
-* `node`: the name of a southbound node
-* `group`: the name of a group
-* `tag`: the name of a tag
-* `value`: the value to write
-
-Below is an example of write request:
-
-```json
-{
-    "uuid": "cd32be1b-c8b1-3257-94af-77f847b1ed3e",
-    "node": "modbus",
-    "group": "grp",
-    "tag": "tag0",
-    "value": 1234
-}
-```
-
-#### Write multiple tags
-
-Since Neuron version 2.6.0, write requests also support writing multiple tags at
-a time. To write multiple tags at a time, the request body should have the
-following fields:
-* `uuid` : a unique identifier, which will be echoed back in the response to help identify the corresponding request.
-* `node` : the name of a southbound node.
-* `group` : the name of a group.
-* `tags` : tags data array where each element corresponds to one tag in the group.
-
-Below is an example write request:
-
-```json
-{
-    "uuid": "cd32be1b-c8b1-3257-94af-77f847b1ed3e",
-    "node": "modbus",
-    "group": "grp",
-    "tags": [
-      {
-        "tag": "tag0",
-        "value": 1234
-      },
-      {
-        "tag": "tag1",
-        "value": 5678
-      }
-    ]
-}
-```
-
-
-### Response
-
-Write response will be published to the MQTT topic designated by the **Write Response Topic** parameter.
-
-::: tip
-Before Neuron version 2.4.5, the write response topic was hard-coded to **/neuron/{random_str}//write/resp**.
-:::
-
-#### Body
-
-The write response body has the following fields:
-* `uuid`: the same unique identifier which is set by the corresponding request.
-* `error`: error code if something bad happens, `0` represents success.
-
-Below is an example of write response:
-
-```json
-{
-  "uuid": "cd32be1b-c8b1-3257-94af-77f847b1ed3e",
-  "error": 0
-}
-```
-
-## Driver Status Report
-
-Reports status of all the southbound nodes to the specified topic.
-
-### Status Report Topic
-
-The status report topic is specified in the northbound node configuration. Its default value is **/neuron/{random_str}/state/update**.
-
-### Status Report Interval
-
-The status report interval is specified in the northbound node configuration, indicating the number of seconds between each message. The default value is 1, with an allowed range of 1-3600.
-
-### Reporting Message Format
-
-The reported data consists of the following fields:
-* `timestamp`: The UNIX timestamp when the data was collected.
-* `states`: An array of node status information.
-
-Below is an example of a driver status reporting message.
-
-```json
-{
-  "timestamp": 1658134132237,
-  "states": [
-    {
-      "node": "modbus-tcp",
-      "link": 1,
-      "running": 3
-    },
-    {
-      "node": "modbus-rtu",
-      "link": 1,
-      "running": 3
-    }
-  ]
-}
-```
@@ -1,89 +0,0 @@
-# Quick Start
-
-This document requires that you have successfully run Neuron according to the [Installation and Operation](https://github.com/emqx/neuron/README.md) guide, and that you can open the Neuron management panel in your browser.
-
-## Start the Modbus TCP Simulator
-
-Two types of Modbus TCP simulators are provided. You can run one of them according to your needs.
-
-### Neuron's Built-in Simulator
-
-The Neuron source code or release package includes a test simulator that runs on Linux, which can read and write some fixed points. The Slave ID is 1.
-
-```bash
-# If compiling from source, it's in the build/simulator directory
-# In the release package, it's in the root directory
-
-# Run the Modbus simulator, use TCP mode, and bind to 0.0.0.0:1502
-$ ./modbus_simulator tcp 1502 ip_v4
-```
-
-### PeakHMI Slave Simulators
-
-The PeakHMI simulator needs to run on a Windows system. [PeakHMI Official Website](https://hmisys.com)
-
-After downloading and installing, run the Modbus TCP slave EX simulator. The default port for this simulator is 502, which will be blocked by the default Windows firewall. Make sure the firewall allows this port or disable the firewall.
-
-![modbus-simulator](./assets/modbus-simulator.png)
-
-## Create a Southbound Device in Neuron
-
-### Create a Device
-
-**Southbound Device Management** -> **Add Device**. In the pop-up dialog box, fill in the device information and create the device. Select `Modbus TCP` for the **Plugin** and enter `modbus-tcp-1` for the **Name**.
-
-### Configure the Device
-After creating the device, go to the device details page to configure the device parameters.
-
-**IP Address**: Fill in the IP address of the machine running the Modbus TCP simulator. If Neuron and the simulator are running on the same machine, you can enter `127.0.0.1`.
-**Port**: The default is 502. Modify it according to the listening port of the simulator.
-
-Other parameters can be left as default.
-
-### Configure Data Points
-
-On the **Southbound Device Management** page, click the **Device Name** to enter the group page. Add a group and name it `group1`.
-
-After entering the group, click the **Group Name** to enter the tag configuration page and create a tag.
-
-![add-tag](./assets/tag-list-null.png)
-
-**Name**: `tag-1`
-**Address**: `1!40001` (Slave ID 1, holding register 40001)
-**Attribute**: `Read` and `Write`
-**Data Type**: `INT16`
-
-### View Tag Values
-
-After configuring the tags, go to the **Data Monitoring** page, select the device and group you just created, and you will see the values of the tags.
-
-![data-monitor](./assets/data-monitoring.png)
-
-## Create a Northbound Application
-
-Use MQTT to send the data collected from the Modbus device to an MQTT Broker.
-
-**Northbound Application Management** -> **Add Application**. In the pop-up dialog box, fill in the application information to create the application.
-Select `MQTT` for the **Plugin** and enter `mqtt` for the **Name**.
-
-### Configure the Northbound Application
-
-After creating the northbound application, go to the northbound configuration page. The default server address is `broker.emqx.io` and the port is `1883`. If you need to connect to another MQTT Broker, please modify it according to the actual situation.
-
-### Subscribe to Southbound Data Groups
-
-On the **Northbound Application Management** page, click the northbound application to enter the **Subscription Management** page. Click **Add Subscription**, and in the pop-up dialog box, select the Modbus device and group you just created.
-
-![subscribe](./assets/subscription-add.png)
-
-Remember the topic used for the subscription, as you will need to subscribe to this topic later to see the data. The default topic format is `/neuron/{application_name}`.
-
-At this point, the configuration for Neuron to collect data via Modbus TCP and send it via MQTT is complete.
-
-## Use MQTTX to Subscribe to the Topic and View Data
-
-After subscribing, open [MQTTX](https://mqttx.app/zh), create a new connection, and connect to `broker.emqx.io:1883` (modify according to the MQTT broker configured in the northbound application).
-
-After a successful connection, subscribe to the topic `/neuron/mqtt` (modify according to the topic used in the northbound subscription), and you will see the tag data.
-
-![mqttx](./assets/mqttx.png)
@@ -1,81 +0,0 @@
-# Neuron Threat Model
-
-## Purpose and scope
-
-This model guides security review of the Neuron core, built-in plugins, and their integration boundaries. It describes intended security requirements and deployment assumptions, not a certification that every path implements them. Check the actual changed code, configuration, packaging, and release when assessing a finding.
-
-This model covers code maintained in this open-source repository. Describe external inputs and deployment dependencies in terms of the interfaces they expose; derive security requirements from Neuron's own behavior and supported identity model.
-
-## Deployment profiles
-
-| Profile | Entry and authentication boundary | Review implications |
-| --- | --- | --- |
-| Direct management access | Management HTTP API, normally port 7000; checked-in configuration uses `127.0.0.1` and enables authentication | Binding, authentication, keys, process identity, and TLS termination are configurable. State the actual profile, not just defaults. |
-| Management through an operator-managed reverse proxy | Client requests reach Neuron through an intermediary | Verify exposed routes, forwarding, TLS termination, and effective gateway/proxy authentication and authorization. Do not assume a proxy preserves the intended boundary. |
-| Device and broker integrations | Protocol sockets, broker subscriptions, and configured remote endpoints | These paths do not inherit REST authentication. Trace their own peer identity, topic permissions, message handling, and device-write controls. |
-
-Loopback reduces direct remote exposure but does not exclude access through a proxy, SSRF, a local process, shared network namespaces, or modified packaging. Conversely, a source-level handler defect does not by itself establish external reachability in a particular deployment.
-
-Production deployments commonly segment management and OT networks. Segmentation affects exploit prerequisites; it is not a parser safety guarantee or a reason to exclude a compromised device or authorized malicious publisher.
-
-## Assets and actors
-
-Protect management identities and JWT signing material; device/broker credentials; configuration and persisted state; plugin libraries and schemas; process memory; collected data; device-write capability; and acquisition/forwarding availability.
-
-Relevant actors include unauthenticated management peers, ordinary authenticated users, administrators, holders of tokens from configured issuers, malicious or compromised devices/brokers/publishers, and local processes. Administrators and installed native code possess substantial intended authority, but that does not authorize lower-trust actors to acquire it.
-
-Use synthetic secrets and simulators for validation. Never direct a security test at customer equipment without explicit authorization.
-
-## Data flows and trust boundaries
-
-| Flow | Boundary | Required checks |
-| --- | --- | --- |
-| Client → REST handler | Network caller → management authority | Explicit authentication and operation-specific identity/authorization checks; complete error handling |
-| JWT → identity | Externally supplied claims → trusted principal | Signature, permitted algorithm, configured issuer/key association, intended audience, applicable time constraints, and explicit identity semantics |
-| Broker → MQTT write request | Authorized publisher → gateway/device action | Broker identity and direction-specific topic ACLs, message validation, configured target and write permissions |
-| Device reply → parser/cache | Remote bytes → process memory and tag values | Actual frame lengths, destination bounds, counts/types, resource limits, and object lifetimes |
-| Configuration/import/database → runtime | Stored or supplied data → allocations, paths, plugins, and connections | Revalidation, bounded decoding, path containment, safe persistence, and secret protection |
-| Plugin library → gateway process | Native extension → service privileges | Authorized loading and trusted artifact admission; no assumed plugin sandbox |
-| Driver write → field device | Management/integration command → operational state | Caller authority, configured destination, writable tag attributes, and value validation |
-
-## Security requirements
-
-### Management identity and JWT
-
-A valid signature is necessary but not sufficient for accepting a token. Bind verification to the expected audience and configured issuer/key relationship; reject missing or invalid claims when required by that token profile. Do not treat tokens minted for other services as Neuron credentials merely because a signing key is shared.
-
-Claims must not implicitly create administrative authority without an explicit supported identity policy. Distinguish legacy local-token conventions from admission of externally issued tokens. User creation, deletion, credential changes, and other sensitive actions require their own authorization decisions; a valid JWT alone does not establish that every operation is permitted.
-
-Trace credential removal and token lifetime separately. Deleting an account need not invalidate an already signed stateless token unless a revocation mechanism exists; do not claim immediate revocation without evidence.
-
-### Parsing, memory, and concurrency
-
-Validate source bytes remaining and destination capacity independently. Check arithmetic before allocation, copy, pointer movement, or narrowing conversion. Reject inconsistent frame lengths, invalid types, excessive counts, oversized strings, and incomplete fragments. Keep allocation sizes consistent with iteration bounds.
-
-For asynchronous messages, establish whether each buffer is borrowed, owned, copied, or transferred. Retain data until the last callback finishes. Cancellation, reconnection, configuration changes, and shutdown must not leave callbacks accessing freed state. Include failure and partial-initialization cleanup paths.
-
-Treat persisted/imported data as input. Schema or UI checks are not substitutes for runtime validation, including when old configuration is restored after an upgrade.
-
-### Cryptography and secrets
-
-Validate peer identity as well as chain trust when the protocol requires it. Keep TLS server verification separate from possession of a client credential. Public certificates are not private keys; do not confuse their sensitivity. Shipped production credentials and reusable trusted CA private keys must not be public image material. Protect key storage, rotation, permissions, logs, backups, and exports.
-
-### Metrics and intended capabilities
-
-Prometheus metrics intentionally supports unauthenticated scraping. Absence of JWT verification on the documented metrics endpoint is not alone an authorization defect. Still review added labels/data for secrets, unexpected sensitive values, unbounded cardinality, expensive requests, and newly introduced control actions. Operators must place the endpoint appropriately.
-
-Native plugins execute within the gateway process with its service-account authority. Authorized loading of native code is an intended capability, not evidence of container escape. A lower-trust path reaching plugin loading or corrupting plugin memory is a separate security question. Process-user execution, container-root execution, and host compromise require different evidence.
-
-## Availability and impact limits
-
-Identify the actual supervisor and restart policy. Recovery is deployment-dependent, not universal. Automatic recovery can reduce a single crash's duration, while repeated inputs may sustain a crash loop. It does not undo credential exposure, state corruption, unsafe device writes, or arbitrary execution.
-
-Do not infer code execution from every invalid memory access. Conversely, do not reduce established memory corruption to harmless failure just because the process restarts. Account for build architecture, hardening, actual privileges, and demonstrated primitives. Do not extrapolate historical non-PIE or sanitizer assumptions to current binaries.
-
-## Evidence and maintenance
-
-Useful anchors are `neuron.json`, `src/argparse.c`, `src/utils/neu_jwt.c`, `include/neuron/utils/http_handler.h`, `plugins/restful/`, `plugins/mqtt/`, `src/core/plugin_manager.c`, `src/persist/`, and `CMakeLists.txt`.
-
-A review should identify the changed boundary, attacker-controlled input, necessary configuration, actual effects, and a safe regression test. Separate implementation evidence from packaging assumptions and unverified downstream consequences.
-
-Update this model when changing binding/authentication defaults, token profiles, metrics contents, user policies, plugin admission, write routing, persistence formats, process privileges, or supervision. Follow the [security policy](../SECURITY.md) for private disclosure and the [review rules](../AGENTS.md) for engineering guidance.
@@ -0,0 +1,258 @@
+import asyncio
+import time
+from collections import defaultdict, deque
+
+from robot.api import logger
+from robot.api.deco import keyword, library
+from gmqtt import Client as MQTTClient, Subscription
+from gmqtt.mqtt.constants import MQTTv311
+
+ROBOT_AUTO_KEYWORDS = False
+
+
+@library
+class Client:
+    """A keyword library for Robot Framework. It provides keywords for
+    performing various operations on an MQTT broker. See http://mqtt.org/
+    for more details on MQTT specification.
+
+    This library uses gmqtt: Python async MQTT client. For more information
+    on underlying methods and documentation, see:
+        https://github.com/wialon/gmqtt
+
+    """
+
+    ROBOT_LIBRARY_SCOPE = "GLOBAL"
+    ROBOT_LIBRARY_VERSION = "0.1.0"
+
+    def __init__(self, reconnect_retries=5, reconnect_delay=0):
+        """
+        `reconnect_retries` number of reconnect attempt in case of lost
+        connections, default to 5
+
+        `reconnect_delay` delay between reconnect attemps in seconds,
+        default to 0
+
+        """
+        self._client = None
+        self._reconnect_retries = reconnect_retries
+        self._reconnect_delay = reconnect_delay
+        self._messages = defaultdict(deque)
+        self._subcribed = asyncio.Event()
+        self._unsubcribed = asyncio.Event()
+        self._recved = asyncio.Event()
+        self._run = asyncio.get_event_loop().run_until_complete
+
+    @keyword
+    def connect(
+        self,
+        host,
+        port=1883,
+        client_id="",
+        username="",
+        password="",
+        keepalive=60,
+        clean_session=True,
+    ):
+        """Connect to an MQTT broker. This is a pre-requisite step for publish
+        and subscribe keywords.
+
+        `host` MQTT broker host
+
+        `port` broker port (default 1883)
+
+        `client_id` if not specified, a random id is generated
+
+        `username` user name, default to ""
+
+        `password` user password, default to ""
+
+        `keepalive` keepalive in seconds
+
+        `clean_session` specifies the clean session flag for the connection
+
+        Examples:
+
+        Connect to a broker with default port and client id
+        | Connect | 127.0.0.1 |
+
+        Connect to a broker by specifying the port and client id explicitly
+        | Connect | 127.0.0.1 | 1883 | test.client |
+
+        Connect to a broker with clean session flag set to false
+        | Connect | 127.0.0.1 | clean_session=${false} |
+
+        """
+        client = MQTTClient(client_id, clean_session=clean_session)
+        client.on_connect = self._on_connect
+        client.on_message = self._on_message
+        client.on_disconnect = self._on_disconnect
+        client.on_subscribe = self._on_subscribe
+        client.on_unsubscribe = self._on_unsubscribe
+        client.set_config(
+            {
+                "reconnect_retries": self._reconnect_retries,
+                "reconnect_delay": self._reconnect_delay,
+            }
+        )
+        self._client = client
+
+        self._run(self._client.connect(host, port, version=MQTTv311))
+
+    @keyword
+    def disconnect(self):
+        """Disconnect from MQTT Broker.
+
+        Example:
+        | Disconnect |
+
+        """
+        self._run(self._client.disconnect())
+        self._messages.clear()
+
+    @keyword
+    def unsubscribe_all_and_clear_messages(self):
+        """Unsubscribe all subscriptions and clear all messages in queue."""
+        for topic in self._messages:
+            self.unsubscribe(topic)
+        self._messages.clear()
+
+    @keyword
+    def subscribe(self, topic, qos=0, timeout=1):
+        """Subscribe to a topic and return a message payload received
+            within the specified time.
+
+        `topic` topic to subscribe to
+
+        `qos` quality of service for the subscription, default to QoS 0
+
+        `timeout` duration of subscription, default to 1 second
+
+        Examples:
+
+        Subscribe and get a list of all messages received within 5 seconds
+        | ${messages}= | Subscribe | test/test | qos=1 | timeout=5 |
+
+        """
+        timeout = 1 if timeout < 1 else timeout
+        self._client.subscribe(Subscription(topic, qos))
+        if self._wait(self._subcribed, timeout=timeout):
+            raise Exception(
+                "MQTT client subscribe timeout topic=%s qos=%s" % (topic, qos))
+        logger.info("MQTT client subscribed to topic=%s qos=%s" % (topic, qos))
+
+    @keyword
+    def unsubscribe(self, topic, timeout=1):
+        """Unsubscribe the client from the specified topic.
+
+        `topic` topic to unsubscribe from
+
+        `timeout` duration of unsubscription, default to 1 second
+
+        Example:
+        | Unsubscribe | test/mqtt_test |
+
+        """
+        timeout = 1 if timeout < 1 else timeout
+        self._client.unsubscribe(topic)
+        if self._wait(self._unsubcribed, timeout=timeout):
+            raise Exception("MQTT client unsubscribe timeout topic=%s" % topic)
+        logger.info("MQTT client unsubscribed topic=%s" % topic)
+
+    @keyword
+    def publish(self, topic, payload, qos=0, retain=False):
+        """Publish a message to a topic with specified qos and retained flag.
+        It is required that a connection has been established using `Connect`
+        keyword before using this keyword.
+
+        `topic` topic to which the message will be published
+
+        `paylod` message payload to publish
+
+        `qos` qos of the message, default to QoS 0
+
+        `retain` retained flag
+
+        Examples:
+
+        | Publish | test/test | test message | 1 | ${false} |
+
+        """
+        self._client.publish(topic, payload, qos=qos, retain=retain)
+
+    @keyword
+    def listen(self, topic, timeout=1):
+        """Listen to a topic and return a message payload received within the
+        specified time. Requires an Subscribe to have been called previously.
+
+        `topic` topic to listen to
+
+        `timeout` duration to listen, default to 1 second
+
+        Examples:
+
+        Listen and get a message received within 5 seconds
+        | ${messages}= | Listen | test/test | timeout=5 |
+
+        """
+        timeout = 1 if timeout < 1 else timeout
+        start = time.time()
+        while True:
+            if topic in self._messages and self._messages[topic]:
+                msg = self._messages[topic].popleft()
+                return msg
+
+            if (
+                self._wait(self._recved, timeout=timeout)
+                or (time.time() - start) >= timeout
+            ):
+                break
+
+    def _wait(self, event, timeout):
+        """Waits for the given event within timeout.
+        Returns true on timeout, false otherwise."""
+        try:
+            self._run(asyncio.wait_for(event.wait(), timeout))
+            event.clear()
+        except asyncio.TimeoutError:
+            return True
+        return False
+
+    def _on_connect(self, client, flags, rc, properties):
+        logger.info("MQTT client connected")
+
+    def _on_message(self, client, topic, payload, qos, properties):
+        logger.info("MQTT client received: topic=%s qos=%s payload=%s" %
+                    (topic, qos, payload))
+        self._messages[topic].append(payload.decode())
+        self._recved.set()
+        return 0
+
+    def _on_disconnect(self, client, packet, exc=None):
+        logger.info("MQTT client disconnected")
+
+    def _on_subscribe(self, client, mid, qos, properties):
+        self._subcribed.set()
+
+    def _on_unsubscribe(self, client, mid, granted_qos):
+        self._unsubcribed.set()
+
+
+if __name__ == "__main__":
+    # import logging
+    # logging.basicConfig(level=logging.DEBUG)
+
+    host = "127.0.0.1"
+    topic = "test/test_mqtt"
+    client = Client()
+
+    client.connect(host)
+    client.subscribe(topic)
+
+    for i in range(3):
+        client.publish(topic, "hello world %s" % i)
+        msg = client.listen(topic)
+        print("MQTT client receive: topic=%s msg=%s" % (topic, msg))
+
+    client.unsubscribe(topic)
+    client.disconnect()
@@ -0,0 +1,235 @@
+from os import remove
+import os
+import random
+import subprocess
+import shutil
+import time
+
+
+def prepare_persistence_dir():
+    os.system("mkdir -p build/persistence")
+
+
+class Neuron(object):
+    process = 0
+    profiler_process = None
+
+    def __init__(self):
+        pass
+
+    def Start_Neuron(self):
+        prepare_persistence_dir()
+        self.process = subprocess.Popen(['./neuron', '--log'], cwd='build/')
+        return self.process
+
+    def Stop_Neuron(self, remove_persistence_data=True):
+        if self.profiler_process is not None:
+            # wait for plotting
+            time.sleep(5)
+        self.process.kill()
+        if remove_persistence_data:
+            os.system("rm build/persistence/sqlite.db")
+            prepare_persistence_dir()
+
+    def End_Neuron(self, process):
+        process.kill()
+
+    def Remove_Persistence(self):
+        os.system("rm build/persistence/sqlite.db")
+        prepare_persistence_dir()
+
+    def Profile_Neuron(self, interval, result_dir):
+        cmd = [
+            'psrecord', str(self.process.pid),
+            '--interval', str(interval),
+            '--plot', result_dir + '/cpu_mem.svg'
+        ]
+
+        self.profiler_process = subprocess.Popen(cmd)
+
+
+class Tool(object):
+
+    def __init__(self):
+        pass
+
+    def Array_Len(self, array):
+        return len(array)
+
+
+class Plugin(object):
+
+    def __init__(self):
+        pass
+
+    def Get_Plugin_By_Name(self, splugins, name):
+        for plugin in splugins:
+            if plugin['name'] == name:
+                return plugin['id']
+        return 0
+
+    def Plugin_With_Name_Sholud_Exist(self, splugins, name):
+        assert 0 != self.Get_Plugin_By_Name(splugins, name)
+
+    def Plugin_With_Name_Should_Not_Exist(self, splugins, name):
+        assert 0 == self.Get_Plugin_By_Name(splugins, name)
+
+
+class GrpConfig(object):
+
+    def __init__(self):
+        pass
+
+    def Get_Interval_In_Group_Config(self, gconfigs, gname):
+        for gconfig in gconfigs[0]:
+            if gconfig['name'] == gname:
+                return gconfig['interval']
+        return 0
+
+    def Group_Config_Size(self, gconfigs):
+        size = 0
+        for gconfig in gconfigs[0]:
+            size = size + 1
+        return size
+
+    def Get_Random_Group_Config(self, gconfigs):
+        return random.choice(gconfigs)['name']
+
+    def Group_Config_Check(self, gconfigs, name, interval):
+        ret = -1
+        for gconfig in gconfigs:
+            if gconfig['name'] == name:
+                if gconfig['interval'] == int(interval):
+                    ret = 0
+                break
+        return ret
+
+    def Get_Group_Config_By_Name(self, sgconfigs, name):
+        for gconfig in sgconfigs:
+            if gconfig['name'] == name:
+                return gconfig['name']
+        return 0
+
+
+class Node(object):
+
+    def __init__(self):
+        pass
+
+    def Get_Node_By_Name(self, snodes, name):
+        for node in snodes:
+            if node['name'] == name:
+                return True
+        return False
+
+    def Node_Should_Exist(self, snodes, name):
+        assert True == self.Get_Node_By_Name(snodes, name)
+
+    def Node_Should_Not_Exist(self, snodes, name):
+        assert False == self.Get_Node_By_Name(snodes, name)
+
+    def Node_With_Name_Should_Not_Exist(self, snodes, name):
+        assert 0 == self.Get_Node_By_Name(snodes, name)
+
+    def Get_Random_Node(self, snodes):
+        return random.choice(snodes)['id']
+
+
+class Tag(object):
+
+    def __init__(self):
+        pass
+
+    def Tag_Check(self, tags, name, type, group_config_name, attribute, address):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if tag['type'] == int(type) and tag['group_config_name'] == group_config_name and tag['attribute'] == int(attribute) and tag['address'] == address:
+                    ret = 0
+                break
+        return ret
+
+    def Tag_Find_By_Name(self, tags, name):
+        for tag in tags:
+            if tag['name'] == name:
+                return tag
+
+        return None
+
+
+class Subscribe(object):
+
+    def __init__(self):
+        pass
+
+    def Subscribe_Check(self, groups, node_id, group_config_name):
+        ret = -1
+        for group in groups:
+            if group['node_id'] == int(node_id) and group['group_config_name'] == group_config_name:
+                ret = 0
+                break
+        return ret
+
+
+class Read(object):
+
+    def __init__(self):
+        pass
+
+    def Compare_Tag_Value_Bool(self, tags, name, value):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if isinstance(value, str):
+                    if (tag['value'] == False and value.lower() == "false" or
+                            tag['value'] == True and value.lower() == "true"):
+                        ret = 0
+                elif tag['value'] == int(value):
+                    ret = 0
+                break
+        return ret
+
+    def Compare_Tag_Value_Int(self, tags, name, value):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if int(tag['value']) == int(value):
+                    ret = 0
+                break
+        return ret
+
+    def Compare_Tag_Value_Float(self, tags, name, value):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if float(tag['value']) <= float(value) + 0.1 and float(tag['value']) >= float(value) - 0.1:
+                    ret = 0
+                break
+        return ret
+
+    def Compare_Tag_Value_String(self, tags, name, value):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if tag['value'] == str(value):
+                    ret = 0
+                break
+        return ret
+
+    def Compare_Tag_Value_Strings(self, tags, name, value):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if "\"" + tag['value'] + "\"" == str(value):
+                    ret = 0
+                break
+        return ret
+
+    def Check_Tag_Error(self, tags, name, value):
+        ret = -1
+        for tag in tags:
+            if tag['name'] == name:
+                if int(tag['error']) == int(value):
+                    ret = 0
+                break
+        return ret
@@ -0,0 +1,35 @@
+# Functional test
+
+Functional testing uses the robotframework automated testing framework, providing templates for each test case of the northbound APP and southbound DRIVER types.
+
+Testing is divided into the following categories.
+|Test case|Description|
+|-----|----------|
+|Core interface test|Mainly including the addition, deletion, modification, query, subscription, and other operations of the HTTP API interface for core data(PLUGIN, NODE, GROUP, TAG)|
+|Southbound DRIVER test||
+|Northbound APP test||
+|Plugin specific test case|Such as OPC UA specific device discovery, can different devices be connected normally|
+
+To run all functional testers
+
+Enter the neuron/build directory.
+Install Mosquito software.
+```shell
+$ sudo apt-get install -y mosquitto
+```
+
+Start the mosquitto server.
+```shell
+$ mosquitto -v &
+```
+
+Install requirements.
+```shell
+$ python3 -m pip install -U pip
+$ python3 -m pip install -r ft/requirements.txt
+```
+
+Run functional tests and generate test reports.
+```shell
+$ python3 -m robot --maxerroelines=600 -P ft/ -d ft/reports ft
+```
@@ -0,0 +1,10 @@
+{
+    "nodes": [
+        {
+            "type": 1,
+            "plugin_name": "modbus-tcp",
+            "name": "modbus-tcp-0000",
+            "state": 1
+        }
+    ]
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0000"
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host": "127.0.0.1",
+        "port": 60502,
+        "connection_mode": 0
+    }
+}
@@ -0,0 +1,11 @@
+{
+    "params": {
+        "req-topic": "Neuron/req",
+        "res-topic": "Neuron/resp",
+        "ssl": "false",
+        "host": "127.0.0.1",
+        "port": 1883,
+        "username": "",
+        "password": ""
+    }
+}
@@ -0,0 +1,10 @@
+{
+    "subscriptions": [
+        {
+            "sub_adapter_name": "mqtt-0000",
+            "group_config_name": "group-0000",
+            "src_adapter_name": "modbus-tcp-0000",
+            "read_interval": 1000
+        }
+    ]
+}
@@ -0,0 +1,3 @@
+{
+    "plugins": []
+}
@@ -0,0 +1,10 @@
+{
+    "nodes": [
+        {
+            "type": 1,
+            "plugin_name": "modbus-tcp",
+            "name": "modbus-tcp-0000",
+            "state": 1
+        }
+    ]
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0000"
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host": "127.0.0.1",
+        "port": 60502,
+        "connection_mode": 0
+    }
+}
@@ -0,0 +1,11 @@
+{
+    "params": {
+        "req-topic": "Neuron/req",
+        "res-topic": "Neuron/resp",
+        "ssl": "false",
+        "host": "127.0.0.1",
+        "port": 1883,
+        "username": "",
+        "password": ""
+    }
+}
@@ -0,0 +1,10 @@
+{
+    "subscriptions": [
+        {
+            "sub_adapter_name": "mqtt-0000",
+            "group_config_name": "group-0000",
+            "src_adapter_name": "modbus-tcp-0000",
+            "read_interval": 1000
+        }
+    ]
+}
@@ -0,0 +1,3 @@
+{
+    "plugins": []
+}
@@ -0,0 +1,124 @@
+{
+  "nodes": [
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0000",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0001",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0002",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0003",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0004",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0005",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0006",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0007",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0008",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "modbus-tcp",
+      "name": "modbus-tcp-0009",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0000",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0001",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0002",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0003",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0004",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0005",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0006",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0007",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0008",
+      "state": 1
+    },
+    {
+      "type": 1,
+      "plugin_name": "neuron-opcua-plugin",
+      "name": "opcua-0009",
+      "state": 1
+    }
+  ]
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0000"
+}
@@ -0,0 +1,604 @@
+{
+    "tags": [
+        {
+            "type": 4,
+            "name": "modbus1",
+            "attribute": 3,
+            "address": "1!400001"
+        },
+        {
+            "type": 4,
+            "name": "modbus2",
+            "attribute": 3,
+            "address": "1!400002"
+        },
+        {
+            "type": 4,
+            "name": "modbus3",
+            "attribute": 3,
+            "address": "1!400003"
+        },
+        {
+            "type": 4,
+            "name": "modbus4",
+            "attribute": 3,
+            "address": "1!400004"
+        },
+        {
+            "type": 4,
+            "name": "modbus5",
+            "attribute": 3,
+            "address": "1!400005"
+        },
+        {
+            "type": 4,
+            "name": "modbus6",
+            "attribute": 3,
+            "address": "1!400006"
+        },
+        {
+            "type": 4,
+            "name": "modbus7",
+            "attribute": 3,
+            "address": "1!400007"
+        },
+        {
+            "type": 4,
+            "name": "modbus8",
+            "attribute": 3,
+            "address": "1!400008"
+        },
+        {
+            "type": 4,
+            "name": "modbus9",
+            "attribute": 3,
+            "address": "1!400009"
+        },
+        {
+            "type": 4,
+            "name": "modbus10",
+            "attribute": 3,
+            "address": "1!400010"
+        },
+        {
+            "type": 4,
+            "name": "modbus11",
+            "attribute": 3,
+            "address": "1!400011"
+        },
+        {
+            "type": 4,
+            "name": "modbus12",
+            "attribute": 3,
+            "address": "1!400012"
+        },
+        {
+            "type": 4,
+            "name": "modbus13",
+            "attribute": 3,
+            "address": "1!400013"
+        },
+        {
+            "type": 4,
+            "name": "modbus14",
+            "attribute": 3,
+            "address": "1!400014"
+        },
+        {
+            "type": 4,
+            "name": "modbus15",
+            "attribute": 3,
+            "address": "1!400015"
+        },
+        {
+            "type": 4,
+            "name": "modbus16",
+            "attribute": 3,
+            "address": "1!400016"
+        },
+        {
+            "type": 4,
+            "name": "modbus17",
+            "attribute": 3,
+            "address": "1!400017"
+        },
+        {
+            "type": 4,
+            "name": "modbus18",
+            "attribute": 3,
+            "address": "1!400018"
+        },
+        {
+            "type": 4,
+            "name": "modbus19",
+            "attribute": 3,
+            "address": "1!400019"
+        },
+        {
+            "type": 4,
+            "name": "modbus20",
+            "attribute": 3,
+            "address": "1!400020"
+        },
+        {
+            "type": 4,
+            "name": "modbus21",
+            "attribute": 3,
+            "address": "1!400021"
+        },
+        {
+            "type": 4,
+            "name": "modbus22",
+            "attribute": 3,
+            "address": "1!400022"
+        },
+        {
+            "type": 4,
+            "name": "modbus23",
+            "attribute": 3,
+            "address": "1!400023"
+        },
+        {
+            "type": 4,
+            "name": "modbus24",
+            "attribute": 3,
+            "address": "1!400024"
+        },
+        {
+            "type": 4,
+            "name": "modbus25",
+            "attribute": 3,
+            "address": "1!400025"
+        },
+        {
+            "type": 4,
+            "name": "modbus26",
+            "attribute": 3,
+            "address": "1!400026"
+        },
+        {
+            "type": 4,
+            "name": "modbus27",
+            "attribute": 3,
+            "address": "1!400027"
+        },
+        {
+            "type": 4,
+            "name": "modbus28",
+            "attribute": 3,
+            "address": "1!400028"
+        },
+        {
+            "type": 4,
+            "name": "modbus29",
+            "attribute": 3,
+            "address": "1!400029"
+        },
+        {
+            "type": 4,
+            "name": "modbus30",
+            "attribute": 3,
+            "address": "1!400030"
+        },
+        {
+            "type": 4,
+            "name": "modbus31",
+            "attribute": 3,
+            "address": "1!400031"
+        },
+        {
+            "type": 4,
+            "name": "modbus32",
+            "attribute": 3,
+            "address": "1!400032"
+        },
+        {
+            "type": 4,
+            "name": "modbus33",
+            "attribute": 3,
+            "address": "1!400033"
+        },
+        {
+            "type": 4,
+            "name": "modbus34",
+            "attribute": 3,
+            "address": "1!400034"
+        },
+        {
+            "type": 4,
+            "name": "modbus35",
+            "attribute": 3,
+            "address": "1!400035"
+        },
+        {
+            "type": 4,
+            "name": "modbus36",
+            "attribute": 3,
+            "address": "1!400036"
+        },
+        {
+            "type": 4,
+            "name": "modbus37",
+            "attribute": 3,
+            "address": "1!400037"
+        },
+        {
+            "type": 4,
+            "name": "modbus38",
+            "attribute": 3,
+            "address": "1!400038"
+        },
+        {
+            "type": 4,
+            "name": "modbus39",
+            "attribute": 3,
+            "address": "1!400039"
+        },
+        {
+            "type": 4,
+            "name": "modbus40",
+            "attribute": 3,
+            "address": "1!400040"
+        },
+        {
+            "type": 4,
+            "name": "modbus41",
+            "attribute": 3,
+            "address": "1!400041"
+        },
+        {
+            "type": 4,
+            "name": "modbus42",
+            "attribute": 3,
+            "address": "1!400042"
+        },
+        {
+            "type": 4,
+            "name": "modbus43",
+            "attribute": 3,
+            "address": "1!400043"
+        },
+        {
+            "type": 4,
+            "name": "modbus44",
+            "attribute": 3,
+            "address": "1!400044"
+        },
+        {
+            "type": 4,
+            "name": "modbus45",
+            "attribute": 3,
+            "address": "1!400045"
+        },
+        {
+            "type": 4,
+            "name": "modbus46",
+            "attribute": 3,
+            "address": "1!400046"
+        },
+        {
+            "type": 4,
+            "name": "modbus47",
+            "attribute": 3,
+            "address": "1!400047"
+        },
+        {
+            "type": 4,
+            "name": "modbus48",
+            "attribute": 3,
+            "address": "1!400048"
+        },
+        {
+            "type": 4,
+            "name": "modbus49",
+            "attribute": 3,
+            "address": "1!400049"
+        },
+        {
+            "type": 4,
+            "name": "modbus50",
+            "attribute": 3,
+            "address": "1!400050"
+        },
+        {
+            "type": 4,
+            "name": "modbus51",
+            "attribute": 3,
+            "address": "1!400051"
+        },
+        {
+            "type": 4,
+            "name": "modbus52",
+            "attribute": 3,
+            "address": "1!400052"
+        },
+        {
+            "type": 4,
+            "name": "modbus53",
+            "attribute": 3,
+            "address": "1!400053"
+        },
+        {
+            "type": 4,
+            "name": "modbus54",
+            "attribute": 3,
+            "address": "1!400054"
+        },
+        {
+            "type": 4,
+            "name": "modbus55",
+            "attribute": 3,
+            "address": "1!400055"
+        },
+        {
+            "type": 4,
+            "name": "modbus56",
+            "attribute": 3,
+            "address": "1!400056"
+        },
+        {
+            "type": 4,
+            "name": "modbus57",
+            "attribute": 3,
+            "address": "1!400057"
+        },
+        {
+            "type": 4,
+            "name": "modbus58",
+            "attribute": 3,
+            "address": "1!400058"
+        },
+        {
+            "type": 4,
+            "name": "modbus59",
+            "attribute": 3,
+            "address": "1!400059"
+        },
+        {
+            "type": 4,
+            "name": "modbus60",
+            "attribute": 3,
+            "address": "1!400060"
+        },
+        {
+            "type": 4,
+            "name": "modbus61",
+            "attribute": 3,
+            "address": "1!400061"
+        },
+        {
+            "type": 4,
+            "name": "modbus62",
+            "attribute": 3,
+            "address": "1!400062"
+        },
+        {
+            "type": 4,
+            "name": "modbus63",
+            "attribute": 3,
+            "address": "1!400063"
+        },
+        {
+            "type": 4,
+            "name": "modbus64",
+            "attribute": 3,
+            "address": "1!400064"
+        },
+        {
+            "type": 4,
+            "name": "modbus65",
+            "attribute": 3,
+            "address": "1!400065"
+        },
+        {
+            "type": 4,
+            "name": "modbus66",
+            "attribute": 3,
+            "address": "1!400066"
+        },
+        {
+            "type": 4,
+            "name": "modbus67",
+            "attribute": 3,
+            "address": "1!400067"
+        },
+        {
+            "type": 4,
+            "name": "modbus68",
+            "attribute": 3,
+            "address": "1!400068"
+        },
+        {
+            "type": 4,
+            "name": "modbus69",
+            "attribute": 3,
+            "address": "1!400069"
+        },
+        {
+            "type": 4,
+            "name": "modbus70",
+            "attribute": 3,
+            "address": "1!400070"
+        },
+        {
+            "type": 4,
+            "name": "modbus71",
+            "attribute": 3,
+            "address": "1!400071"
+        },
+        {
+            "type": 4,
+            "name": "modbus72",
+            "attribute": 3,
+            "address": "1!400072"
+        },
+        {
+            "type": 4,
+            "name": "modbus73",
+            "attribute": 3,
+            "address": "1!400073"
+        },
+        {
+            "type": 4,
+            "name": "modbus74",
+            "attribute": 3,
+            "address": "1!400074"
+        },
+        {
+            "type": 4,
+            "name": "modbus75",
+            "attribute": 3,
+            "address": "1!400075"
+        },
+        {
+            "type": 4,
+            "name": "modbus76",
+            "attribute": 3,
+            "address": "1!400076"
+        },
+        {
+            "type": 4,
+            "name": "modbus77",
+            "attribute": 3,
+            "address": "1!400077"
+        },
+        {
+            "type": 4,
+            "name": "modbus78",
+            "attribute": 3,
+            "address": "1!400078"
+        },
+        {
+            "type": 4,
+            "name": "modbus79",
+            "attribute": 3,
+            "address": "1!400079"
+        },
+        {
+            "type": 4,
+            "name": "modbus80",
+            "attribute": 3,
+            "address": "1!400080"
+        },
+        {
+            "type": 4,
+            "name": "modbus81",
+            "attribute": 3,
+            "address": "1!400081"
+        },
+        {
+            "type": 4,
+            "name": "modbus82",
+            "attribute": 3,
+            "address": "1!400082"
+        },
+        {
+            "type": 4,
+            "name": "modbus83",
+            "attribute": 3,
+            "address": "1!400083"
+        },
+        {
+            "type": 4,
+            "name": "modbus84",
+            "attribute": 3,
+            "address": "1!400084"
+        },
+        {
+            "type": 4,
+            "name": "modbus85",
+            "attribute": 3,
+            "address": "1!400085"
+        },
+        {
+            "type": 4,
+            "name": "modbus86",
+            "attribute": 3,
+            "address": "1!400086"
+        },
+        {
+            "type": 4,
+            "name": "modbus87",
+            "attribute": 3,
+            "address": "1!400087"
+        },
+        {
+            "type": 4,
+            "name": "modbus88",
+            "attribute": 3,
+            "address": "1!400088"
+        },
+        {
+            "type": 4,
+            "name": "modbus89",
+            "attribute": 3,
+            "address": "1!400089"
+        },
+        {
+            "type": 4,
+            "name": "modbus90",
+            "attribute": 3,
+            "address": "1!400090"
+        },
+        {
+            "type": 4,
+            "name": "modbus91",
+            "attribute": 3,
+            "address": "1!400091"
+        },
+        {
+            "type": 4,
+            "name": "modbus92",
+            "attribute": 3,
+            "address": "1!400092"
+        },
+        {
+            "type": 4,
+            "name": "modbus93",
+            "attribute": 3,
+            "address": "1!400093"
+        },
+        {
+            "type": 4,
+            "name": "modbus94",
+            "attribute": 3,
+            "address": "1!400094"
+        },
+        {
+            "type": 4,
+            "name": "modbus95",
+            "attribute": 3,
+            "address": "1!400095"
+        },
+        {
+            "type": 4,
+            "name": "modbus96",
+            "attribute": 3,
+            "address": "1!400096"
+        },
+        {
+            "type": 4,
+            "name": "modbus97",
+            "attribute": 3,
+            "address": "1!400097"
+        },
+        {
+            "type": 4,
+            "name": "modbus98",
+            "attribute": 3,
+            "address": "1!400098"
+        },
+        {
+            "type": 4,
+            "name": "modbus99",
+            "attribute": 3,
+            "address": "1!400099"
+        },
+        {
+            "type": 4,
+            "name": "modbus100",
+            "attribute": 3,
+            "address": "1!400100"
+        }
+    ]
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0001",
+    "adapter_name": "modbus-tcp-0000"
+}
@@ -0,0 +1,604 @@
+{
+    "tags": [
+        {
+            "type": 4,
+            "name": "modbus101",
+            "attribute": 3,
+            "address": "1!400101"
+        },
+        {
+            "type": 4,
+            "name": "modbus102",
+            "attribute": 3,
+            "address": "1!400102"
+        },
+        {
+            "type": 4,
+            "name": "modbus103",
+            "attribute": 3,
+            "address": "1!400103"
+        },
+        {
+            "type": 4,
+            "name": "modbus104",
+            "attribute": 3,
+            "address": "1!400104"
+        },
+        {
+            "type": 4,
+            "name": "modbus105",
+            "attribute": 3,
+            "address": "1!400105"
+        },
+        {
+            "type": 4,
+            "name": "modbus106",
+            "attribute": 3,
+            "address": "1!400106"
+        },
+        {
+            "type": 4,
+            "name": "modbus107",
+            "attribute": 3,
+            "address": "1!400107"
+        },
+        {
+            "type": 4,
+            "name": "modbus108",
+            "attribute": 3,
+            "address": "1!400108"
+        },
+        {
+            "type": 4,
+            "name": "modbus109",
+            "attribute": 3,
+            "address": "1!400109"
+        },
+        {
+            "type": 4,
+            "name": "modbus110",
+            "attribute": 3,
+            "address": "1!400110"
+        },
+        {
+            "type": 4,
+            "name": "modbus111",
+            "attribute": 3,
+            "address": "1!400111"
+        },
+        {
+            "type": 4,
+            "name": "modbus112",
+            "attribute": 3,
+            "address": "1!400112"
+        },
+        {
+            "type": 4,
+            "name": "modbus113",
+            "attribute": 3,
+            "address": "1!400113"
+        },
+        {
+            "type": 4,
+            "name": "modbus114",
+            "attribute": 3,
+            "address": "1!400114"
+        },
+        {
+            "type": 4,
+            "name": "modbus115",
+            "attribute": 3,
+            "address": "1!400115"
+        },
+        {
+            "type": 4,
+            "name": "modbus116",
+            "attribute": 3,
+            "address": "1!400116"
+        },
+        {
+            "type": 4,
+            "name": "modbus117",
+            "attribute": 3,
+            "address": "1!400117"
+        },
+        {
+            "type": 4,
+            "name": "modbus118",
+            "attribute": 3,
+            "address": "1!400118"
+        },
+        {
+            "type": 4,
+            "name": "modbus119",
+            "attribute": 3,
+            "address": "1!400119"
+        },
+        {
+            "type": 4,
+            "name": "modbus120",
+            "attribute": 3,
+            "address": "1!400120"
+        },
+        {
+            "type": 4,
+            "name": "modbus121",
+            "attribute": 3,
+            "address": "1!400121"
+        },
+        {
+            "type": 4,
+            "name": "modbus122",
+            "attribute": 3,
+            "address": "1!400122"
+        },
+        {
+            "type": 4,
+            "name": "modbus123",
+            "attribute": 3,
+            "address": "1!400123"
+        },
+        {
+            "type": 4,
+            "name": "modbus124",
+            "attribute": 3,
+            "address": "1!400124"
+        },
+        {
+            "type": 4,
+            "name": "modbus125",
+            "attribute": 3,
+            "address": "1!400125"
+        },
+        {
+            "type": 4,
+            "name": "modbus126",
+            "attribute": 3,
+            "address": "1!400126"
+        },
+        {
+            "type": 4,
+            "name": "modbus127",
+            "attribute": 3,
+            "address": "1!400127"
+        },
+        {
+            "type": 4,
+            "name": "modbus128",
+            "attribute": 3,
+            "address": "1!400128"
+        },
+        {
+            "type": 4,
+            "name": "modbus129",
+            "attribute": 3,
+            "address": "1!400129"
+        },
+        {
+            "type": 4,
+            "name": "modbus130",
+            "attribute": 3,
+            "address": "1!400130"
+        },
+        {
+            "type": 4,
+            "name": "modbus131",
+            "attribute": 3,
+            "address": "1!400131"
+        },
+        {
+            "type": 4,
+            "name": "modbus132",
+            "attribute": 3,
+            "address": "1!400132"
+        },
+        {
+            "type": 4,
+            "name": "modbus133",
+            "attribute": 3,
+            "address": "1!400133"
+        },
+        {
+            "type": 4,
+            "name": "modbus134",
+            "attribute": 3,
+            "address": "1!400134"
+        },
+        {
+            "type": 4,
+            "name": "modbus135",
+            "attribute": 3,
+            "address": "1!400135"
+        },
+        {
+            "type": 4,
+            "name": "modbus136",
+            "attribute": 3,
+            "address": "1!400136"
+        },
+        {
+            "type": 4,
+            "name": "modbus137",
+            "attribute": 3,
+            "address": "1!400137"
+        },
+        {
+            "type": 4,
+            "name": "modbus138",
+            "attribute": 3,
+            "address": "1!400138"
+        },
+        {
+            "type": 4,
+            "name": "modbus139",
+            "attribute": 3,
+            "address": "1!400139"
+        },
+        {
+            "type": 4,
+            "name": "modbus140",
+            "attribute": 3,
+            "address": "1!400140"
+        },
+        {
+            "type": 4,
+            "name": "modbus141",
+            "attribute": 3,
+            "address": "1!400141"
+        },
+        {
+            "type": 4,
+            "name": "modbus142",
+            "attribute": 3,
+            "address": "1!400142"
+        },
+        {
+            "type": 4,
+            "name": "modbus143",
+            "attribute": 3,
+            "address": "1!400143"
+        },
+        {
+            "type": 4,
+            "name": "modbus144",
+            "attribute": 3,
+            "address": "1!400144"
+        },
+        {
+            "type": 4,
+            "name": "modbus145",
+            "attribute": 3,
+            "address": "1!400145"
+        },
+        {
+            "type": 4,
+            "name": "modbus146",
+            "attribute": 3,
+            "address": "1!400146"
+        },
+        {
+            "type": 4,
+            "name": "modbus147",
+            "attribute": 3,
+            "address": "1!400147"
+        },
+        {
+            "type": 4,
+            "name": "modbus148",
+            "attribute": 3,
+            "address": "1!400148"
+        },
+        {
+            "type": 4,
+            "name": "modbus149",
+            "attribute": 3,
+            "address": "1!400149"
+        },
+        {
+            "type": 4,
+            "name": "modbus150",
+            "attribute": 3,
+            "address": "1!400150"
+        },
+        {
+            "type": 4,
+            "name": "modbus151",
+            "attribute": 3,
+            "address": "1!400151"
+        },
+        {
+            "type": 4,
+            "name": "modbus152",
+            "attribute": 3,
+            "address": "1!400152"
+        },
+        {
+            "type": 4,
+            "name": "modbus153",
+            "attribute": 3,
+            "address": "1!400153"
+        },
+        {
+            "type": 4,
+            "name": "modbus154",
+            "attribute": 3,
+            "address": "1!400154"
+        },
+        {
+            "type": 4,
+            "name": "modbus155",
+            "attribute": 3,
+            "address": "1!400155"
+        },
+        {
+            "type": 4,
+            "name": "modbus156",
+            "attribute": 3,
+            "address": "1!400156"
+        },
+        {
+            "type": 4,
+            "name": "modbus157",
+            "attribute": 3,
+            "address": "1!400157"
+        },
+        {
+            "type": 4,
+            "name": "modbus158",
+            "attribute": 3,
+            "address": "1!400158"
+        },
+        {
+            "type": 4,
+            "name": "modbus159",
+            "attribute": 3,
+            "address": "1!400159"
+        },
+        {
+            "type": 4,
+            "name": "modbus160",
+            "attribute": 3,
+            "address": "1!400160"
+        },
+        {
+            "type": 4,
+            "name": "modbus161",
+            "attribute": 3,
+            "address": "1!400161"
+        },
+        {
+            "type": 4,
+            "name": "modbus162",
+            "attribute": 3,
+            "address": "1!400162"
+        },
+        {
+            "type": 4,
+            "name": "modbus163",
+            "attribute": 3,
+            "address": "1!400163"
+        },
+        {
+            "type": 4,
+            "name": "modbus164",
+            "attribute": 3,
+            "address": "1!400164"
+        },
+        {
+            "type": 4,
+            "name": "modbus165",
+            "attribute": 3,
+            "address": "1!400165"
+        },
+        {
+            "type": 4,
+            "name": "modbus166",
+            "attribute": 3,
+            "address": "1!400166"
+        },
+        {
+            "type": 4,
+            "name": "modbus167",
+            "attribute": 3,
+            "address": "1!400167"
+        },
+        {
+            "type": 4,
+            "name": "modbus168",
+            "attribute": 3,
+            "address": "1!400168"
+        },
+        {
+            "type": 4,
+            "name": "modbus169",
+            "attribute": 3,
+            "address": "1!400169"
+        },
+        {
+            "type": 4,
+            "name": "modbus170",
+            "attribute": 3,
+            "address": "1!400170"
+        },
+        {
+            "type": 4,
+            "name": "modbus171",
+            "attribute": 3,
+            "address": "1!400171"
+        },
+        {
+            "type": 4,
+            "name": "modbus172",
+            "attribute": 3,
+            "address": "1!400172"
+        },
+        {
+            "type": 4,
+            "name": "modbus173",
+            "attribute": 3,
+            "address": "1!400173"
+        },
+        {
+            "type": 4,
+            "name": "modbus174",
+            "attribute": 3,
+            "address": "1!400174"
+        },
+        {
+            "type": 4,
+            "name": "modbus175",
+            "attribute": 3,
+            "address": "1!400175"
+        },
+        {
+            "type": 4,
+            "name": "modbus176",
+            "attribute": 3,
+            "address": "1!400176"
+        },
+        {
+            "type": 4,
+            "name": "modbus177",
+            "attribute": 3,
+            "address": "1!400177"
+        },
+        {
+            "type": 4,
+            "name": "modbus178",
+            "attribute": 3,
+            "address": "1!400178"
+        },
+        {
+            "type": 4,
+            "name": "modbus179",
+            "attribute": 3,
+            "address": "1!400179"
+        },
+        {
+            "type": 4,
+            "name": "modbus180",
+            "attribute": 3,
+            "address": "1!400180"
+        },
+        {
+            "type": 4,
+            "name": "modbus181",
+            "attribute": 3,
+            "address": "1!400181"
+        },
+        {
+            "type": 4,
+            "name": "modbus182",
+            "attribute": 3,
+            "address": "1!400182"
+        },
+        {
+            "type": 4,
+            "name": "modbus183",
+            "attribute": 3,
+            "address": "1!400183"
+        },
+        {
+            "type": 4,
+            "name": "modbus184",
+            "attribute": 3,
+            "address": "1!400184"
+        },
+        {
+            "type": 4,
+            "name": "modbus185",
+            "attribute": 3,
+            "address": "1!400185"
+        },
+        {
+            "type": 4,
+            "name": "modbus186",
+            "attribute": 3,
+            "address": "1!400186"
+        },
+        {
+            "type": 4,
+            "name": "modbus187",
+            "attribute": 3,
+            "address": "1!400187"
+        },
+        {
+            "type": 4,
+            "name": "modbus188",
+            "attribute": 3,
+            "address": "1!400188"
+        },
+        {
+            "type": 4,
+            "name": "modbus189",
+            "attribute": 3,
+            "address": "1!400189"
+        },
+        {
+            "type": 4,
+            "name": "modbus190",
+            "attribute": 3,
+            "address": "1!400190"
+        },
+        {
+            "type": 4,
+            "name": "modbus191",
+            "attribute": 3,
+            "address": "1!400191"
+        },
+        {
+            "type": 4,
+            "name": "modbus192",
+            "attribute": 3,
+            "address": "1!400192"
+        },
+        {
+            "type": 4,
+            "name": "modbus193",
+            "attribute": 3,
+            "address": "1!400193"
+        },
+        {
+            "type": 4,
+            "name": "modbus194",
+            "attribute": 3,
+            "address": "1!400194"
+        },
+        {
+            "type": 4,
+            "name": "modbus195",
+            "attribute": 3,
+            "address": "1!400195"
+        },
+        {
+            "type": 4,
+            "name": "modbus196",
+            "attribute": 3,
+            "address": "1!400196"
+        },
+        {
+            "type": 4,
+            "name": "modbus197",
+            "attribute": 3,
+            "address": "1!400197"
+        },
+        {
+            "type": 4,
+            "name": "modbus198",
+            "attribute": 3,
+            "address": "1!400198"
+        },
+        {
+            "type": 4,
+            "name": "modbus199",
+            "attribute": 3,
+            "address": "1!400199"
+        },
+        {
+            "type": 4,
+            "name": "modbus200",
+            "attribute": 3,
+            "address": "1!400200"
+        }
+    ]
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host":"127.0.0.1",
+        "port":60502,
+        "connection_mode":0
+    }
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0001"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0001",
+    "adapter_name": "modbus-tcp-0001"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0002",
+    "adapter_name": "modbus-tcp-0001"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0003",
+    "adapter_name": "modbus-tcp-0001"
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host":"127.0.0.1",
+        "port":60502,
+        "connection_mode":0
+    }
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0002"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0001",
+    "adapter_name": "modbus-tcp-0002"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0002",
+    "adapter_name": "modbus-tcp-0002"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0003",
+    "adapter_name": "modbus-tcp-0002"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0004",
+    "adapter_name": "modbus-tcp-0002"
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host":"127.0.0.1",
+        "port":60502,
+        "connection_mode":0
+    }
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0003"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0001",
+    "adapter_name": "modbus-tcp-0003"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0002",
+    "adapter_name": "modbus-tcp-0003"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0003",
+    "adapter_name": "modbus-tcp-0003"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0004",
+    "adapter_name": "modbus-tcp-0003"
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host":"127.0.0.1",
+        "port":60502,
+        "connection_mode":0
+    }
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0004"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0001",
+    "adapter_name": "modbus-tcp-0004"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0002",
+    "adapter_name": "modbus-tcp-0004"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0003",
+    "adapter_name": "modbus-tcp-0004"
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0004",
+    "adapter_name": "modbus-tcp-0004"
+}
@@ -0,0 +1,7 @@
+{
+    "params": {
+        "host":"127.0.0.1",
+        "port":60502,
+        "connection_mode":0
+    }
+}
@@ -0,0 +1,5 @@
+{
+    "read_interval": 1000,
+    "group_config_name": "group-0000",
+    "adapter_name": "modbus-tcp-0005"
+}
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
fengzeroz	f74d55a98c	Merge pull request #1803 from fengzeroz/v2.7 version: 2.7.1	2024-01-05 10:02:33 +08:00
fengzero	f0d20ec77b	version: 2.7.1	2024-01-05 02:01:49 +00:00
fengzeroz	9693d50dd0	Merge pull request #1800 from fengzeroz/v2.7 version: 2.7.1	2024-01-05 09:48:49 +08:00
fengzero	e34d7bf3e5	version: 2.7.1	2024-01-05 01:48:11 +00:00
fengzeroz	8fe1202d3f	Merge pull request #1796 from hxy7yx/v2.7-2 limit the number of groups to a maximum of 512	2024-01-04 16:20:41 +08:00
hxy7yx	11672c62ee	limit the number of groups to a maximum of 512	2024-01-04 16:04:42 +08:00
fengzeroz	af8d29f9e9	Merge pull request #1798 from eeff/v2.7 Pick to v2.7 feat(core): get subscribe group request support filter	2024-01-04 14:53:56 +08:00
eeff	96fc6ebf6e	test: get subscribe info ft	2024-01-04 14:23:15 +08:00
eeff	b922905e39	feat(restful): get subscribe group api support filtering	2024-01-04 14:23:15 +08:00
eeff	b49f39729a	feat(core): get subscribe group request support filtering	2024-01-04 14:23:13 +08:00
fengzeroz	128bc2820b	Merge pull request #1794 from fengzeroz/v2.7 get tags: query description	2024-01-04 10:21:51 +08:00
fengzero	5e33fc9d17	get tags: query description	2024-01-04 02:12:14 +00:00
fengzeroz	b1d410e497	Merge pull request #1793 from eeff/v2.7 Pick to v2.7 feat(core): read group support filter	2024-01-03 17:46:56 +08:00
eeff	2c09db89c0	test: read group query ft	2024-01-03 17:32:15 +08:00
eeff	40025265f2	feat(restful): read group handler support query	2024-01-03 17:32:15 +08:00
eeff	725618d345	feat(core): read group support query matching	2024-01-03 17:32:14 +08:00
fengzeroz	e61826de1c	Merge pull request #1788 from hxy7yx/v2.7-1 increase the size of EVENT_SIZE	2024-01-03 10:03:55 +08:00
fengzeroz	4beaa8c113	Merge pull request #1786 from fengzeroz/v2.7 msg q	2024-01-03 10:03:23 +08:00
hxy7yx	fbe5c2f42b	increase the size of EVENT_SIZE	2024-01-02 18:06:01 +08:00
fengzero	6d90208a6e	msg q	2023-12-29 06:53:26 +00:00
fengzeroz	9c7d95d3a1	Merge pull request #1783 from fengzeroz/v2.7 lock tag table	2023-12-29 11:06:37 +08:00
fengzero	c2a59e9a23	lock tag table	2023-12-29 02:03:03 +00:00
fengzeroz	71227496ac	Merge pull request #1779 from fengzeroz/v2.7 fix event leak	2023-12-25 10:55:21 +08:00
fengzero	52d15c31de	event log	2023-12-25 02:46:30 +00:00
fengzero	3fb501630a	fix(event): timer/io index set	2023-12-25 02:42:32 +00:00
fengzeroz	2b814b8fe2	Merge pull request #1776 from fengzeroz/v2.7 V2.7	2023-12-22 15:59:12 +08:00
fengzero	336563834b	version: 2.7.0	2023-12-22 07:52:13 +00:00
hxy7yx	59e7ff3e60	fix(add_gtags):license tag count	2023-12-22 07:52:13 +00:00
hxy7yx	b145220585	fix http status	2023-12-22 07:52:13 +00:00
hxy7yx	3e4489d2c2	fix:add_tags and add_gtags http resp code	2023-12-22 07:52:13 +00:00
fengzero	74dc6b9489	fix(conn): lock conn buf	2023-12-22 07:52:13 +00:00
xiang.zhou	d6e94f7009	fix:add library update fail error code	2023-12-22 07:52:13 +00:00
fengzeroz	8930b16948	Merge pull request #1774 from eeff/v2.7 Pick to v2.7 fix(core): replace path separator char in adapter log category	2023-12-22 14:50:51 +08:00
eeff	d95137d1a3	fix(core): replace path separator char in adapter log category	2023-12-22 14:47:21 +08:00
fengzeroz	21ff7aea65	Merge pull request #1754 from ZhouBox/v2.7 [v2.7]fixbug:no update plugin when update plugin library	2023-12-15 09:29:40 +08:00
xiang.zhou	58cc696e5e	fixbug:no update plugin when update plugin library	2023-12-14 19:11:41 +08:00
fengzeroz	76ea51be2b	Merge pull request #1747 from hxy7yx/v2.7-1 fix(NEU_REQ_ADD_GTAG): del added tags when add failed	2023-12-13 10:00:21 +08:00
hxy7yx	b91b2ef55d	fix(NEU_REQ_ADD_GTAG): del all tags when add failed	2023-12-12 15:53:03 +08:00
fengzeroz	8fc783e679	Merge pull request #1750 from fengzeroz/v2.7 event: log	2023-12-12 15:29:55 +08:00
fengzero	36e66e1521	event: log	2023-12-12 07:21:33 +00:00
fengzeroz	2ad3c5e87c	Merge pull request #1744 from fengzeroz/v2.7 fix write tag in arm64	2023-12-12 10:30:56 +08:00
fengzero	d51ef29568	fix write tag	2023-12-12 02:24:46 +00:00
fengzero	b3d88977bf	fix write tag in arm64	2023-12-11 10:34:05 +00:00
fengzeroz	330a58f825	Merge pull request #1740 from fengzeroz/v2.7 reg sigkill	2023-12-11 17:07:01 +08:00
fengzero	c779d86da2	reg sigkill	2023-12-11 09:03:48 +00:00
fengzeroz	0b3075e94d	Merge pull request #1735 from hxy7yx/v2.7-1 add ft case for negative decimal	2023-12-11 16:17:05 +08:00
fengzeroz	33d317551c	Merge pull request #1737 from fengzeroz/v2.7 Revert "fix(conn): lock conn buf"	2023-12-11 15:50:15 +08:00
fengzero	1f019eb02b	Revert "fix(conn): lock conn buf" This reverts commit `1151bb43b8`.	2023-12-11 07:48:16 +00:00
hxy7yx	2e407c3e6e	add ft case for negative decimal	2023-12-11 14:42:58 +08:00
fengzeroz	a4fb604db7	Merge pull request #1733 from fengzeroz/v2.7 ci: v2.7	2023-12-08 17:13:00 +08:00
fengzero	090650c5c4	ci: v2.7	2023-12-08 09:10:27 +00:00
fengzeroz	d6c0c04feb	Merge pull request #1732 from fengzeroz/v2.7 cmake v2.7	2023-12-08 17:06:49 +08:00
fengzero	bf548c974f	cmake v2.7	2023-12-08 09:06:06 +00:00
fengzeroz	54aa2a15b3	Merge pull request #1731 from fengzeroz/v2.7 V2.7	2023-12-08 16:55:37 +08:00
fengzero	e3040ea184	rm codecov	2023-12-08 08:55:09 +00:00
fengzero	9d02f1faec	branch v2.7	2023-12-08 08:55:09 +00:00
fengzeroz	34f64c832f	Merge pull request #1730 from fengzeroz/v2.7 version: 2.7.0	2023-12-08 16:50:19 +08:00
fengzero	93b488a02c	version: 2.7.0	2023-12-08 08:48:57 +00:00