From: lkcl 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.