MSXPI:Specs:EN:SETUP

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

MSXPi can be setup in two ways:

  • Method 1:Using a pre-configured Raspnian Image provided by me
  • Method 2:updating your existing Raspbian system


Method 1: Using a pre-configured Raspbian Image

Note: This is the recomended method to quick start with MSXPi.


1. Download Raspbian image with MSXPi already setup. This image starts up the server on boot, and will be ready to listen for MSX commands. Get the image from DropBox here: https://www.dropbox.com/sh/icncwnbdo0z0089/AAB9zX1w7pgQFZkWKfxhL82ha). Download file "msxpi_raspbian.img".


2. Write the image to a SD Card, with at least 8 GB of space.

  • If under Mac OS X or Linux, you can use dd command:

dd if=msxpi_raspbian.img of=/dev/diskX


Attention: diskX is the disk corresponding to the SD Card, usually the X is the number 2 or higher.



3. Connect Raspberry Pi to the interface. Use manual section 4 "4 - Connecting MSXPi to the Raspberry Pi"), available on dropbox as well.

  • For Raspberry Pi Zero use Figure 2 as reference on how to plug the Pi to the interface. It will be necessary 7 soldering joints in this case.
  • For Raspberry Pi 2 or 3, connect it to the interface using the provided wires, using Figure 3 as reference, on section 4.


MSXPi manual: https://github.com/costarc/MSXPi/blob/dev/documents/MSX%20Pi%20Interface%200.8.2.pdf


4. Insert the SD card into Raspberry Pi and switch it on as follows:

  • For Raspberry Pi Zero, insert the MSXPi in a MSX slot and switch on the MSX. Raspberry Pi Zero will turn on, since it is powered by MSX.
  • or Raspberry Pi 2/3, connect a power adapter to the Raspberry Pi. Then switch on the MSX.


At this point, the MSX should boot and start searching for MSXPi. After a while, it should boot into MSXPi-DOS. In this setup, MSX should have access to two drives, A: with MSXPi-DOS system, and B: with MSXPi tools and commands. When you use MSXPi along with some other disk interface connected, the drives from that other interface will be available as drive C:, D:, and so on.


Next steps depends on how you are using MSXPi.

If you are using along with other SD/CF interface, you can use your personal computer to download MSXPi commands and copy to SD Card. The repository with latest commands is http://retro-cpu.run/MSXPI/MSXPi-DOS/

If you are using MSXPi-DOS booting from RPi, then you can update your MSXPi system and tools to latest version running:

msxpiupd.bat

This batch file will automatically download all required files (server and client). For server files to be updated, you need to reboot RPi after the download completes.


Note: If you prefer to boot MSX form the other disk interface then remove jumper CS1. In this case, you won't have access to he MSXPi disk images.

Method 2: Updating your existing Raspbian system

Login to your RPi and execute next steps


1. Download the setup script:

wget --no-check-certificate https://goo.gl/wAf3U6 -O msxpi-setup.sh


Note: You can use the longer URL if you want to:

wget --no-check-certificate https://raw.githubusercontent.com/costarc/MSXPi/dev/software/Server/Shell/msxpi-setup.sh


2. Rename the file downloaded to msxpi-setup.sh if necessary


3. run msxpi-setup.sh

sudo /home/pi/msxpi-setup.sh


4. Reboot Raspberry Pi.

MSXPi server process will start automatically during boot.


Next steps depends on how you are using MSXPi.

If you are using along with other SD/CF interface, you can use your personal computer to download MSXPi commands and copy to SD Card. The repository with latest commands is http://retro-cpu.run/MSXPI/MSXPi-DOS/

If you are using MSXPi-DOS booting from RPi, then you can update your MSXPi system and tools to latest version running:

msxpiupd.bat

This batch file will automatically download all required files (server and client). For server files to be updated, you need to reboot RPi after the download completes.


Attention: Careful with the most right pin, it is 5v pin. It is there to provide power supply to Pi Zero, when it is being used. Do not connect any wire form Pi on this 5v pin, because you will surely damage the Pi. Raspberry Pi 2/3 must be powered using a power adapter, not MSX.

I4EGifm.png