Skip to main content

Syncing with Computer

Spectranext includes an onboard XFS filesystem directly on the cartridge, providing local storage that doesn't require a network connection. You can upload files directly to the cartridge from your computer, and then access them from Spectrum programs by mounting the XFS filesystem. This provides a simple, convenient way to transfer files for development workflows.

Overview​

Spectranext provides multiple ways to upload files to the cartridge's onboard XFS filesystem:

  1. Web File Browser: Access the file manager at device.spectranext.net (recommended)
  2. SPX Command-Line Tool: Upload/download files via spx command

All methods upload files to the cartridge's RAM filesystem, which can then be accessed from Spectrum programs by mounting the XFS filesystem: %mount 0, "xfs://ram/". Files are stored directly on the cartridge, making them immediately available without requiring a network connection or TNFS server.

Development Workflow​

Method 1: Web File Browser​

The easiest way to manage files on your Spectranext cartridge is through the web-based file browser:

  1. Open the File Browser: Navigate to device.spectranext.net in your web browser
  2. Connect to Device: Click the "Connect" button and select your Spectranext device from the USB device picker (the device named "spectranext")
  3. Manage Files: Once connected, you can:
    • Browse the RAM filesystem
    • Upload files via drag-and-drop
    • Download files
    • Create/delete directories
    • View text file contents
    • Refresh the file list

The file browser uses the Web Serial API to communicate directly with your Spectranext device via USB CDC. Files uploaded via the browser are immediately stored on the cartridge's onboard filesystem and can be accessed after mounting XFS on Spectrum.

Browser Compatibility: The Web Serial API is supported in Chromium-based browsers (Chrome, Edge, Opera). Firefox and Safari do not currently support Web Serial API.

Method 2: SPX Command-Line Tools​

Note on accessing SPX

In order for spx tools to work, add spectranext-sdk/bin folder to your PATH. Installation script helps you do that.

Working with FuseX Emulator

The SPX command-line tools and SDK operations work with both physical Spectranext hardware and the FuseX emulator. When using FuseX, the spx tool will connect via TCP instead of USB. This allows you to develop and test your programs entirely in the emulator before deploying to physical hardware.

The web file browser (Method 1) only works with physical hardware via USB CDC.

The SDK provides spx command-line tool for programmatic file transfer:

# List files in RAMFS
spx ls

# Upload a file
spx put localfile.bin /remotefile.bin

# Download a file
spx get /remotefile.bin localfile.bin

# Create directory
spx mkdir /mydir

# Move/rename file
spx mv /oldname.bin /newname.bin

# Delete file
spx rm /file.bin

# Remove directory
spx rmdir /mydir

# Trigger ZX Spectrum reboot
spx reboot

# Configure autoboot from xfs://ram/ and reboot
spx autoboot

The spx tool connects via USB CDC for physical hardware (or TCP for FuseX emulator) and works directly with the cartridge's onboard RAM filesystem. Files uploaded via spx put are immediately available on the cartridge/emulator and can be accessed after mounting XFS on Spectrum.

Next Steps​