> For the complete documentation index, see [llms.txt](https://dahl-design.gitbook.io/ddc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dahl-design.gitbook.io/ddc/4.-advanced-features/simhub-control.md).

# LED control

There are a few things to set up to allow SimHub to make contact with your controller. 

First you'll need to[ set up a VID/PID](/ddc/3.-coding/naming-the-controller.md) for the controller.

When you've [uploaded](/ddc/3.-coding/upload.md) the firmware to your controller, you can connect to SimHub:

* Go to devices, utilities in top right corner and select "Device definition authoring tools"

<figure><img src="/files/gKRCHjoN2jvhxnvVuCx4" alt=""><figcaption></figcaption></figure>

* Select new device definition and name the device

<figure><img src="/files/H8XHKT79lWvIFI49rOo4" alt=""><figcaption></figcaption></figure>

* Follow instructions for setting up the device page with branding and image

<figure><img src="/files/XlYHvH0Sa6dE2VI60PYE" alt=""><figcaption></figcaption></figure>

* Scroll down to add LEDs and a VoCore screen if needed

<figure><img src="/files/eqJvGu5V4Ly2QBIz0EfR" alt=""><figcaption></figcaption></figure>

* You can also define which LEDs do what by sorting your LEDs in the section below

<figure><img src="/files/H0KeFu63rpaSbdwCzp1U" alt=""><figcaption></figcaption></figure>

* Set the LED count and edit the physical LED mapping if wanted

<figure><img src="/files/iPPBpeOsvq9r1MdKzgSh" alt=""><figcaption></figcaption></figure>

* Set communication to Standard SimHub Serial protocol and enter your VID/PID

<figure><img src="/files/657SwtkpjQvWQfb6Jl4n" alt=""><figcaption></figcaption></figure>

* Save definition!

<figure><img src="/files/Xkwh8fri4dINwPM3ck93" alt=""><figcaption></figcaption></figure>

* Now you can add a new device

<figure><img src="/files/cbrxAbFTiUzBhyPxSUxH" alt=""><figcaption></figcaption></figure>

* Find the definition you made and add it!

<figure><img src="/files/z2AUPVpHq0cpFjWn98yZ" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://dahl-design.gitbook.io/ddc/4.-advanced-features/simhub-control.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.