README.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

<h1>Unmatched Patchwork</h1>
<p>
 This is an overlay voor the Gentoo Linux distribution, it is intended for
 owners of the <a href="https://www.sifive.com/boards/hifive-unmatched">SiFive
 HiFive Unmatched RISC-V PC</a>.
</p>
<h2>Why this overlay?</h2>
<p>
 Running Gentoo Linux on the Unmatched requires some modifications to some
 packages. Some are specific to this specific board, others are for RISC-V in
 general.
</p>
<p>
 Instead of keeping all those patches for myself I decided to share and hope it
 will help someone else too. This is actually the first overlay I'm sharing, so
 feedback is appreciated. You're quite likely to find me on the
 <a href="https://forums.gentoo.org">Gentoo forums</a> or the
 <a href="https://forums.sifive.com">SiFive forums</a>.
</p>
<h2>What is in this overlay?</h2>
<p>
 This overlay contains a few packages:
</p>
<ul>
 <li>media-video/mplayer: mplayer with a patch for it's configure script to accept RISC-V</li>
 <li>sys-apps/sysvinit: sysvinit patched so that the "reboot" command does the
     same als "halt" because the Unmatched can't rebooti and will be stuck
     if you do</li>
 <li>sys-boot/grub: Grub with patches to allow loading linux</li>
 <li>sys-boot/opensbi: OpenSBI with patches from SiFive</li>
 <li>sys-boot/u-boot: u-boot with patches from SiFive. Also has USE flags to
     set the CPU Frequency and prioritize EFI booting (required for grub)</li>
 <li>sys-kernel/sifive-sources: gentoo-sources with patches from SiFive</li>
</ul>
<h2>How to use this overlay?</h2>
<p>
 First you'll have to clone this overlay on a place you like. A common place
 these days is <b>/var/db/repos</b>. So cd into that direcoty and use
 <b>git clone https://code.pa4wdh.nl.eu.org/gentoo/unmatched-patchwork</b>,
 this will create a directory called unmatched-patchwork with the overlay in
 it.
</p>
<p>
 Next you have to make portage aware of the repo, for that you'll have to
 create a config file under <b>/etc/portage/repos.conf</b>. Create a file
 called <b>unmatched-patchwork.conf</b> and give it these contents:
</p>
<pre>
[unmatched-patchwork]
location = /var/db/repos/unmatched-patchwork
sync-type = git
sync-uri = https://code.pa4wdh.nl.eu.org/gentoo/unmatched-patchwork
</pre>
<p>
 If you placed the overlay on a different place than <b>/var/db/repos</b> make
 sure to adapt the <b>location</b> line to your needs.
</p>
<h2>What can i do with this?</h2>
<p>
 For me booting with grub has great value, it allows me to boot different
 kernels via it's menu. This allows me to experiment with different kernel
 versions and configurations, and i don't run into problems if it somehow
 doesn't boot.
</p>
<p>
 Mplayer is my favorite media player and is nice to get quick results. Even
 if you don't have a GPU you can test video with aalib :-).
</p>
<p>
 Have fun!
</p>