bitcraze / hardware Goto Github PK

Design and documentation of hardware

HTML 1.65% Ruby 1.87% Shell 1.48% SCSS 95.01%

hardware's Introduction

Hardware documentation and design

This repository hold hardware documentation and design.

Product datasheets

The product datasheets are written in markdown and generated to HTML by Jekyll and to PDF by wkhtmltopdf. It uses bootstrap for layout of the HTML and liquid tags to help with the content generation.

Writing

Each datasheets needs to contain the following:

Front Matter variables
Ingress (with image)
Datasheet history

Front Matter variables

Each datahseet has a number of attributs set in FrontMatter for datasheet:

Name	Values	Description
layout	datasheet-base	Selects the layout, there is only one
title		Name of the product
sku		The product SKU
version		The version of the datasheet
status	early-access / active / eol	The product life cycle status

Liquid tags

There's a number of liquid tags to make things easier and keep formatting consisent, they are listed below.

Datasheet intro

Used to create the ingress and image at the start of the datasheet. The tag takes one argument, the image.

{% datasheet_intro my-fancy-image-jpg; %}
This is the ingress for the datahseet right here!
{% enddatasheet_intro %}

Note: The image should be located in the same folder as the markdown file. A full path will not work when generating product pages on the web from the markdown.

Inserting images

This tag is used to insert images and takes three arguments:

Name of image
Size of image: small, medium, large
Alignment of image: center

{% datasheet_img My Fancy image; medium; center; my-fancy-image.png; %}

Note: The image should be located in the same folder as the markdown file. A full path will not work when generating product pages on the web from the markdown.

Notice

This tag is used to insert a notice and takes one arguments:

Type: warning (yellow background), success (green background), danger (red background)

{% datasheet_notice warning; %}
You have been warned!
{% enddatasheet_notice %}

Generating

You need the toolbelt to generate the datasheets.

The generation is done using the following command:

$ tb generate [datasheet]

  datasheet - Optional directory name of datasheet for generating
              only one datasheet. If this is not specified all the
              datasheets are generated.

hardware's People

Contributors

Stargazers

Watchers

Forkers

chibinliao octdrone mutiande tichoi der-schmelle2 alanxuecn embedded-tech droneswat unalhyt gemenerik tvrt0001 mirsys userwhoare

hardware's Issues

Add instructions on how to write datasheets

Right now there's no instructions on what liquid tags can be used and what a datasheet should include. This should be added.

Add output of source files in build

Add a second zip with the source files (markdown and images) for all products. This information will be used in the web build to populate some parts of the product pages on the web.

Make layout for datasheets

Make a basic layout for the datasheets that is good enough for release.

Convert build to work with the web build

Convert the build to use the toolbelt and web-builder.
Output a zip with all pdfs in a tree structure

Add support for generating only one datasheet at a time

It takes some time to generate all the datasheets, so add functionality so it's possible to generate only a specific datasheet.

Add datasheet for battery without charger

We should add a datasheet for the new battery without charger (114992766).

Component details are incomplete on the schematic file

https://github.com/bitcraze/hardware/raw/master/src/products/crazyradio-pa/electronics/crazyradio-pa_rev.b.pdf , most of the schematic resistors, capacitors doesn't have a proper type and part identification for recognizing/transparent about the use of ROHS based or cheap resistors.