Getting Started with Layer 1
Get your energy data flowing through the Qubit Foundation infrastructure in just a few steps. This guide walks you through connecting your first device and processing energy data.Prerequisites
This guide assumes you have basic familiarity with energy systems and Python programming. For production deployments, consult with your system administrator.
1
System Requirements
- Python 3.8+ or Node.js 16+
- Git for cloning repositories
- Docker (optional, for containerized deployment)
- Access to energy device or historical data
2
Network Access
- MQTT broker connectivity (port 1883/8883)
- OCPP WebSocket endpoints (port 80/443)
- Modbus TCP connectivity (port 502)
- Outbound HTTPS for schema validation
Quick Start: 5-Minute Setup
1. Install Qubit Components
- Python
- Docker
- Node.js
2. Choose Your Data Source
- Demo MQTT Data
- Your MQTT Broker
- Historical CSV Data
Use our live demo data to get started immediately:
3. Process and Validate Data
Complete Example: Solar Farm Monitoring
Let’s build a complete solar farm monitoring system:1. Project Structure
2. Configuration
3. Implementation
4. Run and Monitor
Verification
Once your system is running, verify data flow:1. Check Data Quality
2. Monitor Performance
Common Integration Patterns
Pattern 1: Real-time Dashboard
Pattern 2: Data Lake Storage
Pattern 3: Alert Generation
Troubleshooting
Connection Issues
Connection Issues
Schema Validation Errors
Schema Validation Errors
Unit Conversion Issues
Unit Conversion Issues
Performance Issues
Performance Issues
Production Deployment
High Availability Setup
- Kubernetes
- Docker Swarm
Monitoring and Alerting
Next Steps
Scale Your Deployment
Learn about production deployment patterns and scaling strategies
Layer 2: Predictions
Add AI-powered forecasting to your energy data
Custom Connectors
Build connectors for proprietary or emerging protocols
Advanced Monitoring
Set up comprehensive observability and alerting
Community and Support
1
Join the Community
Connect with other developers in our GitHub Discussions
2
Report Issues
Found a bug? Create an issue on GitHub
3
Contribute
Help improve the connectors by contributing code
You’ve now established the data foundation for your energy system. Layer 1 provides clean, standardized data ready for advanced processing, optimization, and coordination in the upper layers of the Qubit Foundation stack.