Resources - mystorm-org/BlackIce-II GitHub Wiki
BlackIce-II Resources
-
Source code of the hardware, firmware, and examples.
-
You're reading it right now!
-
A friendly community about your board.
-
Getting started with myStorm BlackIce
A very long blog post that discusses design decisions of the original BlackIce board, as well as instructions on how to use. Some things are out of date! For example, you can't use the USB2 port (/dev/ttyUSB0) anymore to download an FPGA bitstream. This has to happen over USB1 (/dev/ttyACM0). Still, an essential read to understand your board better!
ICE40 FPGA Resources
-
Overview of the full iCE40 product family. Contains lots of resources at the bottom, with data sheets etc.
-
Description of iCE40 family features, logic blocks, RAMs, PLLs, IOs, pinout etc.
-
iCE40TM LP/HX/LM Family Handbook
All the gory details of the iCE40.
-
iCE40 Programming and Configuration
Detailed information about how to download bitstreams into the FPGA over SPI.
-
iCE40 sysCLOCK PLL Design and Usage Guide
Detailed architecture of the PLLs.
-
Memory Usage Guide for iCE40 Devices
Detailed information about the capabilities of iCE40 memories, and how to use them in your design.
-
Lattice ICE Technology Library
Handbook with cell primitives. Check out the Yosys
ice40/cells_sim.v
file for Verilog models of the ICE40 primitives. You can find the location by executing:yosys-config --datdir/ice40/cells_sim.v
The most useful primitives will be those of the IOs (e.g. SB_IO), RAMs, and PLLs. (Note that some primitives may be
ice40/cells_sim.v
but as a black box only, without an actual simulation model!)
STM32L433 Resources
-
STM32L433RCT6
Name of the exact STM32L433 controller that's soldered on your board.
-
Home page with links to a lot of STM32L433 microcontoller resources
-
PDF with feature list, block diagrams, pinouts, address maps. Not quite the detail of the reference manual, but a good starting point.
-
Large PDF. If you really want to know all the ins and outs of the microcontroller, this is the document to get.
-
When you want to run custom firmware on the microcontroller.
-
STM32L433RC Special Pin Assignment: Table starts on page 56 of the STM32L433xx Datasheet
This is important if you want to use special features, such as the QUADSPI interface between the STM32 and the FPGA. The STM32L433RC uses a LQFP64 package, as seen in figure 7 on page 57.
-
STM32CubeL4 Development Libraries
The firmware directory of the BlackIce-II repo should give you a good starting point to start developing your own STM32 firmware. But it's only a subset of the humongous amount of driver and example software that's available on the ST website.
Miscellaneous
-
IS61WV25616EDBLL-10TLI 512KBit SRAM
Note: the board schematic says IS62WV25616DBLL-10TLI, but this component has been discontinued and replaced by the IS61WV25616EDBLL-10TLI.
-
CH340G USB-to-Serial Converter pinout
-
SN74CBTLV3257 4-Bit Multiplexer/Demultiplexer
Although not named, you can find this chip in the top right part of the board schematic, right above the 100 MHz oscillator.