Step-by-step guide for integrating a new site with Enexa. Enexa serves as the master data repository for asset registry and configuration, with Amperio Middleware fetching settings via API.
Enexa serves as the central source of truth for asset registry and configuration. Amperio Middleware fetches configuration from Enexa API and applies it to site controllers.
1
Registration
Site & API credentials
2
Configuration
Assets & parameters in Enexa
3
Integration
API connectivity testing
4
Go-Live
Production optimization
Create Site Record
Unique site_id, customer association, billing setup
Generate API Credentials
API key, secret, and MQTT certificates (X.509)
Configure Sandbox Environment
Test endpoints, mock data, and logging enabled
Deliver Onboarding Package
Credentials, certificates, and integration guide
Provide Site Information
Location, grid connection capacity, hardware inventory
Hardware Specifications
Battery model, PV capacity, charger count and types
Network Connectivity
Internet connection type, static IP (if any), firewall rules
Technical Contact
Person responsible for integration and testing
credentials.json
API key, secret, site_id, endpoints
certificates.zip
X.509 device cert, private key, CA chain
initial-config.json
Default site configuration for bootstrap
Install Gateway Software
Flash firmware image to edge device (Raspberry Pi, industrial PC, etc.)
Load Certificates
Copy X.509 certificates to secure storage on device
Bootstrap Configuration
Load initial-config.json, device auto-registers with Enexa
Fetch Full Configuration
Device calls Config API to get complete site setup
Connect BMS
RS485/CAN connection to battery management system
Connect PV Inverter
Modbus/SunSpec communication to solar inverter
Connect EV Chargers
OCPP 1.6/2.0 connection to charge points
Connect Grid Meter
Pulse counter or Modbus energy meter
Enexa is the master for all site configuration. Amperio Middleware fetches configuration from Enexa's Configuration API and applies it to site controllers.
Battery Settings
Capacity, SOC limits, charge/discharge rates
PV Settings
Peak capacity, orientation, efficiency
Charger Settings
Connector types, power limits, OCPP config
Grid Settings
Import/export limits, tariff zones