Skip to content

User Plug In

Jump to bottom
Chysn edited this page Feb 12, 2022 · 15 revisions

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
Clone this wiki locally