arthexis 0.1.33

Power & Energy Infrastructure

Arthexis Constellation

Purpose

Arthexis Constellation is a story-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. Supported actions are summarized below.

  Charge point → CSMS

  Action	What we do
  Authorize	Validate RFID or token authorization requests before a session starts.
  BootNotification	Register the charge point and update identity, firmware, and status details.
  DataTransfer	Accept vendor-specific payloads and record the results.
  DiagnosticsStatusNotification	Track the progress of diagnostic uploads kicked off from the back office.
  FirmwareStatusNotification	Track firmware update lifecycle events from charge points.
  Heartbeat	Keep the websocket session alive and update last-seen timestamps.
  MeterValues	Persist periodic energy and power readings while a transaction is active.
  StartTransaction	Create charging sessions with initial meter values and identification data.
  StatusNotification	Reflect connector availability and fault states in real time.
  StopTransaction	Close charging sessions, capturing closing meter values and stop reasons.

  CSMS → Charge point

  Action	What we do
  CancelReservation	Withdraw pending reservations and release connectors directly from the control center.
  ChangeAvailability	Switch connectors or the whole station between operative and inoperative states.
  ChangeConfiguration	Update supported charger settings and persist applied values in the control center.
  ClearCache	Flush local authorization caches to force fresh lookups from the CSMS.
  DataTransfer	Send vendor-specific commands and log the charge point response.
  GetConfiguration	Poll the device for the current values of tracked configuration keys.
  GetLocalListVersion	Retrieve the current RFID whitelist version and synchronize entries reported by the charge point.
  RemoteStartTransaction	Initiate a charging session remotely for an identified customer or token.
  RemoteStopTransaction	Terminate active charging sessions from the control center.
  ReserveNow	Reserve connectors for upcoming sessions with automatic connector selection and confirmation tracking.
  Reset	Request a soft or hard reboot to recover from faults.
  SendLocalList	Publish released and approved RFIDs as the charge point's local authorization list.
  TriggerMessage	Ask the device to send an immediate update (for example status or diagnostics).
  UnlockConnector	Release stuck connectors without on-site intervention.
  UpdateFirmware	Deliver firmware packages to chargers with secure download tokens and track installation responses.

  OCPP 1.6 roadmap. The following catalogue actions are in our backlog: ClearChargingProfile, GetCompositeSchedule, GetDiagnostics, SetChargingProfile.

• Charge point reservations with automated connector assignment, energy account and RFID linkage, EVCS confirmation tracking, and control-center cancellation support.

• 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
Watchtower	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 Watchtower roles require installation first. Both approaches listen on http://localhost:8888/ 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.
    • --watchtower – 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.
  • Consult the Install & Lifecycle Scripts Manual for complete flag descriptions and operational notes.
  • Review the Upgrade Guide for manual steps required after releases that stop automating specific migrations.

• 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

• Access the Django admin at http://localhost:8888/admin/ to review and manage live data. Use --port with the start scripts or installer when you need to expose a different port.
• Browse the admindocs at http://localhost:8888/admindocs/ for API documentation that is generated from your models.
• Follow the Install & Administration Guide for deployment, lifecycle tasks, and operational runbooks.
• Reference the Sigils Cookbook when configuring tokenized settings across environments.
• Manage exports, imports, and audit trails with the User Data Cookbook.
• Plan feature rollout strategies using the Node Features Cookbook.
• Curate shortcuts for power users through the Favorites Cookbook.

Support

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

Project Guidelines

• AGENTS – operating handbook for repository workflows, testing, and release management.
• DESIGN – visual, UX, and branding guidance that all interfaces must follow.

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 above all else." --Arthexis