Skip to content

Commit 9a5c9cb

Browse files
author
matt venn
committed
readme edits
1 parent 56dfcf0 commit 9a5c9cb

File tree

1 file changed

+23
-3
lines changed

1 file changed

+23
-3
lines changed

examples/picosoc/README.md

Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,15 @@
1+
# Video Notes
2+
3+
Git repository https://github.com/mattvenn/TinyFPGA-BX/tree/master/examples/picosoc
4+
5+
The README.md contains information on:
6+
7+
* Information about installing the toolchains
8+
* Electrical wiring for the demos
9+
* Precompiled firmware binaries:
10+
* master - starting point
11+
* ws2812 - includes ws2812 driver and serial driver
12+
113
# PicoSOC TinyFPGA example
214

315
PicoSOC is an SOC - system on chip. It includes everything you need to
@@ -14,10 +26,12 @@ board. This example has been modified to work with the TinyFPGA by Luke from Tin
1426

1527
You can synthesise the demo with the [icestorm](http://www.clifford.at/icestorm/) toolchain.
1628
A very convient way to install the toolchain is to use [APIO](https://github.com/FPGAwars/apio)
17-
And then set your path to include the installed tools and copy the chipdb files:
29+
And then set your path to include the installed tools and copy the chipdb and yosys files:
1830

1931
export PATH=$PATH:~/.apio/packages/toolchain-icestorm/bin/
2032
sudo cp -r ~/.apio/packages/toolchain-icestorm/share/icebox/ /usr/local/share/
33+
sudo cp -r ~/.apio/packages/toolchain-icestorm/share/yosys /usr/local/share/
34+
2135

2236
You will also need tinyprog:
2337

@@ -28,9 +42,8 @@ For more info on the TinyFPGA tools and setup see the TinyFPGA page: https://tin
2842
At this point you should be able to run make upload to synthesise the hardware and program to the TinyFPGA.
2943
I have precompiled the firmware.c and added the firmware.bin and hex files to the repo so you don't need GCC.
3044

31-
If you just want to see the demos in the video, you can just switch to the serial branch
45+
If you just want to see the demos in the video, you can switch to the ws2812 branch
3246

33-
git checkout serial
3447
git checkout ws2812
3548

3649
Which should allow you to program the precompiled firmware or run the simulation without installing GCC.
@@ -46,9 +59,16 @@ What I did was:
4659
sudo apt-get install autoconf automake autotools-dev curl libmpc-dev \
4760
libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo \
4861
gperf libtool patchutils bc zlib1g-dev git libexpat1-dev
62+
4963
git clone [email protected]:cliffordwolf/picorv32.git
5064
cd picorv32/
5165
time make -j2 build-riscv32i-tools
5266
export PATH=$PATH:/opt/riscv32i/bin/
5367

5468
Then make firmware.bin should work and you can then write your own c program or edit my demos.
69+
70+
# Wiring for the demo
71+
72+
* Serial TX is pin 1
73+
* Serial RX is pin 2
74+
* WS2812 data is pin 3

0 commit comments

Comments
 (0)