VoltPlan Wiring Diagrams

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['dailyConsumptionWh', 'systemVoltage', 'singleBatteryAh', 'singleBatteryVoltage'], 'properties': {'systemVoltage': {'type': 'number', 'description': 'Target system voltage in volts (e.g. 12, 24, 48)'}, 'daysOfAutonomy': {'type': 'number', 'default': 2, 'description': 'Days the system should run without any charging (default: 2)'}, 'singleBatteryAh': {'type': 'number', 'description': 'Capacity of a single battery in amp-hours (e.g. 100, 200)'}, 'dailyConsumptionWh': {'type': 'number', 'description': 'Daily energy consumption in watt-hours (from calculate_power_budget)'}, 'singleBatteryVoltage': {'type': 'number', 'description': 'Voltage of a single battery (e.g. 12.8 for LiFePO4, 12 for lead-acid)'}, 'depthOfDischargePercent': {'type': 'number', 'default': 80, 'description': 'Usable percentage of battery capacity. LiFePO4: 80-90%, AGM: 50%, Gel: 50% (default: 80)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['targetVoltage', 'targetCapacityAh', 'singleBatteryVoltage', 'singleBatteryAh'], 'properties': {'targetVoltage': {'type': 'number', 'description': 'Desired system voltage (e.g. 12, 24, 48)'}, 'singleBatteryAh': {'type': 'number', 'description': 'Capacity of one battery in amp-hours'}, 'targetCapacityAh': {'type': 'number', 'description': 'Desired total capacity in amp-hours'}, 'singleBatteryVoltage': {'type': 'number', 'description': 'Nominal voltage of one battery (e.g. 12.8 for LiFePO4, 12 for lead-acid, 3.2 for LiFePO4 cells)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['batteryCapacityAh', 'batteryVoltage', 'currentStateOfChargePercent', 'chargePowerWatts'], 'properties': {'batteryVoltage': {'type': 'number', 'description': 'Battery bank voltage (e.g. 12, 24, 48)'}, 'chargePowerWatts': {'type': 'number', 'description': 'Charger output power in watts'}, 'batteryCapacityAh': {'type': 'number', 'description': 'Total battery bank capacity in amp-hours'}, 'chargeCurrentAmps': {'type': 'number', 'description': 'Maximum charge current in amps (if limited by the charger or battery BMS). If omitted, calculated from power and voltage.'}, 'targetStateOfChargePercent': {'type': 'number', 'default': 100, 'description': 'Target state of charge in percent (default: 100)'}, 'currentStateOfChargePercent': {'type': 'number', 'description': 'Current state of charge in percent (e.g. 20 for 20%)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['systemVoltage', 'loads'], 'properties': {'loads': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'continuousWatts'], 'properties': {'name': {'type': 'string', 'description': 'Name of the AC load (e.g. "Microwave", "Coffee Machine")'}, 'quantity': {'type': 'number', 'default': 1, 'description': 'Number of identical units (default: 1)'}, 'surgeWatts': {'type': 'number', 'description': 'Startup surge power in watts (for motors, compressors). If omitted, assumed equal to continuous watts.'}, 'continuousWatts': {'type': 'number', 'description': 'Continuous power draw in watts'}}, 'additionalProperties': False}, 'description': 'List of AC loads that will run through the inverter'}, 'systemVoltage': {'type': 'number', 'description': 'DC system voltage (e.g. 12, 24, 48)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['systemVoltage', 'loads'], 'properties': {'loads': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'powerWatts', 'hoursPerDay'], 'properties': {'name': {'type': 'string', 'description': 'Name of the load (e.g. "LED Lights")'}, 'quantity': {'type': 'number', 'default': 1, 'description': 'Number of identical units (default: 1)'}, 'powerWatts': {'type': 'number', 'description': 'Power consumption of a single unit in watts'}, 'hoursPerDay': {'type': 'number', 'description': 'Average hours of use per day'}}, 'additionalProperties': False}, 'description': 'List of electrical loads to include in the budget'}, 'systemVoltage': {'type': 'number', 'description': 'System voltage in volts (e.g. 12, 24, 48)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['dailyConsumptionWh', 'peakSunHours'], 'properties': {'peakSunHours': {'type': 'number', 'description': 'Average daily peak sun hours for the location. Examples: Northern Europe winter 1-2h, summer 4-6h. Southern US 5-6h. Equatorial regions 5-7h.'}, 'systemEfficiency': {'type': 'number', 'default': 0.85, 'description': 'Overall system efficiency factor (default: 0.85). Accounts for MPPT losses, wiring losses, temperature derating, and panel soiling.'}, 'dailyConsumptionWh': {'type': 'number', 'description': 'Daily energy consumption in watt-hours (from calculate_power_budget)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['voltage', 'cableLengthM'], 'properties': {'power': {'type': 'number', 'description': 'Load power in watts. Will be converted to current using the voltage. Provide either current or power.'}, 'current': {'type': 'number', 'description': 'Load current in amps. Provide either current or power.'}, 'voltage': {'type': 'number', 'description': 'System voltage in volts (e.g. 12, 24, 48)'}, 'isRoundTrip': {'type': 'boolean', 'default': True, 'description': 'Account for both positive and negative conductor (default: true). Set to false for chassis-ground returns.'}, 'cableLengthM': {'type': 'number', 'description': 'One-way cable length in meters'}, 'temperatureCelsius': {'type': 'number', 'default': 20, 'description': 'Ambient temperature in °C (default: 20°C). Affects copper resistance.'}, 'maxVoltageDropPercent': {'type': 'number', 'default': 3, 'description': 'Maximum acceptable voltage drop in percent (default: 3%)'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['systemName'], 'properties': {'loads': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'power', 'voltage', 'current'], 'properties': {'name': {'type': 'string', 'description': 'Load name (e.g. "LED Lights")'}, 'power': {'type': 'number', 'description': 'Power consumption in watts'}, 'current': {'type': 'number', 'description': 'Current draw in amps'}, 'voltage': {'type': 'number', 'description': 'Operating voltage'}}, 'additionalProperties': False}, 'description': 'Electrical loads / consumers'}, 'format': {'enum': ['svg', 'png'], 'type': 'string', 'default': 'svg', 'description': 'Output format: svg (recommended, renders inline) or png (base64-encoded image, may not display in all clients)'}, 'chargers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'inputVoltage', 'outputVoltage', 'power'], 'properties': {'name': {'type': 'string', 'description': 'Charger name (e.g. "MPPT Solar Charger")'}, 'power': {'type': 'number', 'description': 'Power rating in watts'}, 'sourceType': {'enum': ['shore', 'solar', 'wind', 'generator', 'alternator'], 'type': 'string', 'description': 'Type of power source feeding this charger'}, 'inputVoltage': {'type': 'number', 'description': 'Input voltage. For shore/generator (AC) chargers use the regional mains voltage: 230 V in Europe, UK, Australia, most of Asia and Africa; 120 V in North America and Japan. For solar/wind use the panel or turbine output voltage. For alternator use the vehicle system voltage (typically 14 V).'}, 'outputVoltage': {'type': 'number', 'description': 'Output voltage'}}, 'additionalProperties': False}, 'description': 'Chargers with their power sources'}, 'batteries': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'voltage', 'capacityAh', 'energyWh'], 'properties': {'name': {'type': 'string', 'description': 'Battery name (e.g. "LiFePO4 100Ah")'}, 'voltage': {'type': 'number', 'description': 'Nominal voltage (e.g. 12)'}, 'energyWh': {'type': 'number', 'description': 'Energy in watt-hours'}, 'capacityAh': {'type': 'number', 'description': 'Capacity in amp-hours'}}, 'additionalProperties': False}, 'description': 'Batteries in the system'}, 'systemName': {'type': 'string', 'description': 'Name of the electrical system (e.g. "My Camper Van")'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}}