Repository with instructions and remarks on assembling and testing Sinara hardware. Doesn't pretend to be source of ultimate truth, and can change at any time.

Go to file

Egor Savkin af2d962821 Add mismatch problem to the urukul and add known issue to the kasli-soc Signed-off-by: Egor Savkin <es@m-labs.hk>		2023-04-14 11:40:19 +08:00
src	Add mismatch problem to the urukul and add known issue to the kasli-soc	2023-04-14 11:40:19 +08:00
.gitignore	Init MDBook and Nix	2023-02-03 16:55:09 +08:00
LICENSE	Initial commit	2023-02-03 16:13:18 +08:00
README.md	Add clocker, grabber (draft), almazny, sampler, fastino, master-satellite instructions	2023-02-13 14:15:36 +08:00
book.toml	Init MDBook and Nix	2023-02-03 16:55:09 +08:00
flake.lock	Init MDBook and Nix	2023-02-03 16:55:09 +08:00
flake.nix	Init MDBook and Nix	2023-02-03 16:55:09 +08:00

README.md

sinara-assembly

Repository with instructions and remarks on assembling and testing Sinara hardware

Build docs

nix build

The output files are in result/book directory.

Development shell

nix develop
mdbook build

The output files are in book directory.

Contributing

If you found missing hardware or just want to add/enhance hints and instructions, feel free to push them.

Tips for adding hardware instructions:

Compose a chapter in a new Markdown file in src/hw
Add pictures if needed, store them in src/img, assure them to be clear, informative and compressed (you can use convert <INPUT IMAGE> -quality 80% -resize <width>x<height> <OUTPUT IMAGE> for optimizing JPEG image or convert <INPUT IMAGE> -quality 80% -resize <width>x<height> -background white -alpha remove -alpha off <OUTPUT IMAGE> for images with transparent background)
Add link to the new chapter to the src/SUMMARY.md
Do not forget to tell about all hidden/non-obvious obstacles and pitfalls
Add testing steps, even the "obvious" ones
Add JSON sample if needed
Add hardware setup (e.g. pins, switches) steps if needed
View changed and added pages with mdbook build (see building instructions above)