Category:MSX-AUDIO BASIC
This page was last modified 22:34, 2 December 2016 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.

Instruction Generation Short instruction Type
CALL APEEK MSX1 _APEEK General instruction
CALL APOKE MSX1 _APOKE General instruction
CALL APPEND MK MSX1 _APPEND MK Music Keyboard instruction
CALL AUDIO MSX1 _AUDIO General instruction
CALL AUDREG MSX1 _AUDREG General instruction
CALL BGM MSX1 _BGM General instruction
CALL CONT MK MSX1 _CONT MK Music Keyboard instruction
CALL CONVA MSX1 _CONVA ADPCM/PCM instruction
CALL CONVP MSX1 _CONVP ADPCM/PCM instruction
CALL COPY PCM MSX1 _COPY PCM ADPCM/PCM instruction
CALL INMK MSX1 _INMK Instrument instruction
CALL KEY OFF MSX1 _KEY OFF Instrument instruction
CALL KEY ON MSX1 _KEY ON Instrument instruction
CALL LOAD PCM MSX1 _LOAD PCM ADPCM/PCM instruction
CALL MK PCM MSX1 _MK PCM Instrument instruction
CALL MK STAT MSX1 _MK STAT Music Keyboard instruction
CALL MK TEMPO MSX1 _MK TEMPO Instrument instruction
CALL MK VEL MSX1 _MK VEL Instrument instruction
CALL MK VOICE MSX1 _MK VOICE Instrument instruction
CALL MK VOL MSX1 _MK VOL Instrument instruction
CALL PCM FREQ MSX1 _PCM FREQ ADPCM/PCM instruction
CALL PCM VOL MSX1 _PCM VOL ADPCM/PCM instruction
CALL PITCH MSX1 _PITCH General instruction
CALL PLAY MSX1 _PLAY General instruction
CALL PLAY MK MSX1 _PLAY MK Music Keyboard instruction
CALL PLAY PCM MSX1 _PLAY PCM ADPCM/PCM instruction
CALL REC MK MSX1 _REC MK Music Keyboard instruction
CALL RECMOD MSX1 _RECMOD Music Keyboard instruction
CALL REC PCM MSX1 _REC PCM ADPCM/PCM instruction
CALL SAVE PCM MSX1 _SAVE PCM ADPCM/PCM instruction
CALL SET PCM MSX1 _SET PCM ADPCM/PCM instruction
CALL STOPM MSX1 _STOPM General instruction
CALL TEMPER MSX1 _TEMPER General instruction
CALL TRANSPOSE MSX1 _TRANSPOSE General instruction
CALL VOICE MSX1 _VOICE General instruction
CALL VOICE COPY MSX1 _VOICE COPY 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)
  • CALL AUDREG(Reg,Dat,Chan)
    • Writes a value into a register of the MSX-AUDIO LSI.
      • Reg = register number.
        Dat = data. (0~255)
        Chan (optional) = Channel number. (0 or 1)
  • CALL VOICE(v1,v2, ... ,v9)
    • Sets a tone for FM sound source voices.
      • vx = @+tone number or variables array. (vx = 0~63 if system library tone, 0~31 if offset)
  • CALL VOICE COPY(Param1,Param2)
    • Copies the data of tone parameters for a voice.
      • Param1 = parameter for source tone. (@+tone number or *)
        Param2 = parameter for destination. (@+tone number, Name or variables array)

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 10 pages are in this category, out of 10 total.

C

C cont.

C cont.

P