Naming Conventions¶
Ampowr Product naming¶
Ampowr uses a product code to distinguish between different container types from different manufacturers, capacity and power. The format is as follow:
AF-C<LENGTH>-<M_CODE>-<CAP>-<B_TYPE>-<POWER>
Where:
- LENGTH: Container length in feet
- M_CODE: Manufacturer code. E.g., CY or KR
- CAP: Storage capacity in kilowatt-hours
- B_TYPE: Battery type code. E.g., NCPB for Nano crystal phosphate battery.
- POWER: Converter max power
Example:
AF-C20-CY-550-NCPB-500
EMS Component-IDs¶
For the components that may be present in an Ampowr EMS steered storage system, there are existing naming conventions. The following table lists these conventions, showing the naming we use and the related prefix for components defined in OpenEMS implementations.
| Cosmos | Abbreviation | OpenEMS prefix | Description |
|---|---|---|---|
| Photovoltaic Inverter | PV Inverter | pv-inverter | Converts electricity coming from solar panels as direct current (DC) to alternating current(AC). |
| Energy Storage System | ESS | ess | Handles charging and discharging of included batteries. Generally a collection of components. |
| Metering Device | Meter | meter | Metering device used for measuring properties of an electrical connection point in a system. |
| Power Converter System | PCS | - | A power converter is an electrical circuit that changes the electric energy from AC/DC and DC/AC. |
Ampowr Device EMS representation¶
Ampowr has different product ranges, such as as AmpiFarms (containers) or AmpiTowers. These products come in different types and varry by capacity, max power and manufacturer.
On the EMS implementation side we see that these types require different integrations, however some types can reuse the same integration.
This called for a grouping based on integration, for which no standard or convention was present. To avoid a complex convention such as used for the different types, e.g., AF-C20-CY-550-NCPB-500, we opted for a human readable format per manufacturer.
For KStar products we use: AmpiFarm + Alpha/Beta/Gamma ((Greek) Alphabet).
For Cube products we use: AmpiFarm + One/Two/Three (Decimal).
For KingFisher HV Towers we use: AmpiTower + Anton/Bernard/Cornelis (Nederlands telefoonalfabet)
Below the mapping table to understand which device type belongs to which implementation name
| Manufacturer | Type | Implementation Name | Ampowr Product Code |
|---|---|---|---|
| KStar | Container | AmpiFarmAlpha | AF-C40-KR-1300-NCPB-500 |
| KStar | Container | AmpiFarmBeta | AF-C20-KR-695-NCPB-250 |
| Cube | Container | AmpiFarmOne | AF-C20-CY-2060-NCPB-1200 |
| Cube | Container | AmpiFarmTwo | AF-C10-CY-275-NCPB-125 |
| Cube | Container | AmpiFarmThree | AF-C10-CY-425-NCPB-200 |
| Kingfisher | HV Tower | AmpiTowerAnton | AT-4D-81-PB409-16-100-1-3/60 AT-4D-122-PB614-24-100-1-3/60 |