1,345
edits
Changes
Created page with "==How to play on real X1 or X1 emulators== Driver of NRTDRV embeds easy play monitor for real X1 or X1 emulator, and it can be called from IPL boot patch or original programs..."
==How to play on real X1 or X1 emulators==
Driver of NRTDRV embeds easy play monitor for real X1 or X1 emulator, and it can be called from IPL boot patch or original programs.
Included IPL boot patches are 2 versions. One has easy playing monitor (IPLPATCH.BIN) and other has OPM tone editor(IPLOPMED.BIN). It is selectable from menu of NRTDRV.EXE.
===Easy play monitor===
When press trigger 1 of joypad while playing music, switches play and stop as toggle. Trigger 2 or NMI switch to play test sounds.
===OPM tone editor===
This is tone editor which can change parameter simultaneously.
Tone parameter changing effects only editing channel simultaneously..
Enter return key twice while value inputting when you want set same parameters to multiple channels like chord. (Sends parameter to editing channel when enter return once).
The values of WF/LFRQ/PMD/AMD are common among A-H and I-P channels.
Key binds are like below.
;:Cursor keys (left and right of joypad)
;;Selects parameters
;:[0]-[9] key : [+][-]key (up and down of joypad)
;;Changes parameter. When input values with number keys, type return to enter (send tone to editing channel) and others to cancel.
:;[A]-[P] keys
;;Selects channel to edit.
:;[SHIFT]+[A]-[P] keys
;;Select target (of sending tone) channels to enter with return key.
:;[CTRL]+[A]-[P] keys / [CTRL]+[1]-[3] keys
Select channel to play or mute.
:;[CTRL]+[R] key
;;Revert to play and mute channels.
:;Return key (trigger 1)
;;Sends all parameters to multiple channels as usual. When input values, sends parameters to channels editing.
:;[S]key (trigger2)
;;Escapes editing tones.
:;[R]key
;;Rewrite escaped tone to editing channel.
:;Space key
;;Stops / plays music data.
:;[SHIFT]+space key
;;Fades out music data.
:;[CTRL]+[T]key
;;Plays test sound.
Editing tone is overwritten as soon as tone data is switched. It can be escaped with I, I@, IP or IV command, but it is more convenient that periodically escape it with S key or trigger 2 to avoid unwilling writing.
===Remote booting with serial connection===
This is special way to do on real X1 PC only. If you use X1 emulator, refer below to make disk image.
===Prerequisites===
Real X1turbo/Z series PC with FDD (turbo model 10 and normal X1 series cannot be used).
Windows PC with serial port (USB serial cables cannot be used).
Serial cross cable (Interlink) or DSUB 9 pins - DSUB 25 pins
Turbo Basic executable (CZ-8FB02) environment.
Key board for X1turbo
Monitor (not necessary ? )
5 inch 2D floppy disk with standard format
Communication between X1 and PC requires cable which connects RTS from 25 pins and CTS of 9 pins (cross cable of Interlink).
If not described "for Interlink" on specifications, such a cross cable is sometimes not connected these pins and cannot communicate. Refer pinouts written in latest document of HSSIO(see below) for details.
===Preparation===
Connect PC and X1turbo/X1turboZ via serial port with cross cable.
Download archive of "HSSIO"(hssio_ver02a.zip) at site of "X1 Center". It provides full-duplex high speed serial communication module and remote booting environment.
Refer "readme.txt" in the archive above and make IPL boot disk for remote booting.
===How to execute===
Execute IPL boot disk prepared on real X1 PC and boot loader.
Select "Start serial communication after compile" and COM port number at compiler settings and then compile MML.
System and music data are transferred to real machine and starts playing.
Automatically reboots loader when recompiles MML while it is playing.
If playing screen is showed only for a moment and loader reboots soon after that, RTS and CTS are correctly connected via serial cross cable.
Use cross cable or disable check for "Start serial communication after compile" on compiler settings.
===Making disk image===
Explanations below is for NRTDRV embedded easy play monitor. Currently we recommend to use NRDSEL and refer NRDSEL.TXT.
IPL boot file "NRTDRV.sys" is written to the folder where NRTDRV.EXE exists when MML is compiled. Use tools from these sites and write as D88 formatted disk image.
"X1EMU and PadKey98" site
http://www.geocities.co.jp/SiliconValley-SanJose/3949/
Use X1FORMAT.EXE and X1SAVE.EXE imaging file tools for X1EMU (img1023.lzh)
> X1FORMAT [D88 image name to aformat]
> X1SAVE [D88 formatted image name ] NRTDRV.Sys /I /R0000 /G0100
The easiest way might be that put X1FORMAT.EXE, X1SAVE.EXE and NRTDRV.Sys into same folder and them execute "D88MAKE.BAT".
Change final line of BAT file for your environment, it can automate to boot "NRTDRV.D88".
If you use this image on real X1, make D88 image as above, write it into 2D disk and boot from IPL.
===Manual preparation===
Extract archive which saved when MML is compiled and use it individually (as a file).
Load NRTDRV(driver itself) to 01800H.
Load NRD file (music data) to 04000H.
Execute entries below.
===List of driver entry===
01800H (DRVINI)
Initialization of driver. This must be executed first.
01803H (MPLAY)
Play. Turns EI and plays from appropriate address.(See note 1)
01806H (MSTOP)
Stop. Stops playing music. Turns EI.
01809H (MFOUT)
Fades out.(See note 2)
0180FH (MTEST)
Play test sound.(See note 3)
01812H (MPLAYD)
Play. Turns EI and plays from 04000H.
01815H (VINIT)
Display initialization. Sets PCG definition etc.(See mote 4)
01818H (VMAIN)
Draws 1 frame of playing monitor. (See note 5)
0181BH (INVREG)
Disables virtual OPM register for NRDSEL/OPM tone editor.
Note 1
Music data is relocatable and can be allocate memory freely. Put music data address to driver's BGMADR work area and then call MPLAY. Default address is 04000H.
Note 2
A little noise occurs when OPM tone is selected while fading outs.
Note3
Test sounds below are played when this entry is called. Use it for balancing volumes etc.
1. OPM#1->PSG->OPM#2
Plays "CDEFGABC" in this order.
2. OPM#1"CD"->PSG"EF"->OPM#2"GA->OPM#1"BC"
3. Chord with OPM#1"C"->PSG"E"->OPM#2"G"
4. OPM#1->PSG->OPM#2
Repeat playing "C" in this order.
After playing this, address of BGMADR work area points test sounds' one. If you want to play ordinary music data again, call MPLAYD or call MPLAY after BGMADR is set.
Note4
When it is called with 0 in A resister, only defines logo as PCG. When it is called with other than 0 in A resister, defines all of PCG and then text attributes changes 80 characters and 19 lines of PCG.
Note5
o0c is treated as rest only in keyboard displaying and it is not displayed (but played sound). Playing sounds has priority towards displaying so when loading is high displaying is not renewed.
===External reference work area===
01831H (VER) Internal version number.
0＝Versions until 2016/10/28
1＝Versions from 2016/11/01
2＝Versions from 2017/03/03
This is version number to avoid mismatching between driver and music data.
Specification is as mentioned above but actually version number is newly implemented from version of 2016/11/03. If this work area is read by previous versions, returns are 0.
Previous versions of 2016/12/03 changes value when starts playing. Get former value before playing if you need.
Driver of NRTDRV embeds easy play monitor for real X1 or X1 emulator, and it can be called from IPL boot patch or original programs.
Included IPL boot patches are 2 versions. One has easy playing monitor (IPLPATCH.BIN) and other has OPM tone editor(IPLOPMED.BIN). It is selectable from menu of NRTDRV.EXE.
===Easy play monitor===
When press trigger 1 of joypad while playing music, switches play and stop as toggle. Trigger 2 or NMI switch to play test sounds.
===OPM tone editor===
This is tone editor which can change parameter simultaneously.
Tone parameter changing effects only editing channel simultaneously..
Enter return key twice while value inputting when you want set same parameters to multiple channels like chord. (Sends parameter to editing channel when enter return once).
The values of WF/LFRQ/PMD/AMD are common among A-H and I-P channels.
Key binds are like below.
;:Cursor keys (left and right of joypad)
;;Selects parameters
;:[0]-[9] key : [+][-]key (up and down of joypad)
;;Changes parameter. When input values with number keys, type return to enter (send tone to editing channel) and others to cancel.
:;[A]-[P] keys
;;Selects channel to edit.
:;[SHIFT]+[A]-[P] keys
;;Select target (of sending tone) channels to enter with return key.
:;[CTRL]+[A]-[P] keys / [CTRL]+[1]-[3] keys
Select channel to play or mute.
:;[CTRL]+[R] key
;;Revert to play and mute channels.
:;Return key (trigger 1)
;;Sends all parameters to multiple channels as usual. When input values, sends parameters to channels editing.
:;[S]key (trigger2)
;;Escapes editing tones.
:;[R]key
;;Rewrite escaped tone to editing channel.
:;Space key
;;Stops / plays music data.
:;[SHIFT]+space key
;;Fades out music data.
:;[CTRL]+[T]key
;;Plays test sound.
Editing tone is overwritten as soon as tone data is switched. It can be escaped with I, I@, IP or IV command, but it is more convenient that periodically escape it with S key or trigger 2 to avoid unwilling writing.
===Remote booting with serial connection===
This is special way to do on real X1 PC only. If you use X1 emulator, refer below to make disk image.
===Prerequisites===
Real X1turbo/Z series PC with FDD (turbo model 10 and normal X1 series cannot be used).
Windows PC with serial port (USB serial cables cannot be used).
Serial cross cable (Interlink) or DSUB 9 pins - DSUB 25 pins
Turbo Basic executable (CZ-8FB02) environment.
Key board for X1turbo
Monitor (not necessary ? )
5 inch 2D floppy disk with standard format
Communication between X1 and PC requires cable which connects RTS from 25 pins and CTS of 9 pins (cross cable of Interlink).
If not described "for Interlink" on specifications, such a cross cable is sometimes not connected these pins and cannot communicate. Refer pinouts written in latest document of HSSIO(see below) for details.
===Preparation===
Connect PC and X1turbo/X1turboZ via serial port with cross cable.
Download archive of "HSSIO"(hssio_ver02a.zip) at site of "X1 Center". It provides full-duplex high speed serial communication module and remote booting environment.
Refer "readme.txt" in the archive above and make IPL boot disk for remote booting.
===How to execute===
Execute IPL boot disk prepared on real X1 PC and boot loader.
Select "Start serial communication after compile" and COM port number at compiler settings and then compile MML.
System and music data are transferred to real machine and starts playing.
Automatically reboots loader when recompiles MML while it is playing.
If playing screen is showed only for a moment and loader reboots soon after that, RTS and CTS are correctly connected via serial cross cable.
Use cross cable or disable check for "Start serial communication after compile" on compiler settings.
===Making disk image===
Explanations below is for NRTDRV embedded easy play monitor. Currently we recommend to use NRDSEL and refer NRDSEL.TXT.
IPL boot file "NRTDRV.sys" is written to the folder where NRTDRV.EXE exists when MML is compiled. Use tools from these sites and write as D88 formatted disk image.
"X1EMU and PadKey98" site
http://www.geocities.co.jp/SiliconValley-SanJose/3949/
Use X1FORMAT.EXE and X1SAVE.EXE imaging file tools for X1EMU (img1023.lzh)
> X1FORMAT [D88 image name to aformat]
> X1SAVE [D88 formatted image name ] NRTDRV.Sys /I /R0000 /G0100
The easiest way might be that put X1FORMAT.EXE, X1SAVE.EXE and NRTDRV.Sys into same folder and them execute "D88MAKE.BAT".
Change final line of BAT file for your environment, it can automate to boot "NRTDRV.D88".
If you use this image on real X1, make D88 image as above, write it into 2D disk and boot from IPL.
===Manual preparation===
Extract archive which saved when MML is compiled and use it individually (as a file).
Load NRTDRV(driver itself) to 01800H.
Load NRD file (music data) to 04000H.
Execute entries below.
===List of driver entry===
01800H (DRVINI)
Initialization of driver. This must be executed first.
01803H (MPLAY)
Play. Turns EI and plays from appropriate address.(See note 1)
01806H (MSTOP)
Stop. Stops playing music. Turns EI.
01809H (MFOUT)
Fades out.(See note 2)
0180FH (MTEST)
Play test sound.(See note 3)
01812H (MPLAYD)
Play. Turns EI and plays from 04000H.
01815H (VINIT)
Display initialization. Sets PCG definition etc.(See mote 4)
01818H (VMAIN)
Draws 1 frame of playing monitor. (See note 5)
0181BH (INVREG)
Disables virtual OPM register for NRDSEL/OPM tone editor.
Note 1
Music data is relocatable and can be allocate memory freely. Put music data address to driver's BGMADR work area and then call MPLAY. Default address is 04000H.
Note 2
A little noise occurs when OPM tone is selected while fading outs.
Note3
Test sounds below are played when this entry is called. Use it for balancing volumes etc.
1. OPM#1->PSG->OPM#2
Plays "CDEFGABC" in this order.
2. OPM#1"CD"->PSG"EF"->OPM#2"GA->OPM#1"BC"
3. Chord with OPM#1"C"->PSG"E"->OPM#2"G"
4. OPM#1->PSG->OPM#2
Repeat playing "C" in this order.
After playing this, address of BGMADR work area points test sounds' one. If you want to play ordinary music data again, call MPLAYD or call MPLAY after BGMADR is set.
Note4
When it is called with 0 in A resister, only defines logo as PCG. When it is called with other than 0 in A resister, defines all of PCG and then text attributes changes 80 characters and 19 lines of PCG.
Note5
o0c is treated as rest only in keyboard displaying and it is not displayed (but played sound). Playing sounds has priority towards displaying so when loading is high displaying is not renewed.
===External reference work area===
01831H (VER) Internal version number.
0＝Versions until 2016/10/28
1＝Versions from 2016/11/01
2＝Versions from 2017/03/03
This is version number to avoid mismatching between driver and music data.
Specification is as mentioned above but actually version number is newly implemented from version of 2016/11/03. If this work area is read by previous versions, returns are 0.
Previous versions of 2016/12/03 changes value when starts playing. Get former value before playing if you need.