# Channel Management

> How channels work — browse, search, read, write and monitor the hardware's endpoints. Channel columns, polling, value types and grouping.

_Source: E-Sharp (esharp.se) · Accordion Funktioner_


> **Note:** This page describes channel handling in the discontinued Windows application Accordion Pilot. The current interface is the browser-based [Web UI – Channel Management](/accordion/support/docs/webui-channel-management); the concepts below apply to it and to Accordion Shell as well.

## Overview

The **Channels** view is the primary interface for interacting with Accordion hardware. Channels represent individual hardware endpoints such as GPIO pins, ADC inputs, I2C buses, power supplies and audio outputs. It lets you browse, search, read, write and monitor all available channels.

## Channel list

The channel list shows these columns:

| Column | Description |
| --- | --- |
| NetName | Technical channel identifier (e.g. `CH_GPIO_01`, `I2C_BUS_0`) |
| Alias | User-friendly name from a loaded alias file |
| Group Name | Logical grouping of related channels |
| Channel Type | Hardware type (GPIO, ADC, DAC, I2C, Audio, …) |
| Capability | Supported operations (Read, Write, ReadWrite, Execute) |
| Direction | Current direction for bidirectional channels (Input/Output) |
| Description | Channel description |
| Device Name | Associated device or module |
| Value | Current value (when polling is enabled) |

The grid supports sorting (click a header), grouping (drag a header to the group panel), filtering (a find panel, with wildcard and regex) and column customisation.

## Reading values

Read a value manually by double-clicking a row or via the context menu (**Get Value**). Enable **automatic polling** from the toolbar and set a poll interval (default 500 ms; 100–1000 ms recommended). Lower intervals mean more network traffic — poll only the channels you need, and disable polling when not required.

## Writing values

Right-click a channel → **Set Value**. Accepted value formats depend on the channel: booleans (`true`/`false`/`1`/`0`/`on`/`off`), numbers (decimal, sometimes hex `0x1A`), strings, and enums (from a dropdown). For batch writes, use Accordion Shell:

```bash
accordionshell set --channel "CH1" --value "1"
accordionshell set --channel "CH2" --value "2"
```

## Configuration & direction

Some channels support runtime configuration (GPIO pull/drive, ADC sample rate/resolution, I2C clock speed/timeout, audio format). For bidirectional channels you can change the direction between Input and Output; an input reads an external signal, an output writes a value to the pin.

## Groups & aliases

Load an alias file to give channels readable names and `GroupName` values for logical grouping:

```xml
<Channel NetName="CH_GPIO_01" Alias="LED_Red" GroupName="LEDs" />
<Channel NetName="CH_ADC_01" Alias="Voltage_3V3" GroupName="PowerMon" />
```

## Numeric results & charts

For numeric channels, open a numeric-results view for statistics (min, max, mean, std dev) and a histogram, or add the channel to the chart to plot it over time. For detailed numeric analysis from the command line, use `accordionshell num`.

## Troubleshooting

- **Values not updating** — verify the connection, that the channel supports Read, and that polling is enabled.
- **Cannot write** — verify the channel supports Write, the value format and range.
- **Too many channels** — filter by name, type or group, or load an alias file with groups.
