# Hardware X Template (for reference)

<br>

1\.  Hardware in context

Write a short description of the hardware and provide context, i.e., describe similar open hardware and proprietary equipment in the field.

<br>

2\.  Hardware description

Describe your hardware, highlighting the customization rather than the steps involved in the procedure. Explain how  it  differs  from  other  hardware  and  the  advantages  it  offers  over  pre-existing  methods.  For  example,  how does this hardware compare to other hardware in terms of cost or ease of use, or how can it be used to develop further designs in a particular area?&#x20;

Add 3-5 bullet points which broadly explain to other researchers - inside or outside of the original user community - how the hardware could help them, with either standard or novel laboratory tasks.

<br>

Design files

Your design files should be editable - see OSHWA’s open source definition of ‘Documentation’ for further details. You must then either:

* Upload your design files to one of the three approved online repositories - Mendeley Data (instructions), the  Open  Science  Framework  (instructions)  or  Zenodo  (instructions).  We  recommend  this  option  as  the repositories support versioning of files.
* Upload your design files as supplementary materials (e.g., CAD files, videos. . . )  to Hardware X’s online editorial system when you submit your manuscript.
* Include your design files in the body of the manuscript (e.g., as figures).

<br>

CAD files:

You are encouraged to use free and open source software packages for creating the  files.  For  CAD files, OpenSCAD, FreeCAD, or Blender  are  encouraged, but, if these are  not  available, we accept source files from proprietary CAD packages, such as Autocad or Solidworks, and other drawing packages.

<br>

3D printing:

Supplementary files that facilitate digital replication of the devices are encouraged; for example, STL files for 3D printing components. We recommend uploading CAD files to the NIH 3D Print Exchange as Custom Labware and then entering the link here.

<br>

Electronics:

PCB layouts and other electronics design files can be uploaded to the Open Hardware  Repository or other repositories or as supplementary materials.

<br>

Software and firmware:

All software files used in the design and operation of the hardware should be included in the repository. Provide a description of the software and firmware and use extensive comments in the code.&#x20;

<br>

3\.  Design files summary

Complete a separate row for each design file associated with your hardware (including the primary design files). Any empty rows should be deleted.

<br>

<br>

| Design filename             | <p>File type</p><p><br></p>     | <p>Open source license</p><p><br><br></p>                                                                               | <p>Location of the file</p><p><br></p>                                                           |
| --------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| For  example: Design file 1 | E.g. CAD  file, figures, videos | All designs must be submitted under an open hardware license.  Enter the corresponding open source license for the file | Either enter    the    URL for the  repository  or  the  sentence: ”Available with the article”. |

<br>

<br>

For each design file listed in the summary table above, include a short description of the file below (just one or two sentences per design file).

<br>

Bill of materials

If  your  bill  of  materials  is  long  or  complex,  you  can  upload  the  details  in  an  editable  spreadsheet, e.g., ODS file type, Excel spreadsheet or PDF file, to an open access online location, such as the Open Science Framework repository.  Include the link here.  Alternatively, the bill of materials can be submitted alongside your manuscript as supplementary material.

<br>

<br>

4\.  Bill of materials summary

Complete  a  separate  row  for  each  component  of  your  hardware  –  all  components  associated  with  a  cost  should be listed and any empty rows should be deleted.

<br>

<br>

| Designator                                                                                                                                                                                      | Component           | Number          | Cost per unit - currency            | <p>Total cost -currency</p><p><br></p> | Source of Materials                 | Material Type                                                                                                                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | --------------- | ----------------------------------- | -------------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>If possible,</p><p>use the same designator  here as you use in the associated</p><p>design file.If that’s not possible, you will need to explain the  relationship</p><p>between the two</p> | Name of component 1 | Number of units | Cost per unit and the currency used | Total cost and the currency used       | If possible, direct purchasing link | <p>Select from:</p><p>-Metal</p><p>-Semi-</p><p>conductor</p><p>-Ceramic</p><p>-Polymer</p><p>-Biomaterial</p><p>-Organic</p><p>-Inorganic</p><p>-Composite</p><p>-Nanomaterial</p><p>-Semiconductor</p><p>-Non-specific</p><p>-Other</p> |

<br>

You can use this space for any additional descriptions of the materials used.

<br>

<br>

5\.  Build instructions

Provide detailed, step-by-step construction instructions for the submitted hardware:

* Include all necessary information for reproducing it.
* Explain and (when possible) characterize design decisions.  Include any design alternatives you created.
* Use visual instructions such as schematics, images and videos.
* Clearly reference design files and component parts described in the Design file summary and the Bill of materials summary
* Highlight any potential safety concerns.

<br>

6\.  Operation instructions

Provide detailed, step-by-step instructions for the safe and proper operation of the hardware.

* Use visual instructions, as necessary.
* Highlight any potential safety hazards.

<br>

7\.  Validation and characterization

Demonstrate the operation of the hardware and characterize its performance for a specific scientific application.

* Highlight a relevant use case.
* If possible, characterize performance of the hardware over operational parameters.
* Create a bulleted list describing the capabilities (and limitations) of the hardware.  For example, load and operation time, spin speed, coefficient of variation, accuracy, precision, etc

\ <br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hackerfab.org/home/templates-to-do/hardware-x-template-for-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
