v2c-any (v2ca)

Turn { device: any } into V2C Dynamic Power Control

v2c-any (binary: v2ca) is a universal adapter that allows any device — physical meters, MQTT topics, simulators, or proxies — to integrate with V2C wallboxes for Dynamic Power Control.

If it can expose power data, v2c-any can make it speak V2C.

Why v2c-any?

V2C wallboxes support Dynamic Power Control via specific meters or MQTT inputs.
In real installations, however, power data often comes from heterogeneous sources:

• Different brands of energy meters
• Existing MQTT infrastructures
• Home Assistant sensors
• Custom hardware or software systems
• Simulated or virtual meters for testing

v2c-any bridges that gap.

It adapts any input into the protocol and format expected by a V2C wallbox — without changing your existing setup.

The idea

{ device: any } → V2C

Or in practical terms:

[Any Meter | MQTT | API | Simulator]
            │
            ▼
         v2c-any
            │
            ▼
       V2C Wallbox

Key features

• 🔌 Universal adapter – works with any power data source
• 📡 MQTT support – publish once, charge dynamically
• ⚡ Dynamic Power Control – grid, solar, or hybrid scenarios
• 🧪 Simulation mode – emulate supported meters for testing
• 🔁 Proxy mode – forward and transform existing devices
• 🧩 Extensible architecture – add new adapters easily
• 🟦 TypeScript-first – predictable, typed, maintainable

Quick Start

Installation

# Install globally via npm
npm install -g v2c-any

# Or run directly with npx
npx v2c-any

Configuration

v2ca uses cosmiconfig to load configuration. Create a configuration file in one of these formats:

• .v2carc (JSON or YAML)
• .v2carc.json
• .v2carc.yaml or .v2carc.yml
• v2ca.config.js (CommonJS or ESM)
• package.json with a "v2ca" key

Example configuration (.v2carc.yaml):

provider: mqtt
properties:
  url: mqtt://localhost:1883
  meters:
    grid:
      mode: pull
      feed:
        type: http-adapter
        properties:
          device: shelly-pro-em
          interval: 5000
          host: 192.168.1.100
    solar:
      mode: pull
      feed:
        type: mock
        properties:
          interval: 5000
          value:
            power: 2500

Running

# Run with auto-detected configuration
v2ca

# Run from source (development)
npm run dev

# Run with Docker
docker run -v $(pwd)/.v2carc.yaml:/app/.v2carc.yaml v2c-any

Operating Modes

v2c-any supports two primary operating modes depending on how your V2C wallbox is configured:

REST Mode (Shelly EM1 Emulator)

Emulates a Shelly Pro EM energy meter by exposing a REST API that V2C wallboxes can poll.

Use this when:

• Your V2C wallbox is configured to poll a Shelly meter
• You want to act as a drop-in replacement for physical hardware
• You prefer a pull-based (polling) approach

Quick example:

provider: rest
properties:
  port: 3000
  meters:
    grid:
      feed:
        type: http-adapter
        properties:
          device: shelly-pro-em
          host: 192.168.1.100
    solar:
      feed:
        type: mock
        properties:
          value:
            id: 1
            act_power: 852.7
            calibration: factory

How it works:

1. v2ca starts a Fastify HTTP server
2. Exposes endpoint matching Shelly Pro EM API format (i.e., /rpc/EM1.GetStatus)
3. V2C wallbox polls the endpoint at configured intervals
4. Returns real-time power data from your configured sources

📖 See full REST Mode documentation for detailed configuration options, schemas, and examples.

MQTT Mode (Direct Publisher)

Publishes power data directly to MQTT topics that V2C wallboxes subscribe to.

Use this when:

• Your V2C wallbox is configured for MQTT integration
• You have an existing MQTT broker
• You want push-based (event-driven) updates
• You need lower latency or more frequent updates

Quick example:

provider: mqtt
properties:
  url: mqtt://broker.local:1883
  meters:
    grid:
      mode: pull # v2ca polls your device
      feed:
        type: http-adapter
        properties:
          device: shelly-pro-em
          interval: 2000
          host: 192.168.1.100
    solar:
      mode: push # v2ca subscribes to MQTT topic
      feed:
        type: bridge
        properties:
          url: mqtt://solar-meter.local:1883
          topic: solar/power

How it works:

1. v2ca connects to your MQTT broker
2. Publishes to V2C-expected topics (e.g., trydan_v2c_sun_power)
3. Supports both pull (polling devices) and push (subscribing to topics)
4. V2C wallbox subscribes and receives real-time updates

📖 See full MQTT Mode documentation for detailed configuration options, schemas, and examples.

Mode Comparison

| Feature | REST Mode | MQTT Mode | | --------------- | -------------------------- | --------------------------- | | Protocol | HTTP/REST | MQTT | | Direction | Pull (V2C polls v2ca) | Push (v2ca publishes) | | Latency | Higher (polling interval) | Lower (event-driven) | | Setup | Simpler (no broker needed) | Requires MQTT broker | | Use Case | Shelly meter replacement | MQTT-native setups | | Scalability | Limited by polling | Better for multiple devices |

What v2c-any is not

• ❌ Not a replacement for your existing meters
• ❌ Not tied to a single vendor or ecosystem
• ❌ Not limited to one communication protocol

It’s an adapter, not a lock-in.

Name origin

v2c-any comes from the TypeScript any type:

“I don’t care what you are — I can work with you.”

Exactly the philosophy behind this project.

License

MIT License - see LICENSE for details.