Whats included in Docker impl/sim container

[akaeba]

Hi Stephan,

i miss a little the docu whats included in the docker container impl/sim. Perhaps you could add a small section into the readme. Whats the purpose and the include. Thanks :)

At the moment i look for an way to build an executable with a docker container as CI/CD build.

BR,
Andreas

[stnolting]

Hey there.

Yeah that's true... the documentation is quite non-existent. 🙈 So far, I've been using these containers only for the CI flows across different repositories. Any ideas how to improve the documentation?

Anyway, you can have a look at the according dockerfiles to see what's included:

• impl: https://github.com/stnolting/neorv32-setups/blob/main/.github/impl.dockerfile
• sim: https://github.com/stnolting/neorv32-setups/blob/main/.github/sim.dockerfile

[akaeba]

Hi Stephan,

Following try:

---

Prebuild Tooling

• sim: GHDL + NVC + Verilator + Icarus Verilog
• impl: GHDL + Yosys + nextpnr

---

For me would it also intresting to have an Docker Container with the prebuild compiler chain. That would allow me to build NEORV32 executables as CICD job. What do you think could this improve this project?

BR,
Andreas

[stnolting]

Following try: [...]

So should we put this (or something like this) in the documentation / user guide?

For me would it also intresting to have an Docker Container with the prebuild compiler chain. That would allow me to build NEORV32 executables as CICD job. What do you think could this improve this project?

Somehow, I do not like using containers when doing "active" development, but I think that is just a matter of taste. So yes, we could add that as well. Would you make a proposal for that? ;)

[NikLeberg]

Hi @akaeba
May I interest you in my prebuilt docker images? I develop within a complete dockerized environment over at NikLeberg/neorv32_soc. That allows me to work from within WSL2, or even from any web browser with github codespaces. It pulls in docker images from NikLeberg/container_builder for riscv-gcc, Intel Quartus, QuestaSim/ModelSim and GHDL. Let me know if something is of interest.

[akaeba]

So should we put this (or something like this) in the documentation / user guide?

I would prefer it in the documentation. Perhaps in the section 5 Getting started as own headline 🧪 Development and there this two docker containers.

Would you make a proposal for that? ;)

Yes I can do :) But i think this will take some minutes more. In general what i have in mind:

• Dockerfile which builds the gcc tool chain from scratch and stores it as own docker container
• Help tools
  • convert HEX File to MIF

any additional ideas?

To the background i face the need to build a binary under usage of CI/CD and artefactory out of an git repository.

[NikLeberg]

Dockerfile which builds the gcc tool chain from scratch and stores it as own docker container

Feel free to copy the first stage of container_builder/riscv-gcc/Dockerfile. It does exactly that. 😉

[akaeba]

Hi @NikLeberg

Let me know if something is of interest

From the naming sounds riscv-gcc very nice. Whats there included. I mean the OS and the GCC variant. Does this work with @stnolting makefiles? Are there also tags available like v13.2 v12.0 and so on?

Thanks for the hint :)

[NikLeberg]

Included is of course the gcc toolchain for riscv in version 13.2.0. It can be found in /opt/riscv/bin with the prefix of RISCV_PREFIX=riscv32-unknown-elf-. The path and the prefix are already set correctly within the container though.
Additionally make and the ubuntu default gcc (version 11.4.0) as well as openocd are installed. The OS itself is ubuntu jammy i.e. version 22.04.

Yes it works very nicely with the makefiles of neorv32.

I do currently not provide any tags besides latest. It's a good point though, I should consider adding that...