microchip-tools-container/README.org

#+title: Installing Microchip Tools via podman or docker
#+subtitle: This is a work in progress. It doesn't fully work yet.
#+author: Penguin

* Download the Libero and SoftConsole installers

- Download Libero from [[https://ww1.microchip.com/downloads/secure/aemdocuments/documents/fpga/media-content/fpga/v2024-1/libero_soc_v2024.1_web_lin.zip][here]].
- Place it in ~./installers/~
- Download SoftConsole from [[https://ww1.microchip.com/downloads/secure/aemDocuments/documents/FPGA/media-content/FPGA/SoftConsole/v2022-2/Microchip-SoftConsole-v2022.2-RISC-V-747-linux-x64-installer.run][here]].
- Place it in ~./installers/~

Unzip libero:
#+begin_src bash
cd installers
unzip Libero_soc_*.*_web_lin.zip
cd ..
#+end_src

* [[https://docs.beagleboard.org/latest/boards/beaglev/fire/demos-and-tutorials/mchp-fpga-tools-installation-guide.html#request-a-libero-silver-license][Request a License from Microchip]]

* Install the license
#+begin_src bash
mv /path/to/License.dat ./licenses/.
#+end_src

Open the license in a text editor and change these lines:
#+begin_example
SERVER <put.hostname.here> <your mac address> 1702
DAEMON actlmgrd  PATH/actlmgrd
DAEMON mgcld PATH/mgcld
VENDOR snpslmd  PATH/snpslmd
#+end_example

to

#+begin_example
SERVER LPOD <your mac address> 1702
DAEMON actlmgrd  /opt/microchip/Libero_SoC_v2024.1/Libero/bin64/actlmgrd
DAEMON mgcld /opt/microchip/Libero_SoC_v2024.1/Libero/bin64/mgcld
VENDOR snpslmd  /opt/microchip/Libero_SoC_v2024.1/Libero/bin64/snpslmd
#+end_example

Your mac address should already be placed there so don't worry about that.

* Build the container
#+begin_src bash
podman build -t microchip_tools .
#+end_src

* Create a podman network
#+begin_src bash
podman network create
#+end_src

The next steps assume this network name is podman1, the default first network name. If you need to name it something else, change the ~--network~ line in the makefile target. This will be polished later.
* Run libero from inside the container
#+begin_src bash
export LIBERO_LICENSE_MAC=<your mac address>
make bash
#+end_src

You should now be root inside of your running container. It should now be as simple as calling ~libero~.
* TODO Running Libero from outside the container