docs: assembly

docs/badge/assembly.rst

+Assembly
+========
+
+We have a `video guide showing how to assemble the badge <https://media.ccc.de>`_. For those who prefer a text version, keep reading.
+
+Check what you've got
+---------------------
+
+Your flow3r badge should've come in a brown paper bag, in which you will find:
+
+1. The top and bottom PCBs connected together
+2. A black plastic spacer
+3. A round LCD display
+4. A blue battery
+5. A metal batery cover
+6. Two speakers
+7. A bag containg: 6 M3 screws, 6 plastic feet, an adhesive sheet, an allen (imbus) wrench, sandpaper
+8. A lanyard
+9. An instruction booklet
+
+Prepare the top PCB
+-------------------
+
+Disconnect the top (pink, smaller) and bottom (white, larger) PCBs. Put the
+bottom PCB aside for now.
+
+Take the screen, and remove its protective film if you want. Then, install the
+screen onto the top PCB - first by connecting the flex cable of the screen to
+the corresponding connector on the board, then by seating the screen into the
+hole in the middle of the top PCB.
+
+If you want, you can use a ring of adhesive from the adhesive sheet to glue the
+display to the top PCB, but this isn't required.
+
+Take the spacer and look at it closely. You'll see one side has little notches
+into which the LEDs on the top PCB go. The other side has 'speakers' written on
+it. Take the spacer, and try to mate it with the top PCB. It will only go in
+correctly in one of the five possible orientations. Check the distance between
+the five metal standoffs on the top PCB and the spacer - it should be even and
+everything should align correctly.
+
+Take the two speakers, and for each of them take the white adhesive protector
+off and glue them in the two spacer labeled as 'speakers'. They should stick
+onto the PCB, with the cables facing eachother in the middle of the badge.
+
+One the speakers are glued in, take off the spacer and route the speaker wires
+to the two connectors on the PCB. The cables should go around the display. Put
+the spacer back on top and make sure it mates correctly with the top PCB, and
+that it doesn't catch the speaker wires.
+
+Prepare the bottom PCB
+----------------------
+
+Put the top PCB aside and take the bottom PCB. It has two sides: the one with
+components is the side that will mate with the top PCB, 'though' the spacer.
+
+Take the battery and connect it to the battery connector on the bototm PCB.
+Route the cable through the notch on the PCB to the back of the board, where the
+battery will live.
+
+Take a round piece of adhesive from the adhesive sheet and use it to glue the
+battery to the back. Use the metal battery cover to make sure the battery is in
+the right spot of the back of the PCB.
+
+Mating the PCBs
+---------------
+
+Now it's time to try to assemble the two PCBs together with the spacer. This can
+be a bit tricky, and here are some general tips we've found useful in doing
+this:
+
+1. Look through the holes on the back PCB, making sure you see the threads of
+   the standoffs of the top PCB.
+2. Pay extra attention to the speaker and battery cables. Especially the
+   battery cable! It has a little channel to route through in the spacer, make
+   sure it doesn't get caught in between the spacer and the bottom PCB.
+3. Ensure the two board-to-board connectors are aligned. You can stare through
+   the side of the PCB sandwich to check if things look okay.
+
+Take five screws and the allen key and screw the two PCBs together, alongside
+with the metal battery case on the bottom. Be *very* gentle with the torque -
+overtorqueing the screws can rip off the standoffs on the top PCB!
+
+Of course, if you're not using the badge with a battery, feel free to skip the
+battery cover.
+
+If you need help with routing the battery cable, you can try use the little
+piece of sandpaper we included in the small bag.
+
+Finishing Touches
+-----------------
+
+Thread the lanyard end bits through the top two holes in the bottom PCB
+(closest to the USB port, near the edge of the boar).
+
+Take the little rubber feet from the small bag and glue them to the bottom PCB
+on the petals that do not have a screw head in them.
\ No newline at end of file

docs/index.rst

@@ -11,6 +11,7 @@ Welcome to flow3r's documentation!
    :caption: The badge:
 
    badge/hardware_specs.rst
+   badge/assembly.rst
    badge/usage.rst
    badge/programming.rst
    badge/firmware.rst