Open Hardware Specification Documentation - Page 1
Forum section: electronics / general

author: Twistx77
author_rank: Regular Contributor
timestamp: February 29, 2020, 06:07:20 pm
content: Hi,I was wondering if someone knows about a open Hardware / Software Requirements Specifications document template.I want to make an open hardware device and I would like to have a clear set of requirements that can be shared so people can see some of my design choices and also specifications without having to go too deep into the design.I don't know if this exists, I could not find anything like that.Also if someone have any templates that could be use to make one, let me know I might just one make one myself and put it in github so people can grab it if needed.My idea is to have a sort of "standard" template for hardware/software specification document for open projects.Thank you

author: awallin
author_rank: Frequent Contributor
timestamp: February 29, 2020, 06:49:52 pm
content: I can't understand what document you are looking for here with a 'requirements / specifications' ??a datasheet? sure an open hardware datasheet template (in your favorite markup language) could be a good idea to put on github.

author: Twistx77
author_rank: Regular Contributor
timestamp: February 29, 2020, 07:47:09 pm
content: Hi,Sorry for no explaining my self clearly. I am talking about something like this:https://itea3.org/project/workpackage/document/download/4842/D1.2.1.%20INSIST%20-%20System%20Requirements%20Specification.pdfIt is pretty common at least in the industries I have worked on to have such a document where is detailed basically the specs of the device to be developed that has to be signed by the client. All the specs in that document need to be testable somehow and then, the device has to be tested to make sure it fulfills all the requirements. This is part of quality control processes and is something that is a must in many industries where devices need to comply with regulations.

author: awallin
author_rank: Frequent Contributor
timestamp: March 01, 2020, 09:03:20 am
content: I think only big players like CERN and similar do open hardware with that amount of rigorous systems-engineering approach...even a short datasheet/manual/test-report is more than most OSHW projects usually have in the repo - I've been trying that for some of my designs...

author: nctnico
author_rank: Super Contributor
timestamp: March 01, 2020, 12:53:07 pm
content: Quote from: Twistx77 on February 29, 2020, 06:07:20 pmJust use a generic project template. Open hardware / software shouldn't be any different. Just start by outlining the requirements, make a block-schematic of the hardware and software which define the various hardware elements & software layers. From there you start with specific chapters about the implementation (flow-charts). In principle a software design document should have an information flow diagram and a state diagram; a cross-check between these two eliminates a lot of potential design flaws on the drawing table.What is most important in any design document is to have block diagrams and flow charts. These don't become clear from the source code itself.

author: wizard69
author_rank: Super Contributor
timestamp: March 03, 2020, 02:04:23 am
content: Generally open hardware gets used two ways. One is as the designer expected and the other as a component that the original designer might not even understand. In the second case a spec document doesn't make sense. In the first case most of the open projects are so thinly staffed that such a document doesn't even exist. Often the project has had a long development period morphing significantly since it first inception.So while it is good to be thinking this way, especially for a project with wide support, it isn't common in the open hardware world. You might try looking at what RISC-V has in this regard as that is one of the bigger "open" projects at the moment.Quote from: Twistx77 on February 29, 2020, 07:47:09 pm