arthexis 0.1.15

Power & Energy Infrastructure

Arthexis Constellation

For coding guidance, see AGENTS.md.

Purpose

Arthexis Constellation is a narrative-driven Django-based software suite that centralizes tools for managing electric vehicle charging infrastructure and orchestrating energy-related products and services.

Current Features

• Compatible with the Open Charge Point Protocol (OCPP) 1.6 central system, handling:
  • Lifecycle & sessions
    • BootNotification
    • Heartbeat
    • StatusNotification
    • StartTransaction
    • StopTransaction
  • Access & metering
    • Authorize
    • MeterValues
  • Maintenance & firmware
    • DiagnosticsStatusNotification
    • FirmwareStatusNotification
• API integration with Odoo, syncing:
  • Employee credentials via res.users
  • Product catalog lookups via product.product
• Runs on Windows 11 and Ubuntu 22.04 LTS
• Tested for the Raspberry Pi 4 Model B

Project under rapid active and open development.

Role Architecture

Arthexis Constellation ships in four node roles tailored to different deployment scenarios.

Role	Description & Common Features
Terminal	Single-User Research & Development Features: GUI Toast
Control	Single-Device Testing & Special Task Appliances Features: AP Public Wi-Fi, Celery Queue, GUI Toast, LCD Screen, NGINX Server, RFID Scanner
Satellite	Multi-Device Edge, Network & Data Acquisition Features: AP Router, Celery Queue, NGINX Server, RFID Scanner
Constellation	Multi-User Cloud & Orchestration Features: Celery Queue, NGINX Server

Quick Guide

1. Clone

• Linux: open a terminal and run git clone https://github.com/arthexis/arthexis.git.
• Windows: open PowerShell or Git Bash and run the same command.

2. Start and stop

Terminal nodes can start directly with the scripts below without installing; Control, Satellite, and Constellation roles require installation first. Both approaches listen on http://localhost:8000/ by default.

• VS Code

  • Open the folder and go to the Run and Debug panel (Ctrl+Shift+D).
  • Select the Run Server (or Debug Server) configuration.
  • Press the green start button. Stop the server with the red square button (Shift+F5).

• Shell

  • Linux: run ./start.sh and stop with ./stop.sh.
  • Windows: run start.bat and stop with Ctrl+C.

3. Install and upgrade

• Linux:

  • Run ./install.sh with a node role flag:
    • --terminal – default when unspecified and recommended if you're unsure. Terminal nodes can also use the start/stop scripts above without installing.
    • --control – prepares the single-device testing appliance.
    • --satellite – configures the edge data acquisition node.
    • --constellation – enables the multi-user orchestration stack.
  • Use ./install.sh --help to list every available flag if you need to customize the node beyond the role defaults.
  • Upgrade with ./upgrade.sh.

• Windows:

  • Run install.bat to install (Terminal role) and upgrade.bat to upgrade.
  • Installation is not required to start in Terminal mode (the default).

4. Administration

Visit http://localhost:8000/admin/ for the Django admin and http://localhost:8000/admindocs/ for the admindocs. Use --port with the start scripts or installer when you need to expose a different port.

Support

Contact us at [e-mail] or visit our web page for professional services and commercial support.

About Me

"What, you want to know about me too? Well, I enjoy developing software, role-playing games, long walks on the beach and a fourth secret thing." --Arthexis