init

.gitignore

@@ -0,0 +1,4 @@
+/installers/*
+!/installers/installer.cfg
+/licenses/*
+!/licenses/README.*

LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.org

@@ -0,0 +1,62 @@
+#+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
+
+* TODO 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