import Battery, ElectricPower

battery = new Battery
battery.voltage = 3.7V +/- 10%  # Li-ion cell
battery.capacity = 2000mAh +/- 5%

# Connect to system power
system_power = new ElectricPower
battery.power ~ system_power

# Battery specifications will constrain system voltage
assert system_power.voltage within battery.voltage

# For multiple cells in series
battery_pack = new Battery
battery_pack.voltage = 11.1V +/- 10%  # 3S Li-ion pack
battery_pack.capacity = 2000mAh +/- 5%

​
Parameters

​
capacity
ampere_hour
​
voltage
volt

​
Interfaces

​
power
ElectricPower

​
Global Attributes

These attributes are available to all modules and interfaces in a design.
​
lcsc_id
str
Assign the LCSC ID of the module.If set, this will tell the picker to select that part from LCSC for this block.
​
manufacturer
str
This module’s manufacturer name, as a string.Only exact matches on the manufacturer’s name will be found by the picker. It’s recommended to fill this information based on what ato create component provides.
​
mpn
str
This module’s manufacturer part number, as a string.For the picker to select the correct part from the manufacturer, this must be set.
​
package
str
The package of the module.This drives which components can be selected, and what footprint is used.Must exactly match a known package name.
​
exclude_from_bom
bool
​
override_net_name
str
When set on an interface, this will override the net name of the interface.This is useful for renaming nets which are automatically generated.
​
required
bool
Only for ModuleInterfaces. If set to True, require that interface is connected to something outside of the module it’s defined in.
import Battery, ElectricPower

battery = new Battery
battery.voltage = 3.7V +/- 10%  # Li-ion cell
battery.capacity = 2000mAh +/- 5%

# Connect to system power
system_power = new ElectricPower
battery.power ~ system_power

# Battery specifications will constrain system voltage
assert system_power.voltage within battery.voltage

# For multiple cells in series
battery_pack = new Battery
battery_pack.voltage = 11.1V +/- 10%  # 3S Li-ion pack
battery_pack.capacity = 2000mAh +/- 5%