© 2024 AutomataNexus, LLC. All Rights Reserved.
The NexusControllers repository contains the complete building automation system platform including control logic templates, configuration tools, and remote access portal for AutomataNexusBms Controller systems. This comprehensive solution provides enterprise-grade HVAC control for commercial facilities running on Raspberry Pi 4 hardware with 32-bit Raspberry Pi OS.
Control Systems:
- Air Handling Units (AHUs) with VFD and DX cooling
- Variable Air Volume (VAV) terminal boxes
- Hot water boiler and pump systems
- Economizer control and free cooling
- Multi-stage DX compressor control
- Lead/lag equipment rotation
Platform Features:
- Neural Nexus AI control algorithms
- Real-time I2C sensor integration (BME280)
- 10K NTC thermistor inputs
- 0-10V analog I/O
- 24VAC triac outputs
- Web-based monitoring and control
- Secure remote access via Cloudflare tunnels
- Comprehensive alarm and audit logging
NexusControllers/
├── README.md # This file
│
├── remote-access-portal/ # Web Portal System
│ ├── SetupNexus.py # GUI installer
│ ├── src/ # React TypeScript source
│ │ ├── App.tsx # Main application
│ │ ├── components/ # React components
│ │ │ ├── WeatherBar.tsx
│ │ │ └── Sidebar.tsx
│ │ ├── pages/ # Page components
│ │ │ ├── Dashboard.tsx
│ │ │ ├── NodeRED.tsx
│ │ │ ├── Terminal.tsx
│ │ │ └── NeuralBMS.tsx
│ │ ├── services/ # API services
│ │ │ └── api.ts
│ │ └── types.ts # TypeScript definitions
│ ├── public/ # Static assets
│ │ ├── index.html
│ │ ├── styles.css
│ │ └── automata-nexus-logo.png
│ ├── server.js # Express backend
│ ├── package.json # Dependencies
│ ├── tsconfig.json # TypeScript config
│ ├── ecosystem.config.js # PM2 configuration
│ ├── init.sh # Portal initialization
│ ├── init-databases.sh # Database setup
│ ├── restartnexus.sh # Quick restart script
│ ├── claudecode.sh # Claude Code reinstall
│ └── README.md # Portal documentation
│
├── Templates/ # Control logic templates
│ ├── AHU_SupplyAir_Template.js # Supply air control AHU
│ ├── AHU_ReturnAir_Template.js # Return air control AHU
│ ├── AHU_SpaceTemp_Template.js # Space temp control AHU
│ ├── VAV_Template.js # VAV terminal box
│ ├── BoilerPump_Template.js # Boiler & pump system
│ └── README.md # Template usage guide
│
├── Documentation/ # System documentation
│ ├── Installation_Guide.md # Hardware & software setup
│ ├── Configuration_Guide.md # System configuration
│ ├── Control_Sequences.md # Control logic details
│ ├── I_O_Specifications.md # Input/output specs
│ └── Troubleshooting_Guide.md # Common issues & fixes
│
└── Tools/ # Utility scripts
├── config_generator.py # Generate config files
├── equipment_validator.js # Validate equipment IDs
└── sensor_tester.js # I2C sensor diagnostics
Platform: AutomataNexusBms Controller
Hardware: Raspberry Pi 4 (2GB RAM minimum, 4GB recommended)
Storage: 64GB SD card (Class 10 or better)
Operating System: Raspberry Pi OS Bullseye 32-bit
CRITICAL: Must use 32-bit Raspberry Pi OS for compatibility with all control system libraries and Node-RED modules.
The AutomataNexusBms Controller supports multiple Sequent Microsystems expansion boards for flexible I/O configuration. All boards are stackable up to 8 units of each type, providing massive I/O capacity for large facilities.
- 4 Triac outputs (24VAC 1A, zero-cross switching)
- 4 Analog outputs (0-10V, 20mA drive)
- 8 Universal analog inputs (configurable: 0-10V, dry contact, or 10K NTC)
- Stackable up to 8 boards (32 triacs, 32 analog outputs, 64 inputs)
- All-in-one solution for standard HVAC control
- Applications: AHUs, VAVs, boilers, pumps, rooftop units
- 16 configurable channels per board
- Input types: 0-10V, dry contact, or 10K NTC thermistor
- Temperature range: -40°F to 250°F (10K mode)
- Accuracy: ±0.5°F (thermistor), ±0.1V (voltage)
- Resolution: 0.1°F / 0.01V
- Per-channel configuration via software
- Stackable up to 8 boards (128 analog inputs)
- 4-20mA analog inputs (4 channels)
- 4-20mA analog outputs (4 channels)
- Industrial sensor compatibility
- Loop-powered operation
- ±0.1mA accuracy
- Stackable up to 8 boards (32 inputs, 32 outputs)
- Applications: Pressure transducers, flow meters, industrial actuators
- 16 SPDT relays per board
- 24VAC/DC rated
- 3A per channel
- Optical isolation
- LED status indicators
- Stackable up to 8 boards (128 relays)
- Applications: Large equipment staging, multi-zone control
- 8 SPDT relays per board
- 24VAC/DC rated
- 3A per channel
- Optical isolation
- LED status indicators
- Stackable up to 8 boards (64 relays)
- Applications: Standard equipment control, compressor staging
- 2 buses, 3.3V logic
- Support for BME280, AHT20, SHT31, and other environmental sensors
- Address range: 0x76, 0x77 (BME280 typical)
- Space temperature sensing
Stacking Capability:
Each board type can be stacked up to 8 units high. Multiple board types can be stacked together on a single Raspberry Pi 4, allowing configurations like:
- 8 BAS boards + 8 16-ch input boards + 8 16-ch relay boards + 8 industrial boards = 368 I/O points on one controller
Note: Users can configure their system with any combination of Sequent Microsystems boards based on project requirements. All boards are hot-swappable and automatically detected by the controller.
The Remote Access Portal provides enterprise-grade web access for AutomataNexusBms Controllers with a Neural Nexus styled interface.
Neural Nexus Interface:
- Light theme design with cyan/teal accents
- Real-time weather display
- System monitoring with charts
- Fully responsive layout
Core Functionality:
- Secure Cloudflare tunnel access
- Full Node-RED integration
- Browser-based terminal (xterm.js)
- Neural BMS integration
- Email notifications via Resend API
- Node-RED readings widget
- Alarm thresholds configuration
Security & Authentication:
- API key authentication
- Rate limiting protection
- BCrypt password hashing
- Session management
- Complete audit logging
Five specialized SQLite3 databases with automatic management:
- Metrics Database - System performance and Node-RED readings
- Users Database - User accounts and authentication
- Audit Log Database - Complete action tracking
- Alarms Database - Active and historical alarms
- Weather Database - Current and forecast weather data
Data Management:
- 7-day retention policy
- Auto-compression to .json.gz archives
- Rolling delete at 100MB limit
- 500MB archive limit
- Daily cleanup at 2:00 AM
- Automatic database vacuuming
cd /home/Automata
git clone https://github.com/AutomataControls/NexusControllers.git
cd NexusControllers/remote-access-portal
sudo python3 SetupNexus.pyThe GUI installer will:
- Collect installation information
- Generate unique controller serial number
- Create secure .env configuration
- Install Node.js dependencies
- Setup Cloudflare tunnel
- Configure systemd services
Default Credentials:
- Username:
DevOps - Password:
Invertedskynet2$
Local: http://localhost:8000
Remote: https://<serial-number>.automatacontrols.com
For complete portal documentation, see remote-access-portal/README.md
Air Handler Units:
AHU_SupplyAir_Template.js- Supply air temperature control with OARAHU_ReturnAir_Template.js- Return air temperature controlAHU_SpaceTemp_Template.js- Space temperature control via I2C sensor
Terminal Units:
VAV_Template.js- VAV box with damper and reheat control
Central Plants:
BoilerPump_Template.js- Dual boiler/pump system with lead/lag
All templates include:
- Equipment identification and configuration
- Occupancy scheduling (occupied/unoccupied modes)
- Temperature setpoint management
- Control mode logic (heating, cooling, economizer, deadband)
- Safety sequences (freeze protection, high temp protection)
- Equipment staging with minimum runtimes
- Comprehensive logging and status reporting
- UI override capability
Control algorithms include:
- Real-time adaptive control
- Predictive equipment staging
- Energy optimization
- Automatic lead/lag rotation
- Intelligent economizer control
- Compressor protection logic
Each system requires two files:
1. Configuration HTML (config.html):
- Equipment specifications and cut sheets
- Complete I/O mapping
- Wire diagrams
- Control sequences documentation
- Safety limits and operational parameters
2. Control Logic File (logic.js):
- Equipment ID and location
- Sensor input mapping
- Control output definitions
- Main control function
- Helper functions for calculations
- Logging and status reporting
Building Automation Board (BAS) - Stack 0-7:
- TR1-TR4: Triac outputs (24VAC, per board)
- AO1-AO4: Analog outputs (0-10V, per board)
- AI1-AI8: Universal inputs (0-10V, dry contact, or 10K NTC, per board)
- Stack notation: BAS0.TR1, BAS1.TR2, BAS7.AO3, etc.
16-Channel Universal Analog Input Board - Stack 0-7:
- AI1-AI16: Configurable per channel (per board)
- Software-selectable input type per channel
- Stack notation: AIN0.AI5, AIN1.AI12, AIN7.AI16, etc.
Industrial Automation Board - Stack 0-7:
- 4-20mA Inputs: Industrial sensors (per board)
- 4-20mA Outputs: Industrial valve control, VFD control (per board)
- Stack notation: IND0.AI1, IND2.AO3, etc.
Relay Boards (8ch or 16ch) - Stack 0-7:
- 8ch: RLY1-RLY8 per board
- 16ch: RLY1-RLY16 per board
- Stack notation: REL8.0.RLY5, REL16.3.RLY12, etc.
- Applications: Fan enable, pump enable, compressor staging, boiler enable
I2C Sensors:
- Bus#1 or Bus#2
- Address specification (typically 0x76 for BME280)
- Space temperature, humidity, pressure sensing
- Raspberry Pi 4 (2GB RAM minimum, 4GB recommended)
- 64GB SD card (Class 10 or better)
- Raspberry Pi OS Bullseye 32-bit
- Active internet connection
Automatically installed:
- Node.js 18+
- Node-RED v3.0+
- PM2 process manager
- Cloudflare tunnel daemon
- SQLite3
- Python 3 with tkinter
- Install Raspberry Pi 4 with 32-bit Raspberry Pi OS Bullseye
- Connect I/O expansion board
- Wire sensors and outputs per configuration
cd /home/Automata
git clone https://github.com/AutomataControls/NexusControllers.git
cd NexusControllers/remote-access-portal
sudo python3 SetupNexus.py- Copy appropriate template from
/Templates - Modify equipment ID and I/O mapping
- Set control parameters and schedules
- Test sensor inputs and control outputs
- Import control logic into Node-RED
- Verify sensor readings
- Test control sequences
- Enable automatic startup
- Local:
http://localhost:8000 - Remote:
https://<serial>.automatacontrols.com - Login with default credentials
- Change password immediately
# Restart portal
restartnexus
# Check status
pm2 status
# View logs
pm2 logs nexus-portal
# Monitor processes
pm2 monit# Start tunnel
sudo systemctl start cloudflared
# Check status
sudo systemctl status cloudflared
# View logs
sudo journalctl -u cloudflared -f# Restart Node-RED
sudo systemctl restart nodered
# Check status
sudo systemctl status nodered
# View logs
sudo journalctl -u nodered -f- Air Handlers: Carrier, Trane, York, Daikin
- Boilers: Lochinvar, Weil-McLain, Cleaver-Brooks
- Pumps: Bell & Gossett, Armstrong, Grundfos
- Chillers: Carrier, Trane, York
- Actuators: Belimo, Honeywell, Johnson Controls
- Sensors: 10K NTC thermistors, BME280, AHT20, SHT31
- VFDs: ABB, Yaskawa, Danfoss
- Relays: 24VAC pilot duty relays
- Installation Guide:
Documentation/Installation_Guide.md - Configuration Guide:
Documentation/Configuration_Guide.md - Control Sequences:
Documentation/Control_Sequences.md - Troubleshooting:
Documentation/Troubleshooting_Guide.md
For commercial support and licensing:
- Company: AutomataNexus, LLC
- Product: AutomataControls™
- Controller: AutomataNexusBms Controller
- Contact: Your AutomataNexus representative
This software is protected by commercial license and is the property of AutomataNexus, LLC.
PROPRIETARY AND CONFIDENTIAL
- This software constitutes valuable trade secrets
- Unauthorized use, copying, or distribution is strictly prohibited
- Use requires a valid commercial license agreement
- Contact AutomataNexus for licensing information
- Change Default Credentials - Immediately upon installation
- Secure .env Files - Never commit to version control
- Regular Updates - Check for security patches
- Backup Configuration - Regular backups of system configuration
- Network Security - Use Cloudflare tunnel for remote access
- API Key Protection - Keep API keys secure and rotate regularly
Initial Release Features:
- Complete remote access portal with Neural Nexus styling
- Five-database system with automatic management
- Control logic templates for AHU, VAV, and boiler systems
- Cloudflare tunnel integration
- Node-RED integration
- Real-time monitoring and control
- Comprehensive alarm system
- Audit logging
This is a commercial product. For feature requests or bug reports, contact AutomataNexus support.
- 32-bit OS Required: Must use 32-bit Raspberry Pi OS Bullseye for compatibility
- Security: Keep .env files secure and never commit to version control
- Backups: Regularly backup configuration and Node-RED flows
- Updates: Check regularly for security patches and updates
- License: Valid commercial license required for production use
- Support: Commercial support available for licensed users
AutomataControls™ - Enterprise HVAC Control Solutions
© 2024 AutomataNexus, LLC. All Rights Reserved.