Using FujiNet‐PC‐RS232 with MartyPC

Prerequisites:

• Fujinet-RS232 adapter with firmware 1.6.1 or greater

  • If you need to update your firmware, download fujinet-flasher 1.5.0 or greater here

• MartyPC 0.5.0 or greater, from an official release or compiled from source

• Fujinet-PC-RS232 1.6 or greater. This is the command-line utility that interfaces your host PC with a Fujinet-RS232.

  • Download a nightly release from for your platform from releases.

• DOS Fujinet driver (FUJINET.SYS) 1.6.1 or greater.

  • Download from releases

Configuring Fujinet-RS232

• Edit fnconfig.ini on the SD card
  • Edit the section under [WiFi] with your SSID details.

    [WiFi]
    enabled=1
    SSID=[Your network name here]
    passphrase=[Your WPA password here] 
    

  • Edit the section under [BOIP] set enabled to 1, set host to localhost and pick your desired port number.

    [BOIP]
    enabled=1
    host=localhost
    port=42000
    

Configuring MartyPC

• Uncomment or create the following section under [emulator.serial_bridge] in your martypc.toml

  [[emulator.serial_bridge.connection]]
  guest_port = 0
  transport = "tcp"
  port_name = "Fujinet"
  address = "127.0.0.1:42000"
  connect_timeout_ms = 3000
  connect_trigger = "OnStartup"
  auto_reconnect = true
  reconnect_interval_ms = 100
  

  • The port number in address should match the port you selected in fnconfig.ini
  • guest_port = 0 will use guest COM1. Use guest_port = 1 to use COM2.

Run Fujinet-PC-RS232

• You should see this at the end of output:

  15:35:18.627338 > Setting up BoIPChannel: listening on localhost:42000
  15:35:18.627984 > Resolving hostname "localhost"
  15:35:18.641358 > Resolved to address 127.0.0.1
  15:35:18.641518 > ### BoIPChannel accepting connections ###
  15:35:18.889598 > BoIPChannel: connection from: 127.0.0.1
  15:35:18.889803 > ### BoIPChannel connected ###
  

  • Confirm the port number you selected is representing after listening on localhost.

Run MartyPC

• Navigate to Machine -> Input/Output -> Serial Ports -> COM1 or COM2.

• You should see TCP Client: (Connected to "Fujinet").

  

Set up FUJINET.SYS driver

• Add FUJINET.SYS to the root of a bootable floppy disk image or your hard disk.
• Edit CONFIG.SYS to add the following line: DEVICE=FUJINET.SYS FUJI_PORT=1 FUJI_BPS=115200
  • Use FUJI_PORT=1 for COM1, FUJI_PORT=2 for COM2, matching the guest_port setting in martypc.toml.
• Reboot with the floppy disk inserted, or boot from your hard drive depending on where you installed FUJINET.SYS.
• If Fujinet has set your date and time correctly, you have connected!

Configure Fujinet

• To configure Fujinet from the guest machine:
  • Navigate to your D: drive (ensure you have no other disks mounted)
  • Run CONFIG.EXE
• To configure Fujinet from your web browser:
  • Navigate to https://127.0.0.1:8000, replacing the port number with the one you have configured.