From: lkcl <lkcl@web>
Date: Sat, 23 Jul 2022 12:48:02 +0000 (+0100)
Subject: (no commit message)
X-Git-Tag: opf_rfc_ls005_v1~1082
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=fc608d12b704ec2b6963b877d084cae0cec64678;p=libreriscv.git

---

diff --git a/docs/pypowersim.mdwn b/docs/pypowersim.mdwn
index 5499712d1..4e9b38695 100644
--- a/docs/pypowersim.mdwn
+++ b/docs/pypowersim.mdwn
@@ -11,13 +11,17 @@ These are multimedia tests intended to cover the inner loops of various
 Audio/Video CODECs (such as MP3).
 
 **Note:** There's no GUI, UART, or console. To check that the tests ran
-succesfully, you need to dump the memory contents and inspect them.
+succesfully, you need to dump the memory contents and inspect the output.
 
 
 # Pypowersim - PowerISA Simulator
 
-Pypowersim is a PowerISA simulator written and Python.
-PowerISA binaries are decoded by a given ISA class instance.
+Pypowersim is a PowerISA simulator written in Python.
+PowerISA binaries are decoded by an
+[ISA class instance](https://git.libre-soc.org/?p=openpower-isa.git;a=blob;f=src/openpower/decoder/isa/caller.py;hb=HEAD).
+ISACaller utilises compiled machine-readable Power ISA 3.0
+pseudocode taken directly from the Power ISA Specification.
+
 SVP64 binaries are also supported. Simulation is managed cycle by cycle,
 for instruction and memory debugging.
 Use of QEMU as a co-simulator is also supported for verifying the
@@ -110,9 +114,11 @@ After execution 128 bytes are dumped from address 0x900000.
 
 As the SVP64 spec and Libre-SOC CPU is developing, the available opcodes
 will grow. Make sure to update the auto-generated Python functions
-simulating the instructions by calling:
+simulating the instructions. Also the audio data needs to be downloaded.
 
-* run "pywriter". This is an installed utility, so should be in your PATH
+* run "pywriter". This is an installed utility, so should be in your PATH.
+  It recompiles the machine-readable Power ISA pseudocode into
+  executable python.
 * Download audio data. Use the Makefile inside "openpower-isa/media" to 
  download the audio samples.