http://www.spiderboard.org/api.php?action=feedcontributions&feedformat=atom&user=Jsspiderboard.org - User contributions [en]2026-05-28T07:35:17ZUser contributionsMediaWiki 1.29.1http://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=346Installing OpenOCD2021-11-12T09:51:51Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD (Linux) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Installing OpenOCD (Windows) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* Prebuild binaries of [https://openocd.org/pages/getting-openocd.html OpenOCD] can be downloaded from [https://github.com/openocd-org/openocd/releases/tag/v0.11.0 here]<br />
* Install the libusbK driver for the JTAG interface<br />
** Download and start [https://zadig.akeo.ie/ Zadig]<br />
** Select ''MX10/Spider JTAG (Interface 0)'' and ''libusbK driver'' and click Install Driver.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Zadig.png|x200px|thumb]] </li><br />
</ul></div><br />
<br />
== Shell Script For Easier Use (Linux) ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example.svf<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== CMD Script For Easier Use (Windows) ==<br />
<br />
A CMD script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single console command.<br />
<br />
* Create the directory ''OpenOCD\cmd'' and the file ''mx10spider.cmd'' in this directory.<br />
* Insert the content in this file from below.<br />
* Add the folder to the path variable.<br />
<br />
* Now you can open a console and use the command:<br />
* '''mx10spider''' ''<path\to\file.svf>''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Windowscmd.png|x300px|thumb|Example CMD to programm the FPGA.]] </li><br />
</ul></div><br />
<br />
For this script OpenOCD was installed under ''C:\OpenOCD\bin\openocd.exe'', adjust this path as necessary. <br />
<br />
'''mx10spider.cmd'''<br />
<nowiki><br />
"C:\OpenOCD\bin\openocd.exe" -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd -expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd -expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd -expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd -expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf %1 progress" -c "shutdown"<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module, marked with a red cross.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module, each marked with a red cross.]]</div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=345Installing OpenOCD2021-11-11T09:50:52Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD (Linux) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Installing OpenOCD (Windows) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* Prebuild binaries of [https://openocd.org/pages/getting-openocd.html OpenOCD] can be downloaded from [https://github.com/xpack-dev-tools/openocd-xpack/releases here]<br />
* Install the libusbK driver for the JTAG interface<br />
** Download and start [https://zadig.akeo.ie/ Zadig]<br />
** Select ''MX10/Spider JTAG (Interface 0)'' and ''libusbK driver'' and click Install Driver.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Zadig.png|x200px|thumb]] </li><br />
</ul></div><br />
<br />
== Shell Script For Easier Use (Linux) ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example.svf<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== CMD Script For Easier Use (Windows) ==<br />
<br />
A CMD script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single console command.<br />
<br />
* Create the directory ''OpenOCD\cmd'' and the file ''mx10spider.cmd'' in this directory.<br />
* Insert the content in this file from below.<br />
* Add the folder to the path variable.<br />
<br />
* Now you can open a console and use the command:<br />
* '''mx10spider''' ''<path\to\file.svf>''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Windowscmd.png|x300px|thumb|Example CMD to programm the FPGA.]] </li><br />
</ul></div><br />
<br />
For this script OpenOCD was installed under ''C:\OpenOCD\bin\openocd.exe'', adjust this path as necessary. <br />
<br />
'''mx10spider.cmd'''<br />
<nowiki><br />
"C:\OpenOCD\bin\openocd.exe" -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd -expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd -expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd -expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd -expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf %1 progress" -c "shutdown"<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module, marked with a red cross.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module, each marked with a red cross.]]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=344RISC-V & FreeRTOS2021-11-09T16:19:08Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 20.04)<br />
* Developer Tools (git, make, gcc, python (3))<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime] (this guide uses version 20.1 Lite)<br />
* USB Blaster or [[Installing OpenOCD|OpenOCD]]<br />
* SpiderSoM-S, MX10-S8 or MX10-U<br />
* optionally [https://shop.aries-embedded.de/tools/pmod/302/pmod-8ld?c=88 LED Pmod]<br />
<br />
'''Note:'''<br><br />
Instructions starting with '''$''' are commands to be executed in the terminal.<br><br />
The working directory is to be taken from context.<br />
<br />
== RISC-V Cores ==<br />
<br />
Three open source RISC-V cores have been made available for the Intel Platform Designer (Qsys).<br />
<br />
* [https://github.com/olofk/serv SERV]<br />
* [https://github.com/cliffordwolf/picorv32 PicoRV32]<br />
* [https://github.com/SpinalHDL/VexRiscv VexRiscv]<br />
<br />
To install the cores for Intel Platform Designer, first download the source from the [https://github.com/ARIES-Embedded/riscv-on-max10 GitHub repository].<br />
:'''$''' <nowiki> git clone https://github.com/ARIES-Embedded/riscv-on-max10.git </nowiki><br />
Then copy the cores to a location such as '''/opt/riscv-cores'''<br />
:'''$''' cp --parents riscv-on-max10/RiscvCores /opt/riscv-cores<br />
Start Intel Quartus Prime and add the cores to the global library:<br />
: Open the menu '''Assignments''' -> '''Settings'''<br />
: Under '''IP Settings''' -> '''IP Catalog Search Locations''' add the path<br />
: '''/opt/riscv-cores/**/*''' to the global IP search directories<br />
Now the cores are available as IP under the group ''RISC-V''.<br />
<br />
== Programming The Demo ==<br />
<br />
=== Compiling Firmware ===<br />
<br />
A precompiled memory initialization file (.mif) is available in the '''Prebuild/''' folder, that can be used to skip this section.<br />
<br />
==== Installing The GNU GCC Toolchain ====<br />
<br />
The complete guide for installing the toolchain can be found in the [https://github.com/riscv-collab/riscv-gnu-toolchain RISC-V GNU Toolchain repository].<br />
<br />
Download and install the prerequisites:<br />
: '''$''' sudo apt-get install autoconf automake autotools-dev curl python3 libmpc-dev libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev libexpat-dev<br />
Clone the repository:<br />
: '''$''' git clone https://github.com/riscv-collab/riscv-gnu-toolchain<br />
Configure build with multilib support for RV32 architectures:<br />
: '''$''' cd riscv-gnu-toolchain<br />
: '''$''' ./configure --prefix=/opt/riscv --with-multilib-generator="rv32i-ilp32--;rv32im-ilp32-rv32ima-;rv32imc-ilp32-rv32imac-;rv32imafc-ilp32f--"<br />
Finally start the build, note that this can take some time!<br />
: '''$''' sudo make<br />
Add the build tools to the path variable by opening '''~/.bashrc''' or equivalent and add the line:<br />
: export PATH="$PATH:/opt/riscv/bin"<br />
Reload the terminal:<br />
: '''$''' source ~/.bashrc<br />
Now the build tools are available via:<br />
: '''riscv64-unknown-elf-(*)<br />
<br />
==== Compiling The RISC-V Firmware ====<br />
<br />
Open a terminal in the '''RiscvSimple/''' or '''RiscvFreertos/''' folder of one of the sample projects and run the command:<br />
:'''$''' make<br />
If successful the output files are generated in the subfolder '''out/'''.<br><br />
Copy the '''bootrom.mif''' to the respective Quartus Project folder.<br />
:'''$''' cp out/bootrom.mif ..<br />
<br />
=== Quartus Prime Project ===<br />
<br />
==== Precompiled Files ====<br />
<br />
Precompiled programming files are available for the modules, they can be used to skip the next section and start with [[#Programming the FPGA|programming the FPGA]].<br />
<br />
==== Compiling The Quartus Project ====<br />
<br />
Start Quartus Prime and open the project corresponding to your module.<br><br />
Click on '''Start Compilation'''<br />
If successful, the programming files are generated in the folder '''output_files'''<br />
<br />
==== Programming the FPGA ====<br />
<br />
The FPGA stores its configuration in the internal SRAM.<br />
The configuration is lost when the device is powered down.<br />
At bootup the FPGA loads the configuration image from the internal FLASH to the SRAM.<br />
The '''.sof''' file will only write to the SRAM, usually used for testing and debugging,<br />
whereas the '''.pof''' file writes to the FLASH and reboots the FPGA. This image will then be loaded whenever the FPGA is powered on. The '''.pof''' file is usually used for deploying.<br />
<br />
===== Programming Via USB-Blaster =====<br />
<br />
Start Quartus Prime and open the Programmer.<br />
If no programming file is specified, click '''Add File''' and navigate to the '''Prebuild/''' or '''output_files''' folder and select the appropriate file for the module.<br />
Then under '''Hardware Setup...''' select the USB-Blaster.<br />
Finally press Start.<br />
<br />
===== Programming Via OpenOCD =====<br />
If not done already install and configure [[Installing OpenOCD|OpenOCD]].<br />
Then open a terminal and use the command with the '''.svf''' file:<br />
: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
Example: To program the SpiderSoM with the prebuild "'''.sof'''" file.<br />
: '''$''' mx10spider_prog Prebuild/Spider_S.svf</div>Jshttp://www.spiderboard.org/index.php?title=Getting_Started:_Quartus_Prime_%26_OpenOCD&diff=343Getting Started: Quartus Prime & OpenOCD2021-11-09T16:02:29Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]] (Linux & Windows)<br />
** USB Blaster and Quartus Programmer<br />
* a [https://shop.aries-embedded.de/tools/pmod/302/pmod-8ld Pmod 8LD], to connect to your SpiderBase, in case you want to see the blinking LEDs<br />
<br />
== Quartus Prime Project ==<br />
<br />
<ol><br />
<br />
<li> Create a new Quartus Prime Project. Name the project ''Example'', this will set our top level entity for later.<br />
<li> In ''Family, Device & Board Settings'', select Family "MAX 10" and then search for your FPGA. <br><br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-new-project.png|x150px|thumb|Project and Top-Level-Entity are being set.]] </li><br />
<li style="display: inline-block;"> [[File:quartus-set-device.png|x150px|thumb|In this example the 10M08SAU169C8G FPGA is installed on the module.]] </li><br />
</ul></div><br />
<br />
<li> Go to '' Assignments -> Device -> Device and Pin Options -> Voltage'' and select 3.3-V LVCMOS as Default I/O Standard.<br />
<li> If you plan to use OpenOCD, you can enable automatically creating a .svf file. Under ''Device and Pin Options -> Programming Files'' select ''Serial Vector Format File (.svf)''.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-assignment-device.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-device-pin-options.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-set-voltage.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-enable-svf.png|x150px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Open the new file dialog and create a VHDL file.<br />
<li> Copy and paste the code below.<br />
<li> Save the VHDL file. This file contains our top level entity ''Example'', which matches our project configuration.<br />
<li> Run ''Analysis & Elaboration'', this will create nodes for pin assignment.<br />
<li> Open ''Pin Planner'' and edit the location for the existing signals:<br />
{| class="wikitable"<br />
!Node Name !! SpiderSoM !! MX 10<br />
|-<br />
|button[1]<br />
|PIN_A5<br />
|PIN_T13<br />
|-<br />
|button[0]<br />
|PIN_B7<br />
|PIN_T7<br />
|-<br />
|led[1]<br />
|PIN_L2<br />
|PIN_T6<br />
|-<br />
|led[0]<br />
|PIN_L1<br />
|PIN_T12<br />
|-<br />
|clk25<br />
|PIN_H4<br />
|PIN_J12<br />
|}<br />
For a complete pin assignment table see [[Pin Assignment Table|here]].<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-elaboration.png|x70px|thumb|Analysis & Elaboration]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-bar-planner.png|x70px|thumb|Pin Planner]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-pin-planner.png|x70px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Run ''Compilation''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-compilation.png|x70px|thumb|Compilation]] </li><br />
</ul></div><br />
<br />
<li> The subfolder '''output_files''' now contains an Example.sof file, an Example.pof file and if enabled the respective .svf files.<br /><br />
.sof (.svf) directly configures the FPGA. This configuration will be lost when the FPGA powers down. <br /><br />
.pof (_pof.svf) writes to flash memory. When the FPGA powers up, it will load the configuration stored in the flash memory.<br />
<li> After programming the FPGA via OpenOCD or USB Blaster the yellow LED on the base should start blinking and the green LED lights up if exactly one user button is pressed.<br />
</ol><br />
<br />
<br /><br />
<br />
'''VHDL Code:'''<br />
<nowiki><br />
library IEEE;<br />
use IEEE.std_logic_1164.all;<br />
use IEEE.numeric_std.all;<br />
<br />
entity Example is<br />
port (<br />
clk25 : in std_logic;<br />
button : in std_logic_vector(1 downto 0);<br />
led : out std_logic_vector(1 downto 0)<br />
);<br />
end entity Example;<br />
<br />
<br />
<br />
architecture arch of Example is<br />
<br />
signal counter : integer range 1 to 12500000 := 1;<br />
signal led_yellow : std_logic := '0';<br />
<br />
begin<br />
<br />
process (clk25)<br />
begin<br />
if (clk25 = '1' and clk25'EVENT) then<br />
if (counter < 12500000) then<br />
counter <= counter + 1;<br />
else<br />
led_yellow <= not led_yellow;<br />
counter <= 1;<br />
end if;<br />
end if; <br />
end process;<br />
<br />
led(1) <= led_yellow;<br />
led(0) <= button(0) xor button(1); <br />
<br />
end architecture arch;<br />
</nowiki><br />
<br />
== Programming via OpenOCD ==<br />
<br />
# If not done already install and configure [[Installing OpenOCD|OpenOCD]].<br />
# Open a terminal and run the command<br />
#: '''$''' mx10spider ''<path/to/file.svf>''<br />
# If your project for example is under ''/opt/quartus_projects/Example'' run either:<br />
#: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example.svf<br />
#: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
#: for programming the ''.sof'' or ''.pof'' file respectively. <br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:terminal_oocd_success.png|thumb|Terminal after successfully running Example.svf]] </li><br />
</ul></div><br />
<br />
== Programming via USB Blaster ==<br />
# Connect the USB Blaster to the JTAG Header on the SpiderBase.<br />
# In Quartus Prime, open the Programmer (Tools -> Programmer).<br />
# Choose whether you want to use the .sof or the .pof file.<br />
# Click ''Hardware Setup...'' and select your USB Blaster, if there is none available you may need to start the jtag service.<br />
# Press Start<br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:spider-with-blaster.png|thumb|x160px|SpiderSoM and SpiderBase with USB-Blaster connected.]] </li><br />
<li style="display: inline-block;"> [[File:programmer-hwsetup.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-select-blaster.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-start-success.png|thumb|x170px]] </li><br />
</ul></div></div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=342RISC-V & FreeRTOS2021-11-05T12:37:15Z<p>Js: Replaced content with "'''Under construction.''' For now follow the guide from the [https://github.com/ARIES-Embedded/riscv-on-max10/blob/master/GettingStarted.md repository]."</p>
<hr />
<div>'''Under construction.'''<br />
<br />
For now follow the guide from the [https://github.com/ARIES-Embedded/riscv-on-max10/blob/master/GettingStarted.md repository].</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=329RISC-V & FreeRTOS2019-11-05T12:36:55Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]], optionally [https://shop.aries-embedded.de/tools/pmod/302/pmod-8ld?c=88 LED Pmod]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190604_mx10_spider_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider'', depending on which module you use.<br />
*: '''$''' cp out/bootrom.mif ../quartus_spider<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
* Open Quartus Prime and load the project under ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider''<br />
* Open Device Settings (Assigments -> Device) and select your FPGA, the default FPGA the MX10 project is the 10M08DAF256C8G FPGA and for the SpiderSoM project the 10M08SAU169C8G FPGA.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red or orange LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter. The LED PMod can be acquired in the [https://shop.aries-embedded.de/tools/pmod/302/pmod-8ld?c=88 shop]]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=326Installing OpenOCD2019-09-19T10:31:19Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD (Linux) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Installing OpenOCD (Windows) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* Prebuild binaries can be downloaded from [https://github.com/gnu-mcu-eclipse/openocd/releases GNU MCU Eclipse]<br />
* The .zip file can be unpacked to any location<br />
* Install the libusbK driver for the JTAG interface<br />
** Download and start [https://zadig.akeo.ie/ Zadig]<br />
** Select ''MX10/Spider JTAG (Interface 0)'' and ''libusbK driver'' and click Install Driver.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Zadig.png|x200px|thumb]] </li><br />
</ul></div><br />
<br />
== Shell Script For Easier Use (Linux) ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example.svf<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== CMD Script For Easier Use (Windows) ==<br />
<br />
A CMD script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single console command.<br />
<br />
* Create the directory ''OpenOCD\cmd'' and the file ''mx10spider.cmd'' in this directory.<br />
* Insert the content in this file from below.<br />
* Add the folder to the path variable.<br />
<br />
* Now you can open a console and use the command:<br />
* '''mx10spider''' ''<path\to\file.svf>''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Windowscmd.png|x300px|thumb|Example CMD to programm the FPGA.]] </li><br />
</ul></div><br />
<br />
For this script OpenOCD was installed under ''C:\OpenOCD\bin\openocd.exe'', adjust this path as necessary. <br />
<br />
'''mx10spider.cmd'''<br />
<nowiki><br />
"C:\OpenOCD\bin\openocd.exe" -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd -expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd -expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd -expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd -expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf %1 progress" -c "shutdown"<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module, marked with a red cross.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module, each marked with a red cross.]]</div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=311Installing OpenOCD2019-09-16T09:00:01Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD (Linux) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Installing OpenOCD (Windows) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* Prebuild binaries can be downloaded from [https://github.com/gnu-mcu-eclipse/openocd/releases GNU MCU Eclipse]<br />
* The .zip file can be unpacked to any location<br />
* Install the libusbK driver for the JTAG interface<br />
** Download and start [https://zadig.akeo.ie/ Zadig]<br />
** Select ''MX10/Spider JTAG (Interface 0)'' and ''libusbK driver'' and click Install Driver.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Zadig.png|x200px|thumb]] </li><br />
</ul></div><br />
<br />
== Shell Script For Easier Use (Linux) ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example.svf<br />
*: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== CMD Script For Easier Use (Windows) ==<br />
<br />
A CMD script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single console command.<br />
<br />
* Create the directory ''OpenOCD\cmd'' and the file ''mx10spider.cmd'' in this directory.<br />
* Insert the content in this file from below.<br />
* Add the folder to the path variable.<br />
<br />
* Now you can open a console and use the command:<br />
* '''mx10spider:''' ''<path\to\file.svf>''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Windowscmd.png|x300px|thumb|Example CMD to programm the FPGA.]] </li><br />
</ul></div><br />
<br />
For this script OpenOCD was installed under ''C:\OpenOCD\bin\openocd.exe'', adjust this path as necessary. <br />
<br />
'''mx10spider.cmd'''<br />
<nowiki><br />
"C:\OpenOCD\bin\openocd.exe" -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd -expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd -expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd -expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd -expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf %1 progress" -c "shutdown"<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module, marked with a red cross.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module, each marked with a red cross.]]</div>Jshttp://www.spiderboard.org/index.php?title=Getting_Started:_Quartus_Prime_%26_OpenOCD&diff=310Getting Started: Quartus Prime & OpenOCD2019-09-16T08:59:40Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]] (Linux & Windows)<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Quartus Prime Project ==<br />
<br />
<ol><br />
<br />
<li> Create a new Quartus Prime Project. Name the project ''Example'', this will set our top level entity for later.<br />
<li> In ''Family, Device & Board Settings'', select Family "MAX 10" and then search for your FPGA. <br><br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-new-project.png|x150px|thumb|Project and Top-Level-Entity are being set.]] </li><br />
<li style="display: inline-block;"> [[File:quartus-set-device.png|x150px|thumb|In this example the 10M08SAU169C8G FPGA is installed on the module.]] </li><br />
</ul></div><br />
<br />
<li> Go to '' Assignments -> Device -> Device and Pin Options -> Voltage'' and select 3.3-V LVCMOS as Default I/O Standard.<br />
<li> If you plan to use OpenOCD, you can enable automatically creating a .svf file. Under ''Device and Pin Options -> Programming Files'' select ''Serial Vector Format File (.svf)''.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-assignment-device.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-device-pin-options.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-set-voltage.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-enable-svf.png|x150px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Open the new file dialog and create a VHDL file.<br />
<li> Copy and paste the code below.<br />
<li> Save the VHDL file. This file contains our top level entity ''Example'', which matches our project configuration.<br />
<li> Run ''Analysis & Elaboration'', this will create nodes for pin assignment.<br />
<li> Open ''Pin Planner'' and edit the location for the existing signals:<br />
{| class="wikitable"<br />
!Node Name !! SpiderSoM !! MX 10<br />
|-<br />
|button[1]<br />
|PIN_A5<br />
|PIN_T13<br />
|-<br />
|button[0]<br />
|PIN_B7<br />
|PIN_T7<br />
|-<br />
|led[1]<br />
|PIN_L2<br />
|PIN_T6<br />
|-<br />
|led[0]<br />
|PIN_L1<br />
|PIN_T12<br />
|-<br />
|clk25<br />
|PIN_H4<br />
|PIN_J12<br />
|}<br />
For a complete pin assignment table see [[Pin Assignment Table|here]].<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-elaboration.png|x70px|thumb|Analysis & Elaboration]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-bar-planner.png|x70px|thumb|Pin Planner]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-pin-planner.png|x70px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Run ''Compilation''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-compilation.png|x70px|thumb|Compilation]] </li><br />
</ul></div><br />
<br />
<li> The subfolder '''output_files''' now contains an Example.sof file, an Example.pof file and if enabled the respective .svf files.<br /><br />
.sof (.svf) directly configures the FPGA. This configuration will be lost when the FPGA powers down. <br /><br />
.pof (_pof.svf) writes to flash memory. When the FPGA powers up, it will load the configuration stored in the flash memory.<br />
<li> After programming the FPGA via OpenOCD or USB Blaster the yellow LED on the base should start blinking and the green LED lights up if exactly one user button is pressed.<br />
</ol><br />
<br />
<br /><br />
<br />
'''VHDL Code:'''<br />
<nowiki><br />
library IEEE;<br />
use IEEE.std_logic_1164.all;<br />
use IEEE.numeric_std.all;<br />
<br />
entity Example is<br />
port (<br />
clk25 : in std_logic;<br />
button : in std_logic_vector(1 downto 0);<br />
led : out std_logic_vector(1 downto 0)<br />
);<br />
end entity Example;<br />
<br />
<br />
<br />
architecture archExample of Example is<br />
<br />
signal counter : integer range 1 to 12500000 := 1;<br />
signal led_yellow : std_logic := '0';<br />
<br />
begin<br />
<br />
process (clk25)<br />
begin<br />
if (clk25 = '1' and clk25'EVENT) then<br />
if (counter < 12500000) then<br />
counter <= counter + 1;<br />
else<br />
led_yellow <= not led_yellow;<br />
counter <= 1;<br />
end if;<br />
end if; <br />
end process;<br />
<br />
led(1) <= led_yellow;<br />
led(0) <= button(0) xor button(1); <br />
<br />
end architecture archExample;<br />
</nowiki><br />
<br />
== Programming via OpenOCD ==<br />
<br />
# If not done already install and configure [[Installing OpenOCD|OpenOCD]].<br />
# Open a terminal and run the command<br />
#: '''$''' mx10spider ''<path/to/file.svf>''<br />
# If your project for example is under ''/opt/quartus_projects/Example'' run either:<br />
#: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example.svf<br />
#: '''$''' mx10spider /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
#: for programming the ''.sof'' or ''.pof'' file respectively. <br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:terminal_oocd_success.png|thumb|Terminal after successfully running Example.svf]] </li><br />
</ul></div><br />
<br />
== Programming via USB Blaster ==<br />
# Connect the USB Blaster to the JTAG Header on the SpiderBase.<br />
# In Quartus Prime, open the Programmer (Tools -> Programmer).<br />
# Choose whether you want to use the .sof or the .pof file.<br />
# Click ''Hardware Setup...'' and select your USB Blaster, if there is none available you may need to start the jtag service.<br />
# Press Start<br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:spider-with-blaster.png|thumb|x160px|SpiderSoM and SpiderBase with USB-Blaster connected.]] </li><br />
<li style="display: inline-block;"> [[File:programmer-hwsetup.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-select-blaster.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-start-success.png|thumb|x170px]] </li><br />
</ul></div></div>Jshttp://www.spiderboard.org/index.php?title=Getting_Started:_Quartus_Prime_%26_OpenOCD&diff=309Getting Started: Quartus Prime & OpenOCD2019-09-16T08:58:58Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]] (Linux & Windows)<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Quartus Prime Project ==<br />
<br />
<ol><br />
<br />
<li> Create a new Quartus Prime Project. Name the project ''Example'', this will set our top level entity for later.<br />
<li> In ''Family, Device & Board Settings'', select Family "MAX 10" and then search for your FPGA. <br><br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-new-project.png|x150px|thumb|Project and Top-Level-Entity are being set.]] </li><br />
<li style="display: inline-block;"> [[File:quartus-set-device.png|x150px|thumb|In this example the 10M08SAU169C8G FPGA is installed on the module.]] </li><br />
</ul></div><br />
<br />
<li> Go to '' Assignments -> Device -> Device and Pin Options -> Voltage'' and select 3.3-V LVCMOS as Default I/O Standard.<br />
<li> If you plan to use OpenOCD, you can enable automatically creating a .svf file. Under ''Device and Pin Options -> Programming Files'' select ''Serial Vector Format File (.svf)''.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-assignment-device.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-device-pin-options.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-set-voltage.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-enable-svf.png|x150px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Open the new file dialog and create a VHDL file.<br />
<li> Copy and paste the code below.<br />
<li> Save the VHDL file. This file contains our top level entity ''Example'', which matches our project configuration.<br />
<li> Run ''Analysis & Elaboration'', this will create nodes for pin assignment.<br />
<li> Open ''Pin Planner'' and edit the location for the existing signals:<br />
{| class="wikitable"<br />
!Node Name !! SpiderSoM !! MX 10<br />
|-<br />
|button[1]<br />
|PIN_A5<br />
|PIN_T13<br />
|-<br />
|button[0]<br />
|PIN_B7<br />
|PIN_T7<br />
|-<br />
|led[1]<br />
|PIN_L2<br />
|PIN_T6<br />
|-<br />
|led[0]<br />
|PIN_L1<br />
|PIN_T12<br />
|-<br />
|clk25<br />
|PIN_H4<br />
|PIN_J12<br />
|}<br />
For a complete pin assignment table see [[Pin Assignment Table|here]].<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-elaboration.png|x70px|thumb|Analysis & Elaboration]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-bar-planner.png|x70px|thumb|Pin Planner]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-pin-planner.png|x70px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Run ''Compilation''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-compilation.png|x70px|thumb|Compilation]] </li><br />
</ul></div><br />
<br />
<li> The subfolder '''output_files''' now contains an Example.sof file, an Example.pof file and if enabled the respective .svf files.<br /><br />
.sof (.svf) directly configures the FPGA. This configuration will be lost when the FPGA powers down. <br /><br />
.pof (_pof.svf) writes to flash memory. When the FPGA powers up, it will load the configuration stored in the flash memory.<br />
<li> After programming the FPGA via OpenOCD or USB Blaster the yellow LED on the base should start blinking and the green LED lights up if exactly one user button is pressed.<br />
</ol><br />
<br />
<br /><br />
<br />
'''VHDL Code:'''<br />
<nowiki><br />
library IEEE;<br />
use IEEE.std_logic_1164.all;<br />
use IEEE.numeric_std.all;<br />
<br />
entity Example is<br />
port (<br />
clk25 : in std_logic;<br />
button : in std_logic_vector(1 downto 0);<br />
led : out std_logic_vector(1 downto 0)<br />
);<br />
end entity Example;<br />
<br />
<br />
<br />
architecture archExample of Example is<br />
<br />
signal counter : integer range 1 to 12500000 := 1;<br />
signal led_yellow : std_logic := '0';<br />
<br />
begin<br />
<br />
process (clk25)<br />
begin<br />
if (clk25 = '1' and clk25'EVENT) then<br />
if (counter < 12500000) then<br />
counter <= counter + 1;<br />
else<br />
led_yellow <= not led_yellow;<br />
counter <= 1;<br />
end if;<br />
end if; <br />
end process;<br />
<br />
led(1) <= led_yellow;<br />
led(0) <= button(0) xor button(1); <br />
<br />
end architecture archExample;<br />
</nowiki><br />
<br />
== Programming via OpenOCD ==<br />
<br />
# If not done already install and configure [[Installing OpenOCD|OpenOCD]].<br />
# Open a terminal and run the command<br />
#: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
# If your project for example is under ''/opt/quartus_projects/Example'' run either:<br />
#: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example.svf<br />
#: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
#: for programming the ''.sof'' or ''.pof'' file respectively. <br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:terminal_oocd_success.png|thumb|Terminal after successfully running Example.svf]] </li><br />
</ul></div><br />
<br />
== Programming via USB Blaster ==<br />
# Connect the USB Blaster to the JTAG Header on the SpiderBase.<br />
# In Quartus Prime, open the Programmer (Tools -> Programmer).<br />
# Choose whether you want to use the .sof or the .pof file.<br />
# Click ''Hardware Setup...'' and select your USB Blaster, if there is none available you may need to start the jtag service.<br />
# Press Start<br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:spider-with-blaster.png|thumb|x160px|SpiderSoM and SpiderBase with USB-Blaster connected.]] </li><br />
<li style="display: inline-block;"> [[File:programmer-hwsetup.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-select-blaster.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-start-success.png|thumb|x170px]] </li><br />
</ul></div></div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=308Installing OpenOCD2019-09-16T08:58:30Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD (Linux) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Installing OpenOCD (Windows) ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* Prebuild binaries can be downloaded from [https://github.com/gnu-mcu-eclipse/openocd/releases GNU MCU Eclipse]<br />
* The .zip file can be unpacked to any location<br />
* Install the libusbK driver for the JTAG interface<br />
** Download and start [https://zadig.akeo.ie/ Zadig]<br />
** Select ''MX10/Spider JTAG (Interface 0)'' and ''libusbK driver'' and click Install Driver.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Zadig.png|x200px|thumb]] </li><br />
</ul></div><br />
<br />
== Shell Script For Easier Use (Linux) ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider_prog''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider_prog<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example.svf<br />
*: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider_prog:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== CMD Script For Easier Use (Windows) ==<br />
<br />
A CMD script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single console command.<br />
<br />
* Create the directory ''OpenOCD\cmd'' and the file ''mx10spider.cmd'' in this directory.<br />
* Insert the content in this file from below.<br />
* Add the folder to the path variable.<br />
<br />
* Now you can open a console and use the command:<br />
* '''mx10spider:''' ''<path\to\file.svf>''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Windowscmd.png|x300px|thumb|Example CMD to programm the FPGA.]] </li><br />
</ul></div><br />
<br />
For this script OpenOCD was installed under ''C:\OpenOCD\bin\openocd.exe'', adjust this path as necessary. <br />
<br />
'''mx10spider.cmd'''<br />
<nowiki><br />
"C:\OpenOCD\bin\openocd.exe" -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd -expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd -expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd -expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd -expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf %1 progress" -c "shutdown"<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module, marked with a red cross.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module, each marked with a red cross.]]</div>Jshttp://www.spiderboard.org/index.php?title=File:Windowscmd.png&diff=307File:Windowscmd.png2019-09-16T08:56:23Z<p>Js: Js uploaded a new version of File:Windowscmd.png</p>
<hr />
<div></div>Jshttp://www.spiderboard.org/index.php?title=File:Windowscmd.png&diff=306File:Windowscmd.png2019-09-16T08:46:54Z<p>Js: </p>
<hr />
<div></div>Jshttp://www.spiderboard.org/index.php?title=File:Zadig.png&diff=305File:Zadig.png2019-09-16T08:42:47Z<p>Js: </p>
<hr />
<div></div>Jshttp://www.spiderboard.org/index.php?title=Spiderboard_SoM&diff=304Spiderboard SoM2019-07-18T09:16:35Z<p>Js: </p>
<hr />
<div>== About SpiderSoM ==<br />
The SpiderSoM is a programmable, non-volatile solution based on Intel® MAX®10 FPGA, which enables it to deliver full-featured FPGA capabilities: support for various soft-core CPUs, video-processing algorithms, etc. The SpiderSoM promotes the free and open design concept: all resources, like i.e. design files, gerber, source code, etc. are available under certain open licenses. The SpiderSoM is available as a low cost and extremely flexible platform which enables user to setup a running system according to the required specification in a very short time.<br />
<br />
[[File:SpiderSoM-800x496.png|400px]]<br />
<br />
This module can be considered as a cost-optimized alternative to the [http://www.aries-embedded.de/?q=MX10 MX10 module].<br />
<br />
== Hardware ==<br />
<br />
==== Featureset ====<br />
* MAX 10 FPGA in F256 package<br />
* Module supports wide range of the devices: from 10M04DC to 10M50DA<br />
* Optional 4 MByte SPI NOR<br />
* Optional 4 GByte e.MMC<br />
* Optional 128/256/512MByte DDR3 DRAM (for 10M 16/25/40/50 FPGAs)<br />
* Programmable clock generator and PLL, with optional external reference input<br />
* 178 FPGA GPIO pins, including 13 LVDS transmitters and 54 receivers<br />
* RTC with battery backup<br />
* Programmable high-efficient PMIC, FPGA IO voltages are configurable<br />
* Optional Li-Ion/Li-Pol charger<br />
* Size: 70mm x 35mm<br />
<br />
==== Block Diagram ====<br />
<br />
:::::[[File:SpiderSoM-BD.png|500px]]<br />
<br />
<br />
== Software ==<br />
<br />
MX10 and SpiderSoM modules provide a USB device interface implemented with a Microchip PIC16F1454 microcontroller (MCU).<br /><br />
On the host side Linux is supported as Operating System, currently Ubuntu 16.04 LTS is marked as a reference base.<br /><br />
On the SoM side the MCU is connected to three interfaces:<br />
<br />
* '''UART''' - Accessible as standard serial device ( ''/dev/ttyACMx'' ).<br />
: Connected to the FPGA.<br />
* '''I2C''' - Accessible as standard i2c device ( ''/dev/i2c-x'' ). Requires [https://github.com/ARIES-Embedded/i2c-aries-emb driver].<br />
: Connected to module PMIC, charge controller, RTC and FPGA.<br />
* '''JTAG''' - Used with OpenOCD to program the FPGA (see [[Getting Started: Quartus Prime & OpenOCD]] for more).<br />
* Additionally the MCU implements a bootloader supporting the '''DFU''' (Device Firmware Update) protocol (see [[Compiling and Programming PIC Firmware]] for more).<br />
<br />
Currently Windows is not fully supported. One can use the serial interface by manually installing the USB Serial driver.<br />
* Open device manager and select "Other devices" > "Unknown Device". Open its properties and verify that under the details tab the property "Device install path" reads "USB\VID_04D8&PID_EFD0&MI_02\..." Then in the general tab, select "Update driver". Here select "Browse my computer..." and "Let me pick from a list...". Select "Ports (COM & LPT)" then select manufacturer "Microsoft" and model "USB Serial Device". A new COMx device will then be created which can be used with serial tools.<br />
* Alternative way is to use Zadig (https://zadig.akeo.ie/). With this tool you can overwrite the Composite-Device-driver with a USB Serial driver. Make sure that in the Options tab "List All devices" is checked and "Ignore Hubs or Composite Parents" is unchecked. Then select "MX10/Spider MCU (Composite Parent)" and USB Serial (CDC) and click "Replace Driver".<br />
<br />
== Resources ==<br />
<br />
==== References ====<br />
<br />
* [[Pin Assignment Table| Pin Assignment Table for SpiderSoM and MX10]]<br />
* [[Compiling and Programming PIC Firmware]]<br />
* [[Installing OpenOCD]]<br />
<br />
==== Examples ====<br />
<br />
* [[Getting Started: Quartus Prime & OpenOCD]]<br />
* [[RISC-V & FreeRTOS | VectorBlox ORCA RISC-V & FreeRTOS]]<br />
<br />
==== Downloads ====<br />
<br />
The following components are available for download:<br />
<br />
* [https://github.com/ARIES-Embedded/i2c-aries-emb Linux I2C Driver for SpiderSoM & MX10 on Github]<br />
* [https://github.com/ARIES-Embedded/pic16f1-usb-firmware PIC Firmware for SpiderSoM & MX10 on GitHub]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_schematics_2018-05-16.pdf PDF-Schematics]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_project_2018-05-16.zip KiCad Project Files]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_bom_2018-05-26.csv Bill of Materials]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_gerber_2018-05-16.zip Gerber Data]<br />
<br />
==== License ====<br />
<br />
The SpiderSoM is an Open Hardware. All design files are available under [[CERN_OHL_V1.2]]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=294RISC-V & FreeRTOS2019-06-04T11:27:08Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190604_mx10_spider_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider'', depending on which module you use.<br />
*: '''$''' cp out/bootrom.mif ../quartus_spider<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
* Open Quartus Prime and load the project under ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider''<br />
* Open Device Settings (Assigments -> Device) and select your FPGA, the default FPGA the MX10 project is the 10M08DAF256C8G FPGA and for the SpiderSoM project the 10M08SAU169C8G FPGA.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red or orange LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=293RISC-V & FreeRTOS2019-06-04T11:25:48Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190604_mx10_spider_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider'', depending on which module you use.<br />
*: '''$''' cp out/bootrom.mif ../quartus_spider<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
* Open Quartus Prime and load the project under ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider''<br />
* Open Device Settings (Assigments -> Device) and select your FPGA, the default FPGAs are:<br />
** MX10 SoM project: '''10M08DAF256C8G''' FPGA<br />
** SpiderSoM project: '''10M08SAU169C8G''' FPGA<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red or orange LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=292RISC-V & FreeRTOS2019-06-04T11:25:24Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190604_mx10_spider_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider'', depending on which module you use.<br />
*: '''$''' cp out/bootrom.mif ../quartus_spider<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
* Open Quartus Prime and load the project under ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider''<br />
* Open Device Settings (Assigments -> Device) and select your FPGA, the default FPGAs are:<br />
** MX10 SoM project: 10M08DAF256C8G FPGA<br />
** SpiderSoM project: 10M08SAU169C8G FPGA<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red or orange LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=File:Terminal_make_riscv.png&diff=291File:Terminal make riscv.png2019-06-04T11:24:10Z<p>Js: Js uploaded a new version of File:Terminal make riscv.png</p>
<hr />
<div></div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=290RISC-V & FreeRTOS2019-06-04T11:22:45Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190604_mx10_spider_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd mx10_spider_riscv_freertos/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider'', depending on which module you use.<br />
*: '''$''' cp out/bootrom.mif ../quartus_spider<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
* Open Quartus Prime and load the project under ''mx10_spider_riscv_freertos/quartus_mx10'' or ''mx10_spider_riscv_freertos/quartus_spider''<br />
* Open Device Settings (Assigments -> Device) and select your FPGA, the default FPGAs are<br />
** MX10 SoM project: 10M08DAF256C8G FPGA<br />
** SpiderSoM project: 10M08SAU169C8G FPGA<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red or orange LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190604_mx10_spider_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=289RISC-V & FreeRTOS2019-06-04T08:07:32Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
* Open Device Settings (Assigments -> Device) and select your FPGA.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=288RISC-V & FreeRTOS2019-06-04T08:02:45Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=Getting_Started:_Quartus_Prime_%26_OpenOCD&diff=287Getting Started: Quartus Prime & OpenOCD2019-06-04T08:02:11Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10<sup>[[Installing OpenOCD#MX10 Hardware Issue|[note]]]</sup> with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]] (Linux only)<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Quartus Prime Project ==<br />
<br />
<ol><br />
<br />
<li> Create a new Quartus Prime Project. Name the project ''Example'', this will set our top level entity for later.<br />
<li> In ''Family, Device & Board Settings'', select Family "MAX 10" and then search for your FPGA. <br><br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-new-project.png|x150px|thumb|Project and Top-Level-Entity are being set.]] </li><br />
<li style="display: inline-block;"> [[File:quartus-set-device.png|x150px|thumb|In this example the 10M08SAU169C8G FPGA is installed on the module.]] </li><br />
</ul></div><br />
<br />
<li> Go to '' Assignments -> Device -> Device and Pin Options -> Voltage'' and select 3.3-V LVCMOS as Default I/O Standard.<br />
<li> If you plan to use OpenOCD, you can enable automatically creating a .svf file. Under ''Device and Pin Options -> Programming Files'' select ''Serial Vector Format File (.svf)''.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-assignment-device.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-device-pin-options.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-set-voltage.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-enable-svf.png|x150px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Open the new file dialog and create a VHDL file.<br />
<li> Copy and paste the code below.<br />
<li> Save the VHDL file. This file contains our top level entity ''Example'', which matches our project configuration.<br />
<li> Run ''Analysis & Elaboration'', this will create nodes for pin assignment.<br />
<li> Open ''Pin Planner'' and edit the location for the existing signals:<br />
{| class="wikitable"<br />
!Node Name !! SpiderSoM !! MX 10<br />
|-<br />
|button[1]<br />
|PIN_A5<br />
|PIN_T13<br />
|-<br />
|button[0]<br />
|PIN_B7<br />
|PIN_T7<br />
|-<br />
|led[1]<br />
|PIN_L2<br />
|PIN_T6<br />
|-<br />
|led[0]<br />
|PIN_L1<br />
|PIN_T12<br />
|-<br />
|clk25<br />
|PIN_H4<br />
|PIN_J12<br />
|}<br />
For a complete pin assignment table see [[Pin Assignment Table|here]].<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-elaboration.png|x70px|thumb|Analysis & Elaboration]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-bar-planner.png|x70px|thumb|Pin Planner]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-pin-planner.png|x70px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Run ''Compilation''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-compilation.png|x70px|thumb|Compilation]] </li><br />
</ul></div><br />
<br />
<li> The subfolder '''output_files''' now contains an Example.sof file, an Example.pof file and if enabled the respective .svf files.<br /><br />
.sof (.svf) directly configures the FPGA. This configuration will be lost when the FPGA powers down. <br /><br />
.pof (_pof.svf) writes to flash memory. When the FPGA powers up, it will load the configuration stored in the flash memory.<br />
<li> After programming the FPGA via OpenOCD or USB Blaster the yellow LED on the base should start blinking and the green LED lights up if exactly one user button is pressed.<br />
</ol><br />
<br />
<br /><br />
<br />
'''VHDL Code:'''<br />
<nowiki><br />
library IEEE;<br />
use IEEE.std_logic_1164.all;<br />
use IEEE.numeric_std.all;<br />
<br />
entity Example is<br />
port (<br />
clk25 : in std_logic;<br />
button : in std_logic_vector(1 downto 0);<br />
led : out std_logic_vector(1 downto 0)<br />
);<br />
end entity Example;<br />
<br />
<br />
<br />
architecture archExample of Example is<br />
<br />
signal counter : integer range 1 to 12500000 := 1;<br />
signal led_yellow : std_logic := '0';<br />
<br />
begin<br />
<br />
process (clk25)<br />
begin<br />
if (clk25 = '1' and clk25'EVENT) then<br />
if (counter < 12500000) then<br />
counter <= counter + 1;<br />
else<br />
led_yellow <= not led_yellow;<br />
counter <= 1;<br />
end if;<br />
end if; <br />
end process;<br />
<br />
led(1) <= led_yellow;<br />
led(0) <= button(0) xor button(1); <br />
<br />
end architecture archExample;<br />
</nowiki><br />
<br />
== Programming via OpenOCD ==<br />
<br />
# If not done already install and configure [[Installing OpenOCD|OpenOCD]].<br />
# Open a terminal and run the command<br />
#: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
# If your project for example is under ''/opt/quartus_projects/Example'' run either:<br />
#: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example.svf<br />
#: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
#: for programming the ''.sof'' or ''.pof'' file respectively. <br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:terminal_oocd_success.png|thumb|Terminal after successfully running Example.svf]] </li><br />
</ul></div><br />
<br />
== Programming via USB Blaster ==<br />
# Connect the USB Blaster to the JTAG Header on the SpiderBase.<br />
# In Quartus Prime, open the Programmer (Tools -> Programmer).<br />
# Choose whether you want to use the .sof or the .pof file.<br />
# Click ''Hardware Setup...'' and select your USB Blaster, if there is none available you may need to start the jtag service.<br />
# Press Start<br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:spider-with-blaster.png|thumb|x160px|SpiderSoM and SpiderBase with USB-Blaster connected.]] </li><br />
<li style="display: inline-block;"> [[File:programmer-hwsetup.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-select-blaster.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-start-success.png|thumb|x170px]] </li><br />
</ul></div></div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=286Installing OpenOCD2019-06-04T07:52:22Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Shell Script For Easier Use ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider_prog''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider_prog<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example.svf<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider_prog:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module, marked with a red cross.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module, each marked with a red cross.]]</div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=285Installing OpenOCD2019-06-04T07:51:37Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Shell Script For Easier Use ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider_prog''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider_prog<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example.svf<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider_prog:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki><br />
<br />
== MX10 Hardware Issue ==<br />
<br />
Due to a hardware issue on the MX10, in order to get PIC JTAG programming through OpenOCD to work, one has to desolder four resistors on the module. <br />
[[File:Mx10-resistors-to-remove.pdf | page=1 | left | 750px | thumb | One resistor on the top side of the module.]]<br />
[[File:Mx10-resistors-to-remove.pdf | page=2 | center | 750px | thumb | Three resistors on the bottom side of the module.]]</div>Jshttp://www.spiderboard.org/index.php?title=File:Mx10-resistors-to-remove.pdf&diff=284File:Mx10-resistors-to-remove.pdf2019-06-04T07:43:14Z<p>Js: Due to a hardware issue, these resistors have to be removed, in order to get PIC JTAG programming to work.</p>
<hr />
<div>Due to a hardware issue, these resistors have to be removed, in order to get PIC JTAG programming to work.</div>Jshttp://www.spiderboard.org/index.php?title=Pin_Assignment_Table&diff=283Pin Assignment Table2019-06-03T12:23:56Z<p>Js: </p>
<hr />
<div>== On Module ==<br />
<br />
=== General ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| CLK25_0 || PIN_H4 || PIN_F9<br />
|-<br />
| CLK25_1 || PIN_F13 || PIN_J12<br />
|-<br />
| CLK0_P || PIN_H6 || PIN_L3<br />
|-<br />
| CLK0_N || PIN_G5 || PIN_M3<br />
|-<br />
| DPCLK0 || PIN_N2 || PIN_N2?<br />
|-<br />
| DPCLK1 || PIN_N3 || PIN_P1<br />
|-<br />
| CLK2_P || PIN_G9 || -<br />
|-<br />
| CLK2_N || PIN_G10 || -<br />
|-<br />
| D1 (Red / Orange LED) || PIN_D6 || PIN_C5<br />
|-<br />
| D2 (Green LED) || PIN_C5 || PIN_E7<br />
|}<br />
<br />
=== SDRAM ===<br />
<br />
SDRAM is available on SpiderSoM in place of DDR3.<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| LDQM || PIN_K10 || -<br />
|-<br />
| WEN || PIN_K11 || -<br />
|-<br />
| RASN || PIN_J10 || -<br />
|-<br />
| CASN || PIN_L12 || -<br />
|-<br />
| UDQM || PIN_K12 || -<br />
|-<br />
| CSN || PIN_J12 || -<br />
|-<br />
| CKE || PIN_J9 || -<br />
|-<br />
| CLK || PIN_J13 || -<br />
|-<br />
| BA0 || PIN_H10 || -<br />
|-<br />
| BA1 || PIN_H13 || -<br />
|-<br />
| A0 || PIN_E9 || -<br />
|-<br />
| A1 || PIN_D9 || -<br />
|-<br />
| A2 || PIN_E10 || -<br />
|-<br />
| A3 || PIN_D11 || -<br />
|-<br />
| A4 || PIN_B13 || -<br />
|-<br />
| A5 || PIN_B12 || -<br />
|-<br />
| A6 || PIN_A12 || -<br />
|-<br />
| A7 || PIN_C11 || -<br />
|-<br />
| A8 || PIN_C12 || -<br />
|-<br />
| A9 || PIN_D12 || -<br />
|-<br />
| A10 || PIN_F8 || -<br />
|-<br />
| A11 || PIN_B11 || -<br />
|-<br />
| DQ0 || PIN_J7 || -<br />
|-<br />
| DQ1 || PIN_K7 || -<br />
|-<br />
| DQ2 || PIN_N9 || -<br />
|-<br />
| DQ3 || PIN_N10 || -<br />
|-<br />
| DQ4 || PIN_M12 || -<br />
|-<br />
| DQ5 || PIN_M13 || -<br />
|-<br />
| DQ6 || PIN_M10 || -<br />
|-<br />
| DQ7 || PIN_L10 || -<br />
|-<br />
| DQ8 || PIN_M9 || -<br />
|-<br />
| DQ9 || PIN_N6 || -<br />
|-<br />
| DQ10 || PIN_M7 || -<br />
|-<br />
| DQ11 || PIN_N7 || -<br />
|-<br />
| DQ12 || PIN_K6 || -<br />
|-<br />
| DQ13 || PIN_M8 || -<br />
|-<br />
| DQ14 || PIN_N8 || -<br />
|-<br />
| DQ15 || PIN_J6 || -<br />
|-<br />
|}<br />
<br />
=== DDR3 ===<br />
<br />
DDR3 is available on MX10 in place of SDRAM.<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| CKE || - || PIN_D16<br />
|-<br />
| CK_N || - || PIN_C15<br />
|-<br />
| CK || - || PIN_D15<br />
|-<br />
| CS_N || - || PIN_H15<br />
|-<br />
| WE_N || - || PIN_J15<br />
|-<br />
| RESET_N || - || PIN_K15<br />
|-<br />
| RAS_N || - || PIN_J16<br />
|-<br />
| CAS_N || - || PIN_H15<br />
|-<br />
| ODT || - || PIN_J14<br />
|-<br />
| DM || - || PIN_G15<br />
|-<br />
| DQS_N || - || PIN_G12<br />
|-<br />
| DQS || - || PIN_G11<br />
|-<br />
| DQ0 || - || PIN_H11<br />
|-<br />
| DQ1 || - || PIN_H12<br />
|-<br />
| DQ2 || - || PIN_G14<br />
|-<br />
| DQ3 || - || PIN_G16<br />
|-<br />
| DQ4 || - || PIN_F16<br />
|-<br />
| DQ5 || - || PIN_F14<br />
|-<br />
| DQ6 || - || PIN_E15<br />
|-<br />
| DQ7 || - || PIN_E14<br />
|-<br />
| BA0 || - || PIN_D14<br />
|-<br />
| BA1 || - || PIN_B16<br />
|-<br />
| BA2 || - || PIN_C16<br />
|-<br />
| A0 || - || PIN_T15<br />
|-<br />
| A1 || - || PIN_K14<br />
|-<br />
| A2 || - || PIN_K12<br />
|-<br />
| A3 || - || PIN_K11<br />
|-<br />
| A4 || - || PIN_P16<br />
|-<br />
| A5 || - || PIN_R15<br />
|-<br />
| A6 || - || PIN_N16<br />
|-<br />
| A7 || - || PIN_M14<br />
|-<br />
| A8 || - || PIN_P15<br />
|-<br />
| A9 || - || PIN_M15<br />
|-<br />
| A10 || - || PIN_N14<br />
|-<br />
| A11 || - || PIN_L12<br />
|-<br />
| A12 || - || PIN_L11<br />
|-<br />
| A13 || - || PIN_J11<br />
|-<br />
| A14 || - || PIN_T14<br />
|-<br />
| A15 || - || PIN_C14<br />
|}<br />
<br />
=== eMMC Flash ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| CMD || PIN_B10 || PIN_E10<br />
|-<br />
| CLK || PIN_E8 || PIN_B13<br />
|-<br />
| RSTN || PIN_A7 || PIN_A13<br />
|-<br />
| DAT0 || PIN_A6 || PIN_D12<br />
|-<br />
| DAT1 || PIN_E6 || PIN_C13<br />
|-<br />
| DAT2 || PIN_A4 || PIN_E11<br />
|-<br />
| DAT3 || PIN_B6 || PIN_C12<br />
|-<br />
| DAT4 || PIN_A3 || PIN_F11<br />
|-<br />
| DAT5 || PIN_B4 || PIN_A14<br />
|-<br />
| DAT6 || PIN_B3 || PIN_F12<br />
|-<br />
| DAT7 || PIN_B5 || PIN_F10<br />
|}<br />
<br />
=== UART, I2C & SPI ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| UART_TX || PIN_G4 || PIN_H6<br />
|-<br />
| UART_RX || PIN_F4 || PIN_J5<br />
|-<br />
| I2C_SCL || PIN_H2 || PIN_J3<br />
|-<br />
| I2C_SDA || PIN_H3 || PIN_J2<br />
|-<br />
| SPI_SCLK || PIN_H9 || PIN_K5<br />
|-<br />
| SPI_MOSI || PIN_G13 || PIN_L2<br />
|-<br />
| SPI_MISO || PIN_G12 || PIN_L6<br />
|-<br />
| SPI_SSN || PIN_H8 || PIN_N1<br />
|}<br />
<br />
== On Baseboard ==<br />
<br />
=== Buttons & LEDs ===<br />
<br />
{| class="wikitable"<br />
! Function !! Description !! SpiderSoM !! MX10<br />
|-<br />
| D1 || LED Yellow || PIN_L2 || PIN_T6<br />
|-<br />
| D2 || LED Green || PIN_L1 || PIN_T12<br />
|-<br />
| S1 || Reset Button || PIN_B9 || PIN_B10<br />
|-<br />
| S3 || User Button 1 || PIN_B7 || PIN_T7<br />
|-<br />
| S4 || User Button 2 || PIN_A5 || PIN_T13<br />
|}<br />
<br />
=== PMod ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J2 Pin 1 || PIN_A11 <ref group="note" name=ARD>SpiderSoM: Shared with Arduino Shield</ref>|| PIN_B4<br />
|- <br />
| J2 Pin 2 || PIN_A10 <ref group="note" name=ARD />|| PIN_A5<br />
|- <br />
| J2 Pin 3 || PIN_A9 || PIN_L7<br />
|- <br />
| J2 Pin 4 || PIN_A8 || PIN_M6<br />
|- <br />
| J2 Pin 5 || PIN_F12 <ref group="note" name=ARD />|| PIN_A2<br />
|- <br />
| J2 Pin 6 || PIN_E12 <ref group="note" name=ARD />|| PIN_A3<br />
|- <br />
| J2 Pin 7 || PIN_C10 || PIN_P4<br />
|- <br />
| J2 Pin 8 || PIN_C9 || PIN_N5<br />
|}<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J3 Pin 1 || PIN_A2 || PIN_L8<br />
|- <br />
| J3 Pin 2 || PIN_B2 || PIN_M7<br />
|- <br />
| J3 Pin 3 || PIN_K1 || PIN_R6<br />
|- <br />
| J3 Pin 4 || PIN_K2 || PIN_R5<br />
|- <br />
| J3 Pin 5 || PIN_F9 || PIN_P5<br />
|- <br />
| J3 Pin 6 || PIN_F10 || PIN_R4<br />
|- <br />
| J3 Pin 7 || PIN_J1 || PIN_P6<br />
|- <br />
| J3 Pin 8 || PIN_J2 || PIN_R7<br />
|}<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J4 Pin 1 || PIN_M1 || PIN_P9<br />
|- <br />
| J4 Pin 2 || PIN_M2 || PIN_P8<br />
|- <br />
| J4 Pin 3 || PIN_M4 || PIN_P13<br />
|- <br />
| J4 Pin 4 || PIN_M5 || PIN_P12<br />
|- <br />
| J4 Pin 5 || PIN_L3 || PIN_T11<br />
|- <br />
| J4 Pin 6 || PIN_M3 || PIN_R10<br />
|- <br />
| J4 Pin 7 || PIN_L4 || PIN_M8<br />
|- <br />
| J4 Pin 8 || PIN_L5 || PIN_M9<br />
|}<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J5 Pin 1 || PIN_K8 <ref group="note" name=ARD /> || PIN_L10<br />
|- <br />
| J5 Pin 2 || PIN_J8 <ref group="note" name=ARD /> || PIN_M11<br />
|- <br />
| J5 Pin 3 || PIN_N5 || PIN_L9<br />
|- <br />
| J5 Pin 4 || PIN_N4 || PIN_M10<br />
|- <br />
| J5 Pin 5 || PIN_L11 || PIN_T9<br />
|- <br />
| J5 Pin 6 || PIN_M11 || PIN_R9<br />
|- <br />
| J5 Pin 7 || PIN_J5 || PIN_T8<br />
|- <br />
| J5 Pin 8 || PIN_K5 || PIN_R8<br />
|}<br />
<br />
=== Arduino Shield ===<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| A0 || PIN_D1 || PIN_F5<br />
|-<br />
| A1 || PIN_C2 || PIN_F4<br />
|-<br />
| A2 || PIN_E3 || PIN_H5<br />
|-<br />
| A3 || PIN_E4 || PIN_G5<br />
|-<br />
| A4 <ref group="note"> May be connected to Arduino SDA or ADC1_IN5</ref> || PIN_C1 || PIN_G2<br />
|-<br />
| A5 <ref group="note"> May be connected to Arduino SCL or ADC1_IN6</ref> || PIN_B1 || PIN_F1<br />
|-<br />
| D0 || PIN_K13 || PIN_B3<br />
|-<br />
| D1 || PIN_E13 || PIN_A4<br />
|-<br />
| D2 || PIN_F12 <ref group="note" name=PMODJ2>SpiderSoM: Shared with PMod J2</ref> || PIN_B9<br />
|-<br />
| D3 || PIN_E12 <ref group="note" name=PMODJ2 /> || PIN_A8<br />
|-<br />
| D4 || PIN_A11 <ref group="note" name=PMODJ2 /> || PIN_A12<br />
|-<br />
| D5 || PIN_A10 <ref group="note" name=PMODJ2 /> || PIN_A11<br />
|-<br />
| D6 || PIN_K8 <ref group="note" name=PMODJ5>SpiderSom: Shared with PMod J5</ref> || PIN_B12<br />
|-<br />
| D7 || PIN_J8 <ref group="note" name=PMODJ5 /> || PIN_B11<br />
|-<br />
| B0 || PIN_D8 || PIN_B8<br />
|-<br />
| B1 || PIN_H5 || PIN_B7<br />
|-<br />
| B2 || PIN_L13 || PIN_A6<br />
|-<br />
| B3 || PIN_H1 || PIN_A7<br />
|-<br />
| B4 || PIN_N11 || PIN_C6<br />
|-<br />
| B5 || PIN_N12 || PIN_B6<br />
|}<br />
<br />
{{notelist}}</div>Jshttp://www.spiderboard.org/index.php?title=Getting_Started:_Quartus_Prime_%26_OpenOCD&diff=282Getting Started: Quartus Prime & OpenOCD2019-06-03T12:20:14Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10 with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]] (Linux only)<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Quartus Prime Project ==<br />
<br />
<ol><br />
<br />
<li> Create a new Quartus Prime Project. Name the project ''Example'', this will set our top level entity for later.<br />
<li> In ''Family, Device & Board Settings'', select Family "MAX 10" and then search for your FPGA. <br><br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-new-project.png|x150px|thumb|Project and Top-Level-Entity are being set.]] </li><br />
<li style="display: inline-block;"> [[File:quartus-set-device.png|x150px|thumb|In this example the 10M08SAU169C8G FPGA is installed on the module.]] </li><br />
</ul></div><br />
<br />
<li> Go to '' Assignments -> Device -> Device and Pin Options -> Voltage'' and select 3.3-V LVCMOS as Default I/O Standard.<br />
<li> If you plan to use OpenOCD, you can enable automatically creating a .svf file. Under ''Device and Pin Options -> Programming Files'' select ''Serial Vector Format File (.svf)''.<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-assignment-device.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-device-pin-options.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-set-voltage.png|x150px|thumb]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-enable-svf.png|x150px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Open the new file dialog and create a VHDL file.<br />
<li> Copy and paste the code below.<br />
<li> Save the VHDL file. This file contains our top level entity ''Example'', which matches our project configuration.<br />
<li> Run ''Analysis & Elaboration'', this will create nodes for pin assignment.<br />
<li> Open ''Pin Planner'' and edit the location for the existing signals:<br />
{| class="wikitable"<br />
!Node Name !! SpiderSoM !! MX 10<br />
|-<br />
|button[1]<br />
|PIN_A5<br />
|PIN_T13<br />
|-<br />
|button[0]<br />
|PIN_B7<br />
|PIN_T7<br />
|-<br />
|led[1]<br />
|PIN_L2<br />
|PIN_T6<br />
|-<br />
|led[0]<br />
|PIN_L1<br />
|PIN_T12<br />
|-<br />
|clk25<br />
|PIN_H4<br />
|PIN_J12<br />
|}<br />
For a complete pin assignment table see [[Pin Assignment Table|here]].<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-elaboration.png|x70px|thumb|Analysis & Elaboration]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-bar-planner.png|x70px|thumb|Pin Planner]] </li><br />
<li style="display: inline-block;"> [[File:Quartus-pin-planner.png|x70px|thumb]] </li><br />
</ul></div><br />
<br />
<li> Run ''Compilation''<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:Quartus-bar-compilation.png|x70px|thumb|Compilation]] </li><br />
</ul></div><br />
<br />
<li> The subfolder '''output_files''' now contains an Example.sof file, an Example.pof file and if enabled the respective .svf files.<br /><br />
.sof (.svf) directly configures the FPGA. This configuration will be lost when the FPGA powers down. <br /><br />
.pof (_pof.svf) writes to flash memory. When the FPGA powers up, it will load the configuration stored in the flash memory.<br />
<li> After programming the FPGA via OpenOCD or USB Blaster the yellow LED on the base should start blinking and the green LED lights up if exactly one user button is pressed.<br />
</ol><br />
<br />
<br /><br />
<br />
'''VHDL Code:'''<br />
<nowiki><br />
library IEEE;<br />
use IEEE.std_logic_1164.all;<br />
use IEEE.numeric_std.all;<br />
<br />
entity Example is<br />
port (<br />
clk25 : in std_logic;<br />
button : in std_logic_vector(1 downto 0);<br />
led : out std_logic_vector(1 downto 0)<br />
);<br />
end entity Example;<br />
<br />
<br />
<br />
architecture archExample of Example is<br />
<br />
signal counter : integer range 1 to 12500000 := 1;<br />
signal led_yellow : std_logic := '0';<br />
<br />
begin<br />
<br />
process (clk25)<br />
begin<br />
if (clk25 = '1' and clk25'EVENT) then<br />
if (counter < 12500000) then<br />
counter <= counter + 1;<br />
else<br />
led_yellow <= not led_yellow;<br />
counter <= 1;<br />
end if;<br />
end if; <br />
end process;<br />
<br />
led(1) <= led_yellow;<br />
led(0) <= button(0) xor button(1); <br />
<br />
end architecture archExample;<br />
</nowiki><br />
<br />
== Programming via OpenOCD ==<br />
<br />
# If not done already install and configure [[Installing OpenOCD|OpenOCD]].<br />
# Open a terminal and run the command<br />
#: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
# If your project for example is under ''/opt/quartus_projects/Example'' run either:<br />
#: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example.svf<br />
#: '''$''' mx10spider_prog /opt/quartus_projects/Example/output_files/Example_pof.svf<br />
#: for programming the ''.sof'' or ''.pof'' file respectively. <br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:terminal_oocd_success.png|thumb|Terminal after successfully running Example.svf]] </li><br />
</ul></div><br />
<br />
== Programming via USB Blaster ==<br />
# Connect the USB Blaster to the JTAG Header on the SpiderBase.<br />
# In Quartus Prime, open the Programmer (Tools -> Programmer).<br />
# Choose whether you want to use the .sof or the .pof file.<br />
# Click ''Hardware Setup...'' and select your USB Blaster, if there is none available you may need to start the jtag service.<br />
# Press Start<br />
<br />
<div><ul> <br />
<li style="display: inline-block;"> [[File:spider-with-blaster.png|thumb|x160px|SpiderSoM and SpiderBase with USB-Blaster connected.]] </li><br />
<li style="display: inline-block;"> [[File:programmer-hwsetup.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-select-blaster.png|thumb|x170px]] </li><br />
<li style="display: inline-block;"> [[File:programmer-start-success.png|thumb|x170px]] </li><br />
</ul></div></div>Jshttp://www.spiderboard.org/index.php?title=Spiderboard_Baseboard&diff=281Spiderboard Baseboard2019-06-03T10:56:43Z<p>Js: </p>
<hr />
<div>== About SpiderBase ==<br />
<br />
The Spiderboard Baseboard (SpiderBase) is a unique baseboard, designed to host the [[Spiderboard SoM]] / [http://www.aries-embedded.de/?q=MX10 MX10 SoM] based on Intel PSG (former Altera®) MAX® 10 FPGAs. <br />
<br />
:::::::::[[File:Spiderboard-baseboard-bird.500x500.png|600px]]<br />
<br />
== Hardware ==<br />
<br />
==== Featureset ====<br />
<br />
* simple baseboard in 2 layer design<br />
* compatibility to the [[Spiderboard SoM]] as well as the [http://www.aries-embedded.de/?q=MX10 MX10 SoM].<br />
* open hardware<br />
* MxM2 pcb edge connector<br />
* every pin of the MxM2 connector module is accessible at one of the pinheaders<br />
* large 25x15 .1” prototyping area<br />
* 4 Pmod compatible connectors (3.3V or 5V supply voltage selectable)<br />
* 2 user push buttons<br />
* reset and power buttons<br />
* 2 user LEDs<br />
* Arduino shield compatible interface<br />
* Intel PSG Blaster compatible programming interfaces<br />
* USB mini B connector<br />
* CR2032 cell holder<br />
* JST-2.0 lithium battery connector<br />
* configuration jumpers (e.g. boot selection for MX10 module)<br />
<br />
==== Block Diagram ====<br />
<br />
:::::[[File:MX10 baseboard BD.png|500px]]<br />
<br />
==== Component Locations ====<br />
<br />
[[File:Spiderbase_components.png]]<br />
<br />
== Resources ==<br />
<br />
==== Downloads ====<br />
<br />
The following components are available for download:<br />
<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/Baseboard/spiderboard_schematics_V2.0_2017-10-27.pdf PDF-Schematics]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/Baseboard/spiderboard_V2.0_project_2017-10-27.tar.gz KiCad Project Files]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/Baseboard/spiderboard_V2.0_bom_2017-10-27.csv Bill of Materials]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/Baseboard/spiderboard_V2.0_gerber_2017-10-27.tar.gz Gerber Data]<br />
<br />
==== License ====<br />
<br />
The Spiderboard Baseboard is an Open Hardware. All design files are available under [[CERN_OHL_V1.2]]</div>Jshttp://www.spiderboard.org/index.php?title=Spiderboard_SoM&diff=280Spiderboard SoM2019-06-03T10:53:27Z<p>Js: </p>
<hr />
<div>== About SpiderSoM ==<br />
The SpiderSoM is a programmable, non-volatile solution based on Intel® MAX®10 FPGA, which enables it to deliver full-featured FPGA capabilities: support for various soft-core CPUs, video-processing algorithms, etc. The SpiderSoM promotes the free and open design concept: all resources, like i.e. design files, gerber, source code, etc. are available under certain open licenses. The SpiderSoM is available as a low cost and extremely flexible platform which enables user to setup a running system according to the required specification in a very short time.<br />
<br />
[[File:SpiderSoM-800x496.png|400px]]<br />
<br />
This module can be considered as a cost-optimized alternative to the [http://www.aries-embedded.de/?q=MX10 MX10 module].<br />
<br />
== Hardware ==<br />
<br />
==== Featureset ====<br />
* MAX 10 FPGA in F256 package<br />
* Module supports wide range of the devices: from 10M04DC to 10M50DA<br />
* Optional 4 MByte SPI NOR<br />
* Optional 4 GByte e.MMC<br />
* Optional 128/256/512MByte DDR3 DRAM (for 10M 16/25/40/50 FPGAs)<br />
* Programmable clock generator and PLL, with optional external reference input<br />
* 178 FPGA GPIO pins, including 13 LVDS transmitters and 54 receivers<br />
* RTC with battery backup<br />
* Programmable high-efficient PMIC, FPGA IO voltages are configurable<br />
* Optional Li-Ion/Li-Pol charger<br />
* Size: 70mm x 35mm<br />
<br />
==== Block Diagram ====<br />
<br />
:::::[[File:SpiderSoM-BD.png|500px]]<br />
<br />
<br />
== Software ==<br />
<br />
MX10 and SpiderSoM modules provide a USB device interface implemented with a Microchip PIC16F1454 microcontroller (MCU).<br /><br />
On the host side Linux is supported as Operating System, currently Ubuntu 16.04 LTS is marked as a reference base.<br /><br />
On the SoM side the MCU is connected to three interfaces:<br />
<br />
* '''UART''' - Accessible as standard serial device ( ''/dev/ttyACMx'' ).<br />
: Connected to the FPGA.<br />
* '''I2C''' - Accessible as standard i2c device ( ''/dev/i2c-x'' ). Requires [https://github.com/ARIES-Embedded/i2c-aries-emb driver].<br />
: Connected to module PMIC, charge controller, RTC and FPGA.<br />
* '''JTAG''' - Used with OpenOCD to program the FPGA (see [[Getting Started: Quartus Prime & OpenOCD]] for more).<br />
* Additionally the MCU implements a bootloader supporting the '''DFU''' (Device Firmware Update) protocol (see [[Compiling and Programming PIC Firmware]] for more).<br />
<br />
== Resources ==<br />
<br />
==== References ====<br />
<br />
* [[Pin Assignment Table| Pin Assignment Table for SpiderSoM and MX10]]<br />
* [[Compiling and Programming PIC Firmware]]<br />
* [[Installing OpenOCD]]<br />
<br />
==== Examples ====<br />
<br />
* [[Getting Started: Quartus Prime & OpenOCD]]<br />
* [[RISC-V & FreeRTOS | VectorBlox ORCA RISC-V & FreeRTOS]]<br />
<br />
==== Downloads ====<br />
<br />
The following components are available for download:<br />
<br />
* [https://github.com/ARIES-Embedded/i2c-aries-emb Linux I2C Driver for SpiderSoM & MX10 on Github]<br />
* [https://github.com/ARIES-Embedded/pic16f1-usb-firmware PIC Firmware for SpiderSoM & MX10 on GitHub]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_schematics_2018-05-16.pdf PDF-Schematics]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_project_2018-05-16.zip KiCad Project Files]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_bom_2018-05-26.csv Bill of Materials]<br />
* [ftp://ftp.aries-embedded.de/products/Spiderboard/SpiderSoM/spidersom_V1.2_gerber_2018-05-16.zip Gerber Data]<br />
<br />
==== License ====<br />
<br />
The SpiderSoM is an Open Hardware. All design files are available under [[CERN_OHL_V1.2]]</div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=279Installing OpenOCD2019-06-03T10:06:01Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Shell Script For Easier Use ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider_prog''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider_prog<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example.svf<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider_prog:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo -e "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo -e "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo -e "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki></div>Jshttp://www.spiderboard.org/index.php?title=Pin_Assignment_Table&diff=278Pin Assignment Table2019-05-28T11:30:57Z<p>Js: </p>
<hr />
<div>== On Module ==<br />
<br />
=== General ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| CLK25_0 || PIN_H4 || PIN_F9<br />
|-<br />
| CLK25_1 || PIN_F13 || PIN_J12<br />
|-<br />
| CLK0_P || PIN_H6 || PIN_L3<br />
|-<br />
| CLK0_N || PIN_G5 || PIN_M3<br />
|-<br />
| DPCLK0 || PIN_N2 || PIN_N2?<br />
|-<br />
| DPCLK1 || PIN_N3 || PIN_P1<br />
|-<br />
| CLK2_P || PIN_G9 || -<br />
|-<br />
| CLK2_N || PIN_G10 || -<br />
|-<br />
| D1 (Red LED) || PIN_D6 || PIN_C5<br />
|-<br />
| D2 (Green LED) || PIN_C5 || PIN_E7<br />
|}<br />
<br />
=== SDRAM ===<br />
<br />
SDRAM is available on SpiderSoM in place of DDR3.<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| LDQM || PIN_K10 || -<br />
|-<br />
| WEN || PIN_K11 || -<br />
|-<br />
| RASN || PIN_J10 || -<br />
|-<br />
| CASN || PIN_L12 || -<br />
|-<br />
| UDQM || PIN_K12 || -<br />
|-<br />
| CSN || PIN_J12 || -<br />
|-<br />
| CKE || PIN_J9 || -<br />
|-<br />
| CLK || PIN_J13 || -<br />
|-<br />
| BA0 || PIN_H10 || -<br />
|-<br />
| BA1 || PIN_H13 || -<br />
|-<br />
| A0 || PIN_E9 || -<br />
|-<br />
| A1 || PIN_D9 || -<br />
|-<br />
| A2 || PIN_E10 || -<br />
|-<br />
| A3 || PIN_D11 || -<br />
|-<br />
| A4 || PIN_B13 || -<br />
|-<br />
| A5 || PIN_B12 || -<br />
|-<br />
| A6 || PIN_A12 || -<br />
|-<br />
| A7 || PIN_C11 || -<br />
|-<br />
| A8 || PIN_C12 || -<br />
|-<br />
| A9 || PIN_D12 || -<br />
|-<br />
| A10 || PIN_F8 || -<br />
|-<br />
| A11 || PIN_B11 || -<br />
|-<br />
| DQ0 || PIN_J7 || -<br />
|-<br />
| DQ1 || PIN_K7 || -<br />
|-<br />
| DQ2 || PIN_N9 || -<br />
|-<br />
| DQ3 || PIN_N10 || -<br />
|-<br />
| DQ4 || PIN_M12 || -<br />
|-<br />
| DQ5 || PIN_M13 || -<br />
|-<br />
| DQ6 || PIN_M10 || -<br />
|-<br />
| DQ7 || PIN_L10 || -<br />
|-<br />
| DQ8 || PIN_M9 || -<br />
|-<br />
| DQ9 || PIN_N6 || -<br />
|-<br />
| DQ10 || PIN_M7 || -<br />
|-<br />
| DQ11 || PIN_N7 || -<br />
|-<br />
| DQ12 || PIN_K6 || -<br />
|-<br />
| DQ13 || PIN_M8 || -<br />
|-<br />
| DQ14 || PIN_N8 || -<br />
|-<br />
| DQ15 || PIN_J6 || -<br />
|-<br />
|}<br />
<br />
=== DDR3 ===<br />
<br />
DDR3 is available on MX10 in place of SDRAM.<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| CKE || - || PIN_D16<br />
|-<br />
| CK_N || - || PIN_C15<br />
|-<br />
| CK || - || PIN_D15<br />
|-<br />
| CS_N || - || PIN_H15<br />
|-<br />
| WE_N || - || PIN_J15<br />
|-<br />
| RESET_N || - || PIN_K15<br />
|-<br />
| RAS_N || - || PIN_J16<br />
|-<br />
| CAS_N || - || PIN_H15<br />
|-<br />
| ODT || - || PIN_J14<br />
|-<br />
| DM || - || PIN_G15<br />
|-<br />
| DQS_N || - || PIN_G12<br />
|-<br />
| DQS || - || PIN_G11<br />
|-<br />
| DQ0 || - || PIN_H11<br />
|-<br />
| DQ1 || - || PIN_H12<br />
|-<br />
| DQ2 || - || PIN_G14<br />
|-<br />
| DQ3 || - || PIN_G16<br />
|-<br />
| DQ4 || - || PIN_F16<br />
|-<br />
| DQ5 || - || PIN_F14<br />
|-<br />
| DQ6 || - || PIN_E15<br />
|-<br />
| DQ7 || - || PIN_E14<br />
|-<br />
| BA0 || - || PIN_D14<br />
|-<br />
| BA1 || - || PIN_B16<br />
|-<br />
| BA2 || - || PIN_C16<br />
|-<br />
| A0 || - || PIN_T15<br />
|-<br />
| A1 || - || PIN_K14<br />
|-<br />
| A2 || - || PIN_K12<br />
|-<br />
| A3 || - || PIN_K11<br />
|-<br />
| A4 || - || PIN_P16<br />
|-<br />
| A5 || - || PIN_R15<br />
|-<br />
| A6 || - || PIN_N16<br />
|-<br />
| A7 || - || PIN_M14<br />
|-<br />
| A8 || - || PIN_P15<br />
|-<br />
| A9 || - || PIN_M15<br />
|-<br />
| A10 || - || PIN_N14<br />
|-<br />
| A11 || - || PIN_L12<br />
|-<br />
| A12 || - || PIN_L11<br />
|-<br />
| A13 || - || PIN_J11<br />
|-<br />
| A14 || - || PIN_T14<br />
|-<br />
| A15 || - || PIN_C14<br />
|}<br />
<br />
=== eMMC Flash ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| CMD || PIN_B10 || PIN_E10<br />
|-<br />
| CLK || PIN_E8 || PIN_B13<br />
|-<br />
| RSTN || PIN_A7 || PIN_A13<br />
|-<br />
| DAT0 || PIN_A6 || PIN_D12<br />
|-<br />
| DAT1 || PIN_E6 || PIN_C13<br />
|-<br />
| DAT2 || PIN_A4 || PIN_E11<br />
|-<br />
| DAT3 || PIN_B6 || PIN_C12<br />
|-<br />
| DAT4 || PIN_A3 || PIN_F11<br />
|-<br />
| DAT5 || PIN_B4 || PIN_A14<br />
|-<br />
| DAT6 || PIN_B3 || PIN_F12<br />
|-<br />
| DAT7 || PIN_B5 || PIN_F10<br />
|}<br />
<br />
=== UART, I2C & SPI ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| UART_TX || PIN_G4 || PIN_H6<br />
|-<br />
| UART_RX || PIN_F4 || PIN_J5<br />
|-<br />
| I2C_SCL || PIN_H2 || PIN_J3<br />
|-<br />
| I2C_SDA || PIN_H3 || PIN_J2<br />
|-<br />
| SPI_SCLK || PIN_H9 || PIN_K5<br />
|-<br />
| SPI_MOSI || PIN_G13 || PIN_L2<br />
|-<br />
| SPI_MISO || PIN_G12 || PIN_L6<br />
|-<br />
| SPI_SSN || PIN_H8 || PIN_N1<br />
|}<br />
<br />
== On Baseboard ==<br />
<br />
=== Buttons & LEDs ===<br />
<br />
{| class="wikitable"<br />
! Function !! Description !! SpiderSoM !! MX10<br />
|-<br />
| D1 || LED Yellow || PIN_L2 || PIN_T6<br />
|-<br />
| D2 || LED Green || PIN_L1 || PIN_T12<br />
|-<br />
| S1 || Reset Button || PIN_B9 || PIN_B10<br />
|-<br />
| S3 || User Button 1 || PIN_B7 || PIN_T7<br />
|-<br />
| S4 || User Button 2 || PIN_A5 || PIN_T13<br />
|}<br />
<br />
=== PMod ===<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J2 Pin 1 || PIN_A11 <ref group="note" name=ARD>SpiderSoM: Shared with Arduino Shield</ref>|| PIN_B4<br />
|- <br />
| J2 Pin 2 || PIN_A10 <ref group="note" name=ARD />|| PIN_A5<br />
|- <br />
| J2 Pin 3 || PIN_A9 || PIN_L7<br />
|- <br />
| J2 Pin 4 || PIN_A8 || PIN_M6<br />
|- <br />
| J2 Pin 5 || PIN_F12 <ref group="note" name=ARD />|| PIN_A2<br />
|- <br />
| J2 Pin 6 || PIN_E12 <ref group="note" name=ARD />|| PIN_A3<br />
|- <br />
| J2 Pin 7 || PIN_C10 || PIN_P4<br />
|- <br />
| J2 Pin 8 || PIN_C9 || PIN_N5<br />
|}<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J3 Pin 1 || PIN_A2 || PIN_L8<br />
|- <br />
| J3 Pin 2 || PIN_B2 || PIN_M7<br />
|- <br />
| J3 Pin 3 || PIN_K1 || PIN_R6<br />
|- <br />
| J3 Pin 4 || PIN_K2 || PIN_R5<br />
|- <br />
| J3 Pin 5 || PIN_F9 || PIN_P5<br />
|- <br />
| J3 Pin 6 || PIN_F10 || PIN_R4<br />
|- <br />
| J3 Pin 7 || PIN_J1 || PIN_P6<br />
|- <br />
| J3 Pin 8 || PIN_J2 || PIN_R7<br />
|}<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J4 Pin 1 || PIN_M1 || PIN_P9<br />
|- <br />
| J4 Pin 2 || PIN_M2 || PIN_P8<br />
|- <br />
| J4 Pin 3 || PIN_M4 || PIN_P13<br />
|- <br />
| J4 Pin 4 || PIN_M5 || PIN_P12<br />
|- <br />
| J4 Pin 5 || PIN_L3 || PIN_T11<br />
|- <br />
| J4 Pin 6 || PIN_M3 || PIN_R10<br />
|- <br />
| J4 Pin 7 || PIN_L4 || PIN_M8<br />
|- <br />
| J4 Pin 8 || PIN_L5 || PIN_M9<br />
|}<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| J5 Pin 1 || PIN_K8 <ref group="note" name=ARD /> || PIN_L10<br />
|- <br />
| J5 Pin 2 || PIN_J8 <ref group="note" name=ARD /> || PIN_M11<br />
|- <br />
| J5 Pin 3 || PIN_N5 || PIN_L9<br />
|- <br />
| J5 Pin 4 || PIN_N4 || PIN_M10<br />
|- <br />
| J5 Pin 5 || PIN_L11 || PIN_T9<br />
|- <br />
| J5 Pin 6 || PIN_M11 || PIN_R9<br />
|- <br />
| J5 Pin 7 || PIN_J5 || PIN_T8<br />
|- <br />
| J5 Pin 8 || PIN_K5 || PIN_R8<br />
|}<br />
<br />
=== Arduino Shield ===<br />
<br />
<br />
{| class="wikitable"<br />
! Function !! SpiderSoM !! MX10<br />
|-<br />
| A0 || PIN_D1 || PIN_F5<br />
|-<br />
| A1 || PIN_C2 || PIN_F4<br />
|-<br />
| A2 || PIN_E3 || PIN_H5<br />
|-<br />
| A3 || PIN_E4 || PIN_G5<br />
|-<br />
| A4 <ref group="note"> May be connected to Arduino SDA or ADC1_IN5</ref> || PIN_C1 || PIN_G2<br />
|-<br />
| A5 <ref group="note"> May be connected to Arduino SCL or ADC1_IN6</ref> || PIN_B1 || PIN_F1<br />
|-<br />
| D0 || PIN_K13 || PIN_B3<br />
|-<br />
| D1 || PIN_E13 || PIN_A4<br />
|-<br />
| D2 || PIN_F12 <ref group="note" name=PMODJ2>SpiderSoM: Shared with PMod J2</ref> || PIN_B9<br />
|-<br />
| D3 || PIN_E12 <ref group="note" name=PMODJ2 /> || PIN_A8<br />
|-<br />
| D4 || PIN_A11 <ref group="note" name=PMODJ2 /> || PIN_A12<br />
|-<br />
| D5 || PIN_A10 <ref group="note" name=PMODJ2 /> || PIN_A11<br />
|-<br />
| D6 || PIN_K8 <ref group="note" name=PMODJ5>SpiderSom: Shared with PMod J5</ref> || PIN_B12<br />
|-<br />
| D7 || PIN_J8 <ref group="note" name=PMODJ5 /> || PIN_B11<br />
|-<br />
| B0 || PIN_D8 || PIN_B8<br />
|-<br />
| B1 || PIN_H5 || PIN_B7<br />
|-<br />
| B2 || PIN_L13 || PIN_A6<br />
|-<br />
| B3 || PIN_H1 || PIN_A7<br />
|-<br />
| B4 || PIN_N11 || PIN_C6<br />
|-<br />
| B5 || PIN_N12 || PIN_B6<br />
|}<br />
<br />
{{notelist}}</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=277RISC-V & FreeRTOS2019-05-28T11:28:05Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make, python)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10 with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=276RISC-V & FreeRTOS2019-05-28T11:27:44Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] or MX10 with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=275RISC-V & FreeRTOS2019-05-28T10:24:47Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with atleast 8K LE, [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=274RISC-V & FreeRTOS2019-05-27T11:49:46Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* Open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=273RISC-V & FreeRTOS2019-05-27T10:49:31Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* For this, open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
<br />
<div><ul><br />
<li style="display: inline-block;"> [[File:spider-running-riscv-leds.png|x330px|thumb|Spider with LED PMod connected on J2 showing the binary counter.]] </li><br />
<li style="display: inline-block;"> [[File:terminal_picocom.png|x330px|thumb|Characters written are looped back and displayed.]] </li><br />
</ul></div><br />
<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=272RISC-V & FreeRTOS2019-05-27T10:43:41Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* For this, open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
[[File:terminal_make_riscv.png|1200px|Terminal after calling make.]]<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
<br />
After programming:<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
[[File:terminal_picocom.png|500px|Characters written are looped back and displayed.]]<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=File:Spider-running-riscv-leds.png&diff=271File:Spider-running-riscv-leds.png2019-05-27T10:42:35Z<p>Js: </p>
<hr />
<div></div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=270RISC-V & FreeRTOS2019-05-27T09:52:10Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH="/opt/riscv/bin:$PATH"<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* For this, open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=269RISC-V & FreeRTOS2019-05-27T09:51:58Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: PATH=/opt/riscv/bin:$PATH<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* For this, open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=268RISC-V & FreeRTOS2019-05-27T09:45:46Z<p>Js: </p>
<hr />
<div>== Prerequisites ==<br />
<br />
* Linux Operating System (this guide uses Ubuntu 16.04)<br />
* Utility Software (git, make)<br />
* [http://fpgasoftware.intel.com/?edition=lite Quartus Prime]<br />
* A [[Spiderboard_SoM|SpiderSoM]] (alternatively MX10) with [[Spiderboard_Baseboard|SpiderBase]]<br />
* One of the following:<br />
** [[Installing OpenOCD|OpenOCD]]<br />
** USB Blaster and Quartus Programmer<br />
<br />
== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: This guide uses the install locations ''/opt/orca/'' and ''/opt/riscv/'', you can substitute them if you wish.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: export PATH=/opt/riscv/bin:$PATH<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* For this, open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
*: '''$''' cp out/bootrom.mif ../quartus<br />
<br />
== Quartus Prime Project ==<br />
<br />
<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then type in as search path ''/opt/orca/**/*'' and click on the ''Add'' button.<br />
[[File:quartus_setting_iploc.png|700px|Type in the search path and then click on ''Add''.]]<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
[[File:qsys-ram-init.png|900px|Setting the memory initialization in Qsys Platform Designer]]<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=File:Qsys-ram-init.png&diff=267File:Qsys-ram-init.png2019-05-27T09:06:49Z<p>Js: </p>
<hr />
<div></div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=266RISC-V & FreeRTOS2019-05-27T08:49:01Z<p>Js: </p>
<hr />
<div>== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: In this guide the install locations ''/opt/orca/'' and ''/opt/riscv/'' were chosen.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: export PATH=/opt/riscv/bin:$PATH<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Then choose either RISC-V or RISC-V & FreeRTOS and run make.<br />
* For this, open a terminal window and run the commands:<br />
*: '''$''' wget <nowiki>ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip</nowiki><br />
*: '''$''' unzip 20190506_SpiderSoM_quartus_riscv_freertos.zip<br />
** For the RISC-V standalone demo:<br />
**: '''$''' cd riscv_freertos_example/riscv<br />
** Or for RISC-V with FreeRTOS:<br />
**: '''$''' cd riscv_freertos_example/riscv_freertos<br />
*: '''$''' make<br />
* This will create the ''bootrom.mif'' (Memory Initialization File) in the subfolder ''out''.<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
<br />
== Quartus Prime Project ==<br />
<br />
[[File:quartus_setting_iploc.png|thumb|Type in the search path and then click on ''Add''.]]<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then use as search path: ''/opt/orca/**/*''<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=265RISC-V & FreeRTOS2019-05-27T08:06:48Z<p>Js: </p>
<hr />
<div>== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: In this guide the install locations ''/opt/orca/'' and ''/opt/riscv/'' were chosen.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: export PATH=/opt/riscv/bin:$PATH<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Open a terminal window, change directory to either '''riscv_freertos_example/riscv''' (for the RISC-V demo) or '''riscv_freertos_example/riscv_freertos''' (for the RISC-V FreeRTOS demo) and run:<br />
*: '''$''' make<br />
* The folder ''out'' now contains the ''bootrom.mif'' (Memory Initalization File).<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
<br />
== Quartus Prime Project ==<br />
<br />
[[File:quartus_setting_iploc.png|thumb|Type in the search path and then click on ''Add''.]]<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then use as search path: ''/opt/orca/**/*''<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. Per default the bootrom.mif in the quartus folder will be used.<br />
** (Optional) Save and Generate the Qsys system.<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=264RISC-V & FreeRTOS2019-05-27T07:44:32Z<p>Js: </p>
<hr />
<div>== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: In this guide the install locations ''/opt/orca/'' and ''/opt/riscv/'' were chosen.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: export PATH=/opt/riscv/bin:$PATH<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Open a terminal window, change directory to either '''riscv_freertos_example/riscv''' (for the RISC-V demo) or '''riscv_freertos_example/riscv_freertos''' (for the RISC-V FreeRTOS demo) and run:<br />
*: '''$''' make<br />
* The folder ''out'' now contains the ''bootrom.mif'' (Memory Initalization File).<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
<br />
== Quartus Prime Project ==<br />
<br />
[[File:quartus_setting_iploc.png|thumb|Type in the search path and then click on ''Add''.]]<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then use as search path: ''/opt/orca/**/*''<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. (The default is to use the bootrom.mif in the quartus folder)<br />
** (Optional) Save and Generate the Qsys system.<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=263Installing OpenOCD2019-05-23T11:59:49Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Shell Script For Easier Use ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider_prog''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run the following command to reload the path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider_prog<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example.svf<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider_prog:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki></div>Jshttp://www.spiderboard.org/index.php?title=Installing_OpenOCD&diff=262Installing OpenOCD2019-05-23T11:58:51Z<p>Js: </p>
<hr />
<div>== Installing OpenOCD ==<br />
<br />
* OpenOCD Version >= 0.10 with the libftdi driver is required.<br />
* If your package distributor provides this version, use your package manager to install OpenOCD:<br />
* For Debian based distributions the terminal command is:<br />
*: '''$''' sudo apt install openocd<br />
* If the package version does not work, it is possible to compile OpenOCD from [https://github.com/ntfreak/openocd source (github)].<br />
<br />
== Shell Script For Easier Use ==<br />
<br />
A shell script can be used that starts OpenOCD, runs the svf file and shuts down afterwards, allowing conveniently programming the FPGA using a single terminal command.<br />
<br />
* Create the file '''mx10spider_prog''' under ''.local/bin'' in your home directory and insert the content below.<br />
* If not already done, add ''.local/bin'' to the path variable.<br />
** Open ''.profile'' in your home directory with a text editor and add the line:<br />
**: PATH=".local/bin:$PATH"<br />
** Logout and login again or run following command to reload path variable:<br />
**: '''$''' source ~/.profile<br />
* Open a terminal and add the executable flag.<br />
*: '''$''' chmod +x .local/bin/mx10spider_prog<br />
* You are now ready to program the fpga using the command:<br />
*: '''$''' mx10spider_prog ''<path/to/file.svf>''<br />
* If your project is for example located under ''/opt/quartus_projects/Example'', use one of the following commands:<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example.svf<br />
*: '''$''' mx10spider_prog /opt/quartus_projets/Example/output_files/Example_pof.svf<br />
*: for programming the .sof or .pof file respectively.<br />
<br />
<br><br />
<br />
'''mx10spider_prog:'''<br />
<nowiki><br />
#!/bin/sh<br />
<br />
me=$(basename $0)<br />
<br />
if [ -f "$1" ]; then<br />
<br />
openocd -c "interface usb_blaster" -c "usb_blaster_lowlevel_driver ftdi" -c "usb_blaster_vid_pid 0x04d8 0xefd0" -c "jtag newtap max10 tap -irlen 10 -expected-id 0x31810dd -expected-id 0x318a0dd \<br />
-expected-id 0x31820dd -expected-id 0x31830dd -expected-id 0x31840dd \<br />
-expected-id 0x318d0dd -expected-id 0x31850dd -expected-id 0x31010dd \<br />
-expected-id 0x310a0dd -expected-id 0x31020dd -expected-id 0x31030dd \<br />
-expected-id 0x31040dd -expected-id 0x310d0dd -expected-id 0x31050dd" -c "init" -c "svf $1 progress" -c "shutdown"<br />
<br />
elif [ "$1" = "" ]; then<br />
<br />
echo "\tError: No file specified.\n\tUsage: $me <file.svf>"<br />
<br />
elif [ "$1" = "-h" ] || [ "$1" = "--help" ]; then<br />
<br />
echo "\tUtility script to start openocd and run an svf file.\n\tUsage: $me <file.svf>"<br />
<br />
else<br />
<br />
echo "\tFile not found: $1\n\tUsage: $me <file.svf>"<br />
<br />
fi<br />
</nowiki></div>Jshttp://www.spiderboard.org/index.php?title=RISC-V_%26_FreeRTOS&diff=261RISC-V & FreeRTOS2019-05-23T11:57:17Z<p>Js: </p>
<hr />
<div>== Installing VectorBlox ORCA Core and RISC-V Tools ==<br />
<br />
* Download the source from [https://github.com/VectorBlox/orca https://github.com/VectorBlox/orca] using git.<br />
*: In this guide the install locations ''/opt/orca/'' and ''/opt/riscv/'' were chosen.<br />
* Open a terminal window and run:<br />
*: '''$''' <nowiki> git clone https://github.com/VectorBlox/orca.git /opt/orca </nowiki><br />
*: '''$''' cd /opt/orca/tools/riscv-toolchain/<br />
*: '''$''' export RISCV_INSTALL="/opt/riscv"<br />
*: '''$''' ./build-toolchain.sh<br />
*:: Info: This may take a while.<br />
* Finally, add the RISC-V tools to your path. Open ''.profile'' in your home directory with a text exitor and add the line:<br />
*: export PATH=/opt/riscv/bin:$PATH<br />
* After updating the path variable you may need to logout and login again or run the following command in the terminal:<br />
*: '''$''' source ~/.profile<br />
<br />
== Compiling Firmware ==<br />
<br />
[[File:terminal_make_riscv.png|thumb|Terminal after calling make.]]<br />
<br />
* Download the [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example] and unpack.<br />
* Open a terminal window, change directory to either ''riscv_freertos_example/riscv'' or ''riscv_freertos_example/riscv_freertos'' and run:<br />
*: '''$''' make<br />
* The folder ''out'' now contains the ''bootrom.mif'' (Memory Initalization File).<br />
* Copy the ''bootrom.mif'' to ''riscv_freertos_example/quartus''<br />
<br />
== Quartus Prime Project ==<br />
<br />
[[File:quartus_setting_iploc.png|thumb|Type in the search path and then click on ''Add''.]]<br />
<br />
* Open Quartus Prime and load the project under ''riscv_freertos_example/quartus''.<br />
*: INFO: This Quartus project is specific to the SpiderSoM - for the MX10 the pin assignment has to be changed.<br />
* Open '''Assignments -> Settings -> IP Settings -> IP Catalog Search Locations''' and add the search path to ORCA.<br />
*: If ORCA was installed under ''/opt/orca/'' then use as search path: ''/opt/orca/**/*''<br />
* (Optional) Launch Qsys Platform Designer and open ''qsys.qsys''<br />
** (Optional) Under System Contents, double-click ''onchip_memory2_0'' and under memory initialization provide your bootrom.mif file. (The default is to use the bootrom.mif in the quartus folder)<br />
** (Optional) Save and Generate the Qsys system.<br />
* Compile the project and program it onto the FPGA using either [[Getting Started: Quartus Prime & OpenOCD#Programming via OpenOCD | OpenOCD]] or [[Getting Started: Quartus Prime & OpenOCD#Programming via USB Blaster| USB-Blaster]].<br />
<br />
After programming:<br />
<br />
[[File:terminal_picocom.png|thumb|Characters written are looped back and displayed.]]<br />
<br />
* If the red LED on the module starts blinking once per second, the FPGA was programmed successfully.<br />
* If the green LED on the module starts blinking once every two seconds, the RISC-V Core and its firmware is working.<br />
* PMod J2 will output a binary counter.<br />
* You can use the UART of the FPGA by using standard tools such as picocom:<br />
*: '''$''' sudo picocom -b 115200 /dev/ttyACM0<br />
** Every character written is looped back and should be displayed on the terminal.<br />
<br />
== Downloads ==<br />
<br />
* [https://github.com/VectorBlox/orca VectorBlox ORCA]<br />
* [ftp://ftp.aries-embedded.de/products/MX10/software/demo/20190506_SpiderSoM_quartus_riscv_freertos.zip RISC-V & FreeRTOS Example]</div>Jshttp://www.spiderboard.org/index.php?title=File:Quartus_setting_iploc.png&diff=260File:Quartus setting iploc.png2019-05-23T11:24:59Z<p>Js: </p>
<hr />
<div></div>Js