Configure an upboard board

Configure an upboard board to integrate an Intel-based board like the UP4000 into your robot.

Complete the following setup requirements, then move on to configuring your board in the Viam app:

Setup requirements

Flash your Intel-based board with:

  1. The Ubuntu "Server install image" version of the operating system. For example, ubuntu-22.04.2-live-server-amd64.iso. Follow these instructions to do so.
  2. The pin control driver. Follow these instructions to do so. This driver stabilizes the GPIO pin mapping definition on the board to make it identical to that of a Raspberry Pi.

Navigate to the Config tab of your robot’s page in the Viam app. Click on the Components subtab and click Create component. Select the board type, then select the upboard model. Enter a name for your board and click Create.

An example configuration for a upboard board in the Viam app Config Builder.

Edit and fill in the attributes as applicable.

{
  "components": [
    {
      "name": "<your-upboard-board>",
      "type": "board",
      "model": "upboard",
      "attributes": {
        "i2cs": [],
        "digital_interrupts": []
      },
      "depends_on": []
    }
  ]
}

{
  "components": [
    {
      "name": "<your-upboard-board>",
      "type": "board",
      "model": "upboard",
      "attributes": {
        "i2cs": ["<your-i2cs-name-1>", "<your-i2cs-name-2>"],
        "digital_interrupts": [
          "<your-digital_interrupts-name-1>",
          "<your-digital_interrupts-name-2>"
        ]
      },
      "depends_on": []
    }
  ]
}

The following attributes are available for upboard boards:

NameTypeInclusionDescription
digital_interruptsobjectOptionalAny digital interrupts’s pin number and name. See configuration info.
i2csobjectOptionalAny Inter-Integrated Circuit (I2C) pins’ bus index and name. See configuration info.


Have questions, or want to meet other people working on robots? Join our Community Discord.