diff --git a/src/_pull_dsvm.py b/resources/_pull_dsvm.py
similarity index 100%
rename from src/_pull_dsvm.py
rename to resources/_pull_dsvm.py
diff --git a/src/ds_stdlib.py b/src/ds_stdlib.py
index 2fb1ec7..f962e9e 100644
--- a/src/ds_stdlib.py
+++ b/src/ds_stdlib.py
@@ -2,20 +2,7 @@ import os
import time
import requests
from enum import IntEnum
-
-"""
-Should not have HARD CODED memory address
-Must be compatible with all duckyScript and duckyPad versions
-
-DPDSSTDLIB
-
-TODO:
-bitread, set, clear, toggle?
-math abs, min, max?
-memcpy?
-try_set_led?
-show error and quit? for unsupported hardwares
-"""
+import webbrowser
default_stdlib_code = """
@@ -117,7 +104,12 @@ class stdlib_fetch_result(IntEnum):
NETWORK_ERROR = 2
OTHER_ERROR = 3
-stdlib_url = 'https://raw.githubusercontent.com/duckyPad/DuckStack/refs/heads/master/README.md'
+stdlib_readme_url = "https://github.com/duckyPad/DPDS-Standard-Library/blob/master/README.md"
+
+def open_stdlib_doc_url():
+ webbrowser.open(stdlib_readme_url)
+
+stdlib_url = 'https://raw.githubusercontent.com/duckyPad/DPDS-Standard-Library/refs/heads/master/releases/duckypad_stdlib_latest.txt'
STDLIB_CHECK_INTERVAL_HOURS = 12
def fetch_update(stdlib_path, force_fetch=False):
@@ -175,5 +167,5 @@ def fetch_update(stdlib_path, force_fetch=False):
except Exception:
return stdlib_fetch_result.OTHER_ERROR
-result = fetch_update("./test")
-print(result)
\ No newline at end of file
+# result = fetch_update("./test")
+# print(result)
\ No newline at end of file
diff --git a/src/duckypad_config.py b/src/duckypad_config.py
index 14aa230..ed4dd30 100644
--- a/src/duckypad_config.py
+++ b/src/duckypad_config.py
@@ -20,7 +20,7 @@ import traceback
import dp20_dumpsd
from tkinter import font
import dsvm_preprocessor
-from ds_stdlib import *
+import ds_stdlib
"""
0.13.5
@@ -207,8 +207,8 @@ ensure_dir(app_save_path)
ensure_dir(backup_path)
ensure_dir(hid_dump_path)
-ensure_dpds_stdlib(ext_lib_path)
-this_global_setting.stdlib_line_list = get_latest_stdlib_lines(ext_lib_path)
+ds_stdlib.ensure_dpds_stdlib(ext_lib_path)
+this_global_setting.stdlib_line_list = ds_stdlib.get_latest_stdlib_lines(ext_lib_path)
print("\n\n--------------------------")
print("\n\nWelcome to duckyPad Configurator!\n")
@@ -1185,7 +1185,7 @@ def edit_header_button_click(global_setting_obj):
stdlib_btn_container = Frame(stdlib_frame)
stdlib_btn_container.pack(side="bottom", fill="x", padx=5, pady=5)
- btn_stdlib_docs = Button(stdlib_btn_container, text="StdLib Docs")
+ btn_stdlib_docs = Button(stdlib_btn_container, text="StdLib Docs", command=ds_stdlib.open_stdlib_doc_url)
btn_stdlib_docs.pack(side="left", fill="x", expand=True, padx=(0, 2))
btn_fetch_latest = Button(stdlib_btn_container, text="Fetch Latest")
diff --git a/src/shared.py b/src/shared.py
index 1a66fbc..b28b879 100644
--- a/src/shared.py
+++ b/src/shared.py
@@ -4,11 +4,9 @@ import webbrowser
from platformdirs import *
from pathlib import Path
from hid_common import *
-
from dsvm_common import *
-import dsvm_make_bytecode
-print("NOTE TO MYSELF: _pull_dsvm.py to download latest VM version")
+print("NOTE TO MYSELF: Don't forget to include latest DSVM compiler!")
MAX_PROFILE_NAME_LEN = 16
MAX_EXPANSION_MODULE_COUNT = 4
diff --git a/src/test/dpds_stdlib_1767962308.txt b/src/test/dpds_stdlib_1767962308.txt
deleted file mode 100644
index 2ea4ff6..0000000
--- a/src/test/dpds_stdlib_1767962308.txt
+++ /dev/null
@@ -1,424 +0,0 @@
-# DuckStack Bytecode Virtual Machine
-
-DuckStack is a simple **stack-based bytecode VM** for executing compiled **duckyScript** binaries.
-
-[duckyPad](https://dekunukem.github.io/duckyPad-Pro/doc/landing.html) uses it for HID macro scripting.
-
-## ⚠️⚠️ UNDER BETA TEST ⚠️⚠️
-
-This VM is currently **under beta test** and not ready for public use yet!
-
-[More info here](https://github.com/dekuNukem/duckyPad-Pro/blob/dsvm2/doc/beta_test.md)
-
-## Features
-
-* 32-Bit Data Path, 16-bit Addressing.
-* Shared Executable & Stack Region
-* Variable-length Instructions
-* Functions with Arguments, Locals, & Recursions.
-* HID-specific Instructions
-
-## Table of Contents
-
-- [How to Use](#how-to-use)
- - [Compile](#compile)
- - [Execute](#execute)
-- [Architecture Overview](#architecture-overview)
- - [Memory Map](#memory-map)
-- [Instruction Set](#instruction-set)
- - [CPU Instructions](#cpu-instructions)
- - [Binary Operators](#binary-operators)
- - [Unary Operators](#unary-operators)
- - [duckyScript Commands](#duckyscript-commands)
-- [Calling Convention](#calling-convention)
- - [Stack Set-up](#stack-set-up)
- - [Arguments / Locals](#arguments--locals)
- - [Stack Unwinding](#stack-unwinding)
-- [Questions or Comments?](#questions-or-comments)
-
-## How to Use
-
-### Compile
-
-* Download / clone this repo
-* Prepare a duckyScript source file `test.txt`
- * Learn More: [Writing duckyScript](https://dekunukem.github.io/duckyPad-Pro/doc/duckyscript_info.html)
-* In `ds_compiler` directory, run:
-
-`python3 ./dsvm_make_bytecode.py test.txt test.dsb`
-
-### Execute
-
-A minimal C-based VM is provided. Based on real duckyPad firmware, but uses placeholders for hardware commands.
-
-----
-
-In `ds_c_vm` folder, run `python3 ./compile.py` to compile the source. (Or write your own Makefile)
-
-Run the VM: `./main test.dsb`
-
-Set `PRINT_DEBUG` to 1 in `main.h` for execution and stack trace.
-
-## Architecture Overview
-
-duckStack uses **32-bit** variables, arithmetics, and stack width.
-
-Addressing is **16-bit**, executable 64KB max.
-
-* Single **Data Stack**
-* Program Counter (PC)
- * 16-bit byte-addressed
-* Stack Pointer (SP)
- * 16-bit byte-addressed
- * Points to **the next free stack slot**
-* Frame Pointer (FP)
- * Points to current function base frame
-
-### Memory Map
-
-* Flat memory map
-* Byte-addressed
-
-|Address|Purpose|Size|Comment|
-|:-:|:--:|:--:|:--:|
-|`0000`
`F7FF` |Shared
**Executable**
and **Stack**|63488 Bytes|See Notes Below|
-|`F800`
`F9FF` |User-defined
Global
Variables|512 Bytes
4 Bytes/Entry
128 Entries|ZI Data|
-|`FA00`
`FAFF` |Scratch
Memory|256 Bytes|General-purpose
User-accessible|
-|`FB00`
`FCFF` |Unused|512 Bytes||
-|`FD00`
`FDFF` |Persistent
Global
Variables|256 Bytes
4 Bytes/Entry
64 Entries |Non-volatile Data
Saved on SD card|
-|`FE00`
`FFFF` |VM
Reserved
Variables|512 Bytes
4 Bytes/Entry
128 Entries|Read/Adjust
VM Settings|
-
-* Binary executable is loaded at `0x0`
-* Stack grows from `0xF7FF` towards **smaller address**
- * Each item **4 bytes long**
- * In actual implementation, SP can be **4-byte aligned** for better performance.
-* Smaller executable allows larger stack, vise versa.
-
-## Instruction Set
-
-**Variable-length** between **1 to 5 bytes**.
-
-* First byte (Byte 0): **Opcode**.
-* Byte 1 - 4: **Optional payload**.
-* ⚠️Integer arithmetics are **signed** BY DEFAULT
- * Set reserved variable `_UNSIGNED_MATH = 1` to switch to **unsigned mode**
-* All multi-byte operations are **Little-endian**
-
-### CPU Instructions
-
-* **1 stack item** = 4 **bytes**
-
-* `PUSHR` / `POPR` **Offset** is a **byte-addressed signed 16-bit integer**
- * Positive: Towards larger address / Base of Stack
- * Negative: Towards smaller address / Top of Stack (TOS)
-
-|Name|Inst.
Size|Opcode
Byte 0|Comment|Payload
Byte 1-2|
-|:-:|:-:|:-:|:-:|:-:|
-|`NOP`|1|`0`/`0x0` |Do nothing|None|
-|`PUSHC16`|3|`1`/`0x1` |Push an **unsigned 16-bit (0-65535)** constant on stack
For negative numbers, push abs then use `USUB`.|2 Bytes:
`CONST_LSB`
`CONST_MSB` |
-|`PUSHI`|3|`2`/`0x2` |Read **4 Bytes** at `ADDR`
Push to stack as one **32-bit** number|2 Bytes:
`ADDR_LSB`
`ADDR_MSB`|
-|`PUSHR`|3|`3`/`0x3`|Read **4 Bytes** at **offset from FP**
Push to stack as one **32-bit** number|2 Bytes:
`OFFSET_LSB`
`OFFSET_MSB`|
-|`POPI`|3|`4`/`0x4` |Pop one item off TOS
Write **4 bytes** to `ADDR`|2 Bytes:
`ADDR_LSB`
`ADDR_MSB`|
-|`POPR`|3|`5`/`0x5`|Pop one item off TOS
Write as **4 Bytes** at **offset from FP**|2 Bytes:
`OFFSET_LSB`
`OFFSET_MSB`|
-|`BRZ`|3|`6`/`0x6` |Pop one item off TOS
If value is zero, jump to `ADDR` |2 Bytes:
`ADDR_LSB`
`ADDR_MSB`|
-|`JMP`|3|`7`/`0x7` |Unconditional Jump|2 Bytes:
`ADDR_LSB`
`ADDR_MSB`|
-|`ALLOC`|3|`8`/`0x8` |Push `n` blank entries to stack
Used to allocate local variables
on function entry|2 Bytes:
`n_LSB`
`n_MSB`|
-|`CALL`|3|`9`/`0x9` |Construct 32b value `frame_info`:
Top 16b `current_FP`,
Bottom 16b `return_addr (PC+3)`.
Push `frame_info` to TOS
Set **FP** to TOS
Jump to `ADDR`|2 Bytes:
`ADDR_LSB`
`ADDR_MSB`|
-|`RET`|3|`10`/`0xa` |`return_value` on TOS
Pop `return_value` into temp location
Pop items until TOS is `FP`
Pop `frame_info`, restore **FP** and **PC**.
Pop off `ARG_COUNT` items
Push `return_value` back on TOS
Resumes execution at PC|2 Bytes:
`ARG_COUNT`
`Reserved`|
-|`HALT`|1|`11`/`0xb` |Stop execution|None|
-|`PEEK8`|1|`12`/`0xc` |Pop **ONE** item off TOS as `ADDR`
`ADDR <= End of Scratch Memory`
Read **ONE byte** at `ADDR`
Push on stack|None|
-|`POKE8`|1|`13`/`0xd` |Pop **TWO** item off TOS
First `ADDR`, then `VAL`.
`ADDR <= End of Scratch Memory`
Write **ONE** byte (LSB of `VAL`) to `ADDR`|None|
-|`PUSH0`|1|`14`/`0xe` |Push `0` to TOS|None|
-|`PUSH1`|1|`15`/`0xf` |Push `1` to TOS|None|
-|`DROP`|1|`16`/`0x10` |Discard **ONE** item off TOS|None|
-|`DUP`|1|`17`/`0x11` |**Duplicate the item** on TOS|None|
-|`RANDINT`|1|`18`/`0x12` |Pop **TWO** item off TOS
First `Upper`, then `Lower`.
Push a random number inbetween (**inclusive**) on TOS|None|
-|`PUSHC32`|5|`19`/`0x13` |Push an **unsigned 32-bit** constant on stack
For negative numbers, push abs then use `USUB`.|4 Bytes
`CONST_LSB`
`CONST_B1`
`CONST_B2`
`CONST_MSB`|
-|`PUSHC8`|2|`20`/`0x14` |Push an **unsigned 8-bit (0-255)** constant on stack
For negative numbers, push abs then use `USUB`.|1 Byte|
-|`VMVER`|3|`255`/`0xff`| VM Version Check
Abort if mismatch |2 Bytes:
`VM_VER`
`Reserved`|
-
-### Binary Operators
-
-Binary as in **involving two operands**.
-
-* All **single-byte** instructions
-* Pop **TWO** items off TOS
-* Top item is right-hand-side, lower item is left-hand-side.
-* Perform operation
-* Push result back on TOS
-
------
-
-* ⚠️ = Affected by current **Arithmetic Mode**
- * Default: Signed
- * Unsigned mode if `_UNSIGNED_MATH = 1`
-
-|Name|Opcode
Byte 0|Comment|
-|:--:|:--:|:--:|
-|`EQ`|`32`/`0x20`|Equal|
-|`NOTEQ`|`33`/`0x21`|Not Equal|
-|`LT`|`34`/`0x22`|⚠️Less Than|
-|`LTE`|`35`/`0x23`|⚠️Less Than or Equal|
-|`GT`|`36`/`0x24`|⚠️Greater Than|
-|`GTE`|`37`/`0x25`|⚠️Greater Than or Equal|
-|`ADD`|`38`/`0x26`|Add|
-|`SUB`|`39`/`0x27`|Subtract|
-|`MULT`|`40`/`0x28`|Multiply|
-|`DIV`|`41`/`0x29`|⚠️Integer Division|
-|`MOD`|`42`/`0x2a`|⚠️Modulus|
-|`POW`|`43`/`0x2b`|Power of|
-|`LSHIFT`|`44`/`0x2c`|Left shift|
-|`RSHIFT`|`45`/`0x2d`|⚠️Right shift
Signed Mode: Arithmetic (sign-extend)
Unsigned Mode: Logical (0-extend)|
-|`BITOR`|`46`/`0x2e`|Bitwise OR|
-|`BITXOR`|`47`/`0x2f`|Bitwise XOR|
-|`BITAND`|`48`/`0x30`|Bitwise AND|
-|`LOGIAND`|`49`/`0x31`|Logical AND|
-|`LOGIOR`|`50`/`0x32`|Logical OR|
-
-### Unary Operators
-
-* All **single-byte** instructions
-* Pop **ONE** items off TOS
-* Perform operation
-* Push result back on TOS
-
-|Name|Opcode
Byte 0|Comment|
-|:--:|:--:|:--:|
-|`BITINV`|`55`/`0x37`|Bitwise Invert|
-|`LOGINOT`|`56`/`0x38`|Logical NOT|
-|`USUB`|`57`/`0x39`|Unary Minus|
-
-### duckyScript Commands
-
-* All **single-byte** instructions
-
-|Name|Opcode
Byte 0|Comment|
-|:-------:|:----------:|:---------:|
-|`DELAY`|`64`/`0x40`| **Delay**
Pop **ONE** item
Delay amount in **milliseconds**|
-|`KDOWN`|`65`/`0x41`| **Press Key**
Pop **ONE** item
`\|MSB\|B2\|B1\|LSB`
`\|Unused\|Unused\|KeyType\|KeyCode\|`|
-|`KUP`|`66`/`0x42`|**Release Key**
Pop **ONE** item
`\|MSB\|B2\|B1\|LSB`
`\|Unused\|Unused\|KeyType\|KeyCode\|`|
-|`MSCL`|`67`/`0x43`| **Mouse Scroll**
Pop **TWO** items
First `hline`, then `vline`
Scroll `hline` horizontally
`(Positive: RIGHT, Negative: LEFT)`
Scroll `vline` vertically
`(Positive: UP, Negative: DOWN)`|
-|`MMOV`|`68`/`0x44`|**Mouse Move**
Pop **TWO** items: `x` then `y`
`x`: Positive RIGHT, Negative LEFT.
`y`: Positive UP, Negative DOWN.|
-|`SWCF`|`69`/`0x45`| **Switch Color Fill**
Pop **THREE** items
`Red, Green, Blue`
Set ALL LED color to the RGB value|
-|`SWCC`|`70`/`0x46`| **Switch Color Change**
Pop **FOUR** item
`N, Red, Green, Blue`
Set N-th switch to the RGB value
If N is 0, set current switch.|
-|`SWCR`|`71`/`0x47`| **Switch Color Reset**
Pop **ONE** item
If value is 0, reset color of current key
If value is between 1 and 20, reset color of that key
If value is 99, reset color of all keys.|
-|`STR`|`72`/`0x48`|**Type String**
Pop **ONE** item as `ADDR`
Print zero-terminated
string at `ADDR`|None||
-|`STRLN`|`73`/`0x49`|**Type Line**
Pop **ONE** item as `ADDR`
Print zero-terminated
string at `ADDR`
**Press ENTER at end**|
-|`OLED_CUSR`|`74`/`0x4a`|**OLED Set Cursor**
Pop **TWO** items: `x` then `y`||
-|`OLED_PRNT`|`75`/`0x4b`|**OLED Print**
Pop **ONE** item as `ADDR`
Print zero-terminated
string at `ADDR` to OLED|None|
-|`OLED_UPDE`|`76`/`0x4c`|**OLED Update**|
-|`OLED_CLR`|`77`/`0x4d`|**OLED Clear**|
-|`OLED_REST`|`78`/`0x4e`| **OLED Restore**|
-|`OLED_LINE`|`79`/`0x4f`|**OLED Draw Line**
Pop **FOUR** items
`x1, y1, x2, y2`
Draw single-pixel line in-between|
-|`OLED_RECT`|`80`/`0x50`|**OLED Draw Rectangle**
Pop **FIVE** items
`fill, x1, y1, x2, y2`
Draw rectangle between two points
Fill if `fill` is non-zero|
-|`OLED_CIRC`|`81`/`0x51`|**OLED Draw Circle**
Pop **FOUR** items
`fill, radius, x, y`
Draw circle with `radius` at `(x,y)`
Fill if `fill` is non-zero|
-|`BCLR`|`82`/`0x52`|**Clear switch event queue**|
-|`SKIPP`|`83`/`0x53`| **Skip Profile**
Pop **ONE** item as `n`
If `n` is **positive**, go to **next** profile
If `n` is **negative**, go to **prev** profile|
-|`GOTOP`|`84`/`0x54`| **Goto Profile**
Pop **ONE** item as `ADDR`
Retrieve zero-terminated string at `ADDR`
If resolves into an **integer `n`**
Go to `n`th profile.
Otherwise jump to profile name|
-|`SLEEP`|`85`/`0x55`| **Sleep**
Put duckyPad to sleep
Terminates execution|
-|`RANDCHR`|`86`/`0x56`| **Random Character**
Pop **ONE** item as bitmask.
Bit 0: Letter Lowercase
Bit 1: Letter Uppercase
Bit 2: Digits
Bit 3: Symbols
Bit 16: Type via Keyboard
Bit 17: Write to Screen Buffer|
-|`PUTS`|`87`/`0x57` |**Print String**
Pop **ONE** item off TOS
Bit 0-15: `ADDR`
Bit 16-23: `n`
Bit 30: Keyboard
Bit 31: OLED
Print string starting from `ADDR`
If `n=0`, print until zero-termination.
Else, print max `n` chars (or until `\0`).
|None|
-|`PWMCTL`|`88`/`0x58`| **PWM Control**
Pop **ONE** item off TOS
Details TBD|
-|`HIDTX`|`89`/`0x59`| Pop **ONE** item off TOS as `ADDR`
Read **9 bytes** from `ADDR`
Construct & send raw HID message
[See `HIDTX()` in duckyScript doc](https://github.com/dekuNukem/duckyPad-Pro/blob/dsvm2/doc/duckyscript_info.md#hidtxaddr)|
-
-
-## String Encoding
-
-The following commands involves user-provided strings:
-
-* `STRING`
-* `STRINGLN`
-* `OLED_PRINT`
-* `GOTO_PROFILE`
-
-Strings are **zero-terminated** and appended at the **end of the binary executable**.
-
-The **starting address** of a string is **pushed onto stack** before calling one of those commands, who pops off the address and fetch the string there.
-
-Identical strings are deduplicated and share the same address.
-
-```
-STRING Hello World!
-STRINGLN Hello World!
-OLED_PRINT Hi there!
-```
-```
-3 PUSHC16 16 0x10 ;STRING Hello World!
-6 STR ;STRING Hello World!
-7 PUSHC16 16 0x10 ;STRINGLN Hello World!
-10 STRLN ;STRINGLN Hello World!
-11 PUSHC16 29 0x1d ;OLED_PRINT Hi there!
-14 OLED_PRNT ;OLED_PRINT Hi there!
-15 HALT
-16 DATA: b'Hello World!\x00'
-29 DATA: b'Hi there!\x00'
-```
-
-## Printing Variables
-
-When printing a variable, its info is embedded into the string between **two separator bytes**.
-
-* `0x1f` for **Global Variables**
- * Contains: **Little-endian** memory address
- * `[0x1f][ADDR_LSB][ADDR_MSB][Format Specifiers][0x1f]`
-* `0x1e` for **Local variables & arguments inside functions**
- * Contains: **FP-Relative Offset**
- * `[0x1e][OFFSET_LSB][OFFSET_MSB][Format Specifiers][0x1e]`
-
-```
-VAR foo = 255
-STRING Count is: $foo%02x
-```
-```
-3 PUSHC16 255 0xff ;VAR foo = 255
-6 POPI 63488 0xf800 ;VAR foo = 255
-9 PUSHC16 14 0xe ;STRING Count is: $foo%02x
-12 STR ;STRING Count is: $foo%02x
-13 HALT
-14 DATA: b'Count is: \x1f\x00\xf8%02x\x1f\x00'
-```
-
-## Run-time Exceptions
-
-Exceptions such as Division-by-Zero, Stack Over/Underflow, etc, result in immediate termination of the VM execution.
-
-## Calling Convention
-
-* Multiple arguments, one return value.
-* Supports nested and recursive calls
-* **TOS** grows towards **smaller address**
-
-### Stack Set-up
-
-Outside function calls, FP points to **base of stack.**
-
-||...|
-|:--:|:--:|
-||...|
-|`FP ->`|Base (`F7FF`)|
-
-When calling a function: **`foo(a, b, c)`**
-
-* **Caller** pushes 32-bit arguments **right to left** to stack
- * Don't push if no args.
-
-|||
-|:--:|:--:|
-||`a`|
-||`b`|
-||`c`|
-||...|
-|`FP ->`|Base (`F7FF`)|
-
-Caller then executes `CALL` instruction, which:
-
-* Constructs a 32b value `frame_info`
- * Top 16b: `current_FP`
- * Bottom 16b: `return_address`
-* Pushes `frame_info` to TOS
-* Sets **FP** to TOS
-* Jumps to the function address
-
-|||
-|:--:|:--:|
-|`FP ->`|`Prev_FP \| Return_addr`|
-||`a`|
-||`b`|
-||`c`|
-||...|
-||Base (`F7FF`)|
-
-### Arguments / Locals
-
-Once in function, callee uses `ALLOC n` to make space for local variables.
-
-To reference arguments and locals, **FP + Byte_Offset** is used.
-
-* **Negative** offset towards **smaller address / TOS / locals**.
- * `FP - 4` points to **first local**, etc
-* **Positive** offset towards **larger address / base of stack / args**.
- * `FP + 4` points to **leftmost argument**, etc
-* Use `PUSHR + Offset` and `POPR + Offset` to read/write to args and locals.
-
-|||
-|:--:|:--:|
-||...|
-|`FP - 8`|`localvar_2`|
-|`FP - 4`|`localvar_1`|
-|`FP ->`|`Prev_FP \| Return_addr`|
-|`FP + 4`|`a`|
-|`FP + 8`|`b`|
-|`FP + 12`|`c`|
-||...|
-||Base (`F7FF`)|
-
-### Stack Unwinding
-
-At end of a function, `return_value` is on TOS.
-
-* If no explicit `RETURN` statement, **0 is returned**.
-
-|||
-|:--:|:--:|
-||`return_value`|
-||`temp data`|
-|`FP - 8`|`localvar_2`|
-|`FP - 4`|`localvar_1`|
-|`FP ->`|`Prev_FP \| Return_addr`|
-|`FP + 4`|`a`|
-|`FP + 8`|`b`|
-|`FP + 12`|`c`|
-||...|
-||Base (`F7FF`)|
-
-**Callee** executes `RET n` instruction, which:
-
-* Pops off `return_value` into temp location
-* Pop off items until `frame_info` is on **TOS**
- * AKA `SP + 4 == FP`
-* Pops off `frame_info`
- * Loads `previous FP` into **FP**
- * Loads `return address` into **PC**
-* Pops off `n` arguments
-* Pushes `return_value` back on TOS
-* Resumes execution at PC
-* Return value now on TOS for caller to use
-
-|||
-|:--:|:--:|
-||`return_val`|
-||...|
-|`FP ->`|Base (`F7FF`)|
-
-## Questions or Comments?
-
-Please feel free to [open an issue](https://github.com/dekuNukem/duckstack/issues), ask in the [official duckyPad discord](https://discord.gg/4sJCBx5), or email `dekuNukem`@`gmail`.`com`!
-
-## To mention in doc
-
-* Hardware RNG
- * Test in both bluetooth and wired more
-* How new GOTO_PROFILE works
-
-## Mentioned
-
-HIDTX
-mouse side buttons
-bluetooth 6KRO
-* Mild optimisations, smaller code size.
-* MOUSE_SCROLL
-* PUSH8
-* difference between signed and unsigned mode?
-* `FUN` and `END_FUN`
-* print format specifiers
-* new duckyscript random commands
-* AugAssign operator `+=, -=, etc`
-* RANDINT() function
-* PUTS() function
-* `THEN` no longer required
-
-* built-in functions
- * POKE8() and PEEK8()
- * RANDCHR(chr_info)
-
-* `_STR_PRINT_FORMAT` and `_STR_PRINT_PADDING` removed
diff --git a/src/test/dpds_stdlib_1767972735.txt b/src/test/dpds_stdlib_1767972735.txt
new file mode 100644
index 0000000..d6d4898
--- /dev/null
+++ b/src/test/dpds_stdlib_1767972735.txt
@@ -0,0 +1,154 @@
+// duckyPad duckyScript Standard Library
+// https://github.com/duckyPad/DPDS-Standard-Library
+
+// Comment Template:
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ What does it do, how to use.
+ Args:
+ If any
+ Returns:
+ If any
+ Additional Notes:
+ If any
+END_REM
+// define func here
+
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ Waits for a specific key to be pressed
+ Any other keypresses are ignored
+ Args:
+ key_id: The ID of the key to wait for (1-20 for keys, etc).
+ Returns:
+ None
+ Additional Notes:
+ None
+END_REM
+FUN WAITKEY(key_id)
+ BCLR
+ WHILE 1
+ IF _BLOCKING_READKEY == key_id
+ RETURN
+ END_IF
+ END_WHILE
+END_FUN
+
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ Fills a block of memory with byte value
+ Args:
+ addr: Starting address
+ value: Byte value (0-255) to write.
+ length: Number of bytes to write.
+ Returns:
+ None
+ Additional Notes:
+ Address should be within scratch memory
+END_REM
+FUN MEMSET(addr, value, length)
+ VAR i = 0
+ WHILE i < length
+ POKE8(addr + i, value)
+ i = i + 1
+ END_WHILE
+END_FUN
+
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ Returns the smaller of two numbers.
+ Args:
+ a: First number
+ b: Second number
+ Returns:
+ The smaller value between a and b.
+ Additional Notes:
+ Result is affected by the current _UNSIGNED_MATH mode.
+END_REM
+FUN MIN(a, b)
+ IF a < b
+ RETURN a
+ END_IF
+ RETURN b
+END_FUN
+
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ Returns the larger of two numbers.
+ Args:
+ a: First number
+ b: Second number
+ Returns:
+ The larger value between a and b.
+ Additional Notes:
+ Result is affected by the current _UNSIGNED_MATH mode.
+END_REM
+FUN MAX(a, b)
+ IF a > b
+ RETURN a
+ END_IF
+ RETURN b
+END_FUN
+
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ Returns the absolute (positive) value of a number.
+ Args:
+ n: The input integer.
+ Returns:
+ The absolute value of n.
+ Additional Notes:
+ Works with both math modes
+END_REM
+FUN ABS(n)
+ IF _UNSIGNED_MATH == 1
+ RETURN n
+ END_IF
+
+ IF n < 0
+ RETURN n * -1
+ END_IF
+
+ RETURN n
+END_FUN
+
+// --------------------
+REM_BLOCK
+ Author:
+ dekuNukem
+ Description:
+ Copies n bytes starting from address `src` to address `dest`
+ Args:
+ dest: Destination memory address
+ src: Source memory address
+ n: Number of bytes to copy
+ Returns:
+ None
+ Additional Notes:
+ Does NOT handle overlapping memory regions.
+END_REM
+FUN MEMCPY(dest, src, n)
+ VAR i = 0
+ WHILE i < n
+ POKE8(dest + i, PEEK8(src + i))
+ i += 1
+ END_WHILE
+END_FUN
\ No newline at end of file