Post Installation¶
Important
This documentation is not recommended for new RISC-V projects. New RISC-V projects should reference the newest version of the documentation. Users targeting Arm devices can still use this documentation as their reference.
The newest version of the documentation can be found here: https://mi-v-ecosystem.github.io/SoftConsole-Documentation/
PolarFire SoC boot mode programming¶
When using PolarFire SoC boot mode programming tool from within SoftConsole then Program and debug, or Libero has to be installed:
https://www.microsemi.com/product-directory/dev-tools/4970-programming
https://www.microsemi.com/product-directory/design-resources/1750-libero-soc
Renode dependencies¶
The Renode emulation platform is not a crucial sub-module of SoftConsole and users who are intending to connect to hardware targets only do not need satisfy the Renode’s dependencies.
Note
A administrative account is required to install the .NET framework.
The Renode emulation platform can be used out of the box on many Windows 10 machines. However in a rare case when the .NET Framework is not already installed with Windows 10 then it can be changed easily from within Windows features menu.
![digraph {
graph [rankdir="LR", ranksep=.01, bgcolor=transparent];
node [fontname="Verdana", fontsize="9", shape="rectangle", width=.1, height=.2, margin=".04,.01", style=filled, fillcolor=white];
edge [arrowsize=.7];
"Start button" -> "Type 'Turn Windows features on or off'" -> "Select '.NET Framework 4.8'" -> "Click OK"
}](../_images/graphviz-02c9360d08aa1dbd4b956b49a0c10b555ed6304e.png)
On Windows 7 the Microsoft .NET Framework v4.7.2 must be installed first:
https://www.microsoft.com/net/download/dotnet-framework-runtime
Windows firewall¶
On Windows if there is a firewall in use then the first time that a debug session is run the firewall may prompt that it is blocking
OpenOCD, fpServer.exe
and/or renode.exe
. Allow the firewall to unblock these and save this as the default setting if
necessary.
Crypto Application Library¶
The Crypto Application Library (CAL) provides the software API to access User Crypto block on the PolarFire and PolarFire SoC device families.
If license was agreed on installation, then the library is installed in <SC_INSTALL_DIR>/extras/CAL/
path and contains these following folders/files:
cal-src
crypto sources in an as-is form, user can use these for reference, but they are not a SoftConsole projectmpfs-user-crypto-lib
a SoftConsole project which after compilation will produce the following files:mpfs-rv64g-user-crypto-lib.a
(U54)mpfs-rv64imac-user-crypto-lib.a
(E51)
These files can be used with PolarFire SoC crypto examples located on the GitHub
miv-rv32-user-crypto-lib
a SoftConsole project which after compilation will produce the following files:miv-rv32imc-user-crypto-lib.a
miv-rv32i-user-crypto-lib.a
These files can be used with Mi-V Soft processor crypto examples located on the GitHub
user_guide.pdf
Documentation for the CAL API
Note
The crypto-lib projects can be imported as any other generic/regular SoftConsole projects. Users who know how to import projects can skip the rest of the section.
To import in into the workspace do the following:
![digraph {
graph [rankdir="LR", ranksep=.01, bgcolor=transparent];
node [fontname="Verdana", fontsize="9", shape="rectangle", width=.1, height=.2, margin=".04,.01", style=filled, fillcolor=white];
edge [arrowsize=.7];
"SoftConsole Menu toolbar" -> "File" -> "Import" -> "Existing Projects into Workspace"
}](../_images/graphviz-693664cfc32b674906b3886c069421e62f65a94d.png)
After Import dialog is showed do following:
![digraph {
graph [rankdir="LR", ranksep=.01, bgcolor=transparent];
node [fontname="Verdana", fontsize="9", shape="rectangle", width=.1, height=.2, margin=".04,.01", style=filled, fillcolor=white];
edge [arrowsize=.7];
"Select root directory" -> "Browse..." -> "find and select the 'miv-rv32-user-crypto-lib' folder" -> "Open"
}](../_images/graphviz-77a782d6d3634c0082ba83aa9f19d18c958f9895.png)
If the dialog was left in the default state (as provided from a fresh workspace) and the project was not imported already into the workspace, then clicking the Finish
button will import it correctly into the workspace.