(no commit message)
authorlkcl <lkcl@web>
Sat, 23 Jul 2022 12:21:38 +0000 (13:21 +0100)
committerIkiWiki <ikiwiki.info>
Sat, 23 Jul 2022 12:21:38 +0000 (13:21 +0100)
docs/pypowersim.mdwn

index d27b12811cf0df2fbd7a8e2c465e5898fb7db2f8..85e67e2d236d57f17d31ac409390a46a1ee630a7 100644 (file)
@@ -45,6 +45,28 @@ There are other options available (such as initialising the Floating Point
 Registers).
 for 
 
+**Example GPR file**:
+
+See <https://git.libre-soc.org/?p=openpower-isa.git;a=blob;f=media/audio/mp3/mp3_0.gpr;hb=HEAD>
+
+This file sets the GPRs to explicit values prior to execution.
+This allows for example a function call's parameters, according
+to Power ISA [ABI](), to be set conveniently and quickly, but
+more importantly without requiring execution of additional
+instructions.
+
+```
+   1 # void ff_mpadsp_apply_window_float(float *synth_buf, float *window,
+   2 #                                  int *dither_state, float *samples,
+   3 #                                  ptrdiff_t incr);
+   4 1: 0x8000        # stack pointer
+   5 3: 0x600000      # param 1: float *sunth_buf     buf
+   6 4: 0x700000      # param 2: float *window        win
+   7 5: 0x800000      # param 3: int *dither_state    &unused
+   8 6: 0x900000      # param 3: float *samples       out
+   9 7: 1             # param 5: ptr_diff_t incr      1
+```
+
 ### Before running the tests!
 
 **NOTE**: Is this correct?