User Plug In - Chysn/VIC20-wAx2 GitHub Wiki

wAx has a vector to a user-defined plug-in program, which can be called with the User Plug-In Tool:

.U [parameters]

parameters is user-defined, based on the plug-in's requirements.

The vector to the plug-in is at memory locations $0005 and $0006. When wAx is initialized, this vector is pointed at either the Memory Configuration plug-in (for wAxpander), or the Relocate plug-in.

A well-constructed wAx2 plug-in will show a usage template when you enter

.U?

The template will also appear when you install the plug-in with the Plug-In Manager (see below).

User Plug-In Manager

wAx has a selection of built-in user plug-ins. A menu may be accessed with the Plug-In Manager:

.P

You may choose which plug-in to install by cursoring up to the plug-in and pressing RETURN. Note that the Plug-In Manager requires only the first two characters to locate the plug-in, so you can install a plug-in with a shortcut at any time. For example,

.P "DE" ; Installs DEBUG

The menu will also show the address for the current plug-in, the type of plug-in (NORMAL or LIST), and the current plug-in's usage template.

You may install other plug-ins by providing the plug-in's address:

.P [addr]

Where addr is a 16-bit hexadecimal address. See here for information about developing your own plug-ins.

Included Plug-Ins

The wAx2 distribution has the following build-in plug-ins available for your convenience:

• Relocate - Update addresses to move code to a new range
• Debug - Stop code for inspection and continue running
• ML to BASIC - Generate BASIC loaders or unit tests for wAx
• Character Helper - Design custom characters and store them in memory
• BASIC Aid - Renumber and link BASIC stages
• wAxfer - High-speed Bluetooth transfer from PC to VIC-20