Don't panic 
Hello RISC-V!
       _            _                        _          _ 
      | |          | |                      | |        (_)
   ___| | ___   ___| | ____      _____  _ __| | ___ __  _ 
  / __| |/ _ \ / __| |/ /\ \ /\ / / _ \| '__| |/ / '_ \| |
 | (__| | (_) | (__|   <  \ V  V / (_) | |  |   <| |_) | |
  \___|_|\___/ \___|_|\_\  \_/\_/ \___/|_|  |_|\_\ .__/|_|
                                                 | |      
                                                 |_| 
-------------------------------------------------------------

REFERENCE 
---------

https://www.clockworkpi.com/product-page/devterm-kit-r01 
http://www.netbsd.org/docs/pkgsrc/

VIDEO DEMO 
----------

https://youtu.be/DA_o2-ng7gY?si=n95j20Y6n0CEYGZE
https://youtu.be/XuUrtfM-sag?feature=shared

MAIN 
----

  ClockworkPi v3.14 mainboard
  R-01 Core module (RISC-V 64bit Single-core RV64IMAFDCVU @ 1.0GHz, No GPU, 1GB DDR3)

  This device has no dedicated "GPU" and all the graphical rendering is done by CPU only.  
  Therefore it is not suitable to mainstream users, and should be regarded as an experimental
  device. 

  I have spent some time working with it and can conclude the following: 

  - Games should be compiled using SDL1.2 if they are to be playable on the R01 
  - Internet browsers/tools all are better of using console versions 
    One exception is the NetSurf, which works really great on the R01 
  - Ubuntu 22.04 LTS based distro has many packages in the repos, but many will simply not work well on the R01 
    due to GPU requirements which R01 lacks ! Instead of trial/error via apt-get and pollutiing the system 
    PKGSRC can be used instead. 
    
    ***************************

    ADVANTAGE of pkgsrc - independent of the OS/Linux distro's libraries (except libc)    
                          Something goes wrong, just delete /usr/pkg and bootstrap again :)  
 
  - Decided to build/bootstrap pkgsrc-Q12024  and use primarily that what was compiled 
  - The system is rock solid (only crashs ever encountered was during compilation and lack of free RAM/SWAP) 

  - Advantage of pkgsrc is that it does not affect the native system packages in any way 
    can be installed unprivileged, or on external storage media 
    The binary bootstrap available here is hardcoded for /usr/pkg  
    (you can have this on a separate partition for example) 
    There are some packages that are missing from the official Ubuntu riscv64 repos   

  - Notable pkgsrc packages (linked against SDL12) 
    GAMES: ScummVM, Chocolate-Doom, PrBoom, ECWolf, Sarien, NAGI, FreeSCI, OpenTyrian, ROTT, Pentagram   
    EMULATORS: Sameboy, Realboy, Vmac 
    (and many more ...)
    (P.S. Some games lag in audio, producing funny noise on the R01, in that case its better to mute it)
    (Only exception is ECWolf where it has to be spefically disabled via SDL environment variables due to crash) 
 
  - Included is the pkg_developer to ease porting new packages to riscv64 platform on Linux 

  - Check out the CDE as well - this is a great WM replacement to the TWM on the default stock image

PKGSRC howto 
------------

Binary bootstrap for the Ubuntu 22.04 riscv64 R01 is available  

On the Devterm R01 

     sudo su -
     cd /usr
     wget https://astr0baby.online/riscv64/DevTerm-R01/pkg.tar.gz 
     gunzip pkg.tar.gz 
     tar -xvf pkg.tar 
     rm pkg.tar 

Or you can pull pkgsrc.xz from https://cdn.netbsd.org , extract in /usr/ and bootstrap yourself (build takes about 60 minutes) 

Add path to your $ENV  

     export PATH=$PATH:/usr/pkg/bin
     export PATH=$PATH:/usr/pkg/sbin


Add binary tgz packages via pkg_add command  

     PKG_PATH="http://astr0baby.online/riscv64/DevTerm-R01/All"
     export PKG_PATH
     pkg_add prboom 


To make Fluidsynth work you need to install the soundfonts.tar.gz (OPTIONAL) 

    cd /usr/pkg/share
    wget http://astr0baby.online/riscv64/DevTerm-R01/soundfonts.tar.gz 
    gunzip soundfonts.tar.gz
    tar -xvf soundfonts.tar 
    rm soundfonts.tar  


To get Alsa audio working on the Devterm R-01 and pkgsrc make sure you symlink the native alsa-lib to /usr/pkg/lib 
and copy the native alsa.conf file 

   cp /usr/share/alsa/alsa.conf /usr/pkg/share/alsa 
   ln -s /usr/lib/riscv64-linux-gnu/alsa-lib/ /usr/pkg/lib/ 


NOTES
-----
 
   SDL2 does not perform well on the device (lack of GPU) 
   All the games compiled in pkgsrc are built against SDL1.2 and tested to work 
   You can find a full detailed list in the PKG_INFO directory