Forager Build Guide

September 10, 2024 ยท View on GitHub

List of Components

Part NamePart NumberCountNotes
Forager PCB-1Files here.
Seeed XIAO nRF52840-2Including Sense version; not compatible with other variants of the XIAO including RP2040 and ESP32-C3
Choc V1 hot swap socketsCPG135001S3034
Diodes1N4148W34SOD-123
Battery ConnectorJST BM02B-ACHSS-GAN / MOLEX 7817100022 (OPTIONAL)Only required for batteries with JST ACH/Molex Pico-EZmate connectors. The two types should be compatible in both PCB footprint and physical connector.
Battery301230 / 4012302Widely available from many keyboard vendors. Little Keyboards sell ones with JST ACH connectors for use with the connector above.
SMD M2 NutsSMTSO2020MTJ10https://www.lcsc.com/product-detail/SMD-round-nut_Sinhoo-SMTSO2020MTJ_C2916384.html

Case

Part NamePart NumberCountNotes
3D-printed Case-4Files here. Designed for FDM. Some walls may be too thin for certain technologies.
Countersunk M2 Screws-18Total length 4-5mm. https://www.mcmaster.com/91294A002/
Rubber Bumpers-8+Anything not too thick will do. https://www.mcmaster.com/95495K18/
LED Light Guide-21.75mm transparent filament segment, 6mm length

Tenting Legs

Part NamePart NumberCountNotes
Locating PinsMcMaster-Carr 97049A2068https://www.mcmaster.com/97049A206/
8mm x 4mm x 2mm Rectangular MagnetsApex Magnets M8x4x2MMBL8https://www.apexmagnets.com/magnets/8mm-x-4mm-x-2mm-block-neodymium-magnet
Rubber Bumpers-410mm diameter, preferably hemispherical.

PCB

Forager is designed exclusively for surface mounting the controller board, therefore it's not compatible with sockets.

This guide assumes that you're using a soldering iron; you can use a hot plate or hot air gun with solder paste. Low temp paste is preferred if you'd like to remove the XIAO later since it's less likely to mess up components on the XIAO itself.

Images shown are of an older revision of the board, without battery pads for direct wiring; everything else still apply.

  • Break off the two halves from each other.

    • There will be some leftover bits from the mouse bites; leave them alone as they're not exposed and won't interfere with the case.
  • Solder everything.

    fully soldered PCB

    • Start with the back side of the PCB where all the silkscreen is.
    • XIAO nRF52840
      • Solder two pads on opposite corners first to anchor it in place. Make sure it is lined up with the pads both horizontally and vertically.
      • Solder all remaining pads.
      • Flip the board over and solder the pin marked with a circle; this is the battery+ pin. You may want to stick the iron in the cutout to make sure solder bonds with the pad properly. Flip the board back around.
    • Hot-swap sockets and diodes
      • Tin one pad first to anchor the diode/socket in place.
      • Solder the other pad.
      • Make sure the line on the diode package matches the direction of the silkscreen.
    • SMD Nuts
      • Place them in their respective holes; make sure they're fully seated. They should be sticking out towards the back like all other components.
      • Apply solder around the perimeter; flux is recommended.
      • Remove the protective tape.
    • OPTIONAL - Battery Connector
      • It is recommended to solder these with a hot plate or hot air, since the two mounting pads are difficult to reach with an iron and if not soldered properly, the connector may lift off the board entirely when removing the battery.
      • Tin one of the mounting pads (the wider ones), place the connector, make sure the electrical pads are lined up and reheat that pad again from the opening side.
      • Solder the other mounting pad and the electrical pads.
    • Battery without connector
      • Trim the battery wires to an appropriate length that they reach the circular pads with the battery itself inside the rectangle.
      • Solder the red wire to the pad marked +, and the black wire to the other.

Case

  • Print the four case parts. Pay attention to the print-in-place reset lever button on the base; it might fuse together with the surrounding and get stuck depending on the amount of first layer squish. Adjust z-offset if needed.

case with reset lever button

  • Cut two 6mm segments of transparent 3D-printing filament (1.75mm diameter).

    • From the inside, insert one into the slot in the case.
    • It might require some convincing; use a small pointy tool like an allen key to push it through the hole and then adjust back until it's flush with the case.

    case light guide 1 case light guide 2

  • Place the plate/top part on the front side of the PCB.

    • Install a couple of switches around the corners to align it with the PCB.
    • Then screw it in.
  • Flip it around and install the base/bottom part.

    • Go first on the USB-C port side; make sure it's snug inside the cutout.
    • Once everything fits nicely together, screw it in.
    • You may want hold the top and bottom part together along the edges to make sure they're lined up while screwing in.

Tenting Legs

  • Insert two Pins and two Magnets into the tenting leg. It should be a very tight friction fit.
    • Apply the adhesive 10mm rubber bumper to the other end.
  • Install two magnets into the cutouts inside the bottom case.
  • Make sure all magnets are of the same orientation so that tenting legs all have the same polarity.