> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shortrange.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Screen and Encoder Build Guide

Build the screen and encoder accessories for use with the ODS Board in or out of the LAB enclosure.

## Tools Needed

<Columns cols={2}>
  <Column>
    * Wire Cutters / Pliers
    * Soldering Iron + Solder
  </Column>

  <Column>
    <Frame>
      <img src="https://mintcdn.com/shortrangetechnologies/M3LBJTM0hvXWvmGQ/images/IMG_5835.jpeg?fit=max&auto=format&n=M3LBJTM0hvXWvmGQ&q=85&s=05e0f0d271d5bdf39a9678e15fe911ec" alt="IMG 5835" title="IMG 5835" className="mx-auto" width="5712" height="4284" data-path="images/IMG_5835.jpeg" />
    </Frame>
  </Column>
</Columns>

## Parts Needed

<Card title="Pre-Built OpenDoorSim Board (For Wiring Reference)" icon="binary">
  Either from the official kit or self-manufactured.
</Card>

<Card title="LAB Kit Screen and Encoder Parts" icon="box-alt" href="/bill-of-materials-screen-encoder">
  The kit comes with all parts needed for the following steps.

  If you want to double check you have the parts, or don't have a kit, or are self-ordering, check out the Screen and Encoder's [Bill of Materials](/bill-of-materials-lab).
</Card>

# Build Guide

<Card title="Wiring Warning" type="warning">
  Ensure you are wiring power and data correctly between your accessories and the ODS board.  Because wire harnesses come in many different colors (even in the official kits!), it is unwise to completely rely on the colors you see in the photos below for correct routing.

  Use the board, accessories, and wires you have on hand for reference — only you can make sure you are routing them correctly.
</Card>

<Steps>
  <Step title="STEP ONE: SCREEN" icon="tv" titleSize="h2">
    <Steps>
      <Step title="Solder 4-PIN JST wire harness to OLED Screen" titleSize="h3">
        Solder the 4 bare end wires of the JST harness into the OLED screen, following the connection table below. Wires should go in from the underside of the screen.

        <Tip>
          TIP: Plugging the JST connector into the board will allow you to confidently route / solder your wire to the screen. Make sure the four wires are connecting as indicated in the table below:
        </Tip>

        | ODS BOARD | wire | SCREEN            |
        | --------- | ---- | ----------------- |
        | GND       | ←→   | GND               |
        | +3V       | ←→   | VDD / VCC / POWER |
        | SCL       | ←→   | SCL               |
        | SDA       | ←→   | SDA               |

        <Columns cols={2}>
          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/ds6orF7j5rXOzLmZ/images/IMG_5850.jpeg?fit=max&auto=format&n=ds6orF7j5rXOzLmZ&q=85&s=252cbf8e708e8992cfefe57403c66c39" alt="IMG 5850" width="4032" height="3024" data-path="images/IMG_5850.jpeg" />
            </Frame>
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/q7WrECFZjQ4OTvwt/images/IMG_5852.jpeg?fit=max&auto=format&n=q7WrECFZjQ4OTvwt&q=85&s=3475a4b9b79b3c382988f92e1e15dc46" alt="IMG 5852" width="4032" height="3024" data-path="images/IMG_5852.jpeg" />
            </Frame>
          </Column>
        </Columns>
      </Step>

      <Step title="Trim Excess Wire Beyond the Solder Blob" titleSize="h3">
        <Frame>
          <img src="https://mintcdn.com/shortrangetechnologies/q7WrECFZjQ4OTvwt/images/IMG_5860.jpeg?fit=max&auto=format&n=q7WrECFZjQ4OTvwt&q=85&s=97cdca53a206ae301b1905457943a896" alt="IMG 5860" width="4032" height="3024" data-path="images/IMG_5860.jpeg" />
        </Frame>
      </Step>

      <Step title="Plug 4-pin JST into ODS Board and Ensure That Wire Routing is Correct" titleSize="h3">
        Ensure wire routing for the screen is correct, double checking with the table above.

        <Columns cols={2}>
          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/3gyKbD52HtMvskwZ/images/IMG_5856-1.jpeg?fit=max&auto=format&n=3gyKbD52HtMvskwZ&q=85&s=1617b51e8e897efe3feefb53462a2391" alt="IMG 5856 1" width="3024" height="3315" data-path="images/IMG_5856-1.jpeg" />
            </Frame>
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/3gyKbD52HtMvskwZ/images/IMG_5857.jpeg?fit=max&auto=format&n=3gyKbD52HtMvskwZ&q=85&s=8d26804128fb5c31a330235a2b3cfb1f" alt="IMG 5857" width="4032" height="3024" data-path="images/IMG_5857.jpeg" />
            </Frame>
          </Column>
        </Columns>
      </Step>
    </Steps>
  </Step>

  <Step title="STEP TWO: ENCODER" icon="dial" titleSize="h2">
    <Steps>
      <Step title="Remove Pin Header From Encoder" titleSize="h3">
        If your encoder includes pin headers, they must be removed.

        First, bend the encoder pins straight(ish) so they are easier to remove, using pliers or cutters of your choice.

        Next, heat each pin with a soldering iron, and use pliers / cutters to gently grip, wiggle, and pull them out one by one.

        <Columns cols={3}>
          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5865.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=f75dc6cb0dd3a89956e44a22b8ab120f" alt="IMG 5865" width="4032" height="3024" data-path="images/IMG_5865.jpeg" />
            </Frame>
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5870.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=6c7f6257caf2b9a9d9abcbbf3df28748" alt="IMG 5870" width="4032" height="3024" data-path="images/IMG_5870.jpeg" />
            </Frame>
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5873.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=68337b91d87911b299f31e69d8713861" alt="IMG 5873" width="4032" height="3024" data-path="images/IMG_5873.jpeg" />
            </Frame>
          </Column>
        </Columns>

        <Columns cols={2}>
          <Column>
            After removing, some solder may remain, but the pins and plastic pin header should be gone to make room for the wires.
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5877.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=0a408ea49f7bf8d39699e73a4ab9c5c5" alt="IMG 5877" width="4032" height="3024" data-path="images/IMG_5877.jpeg" />
            </Frame>
          </Column>
        </Columns>
      </Step>

      <Step title="Solder 5-PIN JST wire harness to Encoder" titleSize="h3">
        Solder the 5 bare end wires of the JST harness into the encoder, following the connection table below. Wires should go in from the underside of the encoder.

        <Tip>
          TIP: Plugging the JST connector into the board will allow you to confidently route / solder your wire to the screen. Make sure the four wires are connecting as indicated in the table below:
        </Tip>

        | ODS BOARD   | wire | ENCODER |
        | ----------- | ---- | ------- |
        | CLK         | ←→   | CLK     |
        | DT          | ←→   | DT      |
        | SW          | ←→   | SW      |
        | +3.3V / +3V | ←→   | +       |
        | GND         | ←→   | GND     |

        <Columns cols={2}>
          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5878.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=cdbc0a8d84b09330321897e03f06d6d8" alt="IMG 5878" width="4032" height="3024" data-path="images/IMG_5878.jpeg" />
            </Frame>
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5881.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=e42bf714879dc353edcde510121ce031" alt="IMG 5881" width="4032" height="3024" data-path="images/IMG_5881.jpeg" />
            </Frame>
          </Column>
        </Columns>
      </Step>

      <Step title="Trim Down Solder Points" titleSize="h3">
        <Frame>
          <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5890.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=5206d3adb798446fcbbf5037e8413440" alt="IMG 5890" width="4032" height="3024" data-path="images/IMG_5890.jpeg" />
        </Frame>
      </Step>

      <Step title="Plug 5-pin JST into ODS Board and Ensure That Wire Routing is Correct" titleSize="h3">
        Ensure wire routing for the encoder is correct, double checking with the table above.

        <Columns cols={2}>
          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5883.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=06a63d96a1aec9cbe51e67312b695bbd" alt="IMG 5883" width="4032" height="3024" data-path="images/IMG_5883.jpeg" />
            </Frame>
          </Column>

          <Column>
            <Frame>
              <img src="https://mintcdn.com/shortrangetechnologies/_u06zGzBQW75e2ga/images/IMG_5884.jpeg?fit=max&auto=format&n=_u06zGzBQW75e2ga&q=85&s=50823bc647bc04056c2290c5824c365e" alt="IMG 5884" width="4032" height="3024" data-path="images/IMG_5884.jpeg" />
            </Frame>
          </Column>
        </Columns>
      </Step>
    </Steps>
  </Step>

  <Step title="STEP THREE: Check Your Work" icon="check" titleSize="h2">
    Ensure that all wires are correctly routed, matching the routing tables above.

    Now, power the board with USB-C. If the board is flashed, the screen should light up, and the encoder should trigger the menu when clicked and rotated!

    <Columns cols={2}>
      <Column>
        <Frame>
          <img src="https://mintcdn.com/shortrangetechnologies/aWpoVMaLH-EQYH6f/images/IMG_5892.jpeg?fit=max&auto=format&n=aWpoVMaLH-EQYH6f&q=85&s=b0d2383bae227e2cdd770c79759562de" alt="IMG 5892" width="5712" height="4284" data-path="images/IMG_5892.jpeg" />
        </Frame>
      </Column>

      <Column>
        <Frame>
          <img src="https://mintcdn.com/shortrangetechnologies/aWpoVMaLH-EQYH6f/images/IMG_5896.jpeg?fit=max&auto=format&n=aWpoVMaLH-EQYH6f&q=85&s=348e3f65ba96df5c3142fd280605654f" alt="IMG 5896" width="4032" height="3024" data-path="images/IMG_5896.jpeg" />
        </Frame>
      </Column>
    </Columns>
  </Step>
</Steps>
