From bd691f83f60fc555a49bb907f8a4a7e925e44dd8 Mon Sep 17 00:00:00 2001
From: David Abdurachmanov <david.abdurachmanov@sifive.com>
Date: Fri, 11 Dec 2020 15:32:18 +0200
Subject: [PATCH] Prepare for 2020.12 release

Signed-off-by: David Abdurachmanov <david.abdurachmanov@sifive.com>
---
 README.md               | 14 ++---------
 ReleaseNotes/2020.12.md | 51 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 53 insertions(+), 12 deletions(-)
 create mode 100644 ReleaseNotes/2020.12.md

diff --git a/README.md b/README.md
index 7df29689..47ed3d57 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@ This needs to be done every time you want a clean setup based on the latest laye
 
 ```bash
 mkdir riscv-sifive && cd riscv-sifive
-repo init -u git://github.com/sifive/meta-sifive -b 2020.11 -m tools/manifests/sifive.xml
+repo init -u git://github.com/sifive/meta-sifive -b 2020.12 -m tools/manifests/sifive.xml
 repo sync
 ```
 
@@ -54,16 +54,6 @@ If you want to make modifications to existing layers then creating working branc
 repo start work --all
 ```
 
-### Updating Existing Workspace
-
-If you want to pull in the latest changes in all layers.
-
-```bash
-cd riscv-sifive
-repo sync
-repo rebase
-```
-
 ### Getting Build Tools (optional)
 
 OpenEmbedded-Core requires GCC 6 or newer to be available on the host system. Your host system might have an older version of GCC if you use LTS (Long Term Support) Linux distribution (e.g. Ubuntu 16.04.6 has GCC 5.4.0). You could solve this issue by installing build tools. This requires less than 400MB of disk space. You can download pre-built one or build your own build tools.
@@ -71,7 +61,7 @@ OpenEmbedded-Core requires GCC 6 or newer to be available on the host system. Yo
 #### Option 1: Installing OpenEmbedded-Core Build Tools (Pre-Built)
 
 ```bash
-./openembedded-core/scripts/install-buildtools
+./openembedded-core/scripts/install-buildtools -r yocto-3.2_M2 -t 20200729
 ```
 
 The native SDK will be installed under `$BUILDDIR/../openembedded-core/buildtools` prefix.
diff --git a/ReleaseNotes/2020.12.md b/ReleaseNotes/2020.12.md
new file mode 100644
index 00000000..6ac07677
--- /dev/null
+++ b/ReleaseNotes/2020.12.md
@@ -0,0 +1,51 @@
+# Release Notes for 2020.12
+
+This release includes major changes compared previous Freedom Unleashed SDK and thus is **experimental** at this stage. Main changes include:
+
+- All layers (openembedded-core, meta-openemedded, meta-riscv, meta-clang) updated to their latest revisions.
+
+- Layer compatibility switched to  _gatesgarth_ release.
+
+- stress-ng updated to 0.12.00.
+
+- U-Boot updated to 2020.10.
+
+- Mesa updated to 20.2.4.
+
+- New packages added to Xfce4 disk image:
+  
+  - `epiphany`
+  
+  - `evince`
+  
+  - `xdg-utils`
+  
+  - `libva`
+  
+  - `libva-utils`
+  
+  - `libvdpau`
+  
+  - `gstreamer1.0`
+  
+  - `gstreamer1.0-vaapi`
+  
+  - `mesa-vdpau-drivers`
+  
+  - `vdpauinfo`
+
+- `hwcodecs` was added to Xfce4 disk image `IMAGE_FEATURES`.
+
+- Mesa is now configurated with `va` and `vdpau`.
+
+- GStreamer1 is configured with `vdpau`.
+
+- PulseAudio is now configured with `autospawn-for-root`.
+
+## Known Issues
+
+1. Avoid overclocking SoC using CPUFreq if you are using HiFive Unleashed Expansion Board from Microsemi as this will hang the board. Hard reset will be required.
+
+2. If Xfce4 desktop disk image is used with HiFive Unleashed Expansion Board and GPU then rebooting is required after the 1st boot.
+
+3. Newer OE/Yocto buildtools could cause build issues for `nspr-native` package. Use `-r yocto-3.2_M2 -t 20200729` as described in README file if you are using OE/Yocto buildtools. See Yocto bug [#14112](https://bugzilla.yoctoproject.org/show_bug.cgi?id=14112)