Description

DM-System2 BASIC is a BASIC extension that is provided with the Gigamix DM-System2 development kit.

This extension adds 68 new instructions, whose 20 require to install specific drivers.

On this page, these instructions are classified according to their purpose. For a general overview of all instructions in alphabetical order, see this page : DM-System2 BASIC Instructions.

Installation

Installation of the DM-System2 Basic

You need three files from the first disk of the DM-System2 package : DISKINST.BAS - DISKINST.BIN - DS2INST.DAT

Enter SCREEN0:WIDTH80:RUN"DISKINST.BAS" to install the DM-System2 BASIC

The installer includes CLEAR 200, &HD800 to extend the free MSX-BASIC memory, BLOAD"DISKINST.BIN",R to install the system and the CALL SYSON instruction to start it and initialise it.

Notes:
- if you attempt to reinstall DM-System2 while it is already installed, the error "File already exists" will occur.
- the Memory Disk, initialised by CALL MEMINI, is not supported by DM-System2. Disable it with CALL MEMINI (0) before installing DM-System2 or your data will be corrupted.

Installation of the drivers

By default, if you use the first disk of the DM-System2 package, the following drivers are installed: BGM-MGS, DEV-NORM, FNT-KROM, PCM-PSG and SE-NSE.

If you create your own installation disk, don't forget to put on the same disk different drivers, at least one per category (BGM, Device, Font, PCM, Sound Effect). So, you will be able to enjoy all the features of the DM-System2 Basic.

You can manually install your preferred driver in each category, check the DM-System2 Drivers page to know how to proceed. You can also use the DM-System2 Setup Utility (DS2SETUP.BAS), except for the Sound Effect driver.

Instructions with driver required

Music Playing

These instructions have a timer interrupt of 1/60 per second (in NTSC/PAL M). The instructions can be disabled or their effects can change according the driver specifications. You must refer you to the driver specifications to use these instructions.

• CALL BGMON
• CALL BGMOFF
• CALL BGMTMP
• CALL BGMTRS
• CALL BGMVOL
• CALL BGMWAIT

Device Input

These instructions allow you to globally manage several input devices. Simply change the driver to manage another external device.

• CALL DMMINI
• CALL DMM
• CALL DMMON
• CALL DMMOFF

Kanji-ROM Characters Display

These instructions to display Kanji are delivered with conviction. You can display a variety of fonts just by changing the driver. Driver designed by default is the FNT-KROM driver (developed by Gigamix).

• CALL KINIT
• CALL KBOLD
• CALL KCOLOR
• CALL KPRINT
• CALL KPUT
• CALL KSIZE

A seventh instruction was planned, but does not have been implemented.

PCM Playing

This instruction can play PCM from the MSX2. By changing the driver, it will be capable of playing a variety of sound sources. Driver designed by default is the PCM-PSG driver (developed by Kichi).

• CALL PCMON

Sound Effect

Sound effect instructions are indispensable to made a game. The instructions can be disabled or their effects can change according the driver specifications. You must refer you to the driver specifications to use these instructions.

• CALL SEON
• CALL SEOFF
• CALL SETSE

Instructions without driver required

Data Compression

These instructions use a technology called BPE compression that allows a high-speed decompression of data.

• CALL EXT
• CALL EXTCOPY

There are three tools to compress data to BPE format. Please check this page: DM-System2 Compression Tools

Image Processing

These instructions appreciably improve the image processing of the MSX-Basic.

• CALL CELLO
• CALL HMMM
• CALL HMMV
• CALL LMMM
• CALL LMMV
• CALL YMMM
• CALL VCOPY

Palette Processing & VDP Macro

These functions allows to make a maximum management of MSX2 palette. These possibilities are unthinkable with a standard MSX-BASIC program.

• CALL SETPLT
• CALL CHGPLT
• CALL VMON
• CALL VMOFF
• CALL VMWAIT
• CALL COLOR=

Pana Amusement Cartridge (PAC)

These instructions allow you to manage data from PAC.

• CALL PACLOAD
• CALL PACSAVE

Memory Mapper Control

This instruction allow you to freely access RAM above 64kB.

• CALL MALLOC

Binary System

VRAM can be a big storage place for data. These instructions allow you to use it as such

• CALL SETBIN
• CALL BINLOAD

Memory Handling

These instructions allow you to read/write directly a byte or an address in main RAM, and even copy a block.

• CALL BLOCK
• CALL PEEK
• CALL PEEKS
• CALL PEEKW
• CALL POKE
• CALL POKES
• CALL POKEW

Calling Machine Language Routine

This instruction is easier than DEFUSR= to use CPU registers.

• CALL CALL

CPU Mode Switching

This instruction allow you to switch CPU mode on MSX turbo R.

• CALL CHGCPU

Disk/File Operations

• CALL CHGDRV
• CALL FILES
• CALL FSIZE
• CALL LOAD
• CALL SAVE

Trigonometric Functions

These trigonometric functions are a bit more evolved than those from MSX-Basic.

• CALL COS
• CALL SIN

Pending Processing

• CALL INTWAIT
• CALL PAUSE
• CALL VDPWAIT
• CALL WAIT

Case Conversion

Only the uppercase conversion is available.

• CALL UPPER

Characters Switching

• CALL CHGCHR (not fully implemented)

Graphic Accumulator

The graphic accumulator can be useful to place a character on the screen for example.

• CALL XY

DM-System2 Control

These instructions allow you to install, uninstall DM-system2 or get information about drivers.

• CALL HELP
• CALL STATUS
• CALL SYSON
• CALL SYSOFF
• CALL SYSTEM

DM-System2 Memory Map