OpenRISC Tutorials

This repository contains the source for the OpenRISC architecture tutorials

These documents are helpful for users who want to get started developing software and SoC's using the OpenRISC cpu architecture.

Outline

We are currently in progress working on a new structure and the intended outline is:

• Intro - OK

  • Programmers Guide - Link to architecture spec, etc.
  • Getting EDA tools, quartus, vivado

• Toolchains - Stub TODO

  • Binaries - downloads from github, need to setup CI for building

  • Tutorials

    • or1k-linux- gcc
    • or1k-elf- newlib - OK
    • or1k-unknown-gnu- glibc - Stub TODO
    • or1k-unkiown-musl- musl - Stub TODO
    • or1k-unknown-uclibc-

• Platforms - Stub TODO

  • Loading binaries into platforms. ELF binaries explanation.
  • Programs on OpenRISC
    • Memory layout
    • Elf binary lays out memory for linux/bare metal.
  • Tutorials
    • or1ksim - OK
    • QEMU - OK
    • Fusesoc - OK
      • mor1kx-generic - TODO
      • de0_nano-multicore - TODO
      • de0_nano - OK
    • Litex TODO

• Linux on OpenRISC - Stub/Outdated move/remove? TODO

  • Memory Layout
    • In addition to ELF binary
    • Device tree
    • Rootfs loaded to memory for embedded systems / no sd card
  • Rootfs
    • buildroot
    • busybox
  • Tutorials
    • linux on or1ksim - OK
      • defconfig + busybox
    • linux on QEMU - OK
      • virt_defconfig + buildroot
    • Running linux on Litex SoC TODO
      • SIM + litex_defconfig + buildroot
      • arty + litex_defconfig + buildroot
    • Running Linux on fusesoc SoC TODO
    • SIM + defconfig + busybox
    • de0_nano + defconfig + busybox
    • de0_nano-multicore + smp_defconfig + busybox