MSXPI:Specs:PT:DOS2

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

MSXPi commandos para o DOS2/Nextor

É possível usar o MSXPi junto com outra interface de disco, como a MegaFlashRom SD ou ATA-IDE. Neste cenário de utilização, o MSXPi-DOS gravado na EPROM do MSXPi não é inicializado, de modo que não é possível acessar images de disco gravados no cartão SD do Pi. Entretanto, os comandos disponíveis do MSXPi disponibilizam acesso direto aos arquivos do Raspberry Pi, e também a arquivos na rede e na internet. A seguir será listado os comandos do MSXPi disponíveis para usar a partir do MSX-DOS2 e Nextor.


  • prun.com  : Executa comandos direto no shell do Raspberry Pi, e mostra o texto resultante da execução do comando (standard output e standard error). Qualquer comando NÃO INTERATIVO pode ser executado. Esta restrição ocorre porque não há um processo de detecção e envio de teclas após o comando ser executado, portanto se for executado um comando que espere uma ação do usuário (como selecionar Y ou N por exemplo), o comando ficará aparentemente congelado esperando o Pi responder.

Exempos de utilização:

prun ls /usr/src/games

prun cat rst.c

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


  • pcopy.com : Permite fazer cópia de arquivos do cartão SD do Pi para o disco do MSX, e também de um servidor em rede para o MSX. Note que o path deve ser previamente definido com o comando pcd. Veja a seguir alguns exemplos.


Copiar um arquivo via http:

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

pcopy zanac2.zip zanac2.zip


Copiar um arquivo do cartão SD do Raspberry Pi, do diretório atual:

pcd /home/pi/msxpi

pcopy rst.c b:rst.c


Copiar um arquivo compartilhado no seu PC Windows:

pcd smb://192.168.1.10/Shared

pcopy mgear.rom mgear.rom


  • pdate.com : atualiza a data e hora do MSX. A data e hora fornecida pelo Raspberry Pi. Não requer parâmetros.


  • pdir.com : lista os arquivos no path definido pelo comando pcd. Na versão atual não é possível especificar path diretamente no comando pdir.

Exemplos:

pcd /home

pdir

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

pdir


  • ploadrom.com : Carrega uma ROM a partir do cartão SD do Raspberry Pi. Em seguida ela é executada (este comando deverá futuramente carregar ROMs a partir da rede).

Exemplo de utilização:

ploadrom zanac.rom


  • pnewdisk.rom : Cria uma nova imagem de disco (.dsk) e armazena no cartão SD do Raspberry Pi. A nova imagem é criada a partir de um template (msxpi_720KB_template.dsk).

Exemplo de utilização:

pnewdisk games.dsk


  • preset.com : Reset o status da interface e tenta efetuar uma comunicação com o Raspberry Pi.


  • pset.com : Define variáveis do MSXPi, que são armazenadas em memória pelo msxpi-server. Existem um total de 10 slots para variáveis, sendo que oito já estão utilizados, e duas outras estã odisponíveis para o usuário. As variáveis são as seguintes:

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


Exemplos de utilização são mostrados a seguir.


Mostrar o valor das variáveis:

PSET DISPLAY


Definir o nome da rede WIFI:

PSET WIFISSID MINHAWIFI


Definir a password da rede WIFI:

PSET WIFIPWD PASSW0RD


  • PSETDISK.COM  : Substitui a imagem de disco no drive especificado. Os drives são numerados a partir do zero (A:). Atualmente dois drives estão habilitados no MSXPi, drives 0 e drive 1. O comando tem efeito imediato.


Por exemplo, para alterar a imagem no drive A: use o comando:

PSETDISK 0 disks/gamesrom.dsk


E para alterar a imagem no drive B: use o comando:

PSETDISK 0 disks/gamesrom.dsk


Nota: A imagem deve ser de 720KB compatível com o MSX, e o caminho é sempre relativo ao local onde o MSXPi server está rodando, o seja, /hom/pi/msxpi/.


  • PWIFI.COM  : Permite configurar a rede wifi no Raspberry Pi. Para usar este comando, é necessário que as variáveis WIFISSID e WIFIPWD já estejam definidas (veja comando pset.com).

Exemplos de uso a seguir.

Mostrar a configuração da rede WIFI:

PWIFI DISPLAY


Forçar a configuração da rede WIFI usando os parâmetros WIFISSID e WIFIPWD:

PWIFI SET


  • PPLAY.COM  : Controla a execução de audio no Raspberry Pi. Os parâmetros disponíveis são:
    • PLAY - Inicia o playback de um audio
    • LOOP - Iniciai o playback de um audio, e mantêm em loop até que o loop seja interrompido
    • PAUSE - Coloca o audio em pausa
    • RESUME - Continua a tocar um audio que havia sido colocado em pausa
    • STOP - Termina o playback de um audio
    • GETIDS - Lista os identificadores de audio em execução
    • GETLIDS - Lista os identificadores de audio em loop em execução


Exemplos de uso:

PPLAY PLAY music/tron.mp3

Nota: O comando retorna um identificador NN para o audio que foi iniciado.

PPLAY PAUSE NN PPLAY RESUME NN PPLAY GETIDS


PPLAY LOOP music/tron.mp3

Nota: O comando retorna dois identificadores XX NN, que representa o ID do controlador do loop, e o ID do audio. Para encerrar o loop é necessário enviar o comando STOP para o controlador do loop e para o audio, em sequência.

PPLAY GETLIDS PPLAY STOP XX PPLAY STOP NN

O controlador do loop de audio deve ser terminado antes do audio.


E isso é tudo - por enquanto para esta versão. Este comandos são relativamente fáceis de implementar, e à medida que o tempo for passando, novos comandos serão implementados, inclusive, pelos usuários que tenham conhecimentos de programação.