MSXPI:Specs:PT:BASIC

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

MSXPi Cloud Client

O MSXPi Client é uma interface de linha de comandos disponível a partir do BASIC. O Cliente é carregado do Raspberry Pi pelo comando CALL MSXPILOAD. O cliente é carregado do Raspberry Pi, onde deve estar armazenado com nome:

/home/pi/mxpi/msxpi-client.bin


Ao carregar o cliente, o usuário é apresentado à linha de comando, onde tem uma quantidade limitada de comandos para executar.


MSXPi Hardware Interface v0.7 MSXPi Cloud OS (Client) v0.8.1 TYPE HELP for available commands CMD:


The available commands can be viewed with the HELP command:


CMD:HELP BASIC CHKPICONN CLS PDIR HELP PLOADBIN PLOADROM PMORE #(Pi Command) PRESET


Os comandos disponíveis para o BASIC são:

* CALL MSXPI

* CALL MSXPILOAD

* CALL MSXPISTATUS

* CALL MSXPIVERSION


Descrição dos comandos

* CALL MSXPI("flag,COMMAND")

Para instalar este comando, execute o "msxpiext.bin" a partir do BASIC:

load "msxpiext.bin",r


Permite executar comandos MSXPi a partir do BASIC. O comando precisa estar entre aspas, pois é tratado como string pelo CALL. Opcionalmente pode ter uma flag para indicar como a resposta do RPi (se existir) deve ser tratada:

0 = descartar a resposta, não mostrar na tela

1 = mostrar a resposta na tela

2 = gravar a resposta no buffer, que começa em #E3D8. Os dois primeiros bytes são o tamanho do buffer (dados) recebidos.


Exemplos:

CALL MSXPI("PDIR")
CALL MSXPI("1,PDIR")
CALL MSXPI("0,PDIR")
CALL MSXPI("PPLAY PLAY music/Aleste.mp3")


Para receber os dados para o buffer:

10 M=&HE3D8: REM Esté endereço é um buffer em RAM que o comando MSXPI usa para gravar dados enviados pelo RPi
20 CALL MSXPI("0,PCD /home")
30 CALL MSXPI("2,PDIR"):REM "2" informa ao MSXPI para gravar a resposta do RPi no buffer em RAM
30 S=PEEK(M)+256*PEEK(M+1): REM Obtêm o tamanho dos dados enviado pelo RPi
40 FOR C=2 TO S-1:PRINT CHR$(PEEK(M+C));:NEXT:REM Lê os dados, pulando os dois primeiros bytes que contêm o tamanho do buffer


* CALL MSXPILOAD

Carrega o msxpi-client a partir do RPi e executa. Este client é uma interface texto com um prompt para receber comandos e enviar ao RPi. Este cliente será descontinuado.