Formerly undocumented STOS extension now documented.

STOS-related stuff in here please

Moderators: exxos, simonsunnyboy, Mug UK, Zorro 2, Moderator Team

Stethane
Atari freak
Atari freak
Posts: 64
Joined: Sun Mar 13, 2005 4:51 pm

Formerly undocumented STOS extension now documented.

Postby Stethane » Wed Jan 28, 2015 4:13 pm

There is an obscure STOS extension which has the filename, MONST_C1.EXK and MONST_C1.ECK is the compiler counterpart. No documentation existed for it, so I went ahead and made some.

This extension is for playing MusicMon v1 files, and for turning mouse reporting off and on.

The extension files are named: MONST_C1.EXK and MONST_C1.ECK for the interpreter and compiler extensions respectively.

The extension has 3 commands:

mausaus - Turns off mouse reporting
mausan - Turns on mouse reporting.

monstplay - Play or stop a MusicMon module. Takes 2 parameters.
To play a module, the parameters are 1,[module address].
To stop a module the parameter is 0,[anything].

Note that with the interpreter extension, you can stop the music with just "monstplay 0", but when you compile it, it expects 2 parameters.

You load a music mon v1 song into a bank and use the monstplay command to play and stop it.

e.g.

Code: Select all

10 erase 15
20 reserve as data 15,2000
30 bload "DEMO.MMM",15
40 monstplay 1,start(15)
50 wait key
60 monstplay 0,0


NOTE: This is not the official documentation, since the extension did not come with any. This information was found by experimentation.

A copy of the extension can be found in Tony Greenwood's STOS archive file found at: ftp://ftp.atari.org/pub/stos/bullis1_TGreenwoodSTOS.zip

Within that zip file you'd navigate into: stos\Stosbits.zip\Extensio\MOST____.EXT\

PS: I made this documentation as part of a much bigger STOS project I've been working on for a while now. It will soon be ready for release. Watch this space...
Last edited by Stethane on Wed Jan 28, 2015 8:14 pm, edited 1 time in total.

User avatar
exxos
Hardware Guru
Hardware Guru
Posts: 4933
Joined: Fri Mar 28, 2003 8:36 pm
Location: England
Contact:

Re: Formerly undocumented STOS extension now documented.

Postby exxos » Wed Jan 28, 2015 4:25 pm

Nice :) I never seen that extension AFAIK. Its on my to do list to sort though TG's stuff..
4MB STFM 1.44 FD- VELOCE+ 020 STE - Falcon 030 CT60 - Atari 2600 - Atari 7800 - Gigafile - SD Floppy Emulator - PeST - various clutter

http://www.exxoshost.co.uk/atari/ All my hardware guides - mods - games - STOS
http://www.exxoshost.co.uk/atari/last/storenew/ - All my hardware mods for sale - Please help support by making a purchase.
http://ataristeven.exxoshost.co.uk/Steem.htm Latest Steem Emulator

User avatar
bullis1
Fuji Shaped Bastard
Fuji Shaped Bastard
Posts: 2301
Joined: Tue Dec 12, 2006 2:32 pm
Location: Canada
Contact:

Re: Formerly undocumented STOS extension now documented.

Postby bullis1 » Thu Jan 29, 2015 6:21 pm

Nice work Stethane! I was previously baffled by those files. It turns out they are actually pretty handy! MusicMon is certaintly one of the best trackers for the ST.
Member of the Atari Legend team

User avatar
exxos
Hardware Guru
Hardware Guru
Posts: 4933
Joined: Fri Mar 28, 2003 8:36 pm
Location: England
Contact:

Re: Formerly undocumented STOS extension now documented.

Postby exxos » Thu Jan 29, 2015 6:25 pm

So where to get MM files ??
4MB STFM 1.44 FD- VELOCE+ 020 STE - Falcon 030 CT60 - Atari 2600 - Atari 7800 - Gigafile - SD Floppy Emulator - PeST - various clutter

http://www.exxoshost.co.uk/atari/ All my hardware guides - mods - games - STOS
http://www.exxoshost.co.uk/atari/last/storenew/ - All my hardware mods for sale - Please help support by making a purchase.
http://ataristeven.exxoshost.co.uk/Steem.htm Latest Steem Emulator

User avatar
exxos
Hardware Guru
Hardware Guru
Posts: 4933
Joined: Fri Mar 28, 2003 8:36 pm
Location: England
Contact:

Re: Formerly undocumented STOS extension now documented.

Postby exxos » Thu Jan 29, 2015 6:27 pm

MMM_PLAY.zip
Steem__00001.png


Is that the same thing ?
You do not have the required permissions to view the files attached to this post.
4MB STFM 1.44 FD- VELOCE+ 020 STE - Falcon 030 CT60 - Atari 2600 - Atari 7800 - Gigafile - SD Floppy Emulator - PeST - various clutter

http://www.exxoshost.co.uk/atari/ All my hardware guides - mods - games - STOS
http://www.exxoshost.co.uk/atari/last/storenew/ - All my hardware mods for sale - Please help support by making a purchase.
http://ataristeven.exxoshost.co.uk/Steem.htm Latest Steem Emulator

Stethane
Atari freak
Atari freak
Posts: 64
Joined: Sun Mar 13, 2005 4:51 pm

Re: Formerly undocumented STOS extension now documented.

Postby Stethane » Thu Jan 29, 2015 9:39 pm

exxos wrote:Is that the same thing ?
MMM_PLAY was included in STOSSER issue 9. It uses the binary replay routine which was included with the Music Mon program. The replay routine is loaded into a memory bank and called using the STOS "areg" and "call" commands.

The extension contains the same replay routine but puts the usage into a command instead ("monstplay").

You can download a copy of Music Mon v1 from: http://www.emuparadise.me/Atari_ST_ROMs/MusicMon_(1991)(Galactic)/118768

The replay routine used both in the MMM_Play example and the extension is called MUSICVBL.INC and is within the INCLUDE.SNG folder on the Music Mon disk.

Music Mon has some example songs with .SNG extensions but these can be saved as a module from within the program. At least I think that's how it worked...

User avatar
bullis1
Fuji Shaped Bastard
Fuji Shaped Bastard
Posts: 2301
Joined: Tue Dec 12, 2006 2:32 pm
Location: Canada
Contact:

Re: Formerly undocumented STOS extension now documented.

Postby bullis1 » Fri Jan 30, 2015 5:05 pm

Various versions of MusicMon can be downloaded here: http://dhs.nu/files.php?t=chipeditor

I wonder if songs created with the latest version of MusicMon can still be accurately played with this extension? Probably not...
Member of the Atari Legend team

Stethane
Atari freak
Atari freak
Posts: 64
Joined: Sun Mar 13, 2005 4:51 pm

Re: Formerly undocumented STOS extension now documented.

Postby Stethane » Fri Jan 30, 2015 7:39 pm

bullis1 wrote:Various versions of MusicMon can be downloaded here: http://dhs.nu/files.php?t=chipeditor

I wonder if songs created with the latest version of MusicMon can still be accurately played with this extension? Probably not...
I'm pretty sure it will only work with MusicMon V1 songs. The song format and replay code is different for version 2 and up. Not that it matters, because Music Mon v2 and up can save directly to the SNDH format, which can be played in STOS with Missing Link or other ways.

User avatar
bullis1
Fuji Shaped Bastard
Fuji Shaped Bastard
Posts: 2301
Joined: Tue Dec 12, 2006 2:32 pm
Location: Canada
Contact:

Re: Formerly undocumented STOS extension now documented.

Postby bullis1 » Sat Jan 31, 2015 3:44 am

Stethane wrote:I'm pretty sure it will only work with MusicMon V1 songs. The song format and replay code is different for version 2 and up. Not that it matters, because Music Mon v2 and up can save directly to the SNDH format, which can be played in STOS with Missing Link or other ways.

Ah, I figured as much. The fancy effects offered by MusicMon 2+ probably consume more CPU than you'd want for use in a STOS application anyway :wink:
Member of the Atari Legend team


Social Media

     

Return to “STOS”

Who is online

Users browsing this forum: No registered users and 1 guest