Universal-IoT-Java/README_EN.md

🤖 NexIoT AI IoT Platform

🎯 Innovative "True Zero-Code Intrusion" IoT Platform

💡 Breaking Traditional IoT Platform Design · Fully Externalized Device Drivers · One-Click Export · Zero Code Intrusion

📖 Documentation | 🌐 Live Demo | 🔧 AI Debug IDE

中文 | English

✨ Platform Introduction

NexIoT AI IoT Platform is an enterprise-level IoT platform with innovative architecture design featuring True Zero-Code Intrusion.

🎯 Core Highlights

🚀 What Can This Project Do For You?

• 🏢 Perfect for Medium & Large Enterprises: IoT Infrastructure Center, Unified Device Data Access, ideal for building your own products and B|G projects
• 🔓 No More Vendor Lock-in: Free yourself from device vendors and software providers who charge exorbitant prices
• 🎓 Easy to Get Started: Simple debugger, accessible even to college students, saving massive R&D, testing, and O&M costs
• 🤝 Ecosystem Co-construction: One-click export of products, thing models, and drivers for ecosystem sharing
• ⚡ Real-time Hot Deployment: Real-time hot deployment, from 0 to 100 device integrations without service restart for years
• 🚀 High Availability Cluster: Open-source version supports clustering for millions of devices

🌟 Platform Features

• ✅ Zero Code Intrusion: Externalized device drivers, no platform code modification needed, no recompilation or redeployment, zero coupling with core platform code
• ✅ Full Protocol Support: TCP, Modbus RTU/TCP, MQTT, HTTP and other industrial and IoT protocols
• ✅ Cloud Platform Integration: Integration with platforms like CTIoT, China Mobile OneNet, WVP GB28281 video standards
• ✅ Multi-Database Support: Supports MySQL 8.0+, IoTDB, ClickHouse and other relational and time-series databases

🏗️ Technical Architecture

🛠️ Tech Stack

🚀 Core Framework (Extremely Lightweight)

• Backend Framework: Java 21 SpringBoot 3.5 Tk.Mybatis 5.0.1
• Frontend Technology: Built on RuoYi-Antdv, thanks to the open-source community!
• Log Storage: IoTDB / ClickHouse / MySQL / None (Production-grade seamless dynamic switching)

🧭 Deployment & Startup (One-Click Start)

The image is the Enterprise edition image (preview) as of 5 December 2025, including a closed-source access agreement!

• One-Click Start: docker-compose up -d
• Access URLs:
  • Admin Panel: http://localhost:80 (Default: nexiot/nexiot@123321)
  • IDE Debugger: http://localhost:9092/magic/debug/index.html (Same password as admin)
  • EMQX Management: http://localhost:18083 (Default: admin/public)

🔧 One-click startup includes database and initialization data (SQL), help yourself!

📈 Ongoing Development

🚀 Roadmap

• 🚀 WVP Video Platform Integration: Integration with WVP video platform series (in beta testing)
• 🚀 Dahua ICC Product Series: Integration with Dahua ICC product series
• 🚀 Hikvision Integrated Security Platform: Integration with Hikvision platform product series
• 📱 Mobile Application: Paid mini-program with command control, property viewing, alarm monitoring, lightweight, multi-admin support

🚀 Quick Start

🎯 Demo Site (Latest Version)

✨ All Real Devices, Driver Source Code Open, Fully Transparent!

💎 Exclusively sponsored by Aeolian Cloud for NexIoT online demo server

• 🌐 Demo Site: http://demo.nexiot.cc/
• 🔧 Debug IDE: http://demo.nexiot.cc/magic/debug/index.html
• 👤 Demo Account: test
• 🔑 Demo Password: nexiot@123321
• 📖 Documentation: https://docs.nexiot.cc/
• 🔗 Backup URL: http://iot.192886.xyz:81

📸 Real-World Cases & Video Tutorials

📊 Device Integration Cases (Partial Display)

⚡ Integration Showcase

---

📸 Platform Interface Display

🏗️ Driver System Architecture

🚀 Cloud-Native Deployment Architecture

🖥️ Intelligent Features Showcase

📺 Product Overview

🔄 Gateway Access to Various Sub-devices (DTU, Modbus)

🛠️ All Protocols Visualized Management & Online Debugging

🔄 Workflow Orchestration Engine

🎯 In-depth Feature Display

🎯 WVP-GB28281 + Hikvision ISC + Dahua ICC

🌐 CTIoT Product Integration

🎯 Mobile / Mini-Program

📺 Video Tutorials

More videos on Bilibili and Douyin

📚 Basic Tutorials

No.	Tutorial Name	Video Link
1	[NexIoT Course] (1) IDEA & Docker One-Click Start	📺 Watch on Bilibili
2	[NexIoT Course] (2) EMQX Configuration	📺 Watch on Bilibili

📨 MQTT Integration Tutorial

No.	Tutorial Name	Video Link
1	Any Topic & Full Process Integration Tutorial	📺 Watch on Bilibili

📊 Feature Comparison

Main Features	Description	Open Source	Enterprise
JDK21 Virtual Threads	Based on Java21, SpringBoot3.x framework, supporting virtual threads, netty high performance	✅	✅
RuoYi Scaffold	Admin, role management, permission management, log management, including extensions for phone verification, OSS file management Supports login logs, operation log query management	✅	✅
Login/Homepage	Account password verification code login Supports i18n multi-language Dashboard data statistics display	✅	✅
Product Management	One-click export/import (product, TSL, parser) for immediate sharing Online thing model editing, supports properties, events, functions Device tag settings, common configs (auto registration, offline detection rules, device SN parsing) TCP cloud config (port, packet splitting, encoding/decoding) HTTP third-party cloud config Independent device thing model storage	✅	✅
Product Categories	Category creation management, supports adding sub-categories	✅	✅
Protocol Management	Unified protocol management and hot updates Protocol drivers fully externalized	✅	✅
Device List	Complete device lifecycle management Device list display, device status Online function calls, device shadows Communication log management, message subscription config Gateway & gateway sub-device support Topology diagram display Batch device operations	✅	✅
Device Shadow	Latest device status cache Supports property, event, function status storage Shadow data query and update	✅	✅
Device Groups	Device grouping for unified management and scene linkage Supports batch group operations	✅	✅
Gateway Polling	Cloud-based scheduled gateway polling Multi-command config, polling intervals (30s/60s/120s/300s/600s) Retry on failure, timeout control Distributed cluster deployment	✅	✅
Integrated WEB IDE	Online protocol debugging, unified management Browser-based visual IDE Protocol script writing, debugging, hot deployment (Premium version provides IDE debug frontend source code)	✅	✅
Scene Linkage	Device thing model event, property configuration Execute linkage to other devices Notification sending Linkage log query	✅	✅
Rule Engine	Visual rule orchestration engine (similar to Node-RED) Supports industrial protocols like Modbus, OPCUA Workflow orchestration, node configuration Greatly enhances platform access capabilities (under development)	✅	✅
Data Bridge	Data source configuration, bridge rule definition Bridge types: input, output, bidirectional Direct output to databases (MySQL, PostgreSQL, SQLServer, Oracle) Time-series database output (IoTDB, Clickhouse, InfluxDB) MQ output (Kafka, MQTT) HTTP data bridging Other middleware extensions	✅	✅
Data Forwarding	Device group filtering Custom data forwarding by rules Forward to HTTP, MQTT and other targets	✅	✅
Multi-Application Management	Application data isolation; multi-application management; complete north-south data push and command invocation Create multiple applications per account Independent data between applications (similar to multi-tenancy)	✅	✅
SDK Support (Java)	Device management: device registration, query, update, delete Device communication: online/offline status management Data reporting: property and event reporting Security authentication: OAuth2 client authentication and password authentication Easy integration: out-of-the-box SDK	✅	✅
Northbound Push	HTTP push, MQTT push (open source support) Other push methods (enterprise exclusive)	✅	✅
Notification Channels	Supports DingTalk, Alibaba Cloud SMS/Voice, Tencent Cloud SMS/Voice, Feishu, Email	✅	✅
Notification Templates	Custom template creation Variable replacement support	✅	✅
Certificate Management	TLS/SSL certificate management Certificate upload, query, delete	✅	✅
MQTT Direct Access	Built-in MQTT access Support for custom MQTT nodes MQTT cluster deployment	✅	✅
HTTP Access	Cloud-to-cloud integration OAUTH2 standard access Seamless Java SDK integration	✅	✅
Modbus Protocol	Modbus RTU/TCP protocol support Modbus device access and data processing Note: Open source version supports MQTT method	✅	✅
TCP/UDP Direct Access	Custom protocols, Modbus and other TCP communication SNI TLS wildcard domain access TCP clustering, unlimited node expansion TCP packet splitting/merging Dynamic start/stop and listener creation	❌	✅
CTIoT	Seamless integration with China Telecom CTIoT AIOT Product and device management unified in NexIoT	❌	✅
Video Access	Lechange cloud video access (enterprise complimentary) GB28181 video protocol support (WVP integration in beta) Dahua ICC and Hikvision ISC in planning	❌	✅
Cluster Deployment	Multi-node cluster deployment Distributed locks, load balancing High availability, horizontal scaling	✅	✅
Time-Series Database	Seamless dynamic switching of log storage Supports None (no storage) / MySQL / ClickHouse / IoTDB	✅	✅
MQTT Any Topic	External MQTT Broker integration MQTT any topic data integration and command control Data passthrough and thing model structure	❌	✅
Community Free Drivers	Thanks to excellent architecture, community drivers can be exported and used for free Supports DLT645-2007, JT808, CTIoT 50+ devices	✅	✅

---

📢 Important Notice

• Media Sharing: Welcome to share project information, please comply with AGPL3.0 open-source license
• Enterprise Authorization: Commercial use requires authorization, retain enterprise authorization information
• Legal Liability: Reserve the right to pursue legal action for misuse that causes legal consequences

🌐 Community Contact

QQ Group	WeChat	Bilibili	Douyin

🛠️ Technical Support & Services

We provide comprehensive technical support services, from basic Q&A to enterprise-level solutions, meeting different levels of needs. Fees enable better service and greater encouragement for authors!

📋 Service Type Comparison

Service Type	Service Content	Price	Applicable Scenarios	Contact
🆓 Community Q&A	• Basic Q&A • Usage guidance • Community exchange	Free	Learning, Usage	QQ Group, WeChat Group
📚 Technical Documentation	• Technical docs • Practice guides • Video tutorials	Free	Self-learning, Reference	Documentation
☁️ Online Deployment	• Customer provides hardware • Complete system deployment • Cloud service deployment	¥199	Quick launch, Cloud deployment	Contact Technical Support
🔧 Dedicated Support	• Various integration support • Usage guidance • Deployment solutions • Solutions	¥600/4hrs	Remote support	Contact Technical Support
⚡ Device Integration	• IDE parser source code • Product config export • Custom integration	¥1000/day	Complex device integration, Custom development	Contact Customer Service
🏢 Enterprise Worry-Free	• Commercial on-premise deployment • Managed operations • 5×8 technical support	¥9,999/year	-	Contact Customer Service

---

📄 Open Source License & Authorization

Please comply with AGPL3.0 open-source license, commercial use requires authorization

📜 Detailed Authorization Terms

✅ Authorized User Rights

1. Internal Use: Authorized users can use indefinitely within their organization

   • Enterprise authorization: excludes branches, subsidiaries, and third parties
   • Personal authorization: personal use only, not for employer or third parties

2. Development Rights: Authorized users can perform secondary development via project form

   • Customized software must be encrypted and packaged before delivery to customers
   • Source code delivery requires purchasing corresponding commercial authorization for customers

❌ Authorization Restrictions

1. No Transfer: Cannot distribute or transfer authorized source code to third parties
   • Whether paid or unpaid transfer
   • Cannot apply for software copyright containing this project

🔒 Closed Source Content

TCP, UDP, CTIoT modules. Can be extended through secondary development, commercial use requires project sponsorship and authorization.

🙏 Acknowledgments

Thanks to the following open-source projects and technology platforms:

• Open Source Frameworks: RuoYi, Antdv, jetlink, ssssssss-team
• Cloud Platforms: Alibaba Cloud, Huawei Cloud, Tencent Cloud, AEP, OneNet and other IoT platforms
• Community Support: All contributors and users for their support and feedback