--- title: "CAISO ADS PowerBridge | Data Model | N3uron KB V1.22" slug: "caiso-ads-powerbridge-data-model" description: "CAISO ADS PowerBridge is a preconfigured N3uron node backup designed to provide a plug-and-play solution for seamlessly integrating any power plant with the California Independent System Operator (CAISO) energy market." updated: 2025-09-30T15:55:29Z published: 2025-12-22T17:54:56Z canonical: "docs.n3uron.com/caiso-ads-powerbridge-data-model" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.n3uron.com/llms.txt > Use this file to discover all available pages before exploring further. # Data Model The **CAISO ADS PowerBridge** data model is preconfigured for **5-minute dispatchable** **batches (Batch Type 0)**, the most commonly used setup. To address diverse operational requirements, the CAISO ADS Client also supports additional batch types, including: - **AS Awards** - **5-Minute Flex Ramp Award** - **Unannounced AS Test** For more details, refer to the [CAISO ADS Tag Configuration](/v122/docs/caiso-ads-client#tag-configuration) section. The **CAISO ADS PowerBridge** relies heavily on [Templates](/v122/docs/platform-templates)to simplify project deployment and maintenance. This project specifically includes three templates: **CAISO_BATCH_TYPE_00**, **CAISO_GROUP**, and **NODE**. Each template serves a distinct purpose, and their details are outlined below. ## **CAISO_BATCH_TYPE_00 Template****** ![CaisoAdsbatchType00(1)](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/CaisoAdsbatchType00(1).png) ### **Custom Properties** - **Batch_type:** Specifies the batch type. - 0) 5 minute dispatchable. - 3) AS awards. - 10) 5-minute flex ramp award. - 12) Unannounced AS test. - **Client:** Identifies the client acting as the data provider for the tags. - **Historian_name:** Specifies the **Historian module instance** responsible for data historization (e.g., "Historian"). - **Module_name:** Identifies the CAISO ADS Client module instance providing the tag's data (e.g., "CaisoAdsClient"). ### **Tag Groups** Tags are grouped into **three states**to represent different batch processing states. - **Active:** Currently active batch being processed. - **Next:** Upcoming batch scheduled after the active one. - **Previous:** Batch processed immediately before the active batch. > [!NOTE] > **Note:** > > N3uron's CAISO ADS Client **automatically assigns and rotates batches** among these categories. This ensures that only one set of valid dispatch instructions is active at a time, enables the preparation and validation of upcoming batches in advance, and clearly distinguishes between older and newer instrunctions for efficient batch management. #### **BATCH_ACTIVE|NEXT|PREVIOUS Tag Groups** > [!NOTE] > **Note:** > > Tags in this group, shown in the table below, are configured as **read-only** and **persist to disk**, ensuring their values are retained after a system restart. | TAG NAME | TYPE | DESCRIPTION | | --- | --- | --- | | BATCH_EXPIRES | STRING | Timestamp indicating when the batch is no longer valid. | | BATCH_RECEIVED | STRING | Timestamp when the batch was received. | | BATCH_REVISION_NUMBER | UINT32 | Integer representing the version of the batch. | | BATCH_SENT | STRING | Timestamp indicating when the batch was sent. | | BATCH_START_TIME | STRING | The start time for the batch's effective period. | | BATCH_STATUS | UINT16 | Indicates the current status of the batch. | | BATCH_TYPE | UINT16 | Type or category of the batch. | | BATCH_UID | STRING | Unique identifier for the batch. | | BINDING_FLAG | STRING | Flag indicating whether the batch is binding (Y) or non-binding(empty). | | DISPATCH_MODE | UINT16 | Mode of dispatch for the batch (0 = Interval 1 = Manual 2 = Contingency). | | DOT | FLOAT64 | Batch DOT for 5 minutes. | | FOLLOW_DOT_FLAG | STRING | Indicates whether the system should follow the ramp dots provided in the batch if 'Y'. | | INSTRUCTION_START_TIME | STRING | Start time of the dispatch instruction. | | MARKET_ID | UINT16 | Identifier for the market type. | | PREVIOUS_DOT | FLOAT64 | Previous DOT for 5 minutes. | | SUPP | FLOAT64 | Supplemental Energy instruction value. | #### **DNP_MODBUS_CONVERSIONS Tag Group** The tags in this group are organized into subgroups: **BATCH_ACTIVE**, and**PREVIOUS**. These tags convert timestamps received from CAISO ADS, formatted in **ISO 8601 UTC** format, into **epoch** timestamp values in seconds. This conversion simplifies processing and ensures compatibility with data types required by DNP and Modbus protocols. Additionally, **BINDING_FLAG**and **FOLLOW_DOT_FLAG**are converted to Boolean data types. All transformations are performed using [Derived Tags](/v122/docs/derived-tags). | TAG NAME | TYPE | DESCRIPTION | | --- | --- | --- | | BATCH_EXPIRES | UINT32 | Timestamp indicating when the batch is no longer valid. | | BATCH_RECEIVED | UINT32 | Timestamp when the batch was received. | | BATCH_SENT | UINT32 | Timestamp indicating when the batch was sent. | | BATCH_START_TIME | UINT32 | The start time for the batch's effective period. | | BINDING_FLAG | BOOL | Flag indicating whether the batch is binding (Y) or non-binding(empty). | | DOT_TS | UINT32 | Timestamp of the DOT. | | FOLLOW_DOT_FLAG | BOOL | Indicates whether the system should follow the ramp dots provided in the batch if 'Y'. | | INSTRUCTION_START_TIME | UINT32 | Start time of the dispatch instruction. | | PREVIOUS_DOT_TS | UINT32 | Timestamp of the Previous DOT. | ## **CAISO_GROUP Template** ![Caiso_Group(1)](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Caiso_Group(1).png) This template consists of the following structure: 1. **BATCH_TYPE_00:** An instance of the **CAISO_BATCH_TYPE_00**template. 2. **CAISO_ADS_HOST_COMM_OK:** A Boolean Derived Tag representing the communication status with the CAISO ADS Host. It periodically evaluates the quality of several tags in the active batch to detect potential communication loss. 3. **CAISO_DOT_RAMP:** A Derived Tag that calculates a DOT ramp to align with the DOT at the instruction start time specified by CAISO ADS. The built-in DOT Ramping function automatically calculates the gradient between the start and end targets, ensuring the DOT provided to the PPC ramps smoothly and accurately. 4. **HEARTBEAT**: The HEARTBEAT is a Derived Tag updated every second. It enables real-time external monitoring of the system's status and health. The graph below illustrates how **DOT Ramp Calculation** works: 1. **Instruction Received:** At the midpoint of each batch interval, **CAISO ADS** sends a new instruction that includes both a **DOT** value and an**Instruction Start Time**. 2. **Ramp Initiation:** The **DOT Ramp** calculation begins at the**Instruction Start Time.** 3. **Target Reached:** The**DOT Ramp** is expected to reach the specified DOT target exactly 5 minutes after the **Instruction Start Time**. ![](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/CAISO ADS Timing.png) ## **NODE Template** ![Caiso_Node](https://cdn.document360.io/54093ab5-6b22-4542-a265-04377931f11a/Images/Documentation/Caiso_Node.png) The **NODE Template** is aimed at providing a comprehensive overview of the system's performance and operational metrics. It organizes information into specific **Tag Groups**, making it easier to monitor and manage critical aspects of the system. Below is a breakdown of each Tag Group and its purpose: - **CPU:**Provides information about CPU usage, enabling monitoring of processor performance and system load. - **DISK:**Displays information about disk usage, including storage capacity and utilization. - **INFO:**Contains various system details, including: - Bootstrap start time - Bootstrap version - N3uron Executable version. - Hostname - Node name - Process ID (PID) - Node uptime - **RAM:** Offers insights into RAM usage, assisting in the assessment of memory performance and allocation efficiency. - **SYSTEM:** Provides high-level system information, including: - System boot time - Current system time - System uptime - **TAGS:** Reports tag statistics, such as: - Number of local tags - Number of remote tags - Total tag count