# list – lista kanaler

> Listar alla tillgängliga kanaler och deras aktuella värden, med valfritt regex-filter.

_Källa: E-Sharp (esharp.se) · Accordion Shell (CLI)_


## Description

The `list` command displays all available channels and their current values. It provides a quick overview of the hardware state and can be filtered to show specific channels.

## Syntax

```bash
list [options]
```

## Optional Options

| Option | Short | Description | Default |
| --- | --- | --- | --- |
| `--filter` | `-f` | Apply a regular expression filter to channel names | (none) |
| `--disabled` | `-d` | Show disabled channels in addition to enabled ones | `false` |

## Examples

```bash
list
list --disabled
list --filter "VOLTAGE.*"
list -f "GPIO_[0-9]+"
list --filter "TEMP.*" --disabled
```

## Output Format

Channels are displayed in the format `<channel_alias>   <value>`, for example:

```
VOLTAGE_SENSOR_1                                             3.3
GPIO_PIN_5                                                   1
I2C_BUS_MAIN                                                 (<data>)
TEMPERATURE_AMBIENT                                          25.4
DISABLED_CHANNEL                                             (disabled)
```

### Output Colors

- **Green**: Enabled channels with values
- **Cyan**: Special data channels (ByteStream, I2C, UART, etc.)
- **Gray**: Disabled channels

### Special Channel Types

Some channel types display `(<data>)` instead of actual values: ByteStream, I2C, UART, SPI, Socket, Waveform and NumericResult channels.

## Performance Information

At the end of the output, query execution time is displayed, e.g. `Query took 45.23 ms`.

## Behavior

1. Retrieves all channels from the hardware
2. Orders channels alphabetically by alias
3. Filters by disabled state if requested
4. Applies regex filter if provided
5. Queries values for all enabled channels
6. Displays results with color coding

## Filter Patterns

The filter option supports standard .NET regular expressions:

| Pattern | Matches |
| --- | --- |
| `VOLTAGE.*` | All channels starting with "VOLTAGE" |
| `.*_SENSOR` | All channels ending with "_SENSOR" |
| `GPIO_[0-9]+` | GPIO channels with numeric suffixes |
| `^ADC_CH[0-7]$` | Exactly ADC_CH0 through ADC_CH7 |

## Notes

- Requires an active connection (use `init` first)
- Values are fetched in a single bulk operation for efficiency
- Disabled channels don't have values queried

## Error Handling

- **Not connected**: Run `init` command first
- **Invalid regex**: Check filter pattern syntax
