mirror of
https://github.com/duckyPad/duckyPad-Configurator.git
synced 2026-11-19 12:19:07 +01:00
stdlib docs button works
This commit is contained in:
+9
-17
@@ -2,20 +2,7 @@ import os
|
|||||||
import time
|
import time
|
||||||
import requests
|
import requests
|
||||||
from enum import IntEnum
|
from enum import IntEnum
|
||||||
|
import webbrowser
|
||||||
"""
|
|
||||||
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
|
|
||||||
"""
|
|
||||||
|
|
||||||
default_stdlib_code = """
|
default_stdlib_code = """
|
||||||
|
|
||||||
@@ -117,7 +104,12 @@ class stdlib_fetch_result(IntEnum):
|
|||||||
NETWORK_ERROR = 2
|
NETWORK_ERROR = 2
|
||||||
OTHER_ERROR = 3
|
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
|
STDLIB_CHECK_INTERVAL_HOURS = 12
|
||||||
|
|
||||||
def fetch_update(stdlib_path, force_fetch=False):
|
def fetch_update(stdlib_path, force_fetch=False):
|
||||||
@@ -175,5 +167,5 @@ def fetch_update(stdlib_path, force_fetch=False):
|
|||||||
except Exception:
|
except Exception:
|
||||||
return stdlib_fetch_result.OTHER_ERROR
|
return stdlib_fetch_result.OTHER_ERROR
|
||||||
|
|
||||||
result = fetch_update("./test")
|
# result = fetch_update("./test")
|
||||||
print(result)
|
# print(result)
|
||||||
@@ -20,7 +20,7 @@ import traceback
|
|||||||
import dp20_dumpsd
|
import dp20_dumpsd
|
||||||
from tkinter import font
|
from tkinter import font
|
||||||
import dsvm_preprocessor
|
import dsvm_preprocessor
|
||||||
from ds_stdlib import *
|
import ds_stdlib
|
||||||
|
|
||||||
"""
|
"""
|
||||||
0.13.5
|
0.13.5
|
||||||
@@ -207,8 +207,8 @@ ensure_dir(app_save_path)
|
|||||||
ensure_dir(backup_path)
|
ensure_dir(backup_path)
|
||||||
ensure_dir(hid_dump_path)
|
ensure_dir(hid_dump_path)
|
||||||
|
|
||||||
ensure_dpds_stdlib(ext_lib_path)
|
ds_stdlib.ensure_dpds_stdlib(ext_lib_path)
|
||||||
this_global_setting.stdlib_line_list = get_latest_stdlib_lines(ext_lib_path)
|
this_global_setting.stdlib_line_list = ds_stdlib.get_latest_stdlib_lines(ext_lib_path)
|
||||||
|
|
||||||
print("\n\n--------------------------")
|
print("\n\n--------------------------")
|
||||||
print("\n\nWelcome to duckyPad Configurator!\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 = Frame(stdlib_frame)
|
||||||
stdlib_btn_container.pack(side="bottom", fill="x", padx=5, pady=5)
|
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_stdlib_docs.pack(side="left", fill="x", expand=True, padx=(0, 2))
|
||||||
|
|
||||||
btn_fetch_latest = Button(stdlib_btn_container, text="Fetch Latest")
|
btn_fetch_latest = Button(stdlib_btn_container, text="Fetch Latest")
|
||||||
|
|||||||
+1
-3
@@ -4,11 +4,9 @@ import webbrowser
|
|||||||
from platformdirs import *
|
from platformdirs import *
|
||||||
from pathlib import Path
|
from pathlib import Path
|
||||||
from hid_common import *
|
from hid_common import *
|
||||||
|
|
||||||
from dsvm_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_PROFILE_NAME_LEN = 16
|
||||||
MAX_EXPANSION_MODULE_COUNT = 4
|
MAX_EXPANSION_MODULE_COUNT = 4
|
||||||
|
|||||||
@@ -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`<br>`F7FF` |Shared<br>**Executable**<br>and **Stack**|63488 Bytes|See Notes Below|
|
|
||||||
|`F800`<br>`F9FF` |User-defined<br>Global<br>Variables|512 Bytes<br>4 Bytes/Entry<br>128 Entries|ZI Data|
|
|
||||||
|`FA00`<br>`FAFF` |Scratch<br>Memory|256 Bytes|General-purpose<br>User-accessible|
|
|
||||||
|`FB00`<br>`FCFF` |Unused|512 Bytes||
|
|
||||||
|`FD00`<br>`FDFF` |Persistent<br>Global<br>Variables|256 Bytes<br>4 Bytes/Entry<br>64 Entries |Non-volatile Data<br>Saved on SD card|
|
|
||||||
|`FE00`<br>`FFFF` |VM<br>Reserved<br>Variables|512 Bytes<br>4 Bytes/Entry<br>128 Entries|Read/Adjust<br>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.<br>Size|Opcode<br>Byte 0|Comment|Payload<br>Byte 1-2|
|
|
||||||
|:-:|:-:|:-:|:-:|:-:|
|
|
||||||
|`NOP`|1|`0`/`0x0` |Do nothing|None|
|
|
||||||
|`PUSHC16`|3|`1`/`0x1` |Push an **unsigned 16-bit (0-65535)** constant on stack<br>For negative numbers, push abs then use `USUB`.|2 Bytes:<br>`CONST_LSB`<br>`CONST_MSB` |
|
|
||||||
|`PUSHI`|3|`2`/`0x2` |Read **4 Bytes** at `ADDR`<br>Push to stack as one **32-bit** number|2 Bytes:<br>`ADDR_LSB`<br>`ADDR_MSB`|
|
|
||||||
|`PUSHR`|3|`3`/`0x3`|Read **4 Bytes** at **offset from FP**<br>Push to stack as one **32-bit** number|2 Bytes:<br>`OFFSET_LSB`<br>`OFFSET_MSB`|
|
|
||||||
|`POPI`|3|`4`/`0x4` |Pop one item off TOS<br>Write **4 bytes** to `ADDR`|2 Bytes:<br>`ADDR_LSB`<br>`ADDR_MSB`|
|
|
||||||
|`POPR`|3|`5`/`0x5`|Pop one item off TOS<br>Write as **4 Bytes** at **offset from FP**|2 Bytes:<br>`OFFSET_LSB`<br>`OFFSET_MSB`|
|
|
||||||
|`BRZ`|3|`6`/`0x6` |Pop one item off TOS<br>If value is zero, jump to `ADDR` |2 Bytes:<br>`ADDR_LSB`<br>`ADDR_MSB`|
|
|
||||||
|`JMP`|3|`7`/`0x7` |Unconditional Jump|2 Bytes:<br>`ADDR_LSB`<br>`ADDR_MSB`|
|
|
||||||
|`ALLOC`|3|`8`/`0x8` |Push `n` blank entries to stack<br>Used to allocate local variables<br>on function entry|2 Bytes:<br>`n_LSB`<br>`n_MSB`|
|
|
||||||
|`CALL`|3|`9`/`0x9` |Construct 32b value `frame_info`:<br>Top 16b `current_FP`,<br>Bottom 16b `return_addr (PC+3)`.<br>Push `frame_info` to TOS<br>Set **FP** to TOS<br>Jump to `ADDR`|2 Bytes:<br>`ADDR_LSB`<br>`ADDR_MSB`|
|
|
||||||
|`RET`|3|`10`/`0xa` |`return_value` on TOS<br>Pop `return_value` into temp location<br>Pop items until TOS is `FP`<br>Pop `frame_info`, restore **FP** and **PC**.<br>Pop off `ARG_COUNT` items<br>Push `return_value` back on TOS<br>Resumes execution at PC|2 Bytes:<br>`ARG_COUNT`<br>`Reserved`|
|
|
||||||
|`HALT`|1|`11`/`0xb` |Stop execution|None|
|
|
||||||
|`PEEK8`|1|`12`/`0xc` |Pop **ONE** item off TOS as `ADDR`<br>`ADDR <= End of Scratch Memory`<br>Read **ONE byte** at `ADDR`<br>Push on stack|None|
|
|
||||||
|`POKE8`|1|`13`/`0xd` |Pop **TWO** item off TOS<br>First `ADDR`, then `VAL`.<br>`ADDR <= End of Scratch Memory`<br>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<br>First `Upper`, then `Lower`.<br>Push a random number inbetween (**inclusive**) on TOS|None|
|
|
||||||
|`PUSHC32`|5|`19`/`0x13` |Push an **unsigned 32-bit** constant on stack<br>For negative numbers, push abs then use `USUB`.|4 Bytes<br>`CONST_LSB`<br>`CONST_B1`<br>`CONST_B2`<br>`CONST_MSB`|
|
|
||||||
|`PUSHC8`|2|`20`/`0x14` |Push an **unsigned 8-bit (0-255)** constant on stack<br>For negative numbers, push abs then use `USUB`.|1 Byte|
|
|
||||||
|`VMVER`|3|`255`/`0xff`| VM Version Check<br>Abort if mismatch |2 Bytes:<br>`VM_VER`<br>`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<br>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<br>Signed Mode: Arithmetic (sign-extend)<br>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<br>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<br>Byte 0|Comment|
|
|
||||||
|:-------:|:----------:|:---------:|
|
|
||||||
|`DELAY`|`64`/`0x40`| **Delay**<br>Pop **ONE** item<br>Delay amount in **milliseconds**|
|
|
||||||
|`KDOWN`|`65`/`0x41`| **Press Key**<br>Pop **ONE** item<br>`\|MSB\|B2\|B1\|LSB`<br>`\|Unused\|Unused\|KeyType\|KeyCode\|`|
|
|
||||||
|`KUP`|`66`/`0x42`|**Release Key**<br>Pop **ONE** item<br>`\|MSB\|B2\|B1\|LSB`<br>`\|Unused\|Unused\|KeyType\|KeyCode\|`|
|
|
||||||
|`MSCL`|`67`/`0x43`| **Mouse Scroll**<br>Pop **TWO** items<br>First `hline`, then `vline`<br>Scroll `hline` horizontally<br>`(Positive: RIGHT, Negative: LEFT)`<br>Scroll `vline` vertically<br>`(Positive: UP, Negative: DOWN)`|
|
|
||||||
|`MMOV`|`68`/`0x44`|**Mouse Move**<br>Pop **TWO** items: `x` then `y`<br>`x`: Positive RIGHT, Negative LEFT.<br>`y`: Positive UP, Negative DOWN.|
|
|
||||||
|`SWCF`|`69`/`0x45`| **Switch Color Fill**<br>Pop **THREE** items<br>`Red, Green, Blue`<br>Set ALL LED color to the RGB value|
|
|
||||||
|`SWCC`|`70`/`0x46`| **Switch Color Change**<br>Pop **FOUR** item<br>`N, Red, Green, Blue`<br>Set N-th switch to the RGB value<br>If N is 0, set current switch.|
|
|
||||||
|`SWCR`|`71`/`0x47`| **Switch Color Reset**<br>Pop **ONE** item<br>If value is 0, reset color of current key<br>If value is between 1 and 20, reset color of that key<br>If value is 99, reset color of all keys.|
|
|
||||||
|`STR`|`72`/`0x48`|**Type String**<br>Pop **ONE** item as `ADDR`<br>Print zero-terminated<br>string at `ADDR`|None||
|
|
||||||
|`STRLN`|`73`/`0x49`|**Type Line**<br>Pop **ONE** item as `ADDR`<br>Print zero-terminated<br>string at `ADDR`<br>**Press ENTER at end**|
|
|
||||||
|`OLED_CUSR`|`74`/`0x4a`|**OLED Set Cursor**<br>Pop **TWO** items: `x` then `y`||
|
|
||||||
|`OLED_PRNT`|`75`/`0x4b`|**OLED Print**<br>Pop **ONE** item as `ADDR`<br>Print zero-terminated<br>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**<br>Pop **FOUR** items<br>`x1, y1, x2, y2`<br>Draw single-pixel line in-between|
|
|
||||||
|`OLED_RECT`|`80`/`0x50`|**OLED Draw Rectangle**<br>Pop **FIVE** items<br>`fill, x1, y1, x2, y2`<br>Draw rectangle between two points<br>Fill if `fill` is non-zero|
|
|
||||||
|`OLED_CIRC`|`81`/`0x51`|**OLED Draw Circle**<br>Pop **FOUR** items<br>`fill, radius, x, y`<br>Draw circle with `radius` at `(x,y)`<br>Fill if `fill` is non-zero|
|
|
||||||
|`BCLR`|`82`/`0x52`|**Clear switch event queue**|
|
|
||||||
|`SKIPP`|`83`/`0x53`| **Skip Profile**<br>Pop **ONE** item as `n`<br>If `n` is **positive**, go to **next** profile<br>If `n` is **negative**, go to **prev** profile|
|
|
||||||
|`GOTOP`|`84`/`0x54`| **Goto Profile**<br>Pop **ONE** item as `ADDR`<br>Retrieve zero-terminated string at `ADDR`<br>If resolves into an **integer `n`**<br>Go to `n`th profile.<br>Otherwise jump to profile name|
|
|
||||||
|`SLEEP`|`85`/`0x55`| **Sleep**<br>Put duckyPad to sleep<br>Terminates execution|
|
|
||||||
|`RANDCHR`|`86`/`0x56`| **Random Character**<br>Pop **ONE** item as bitmask.<br>Bit 0: Letter Lowercase<br>Bit 1: Letter Uppercase<br>Bit 2: Digits<br>Bit 3: Symbols<br>Bit 16: Type via Keyboard<br>Bit 17: Write to Screen Buffer|
|
|
||||||
|`PUTS`|`87`/`0x57` |**Print String**<br>Pop **ONE** item off TOS<br>Bit 0-15: `ADDR`<br>Bit 16-23: `n`<br>Bit 30: Keyboard<br>Bit 31: OLED<br>Print string starting from `ADDR`<br>If `n=0`, print until zero-termination.<br>Else, print max `n` chars (or until `\0`).<br>|None|
|
|
||||||
|`PWMCTL`|`88`/`0x58`| **PWM Control**<br>Pop **ONE** item off TOS<br>Details TBD|
|
|
||||||
|`HIDTX`|`89`/`0x59`| Pop **ONE** item off TOS as `ADDR`<br>Read **9 bytes** from `ADDR`<br>Construct & send raw HID message<br>[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
|
|
||||||
@@ -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
|
||||||
Reference in New Issue
Block a user