mozzwald/fujinet-firmware
1
0
Fork 0
mirror of https://github.com/FujiNetWIFI/fujinet-firmware.git synced 2026-09-17 11:07:36 -05:00
Code Issues Projects Releases Packages Wiki Activity
Page: Run FujiNet with Altirra for Atari
Pages
"upstream.sh" Script To Rebase Changes 5CS PC TODO A Simple NetCat Program ADAM FujiNet Quickstart Guide ADAM Programming ATASCII Printer About Each Printer Accessing the Real Time Clock Active Branches AdamNet Timing Analysis Additional Commands for R: Devices AppKey Registry Page Apple II & III FujiNet Quickstart Guide Apple II FujiNet Platform Reference Guide Apple II SP over SLIP Apple II memleak analysis notes. Apple IIgs Programming Apple Programming Apple2 Test Results ‐ 2025‐08‐26 Apple2 memleak analysis notes. Apple2 AppleII & III FujiNet Quickstart Guide AppleII III FujiNet Quickstart Guide AppleII FujiNet Plaform Reference Guide AppleII FujiNet Quickstart Guide AppleII III FujiNet Quickstart Guide Applesoft Network extensions Apple‐68k: Ideas for Extending the DCD Protocol Application Ideas Atari 1020 Atari 1025 Atari 1027 Atari 1029 Atari 820 Atari 822 Atari 825 Atari BASIC JSON POST Best Practices Atari FujiNet Programming Series: Roman Checkers Atari FujiNet Quickstart Guide Atari Program Recorder (410 1010 XC11 XC12) Atari Programming Atari8 BBS Express 850 1.0 Documentation BBS Express 850 1.0 BBS Baud Rate Test Before Each Test Board Bring Up Hardware Board Bring Up Software Board Bring Up Board bring up for FujiNet Platform.IO code Boot a Game from Fujinet.Online Boot the FujiNet to CONFIG CIO Commands for N Device CIO and FMS copy commands CONFIG HTTP API CONFIG Users Guide CP M Support Carina BBS 2.7 ChatGPT Ruminations on DOS Code Re Org Handling Different Systems Cold Start Profiling Coleco ADAM Tests Color Computer Quickstart Guide Commands for Device $09 (Network) Commands for Device $0F (Fujinet) Commodore 64 Tidying Up Commodore FujiNet Quickstart Guide Complete CLI Guide to Builds Config 2.0 Set WiFi Network Config 2.0 Verify ATR Disk Booting Config 2.0 Verify Host Slot Editing Config 2.0 Verify Joystick Control Config 2.0 Verify Slot Quick Keys Config 2.0 Verify Subdirectory Traversal Config 2.0 Verify Version Config 2.0 Verify XEX Disk Booting Configuration Test Connecting to a BBS Contributing to the Project Copying disk from Internet Creating New Disk Credits DIAGNOSTIC: Alter SIO Timing for T0 DIAGNOSTIC: Alter SIO Timing for T1 DIAGNOSTIC: Alter SIO Timing for T2 DIAGNOSTIC: Alter SIO Timing for T3 DIAGNOSTIC: Alter SIO Timing for T4 DIAGNOSTIC: Alter SIO Timing for T5 DIY FujiNet for the Intellivision DOS XL Cheat Sheet Defoogi Demystified Deploying your Favorite BBS Dev News Developing a Turn Based Multiplayer Server Prototype for Poker Development Atari Development Env for Apps Directory of The Big RunCPM ZIP ESP32 Schematic Epson FX 80 Error Codes for N: Device Example Read Clock on Adam Example Read JSON Data Example TNFS Hosts FEP 001 FEP 002 FEP 003 FEP 004 FOREMDOC FORM2DOC Finding SmartPort Devices Finding The SmartPort Dispatcher Firmware Code Book Blue Firmware Test Plan for Apple II Firmware Test Plan for Apple2 Firmware Versioning FoReM 850 26M FujiCard Hardware Notes FujiNet CLI Flasher FujiNet Commands Reference FujiNet Commodore Programming FujiNet Config Tools FujiNet Configuration File: fnconfig.ini FujiNet Development Guidelines FujiNet Documentation Style Guide FujiNet Documentation Wish List FujiNet Flasher FujiNet Network Protocol Handbook FujiNet Networking (N: Device) Quickstart Guide FujiNet Programming Guide for the Atari 2600 FujiNet Programming Guide for the Bally Astrocade FujiNet Programming Guide for the ColecoVision FujiNet Programming Guide for the Intellivision FujiNet Talking Points for YouTubers, Podcasters, etc. FujiNet VirtualMachine FujiNet for Intellivision FAQ Fujinet Documentation Style Guide Scratch Pad Fujinet Intellivision Mailbox Protocol GRANTIC (screen dump) Git Config Aliases Git History Examples Guide to Building AppleWin on Linux HTML Printer HTTP Collect Headers HTTP Headers HTTP POST HTTP Protocol HTTP Set Channel Mode HTTP Test Harness Hacker List High Score storage for Legacy Games High Score writeable ATR example in BASIC Home How FujiNet Supports Connections to BBS How I added FujiNet Clock support to FoRem 26M Installing a High Score Party Server Intellivision Bring‐up Notes Issuing SmartPort Commands JSON Query Format Known TNFS Hosts Listen Test Load file from HTTP into AtariWriter Loading Binary Files from N: Device Loading PLATOTERM to access IRATA.ONLINE MIDI Maze Notes MIDIMaze MSX Technical Overview MS‐DOS BIOS Specification Mac68k Quickstart Guide N Device Close N Device Get Characters N Device Get Record N Device Open N Device Put Characters N Device Put Record N Device Status N Device Template N: AUX1 Values N: AUX2 Values N: Device Filename Size Limitations N: Game Developer Cheat Sheet N: SIO Command $20 Rename File N: SIO Command $21 Delete File N: SIO Command $25 Point in File N: SIO Command $26 Note in File N: SIO Command $2A Make Directory N: SIO Command $2B Remove Directory N: SIO Command $2C Change Directory N: SIO Command $30 Get Current Directory N: SIO Command $FB Set JSON Parameters N: SIO Command $FC Set Channel Mode N: SIO Command $FD Set Login N: SIO Command $FE Set Password N: SIO Command $FF Query for Special Command DSTATS N: SIO Command 'A' Accept N: SIO Command 'C' Close N: SIO Command 'D' Set UDP Destination N: SIO Command 'E' (get) Error N: SIO Command 'H' Set Hash Type N: SIO Command 'O' Open N: SIO Command 'P' Parse JSON N: SIO Command 'Q' Query JSON N: SIO Command 'R' Read N: SIO Command 'S' Status N: SIO Command 'T' Set Translation N: SIO Command 'W' Write N: SIO Command 'Z' Set PROCEED Timer Rate N: SIO Command 'c' Close Client Connection N: TCP Game Example: Light Cycles N: TCP Game Example: Reversi N: Theory of Operation N: devicespec Nightly Firmware Builds Official Hardware Versions Okimate 10 PC DOS FujiNet Quickstart Guide PLATOTERM Key Charts PR 1108 Atari Testing Procedure PR 1108 Test Plan PiRTO‐II‐Fuji Hardware Notes Printer Emulation Printing Epson Graphics Output from Print Shop Printing Text File to Printer Production Units Protocol libraries Prototype Board Revisions RS232 Quickstart Guide Run FujiNet with Altirra for Atari Run FujiNet with OpenMSX Run FujiNet with Xroar for CoCo S.A.M. Emulation on P4: S100 FujiNet Quickstart Guide SIO Command $4E Network Open SIO Command $53 Network Status SIO Command $64 TCP Disconnect SIO Command $C5 Hash Output SIO Command $C7 Hash Compute SIO Command $C8 Hash Input SIO Command $C9 Base64 Decode Output SIO Command $CA Base64 Decode Length SIO Command $CB Base64 Decode Compute SIO Command $CC Base64 Decode Input SIO Command $CD Base64 Encode Output SIO Command $CE Base64 Encode Length SIO Command $CF Base64 Encode Compute SIO Command $D0 Base64 Encode Input SIO Command $D6 Set Boot Mode SIO Command $D7 Mount All SIO Command $D8 Copy File SIO Command $D9 Enable Disable CONFIG in D1 SIO Command $DA Get Device Slot Filename SIO Command $DB Close App Key SIO Command $DC Open App Key SIO Command $DD Read App Key SIO Command $DE Write App Key SIO Command $DF Set External SIO Clock SIO Command $E0 Get Host Prefix SIO Command $E1 Set Host Prefix SIO Command $E2 Set Filename for Device Slot SIO Command $E3 Set HSIO Index SIO Command $E4 Set Directory Position SIO Command $E5 Get Directory Position SIO Command $E6 Umount Host SIO Command $E7 New Disk SIO Command $E8 Get Adapter Config SIO Command $E9 Unmount Device Image SIO Command $EB Set UART Baudrate SIO Command $F0 Enable UDPStream Mode SIO Command $F1 Write Device Slots SIO Command $F2 Drive Map Read SIO Command $F2 Read Device Slots SIO Command $F3 Write Host Slots SIO Command $F4 TNFS Read Hosts Slots SIO Command $F4 Read Host Slots SIO Command $F5 Close Directory SIO Command $F6 Read Directory SIO Command $F7 Open Directory SIO Command $F8 Mount Device Image SIO Command $F9 Mount Host SIO Command $FA Get WiFi Status SIO Command $FB Set SSID and Connect SIO Command $FC Get Scan Result SIO Command $FD Scan Networks SIO Command $FE Get SSID SIO Command $FF Reset FujiNet SIO Command Page Template SIO Commands for Device ID $70 SIO Commands for Device IDs $71 to $78 Sample FNCONFIG.INI Setting Up TNFS On Windows 10 Setting up TNFS on a Raspberry Pi Setting up a TNFS Server Software Changes for New Platforms SpartaDOS X Ultimate1MB FujiNet Utilities System Quickstarts Testing Plan Testing Results V1.3 ‐ Atari Testing against FTP Server Testing local SD Card Storage The Complete Linux CLI Guide The Complete MacOS CLI Guide The Complete OSX CLI Guide The Definition of Done The Original GoogleDoc Things To Hack On Things to do with FujiNet Toplevel Hardware Toplevel Miscellaneous Toplevel Software Toplevel User Guides Toplevel Virtualization Translation Test Useful External Documentation Using AMAC with FujiNet Using App Keys Using FujiNet from fig FORTH Using FujiNet‐PC‐RS232 with 86Box in Linux Using FujiNet‐PC‐RS232 with MartyPC Using HTTP S from BASIC Using NDEV in Atari DOS 2.0 2.5 Using SAM (Voice Synthesizer) Using the MODEM Sniffer Using the N: Device Using the N: Tools in DOS 2 Using the SD: protocol adapter. Virtual Apple II FujiNet Virtual Apple2 FujiNet Virtual Atari FujiNet Virtual CoCo FujiNet Virtual FujiNet Quickstart Guide What is FujiNet? XIO Commands YAIL Home fnjson.cpp Value Mangling Analysis main hardware main miscellaneous main software main user guide Change This main user guide main virtualization pio 3 x howto pio 6 x howto x test home
2 Run FujiNet with Altirra for Atari
Eric Carr edited this page 2025-02-16 14:33:34 -06:00
Table of Contents

Emulate Atari on Altirra + FujiNet-PC (up to 2 instances)

It is possible to run multiple instances of Fujinet-PC / Altirra to simulate two Ataris on a single computer for emulation.

Follow the guide below to setup 1 or 2 Altirra+FujiNet-PC environment on your Mac, Windows, or Linux machine.

Emulator Data Flow

Altirra (netsio.atdevice) -> FujiNet (NetSIO) Bridge -> FujiNet-PC

Altirra uses a custom device file to talk to the Python NetSIO bridge, which in turns talks to FujiNet-PC.

Out goal - have two instances

  • Altirra -> FujiNet Bridge (port 9996) -> FujiNet-PC (port 9997)
  • Altirra -> FujiNet Bridge (port 9986) -> FujiNet-PC (port 9987)

LET'S DO THIS

Install Dependencies

  1. FujiNet NetSIO bridge requires Python.
  1. Altirra is Windows only, so to run on Mac/Linux, use Wine64.

Download Altirra + FujiNet Applications

  1. Altirra - https://www.virtualdub.org/altirra.html

  2. Fujinet NetSIO Emulator Bridge - https://github.com/a8jan/fujinet-pc-launcher/releases

  • Download/unzip the latest fujinet-pc-scripts-* file
  1. FujiNet-PC Binaries - https://github.com/FujiNetWIFI/fujinet-firmware/releases/
  • Download the latest FujiNet-PC nightly build, unzip to fujinet-pc directory from step 2 above

Setup

We will basically create two copies of some files/directories, with the second copy modified to use different ports.

Step 1 - FujiNet-PC

Duplicate the fujinet-pc directory to fujinet-pc2 for the second instance

In fujinet-pc2/fnconfig.ini , change the port under NetSIO to 9987

[NetSIO]
enabled=1
host=localhost
port=9997

Step 2 - Altirra Device file

In emulator/Altirra, duplicate the netsio.atdevice file to netsio-2.atdevice.

Edit the second copy, changing the port from 9996 to 9986

option "network": 
{
    port: 9986
};

Step 3 - Altirra Instance 1

Start Altirra. Save a configuration as instance-1.ini Open the ini file and make the following changes (alternatively, you can do this in the Altirra screens and save the config afterward):

Disable fastboot so the fujinet config will boot

"Kernel: Fast boot enabled" = 0

Enable Altirra to run in the background

"Pause when inactive" = 0

If on a Mac, disable direct3d/9 to avoid crashes by editing the

"Display: Direct3D9" = 0
"Display: 3D" = 0

Add the FujiNet Bridge device (change to your emulator/Altirra path):

"Devices" = "[{\"tag\":\"custom\",\"params\":{\"hotreload\":false,\"path\":\"C:\\\\users\\\\eric\\\\My Documents\\\\projects\\\\fujinet-emulator-bridge\\\\emulator\\\\Altirra\\\\netsio.atdevice\"}}]"

Step 4 - Altirra Instance 2

Duplicate instance-1.ini to instance-2.ini

Open instance-2.ini and modify the device to point to netsio-2.device

"Devices" = "[{\"tag\":\"custom\",\"params\":{\"hotreload\":false,\"path\":\"C:\\\\users\\\\eric\\\\My Documents\\\\projects\\\\fujinet-emulator-bridge\\\\emulator\\\\Altirra\\\\netsio-2.atdevice\"}}]"

Boot It Up

Now, you should be able to run two instance of Altirra that connect to their own instances of FujiNet Bridge/FujiNet-PC

  1. Start FujiNet bridge for my two instances
cd ~/Documents/fujinet-pc-scripts/;python3 -m netsiohub --port 9996 --netsio-port 9997
cd ~/Documents/fujinet-pc-scripts/;python3 -m netsiohub --port 9986 --netsio-port 9987
  1. Start FujiNet PC
cd ~/Documents/fujinet-pc-scripts/fujinet-pc;./run-fujinet
cd ~/Documents/fujinet-pc-scripts/fujinet-pc2;./run-fujinet
  1. Start Altirra
cd ~/Documents/Altirra;wine64 Altirra64.exe /portablealt:instance-1.ini
cd ~/Documents/Altirra;wine64 Altirra64.exe /portablealt:instance-2.ini

You should see each boot into fujinet config. You can now use FujiNet on these two instances as separate machines.

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Copyright 2026 Contributors to the FujiNetWIFI project.

Join us on Discord: https://discord.gg/7MfFTvD