Category:MSX-AUDIO BASIC
This page was last modified 22:05, 23 August 2018 by Mars2000you. Based on work by Gdx.

Contents

Description

MSX-AUDIO BASIC is a BASIC extension that is only included on the complete MSX-AUDIO cartridge, the Panasonic FS-CA1. However, it is possible to upgrade the other MSX-AUDIO cartridges: Philips NMS 1205 (Music Module) and Toshiba HX-MU900 (FM-synthesizer unit).

Note that the extra instructions linked to a built-in software (CALL SYNTHE, CALL MUSICBOX) are not part of the MSX-AUDIO BASIC instructions.

Instructions

MSX-AUDIO BASIC extends the PLAY instruction and adds 36 new instructions, that can be generally divided into four types.

Note: CALL can be replaced by the character underscore (_). A space is not required after this character. See CALL for more info.

Instruction Generation Type
CALL APEEK MSX1 General instruction
CALL APOKE MSX1 General instruction
CALL APPEND MK MSX1 Music Keyboard instruction
CALL AUDIO MSX1 General instruction
CALL AUDREG MSX1 General instruction
CALL BGM MSX1 General instruction
CALL CONT MK MSX1 Music Keyboard instruction
CALL CONVA MSX1 ADPCM/PCM instruction
CALL CONVP MSX1 ADPCM/PCM instruction
CALL COPY PCM MSX1 ADPCM/PCM instruction
CALL INMK MSX1 Instrument instruction
CALL KEY OFF MSX1 Instrument instruction
CALL KEY ON MSX1 Instrument instruction
CALL LOAD PCM MSX1 ADPCM/PCM instruction
CALL MK PCM MSX1 Instrument instruction
CALL MK STAT MSX1 Music Keyboard instruction
CALL MK TEMPO MSX1 Instrument instruction
CALL MK VEL MSX1 Instrument instruction
CALL MK VOICE MSX1 Instrument instruction
CALL MK VOL MSX1 Instrument instruction
CALL PCM FREQ MSX1 ADPCM/PCM instruction
CALL PCM VOL MSX1 ADPCM/PCM instruction
CALL PITCH MSX1 General instruction
CALL PLAY MSX1 General instruction
CALL PLAY MK MSX1 Music Keyboard instruction
CALL PLAY PCM MSX1 ADPCM/PCM instruction
CALL REC MK MSX1 Music Keyboard instruction
CALL RECMOD MSX1 Music Keyboard instruction
CALL REC PCM MSX1 ADPCM/PCM instruction
CALL SAVE PCM MSX1 ADPCM/PCM instruction
CALL SET PCM MSX1 ADPCM/PCM instruction
CALL STOPM MSX1 General instruction
CALL TEMPER MSX1 General instruction
CALL TRANSPOSE MSX1 General instruction
CALL VOICE MSX1 General instruction
CALL VOICE COPY MSX1 General instruction


General instructions

Most of these MSX-AUDIO BASIC commands are also used by the MSX-MUSIC BASIC, sometimes they work a little differently.

Note that
- CALL AUDIO is replaced by CALL MUSIC in MSX-MUSIC BASIC
- in version 1.3 of the MSX-AUDIO BIOS, CALL MUSIC can also initialize MSX-AUDIO
- CALL APEEK and CALL APOKE are not available in MSX-MUSIC BASIC

  • CALL APEEK(Adrs,Var)
    • Reads a byte into system memory of the MSX-AUDIO.
      • Adrs = address in MSX-AUDIO RAM. (0000h~7FFFh, if a higher address is used, this instruction has the same effect as PEEK.)
        Var = Variable to receive the address read. (0~255)
  • CALL APOKE(Adrs,Val)
    • Writes a byte in system memory of the MSX-AUDIO.
      • Adrs = address in MSX-AUDIO RAM. (0000h~7FFFh, if a higher address is used, this instruction has the same effect as POKE)
        Val = Value. (0~255)

ADPCM/PCM instructions

  • CALL CONVA(Sfn,Dfn)
    • Converts PCM data to ADPCM data.
      • Sfn = source file number.
        Dfn = destination file number.
  • CALL CONVP(Sfn,Dfn)
    • Converts ADPCM data to PCM data.
      • Sfn = source file number.
        Dfn = destination file number.
  • CALL COPY PCM(Sfn,Dfn,Ofs1,Len,Ofs2)
    • Copies ADPCM/PCM data.
      • Sfn = source file number.
        Dfn = destination file number.
        Ofs1 = Offset 1.
        Len (optional) = length.
        Ofs2 (optional) = Offset 2.
  • CALL LOAD PCM("FileName",Fn)
    • Loads ADPCM/PCM data from disk.
      • FileName = file name. (Drive name or device name is possible)
        Fn = file number.
  • CALL PCM FREQ
    • Gives the sampling frequency playing in local mode that use the external RAM/ROM of ADPCM/PCM.
  • CALL PCM VOL
    • Sets the volume of ADPCM/PCM to play.
  • CALL PLAY PCM
    • Plays ADPCM/PCM data.
  • CALL REC PCM
    • Digitizes the sound as ADPCM/PCM data.
  • CALL SAVE PCM("FILENAME", #n)
    • Saves ADPCM/PCM data to disk
  • CALL SET PCM
    • Initializes the parameters of ADPCM/PCM voice file.

Instrument instructions

  • CALL INMK
    • Informs the Music Keyboard status change.
  • CALL KEY OFF
    • Gives the key to OFF for instruments.
  • CALL KEY ON
    • Gives the key to ON for instruments.
  • CALL MK PCM
    • Indicates the ADPCM sound file number to play as instrument.
  • CALL MK TEMPO
    • Sets the speed of metronome function or the Music Keyboard performance recording.
  • CALL MK VEL
    • Sets the velocity of voice.
  • CALL MK VOICE
    • Sets the voice of instrument that can be played with the Music keyboard.
  • CALL MK VOL
    • Sets the voice volume of instrument.

MK (Music Keyboard) instructions

  • CALL APPEND MK
    • Appends a supplementary recording played with the MK.
  • CALL MK STAT
    • Informs on status system for a recording from the MK.
  • CALL PLAY MK
    • Plays a recording from the MK.
  • CALL REC MK
    • Records the music played from the MK.

Pages in category "MSX-AUDIO BASIC"

The following 13 pages are in this category, out of 13 total.

C

C cont.

C cont.

P