Skip to content

Commit

Permalink
adding information to the draft
Browse files Browse the repository at this point in the history
  • Loading branch information
goldfishlaser committed Aug 15, 2024
1 parent a51707e commit 276c924
Showing 1 changed file with 121 additions and 2 deletions.
123 changes: 121 additions & 2 deletions docs/hardware_dev/3d-print.rst
Original file line number Diff line number Diff line change
@@ -1,10 +1,129 @@
Build a 3D-Printed BusKill Instructions
=================================

Heading 1
BusKill is a Dead Man Switch triggered when a magnetic breakaway is tripped, severing a USB connection. While some magnetic breakaways can be found in local stores or purchased on this site, some may prefer to create their own. These instructions guide you through an open hardware design using 3D printed parts designed in OpenSCAD and easily sourceable hardware. Should anyone need to adjust the OpenSCAD files for variations of components, the code is parameterized allowing for easy customization.

The assembly of the BusKill cord is as follows:
(1) attach the caribiner to the usb
(2) insert the USB hard drive into the female usb port in the assembled “breakaway”
(3) connect the magnets of the “breakaway” to the “release”
(4) insert the male usb from the “release” into the female port of the extension cable
(5) insert the male end of the usb cable into the computers usb-a port.

Bill of Materials
----------

To assemble a BusKill Dead Man Switch 3D printed cord you will need:
* a usb-a extension cord,
* a usb hard drive capable of being attached to a caribiner,
* a caribiner,
* the plastic pieces in this file,
* a usb female port,
* a usb male,
* 4 magnets,
* 4 pogo pins,
* 4 pogo receptors,
* wire,
* 8 screws,
* and BusKill software.

Tools
----------
* Soldering equipment
* Wire cutter
* Helping hands or sometimes art putty

Parts Diagram
----------

Heading 2
.. figure:: /image.png
:align: center

Assemble the Breakaway Face
^^^^^^^^^^^^^^^^^^^^^^

Body <hardware_assembly>`


.. figure:: /image.png
:align: center


#. Numbered List 1
#. Numbered List 2
#. Numbered List 3

.. note::
Make sure the ``Volume label`` is ``BusKill`` with an upper-case ``B`` and ``K`` -- not ``Buskill`` nor ``buskill``.


.. warning::
Do *not* proceed if the hash doesn't match.

Assemble the Release Face
^^^^^^^^^^^^^^^^^^^^^^

Body <hardware_assembly>`


.. figure:: /image.png
:align: center


#. Numbered List 1
#. Numbered List 2
#. Numbered List 3

.. note::
Make sure the ``Volume label`` is ``BusKill`` with an upper-case ``B`` and ``K`` -- not ``Buskill`` nor ``buskill``.


.. warning::
Do *not* proceed if the hash doesn't match.

Assemble the Breakaway
^^^^^^^^^^^^^^^^^^^^^^

Body <hardware_assembly>`


.. figure:: /image.png
:align: center


#. Numbered List 1
#. Numbered List 2
#. Numbered List 3

.. note::
Make sure the ``Volume label`` is ``BusKill`` with an upper-case ``B`` and ``K`` -- not ``Buskill`` nor ``buskill``.


.. warning::
Do *not* proceed if the hash doesn't match.

Assemble the Release
^^^^^^^^^^^^^^^^^^^^^^

Body <hardware_assembly>`


.. figure:: /image.png
:align: center


#. Numbered List 1
#. Numbered List 2
#. Numbered List 3

.. note::
Make sure the ``Volume label`` is ``BusKill`` with an upper-case ``B`` and ``K`` -- not ``Buskill`` nor ``buskill``.


.. warning::
Do *not* proceed if the hash doesn't match.

Test
^^^^^^^^^^^^^^^^^^^^^^

Body <hardware_assembly>`
Expand Down

0 comments on commit 276c924

Please sign in to comment.