> For the complete documentation index, see [llms.txt](https://docs.protoboard.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.protoboard.xyz/editor/resource-allocation.md).

# Resource allocation

Assign each interface function to a physical pin or port, automatically or by hand, and fix over-capacity interfaces

## Goal

Make sure every signal on your board is carried by a real pin or port, so harnesses reach the **Configured** state.

## Terms

* A **resource** is a physical endpoint on a part: a pin, a port, a mounting hole or a fitting.
* A **function** is one signal in an interface, such as SDA or VCC.
* An **allocation** assigns a function to a resource. Only resources that can carry that function are offered.

## Allocate automatically

Most of the time you don't need to do anything: choosing an interface pair links functions and allocates pins. When something is left over:

1. Select the harness.
2. In **Function Links**, click **Auto Assign** ("Auto-match and link functions by name").

On a part, the **Interfaces** tab also has **Auto** to allocate every unallocated function of an instance.

## Allocate by hand

Choose a specific pin when it matters, for example to keep a PWM-capable pin free for a motor:

1. Select the part and open the **Interfaces** tab, or select a harness and open **Function Links**.
2. For each function, open its resource picker ("Resource for …") and choose the pin.

Only pins that can carry the function are listed. A pin already used elsewhere isn't offered for an exclusive function.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-6b6b7cbb3d7240dda04e050c5cfe7b563580411d%2Finspector-interfaces-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-176b15401a877ad6506d6331bce834573ffaf521%2Finspector-interfaces-light.png?alt=media" alt="The part Inspector&#x27;s Interfaces tab listing interface instances with a resource picker for each function"></picture><figcaption><p>Interfaces and their pins.</p></figcaption></figure>

## See what's free

The **Resources** tab on a part shows each pin and port, marked free or used, and the tab title shows free out of total. Use it to see whether a microcontroller has room for another device.

<figure><picture><source srcset="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-763a2d54a12faad3b860b8f0e803b6ae3032e6db%2Finspector-resources-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://3535233690-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHc6ZGiGpKHrs578383AS%2Fuploads%2Fgit-blob-52a02a29fe7c05ce53d5049b0c1aae1e7f815c6c%2Finspector-resources-light.png?alt=media" alt="The part Inspector&#x27;s Resources tab listing pins, with used pins and free pins marked"></picture><figcaption><p>Resources on a part.</p></figcaption></figure>

## Capacity

Each interface definition has a capacity: how many instances the part's resources can back. Adding more shows **Capacity exceeded** (you can choose **Add anyway**), and DRC reports the interface as over capacity, which blocks the board. Remove an instance, or use a part with more of that interface.

## Common failures

<details>

<summary>"Side A function 'X' not yet assigned to a resource"</summary>

That function has no pin. Use **Auto Assign** or pick a pin by hand.

</details>

<details>

<summary>The pin I want isn't offered</summary>

It can't carry that function, or another interface already uses it. Check the part's **Resources** tab and free it by changing the other allocation.

</details>

## Related pages

* [Harnesses and function links](https://docs.protoboard.xyz/editor/harnesses-and-function-links.md)
* [Inspector](https://docs.protoboard.xyz/editor/inspector.md)
* [Fixing DRC failures](https://docs.protoboard.xyz/validate-and-build/fixing-drc-failures.md)
