> ## Documentation Index
> Fetch the complete documentation index at: https://docs.directenergypartners.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Features

Once connected to the controller, the PPL Dashboard provides the following capabilities:

### Device State

Get a consolidated overview of every device's operational state in the microgrid. The Device State section displays
each device along with its current status — such as running, faulted, or communication fault — allowing you to
quickly identify which devices are healthy and which require attention. This is particularly useful during
commissioning to verify that all devices are online and communicating correctly with the controller.

### Read Measurements

Monitor live measurements from the devices in the microgrid. Measurements are updated every second. An indicator
displays when the last update was received. If the measurements stop updating — indicated by the **last update**
timer increasing in seconds — click the **Fetch** button to resubscribe to the measurements reported by the
controller.

Each device or component has its own tab in the measurement section. You can switch between components by selecting
the corresponding tab.

### Send Commands

Send commands to individual components and devices. Select a device from the dropdown to get started. There are two
modes for sending commands:

* **Auto** — Select a command from the command dropdown, then select a value from the value dropdown or enter a value
  manually if that particular command does not have predefined values (e.g. voltage setpoint registers).
* **Manual** — Select a device from the dropdown, then enter both the command and the value manually.

<Warning>
  When using Manual mode, ensure that the command you enter exists in the address map of the selected device. If the
  command is not defined in the address map, it cannot and will not be executed.
</Warning>

### Device Health Check

Verify read registers for Modbus TCP/IP and CAN devices to confirm proper communication. Click **Get Devices File**
to load all devices defined on the controller. The dashboard will list all Modbus TCP/IP and CAN devices. If no
Modbus or CAN devices are found, the dashboard will notify you accordingly.

Select a device to check its communication status and read registers.

**Modbus TCP/IP devices:**

* The health check will verify all read registers (function codes 1 through 4).
* You can run a batch check by clicking on the **Run All** button, which automatically goes through each register one by one and verifies whether
  it can be read from the device.
* Alternatively, you can check each register individually.

<Note>
  Before running a batch check or checking registers individually, the device must first pass the communication check.
</Note>

**CAN devices:**

* Since CAN does not use a direct write-reply mechanism, the health check passively listens for incoming messages
  matching the expected CAN IDs.

### Fetch Logs

Retrieve log files from the controller for troubleshooting during startup and commissioning. Once fetched, you can
browse through the log files directly in the dashboard by selecting the tab of each log file.
