| | |
|---|
| | | */ |
|---|
| | | CollectorRealtime latestCollector(String adapterCode, String collectorCode); |
|---|
| | | |
|---|
| | | /** 返回设备直接提供的工步统计，不从实时采样推导。 */ |
|---|
| | | /** |
|---|
| | | * 返回该通道的工步统计。来源有工步层时读设备工步层并原样交出；来源没有工步层时由适配器 |
|---|
| | | * 从采样段推导（ADR-0067），此时记录里的方向是推导出的方向名称（见 {@link StepRecord}）。 |
|---|
| | | * 未结束的段不交出，也不推导来源根本没有的工步层。 |
|---|
| | | */ |
|---|
| | | List<StepRecord> stepRecords(ChannelIdentity channel); |
|---|
| | | |
|---|
| | | /** |
|---|
| | |
|---|
| | | |
|---|
| | | /** 返回适配器定义的实时持久化槽位间隔。 */ |
|---|
| | | long persistenceIntervalMillis(ChannelIdentity channel); |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 返回工步与循环这些汇总记录的读取间隔。默认与实时持久化间隔一致；来源的汇总产出节奏与 |
|---|
| | | * 数据行节奏不同的实现覆盖它——推式来源的落地表在本地（实时行按展示节奏取）， |
|---|
| | | * 而汇总最快也要等来源写下下一行才可能变化，按展示节奏重算只是空跑。 |
|---|
| | | */ |
|---|
| | | default long aggregateIntervalMillis(ChannelIdentity channel) { return persistenceIntervalMillis(channel); } |
|---|
| | | |
|---|
| | | /** 返回设备计划方案；设备未提供时保持为空，不推导计划。 */ |
|---|
| | | default TestPlan testPlan(ChannelIdentity channel) { return null; } |
|---|
| | |
|---|
| | | Instant serverReceivedAt, String metricCode, BigDecimal value, String unit) { } |
|---|
| | | |
|---|
| | | /** |
|---|
| | | * 一条设备工步层记录。{@code stepType} 保留设备给出的原始类型（新威为数字枚举）， |
|---|
| | | * 方向由调用方按该类型解释，不由适配器按电流符号推断。 |
|---|
| | | * 一条设备工步层记录。来源给出工步类型时 {@code stepType} 原样保留（新威为数字枚举）， |
|---|
| | | * 方向由调用方按该类型解释，适配器不按电流符号改写它。 |
|---|
| | | * |
|---|
| | | * <p>来源**没有**工步类型列时（推式来源的厂商库里既没有工步层也没有循环汇总表，ADR-0067）， |
|---|
| | | * 适配器交出的是按已核对列语义判定出的方向名称（{@code charge} / {@code discharge} / {@code rest}）， |
|---|
| | | * 判定不出来时留空；此时该工步的其余一切仍是设备采样行上的原文事实。 |
|---|
| | | * |
|---|
| | | * <p>{@code endVoltageV} 与 {@code endCurrentA} 是该工步结束时的设备读数。 |
|---|
| | | * {@code capacityAh} 与 {@code energyWh} 是该工步自身累计的单项值，只在方向已确认时给出； |
|---|
