MSXPI:Specs:EN:DOS2

From Retro-CPU.run
Jump to: navigation, search

MSXPi commands under DOS2/Nextor

It is possible to use MSXPi along with other disk drive interface, such as the MegaFlashRom SD or ATA-IDE. In this case, MSXPi-DOS burned to the MSXPi EPROM is not started, which means, it is not possible to use the MSXPi disk images stored on Pi. However, all MSXPi commands will be available allowing access to Raspberry Pi, Pi SD card, network and internet. Below are the current commands available for MSXPi - they can be used under both MSXPi-DOS and Nextor/Dos2.

  • prun.com  : Run comands directly on the Linux system/Raspberry Pi.

Examples of usage:

prun ls /usr/src/games

prun cat rst.c

prun wget http://www.msxarchive.nl/pub/msx/games/msx1/castle.lzh


  • pcopy.com : Copy commands from current MSXPi path to MSX-DOS disks. The current path must be previously set using pcd.

Examples of usage:


Copy a file from a http url:

pcd http://www.msxpro.com/download

pcopy zanac2.zip zanac2.zip


Copy a file from Pi SD card:

pcd /home/pi/msxpi

pcopy rst.c b:rst.c


Copy a file from your PC Windows:'

pcd smb://192.168.1.10/Shared

pcopy mgear.rom mgear.rom


  • pdate.com : Update MSX-DOS system date. No parameters are required.


  • pdir.com : List files on current path.

Examples of usage:

pcd /home

pdir

pcd http://retro-cpu.run/MSXPI

pdir


  • ploadrom.com : Load and run a simple ROM from Pi SD card.

Examples of usage:

ploadrom zanac.rom


  • pnewdisk.rom : Create a new disk image (.dsk) on Pi SD Card. The image is created from a template on Pi (msxpi_720KB_template.dsk). This template can be set and viewed with command pset.

Examples of usage:

pnewdisk games.dsk


  • preset.com : Reset MSXPi status and try to re-sync communication with Raspberry Pi.


  • pset.com : Define and display MSXPi custom variables / parameters. There are 10 slots available. The parameters are kept on the server, but lost/reset when Pi are restarted.

The existing parameters are:

PATH=/home/pi/msxpi

DRIVE0=disks/msxpiboot.dsk

DRIVE1=disks/msxpitools.dsk

WIDTH=80

free=notused

WIFISSID=my wifi

WIFIPWD=secret

DSKTMPL=msxpi_720KB_template.dsk


Examples of usage:


Display the current values assigned to the parameters:

PSET DISPLAY


Set your WIFI network name:

PSET WIFISSID MINHAWIFI


Set the password for your WIFI network:

PSET WIFIPWD PASSW0RD


  • PSETDISK.COM  : Switch a disk image on drive 0 or drive 1. Change is immediate.


Examples of usage:

Replace image on drive A:

PSETDISK 0 disks/gamesrom.dsk


Replace image on drive B:

PSETDISK 0 disks/gamesrom.dsk


Note: Path is relative to /hom/pi/msxpi/


  • PWIFI.COM  : Reconfigure the Raspbery Pi wifi networki. WIFISSID and WIFIPWD must have been previously set with command pset (see command pset.com).

Examples of usage:

Show WIFI configuration:

PWIFI DISPLAY


Enforce reconfiguration of wifi interface using parameters in variables WIFISSID e WIFIPWD:

PWIFI SET


  • PPLAY.COM  : Controls audio playback on Raspberry Pi. Current available parameters are:
    • PLAY - Start playback of an audio file
    • LOOP - Start playback of an audio file and keep playing it until receive command STOP
    • PAUSE - Put specified audio in pause
    • RESUME - Restart playback of specified audio
    • STOP - Terminate audio playback
    • GETIDS - Show IDs of audio currently playing
    • GETLIDS - Show IDs of loops currently in progress


Examples of usage:

PPLAY PLAY music/tron.mp3

Note: This command returns a unique identifier for this audio - let's call it NN.

PPLAY PAUSE NN PPLAY RESUME NN PPLAY GETIDS


PPLAY LOOP music/tron.mp3

Note: The command returns two IDs: XX NN, where XX is the loop ID, and NN is the audio ID. In order to terminate a loop it is necessary to send two STOP commands: to the loop ID, then to the audio ID, in this sequence.

PPLAY GETLIDS PPLAY STOP XX PPLAY STOP NN

Audio loop should be terminated before the audio it is looping.