Wiki Home >> FujiNet-Commands-Reference

FujiNet-Commands-Reference

FujiNet Commands Reference

A comprehensive reference guide for FujiNet commands based on the official fuji_commands.py source file from the FujiNet test suite.

Source: fujinet-tests/unitrix/fuji_commands.py

Overview
Command Quick Reference
WiFi Management Commands
Host Slot Commands
Device Slot Commands
Directory Commands
Disk Image Commands
App Key Commands
Base64 Encoding/Decoding Commands
Hash Commands
QR Code Commands
Device Control Commands
Clock Commands
Low-Level I/O Commands
System Commands
Argument Type Reference

Overview

FujiNet uses a command-based protocol to communicate between the host computer and the FujiNet device. Commands are identified by a single byte command code and may include arguments and/or return reply data.

Argument Types

Type	Description
`i8`	8-bit signed integer
`i16`	16-bit signed integer
`u8`	8-bit unsigned integer
`u16`	16-bit unsigned integer
`u32`	32-bit unsigned integer
`b`	Boolean
`s`	Variable length string/bytes
`s7`	Variable length string with 7-bit length prefix
`s8`	Variable length string with 8-bit length prefix
`s16`	Variable length string with 16-bit length prefix
`fNNN`	Fixed length string/bytes, padded to NNN bytes

Command Quick Reference

Code	Name	Category
`0xFF`	RESET	System
`0xFE`	GET_SSID	WiFi
`0xFD`	SCAN_NETWORKS	WiFi
`0xFC`	GET_SCAN_RESULT	WiFi
`0xFB`	SET_SSID	WiFi
`0xFA`	GET_WIFISTATUS	WiFi
`0xF9`	MOUNT_HOST	Host Slots
`0xF8`	MOUNT_IMAGE	Device Slots
`0xF7`	OPEN_DIRECTORY	Directory
`0xF6`	READ_DIR_ENTRY	Directory
`0xF5`	CLOSE_DIRECTORY	Directory
`0xF4`	READ_HOST_SLOTS	Host Slots
`0xF3`	WRITE_HOST_SLOTS	Host Slots
`0xF2`	READ_DEVICE_SLOTS	Device Slots
`0xF1`	WRITE_DEVICE_SLOTS	Device Slots
`0xF0`	ENABLE_UDPSTREAM	Device Control
`0xEB`	SET_BAUDRATE	Device Control
`0xEA`	GET_WIFI_ENABLED	WiFi
`0xE9`	UNMOUNT_IMAGE	Device Slots
`0xE8`	GET_ADAPTERCONFIG	System
`0xE7`	NEW_DISK	Disk Image
`0xE6`	UNMOUNT_HOST	Host Slots
`0xE5`	GET_DIRECTORY_POSITION	Directory
`0xE4`	SET_DIRECTORY_POSITION	Directory
`0xE3`	SET_HSIO_INDEX	Device Control
`0xE2`	SET_DEVICE_FULLPATH	Device Slots
`0xE1`	SET_HOST_PREFIX	Host Slots
`0xE0`	GET_HOST_PREFIX	Host Slots
`0xDF`	SET_SIO_EXTERNAL_CLOCK	Device Control
`0xDE`	WRITE_APPKEY	App Key
`0xDD`	READ_APPKEY	App Key
`0xDC`	OPEN_APPKEY	App Key
`0xDB`	CLOSE_APPKEY	App Key
`0xDA`	GET_DEVICE_FULLPATH	Device Slots
`0xD9`	CONFIG_BOOT	Device Control
`0xD8`	COPY_FILE	Disk Image
`0xD7`	MOUNT_ALL	Device Slots
`0xD6`	SET_BOOT_MODE	Device Control
`0xD5`	ENABLE_DEVICE	Device Control
`0xD4`	DISABLE_DEVICE	Device Control
`0xD3`	RANDOM_NUMBER	System
`0xD1`	DEVICE_ENABLE_STATUS	Device Control
`0xD0`	BASE64_ENCODE_INPUT	Base64
`0xCF`	BASE64_ENCODE_COMPUTE	Base64
`0xCE`	BASE64_ENCODE_LENGTH	Base64
`0xCD`	BASE64_ENCODE_OUTPUT	Base64
`0xCC`	BASE64_DECODE_INPUT	Base64
`0xCB`	BASE64_DECODE_COMPUTE	Base64
`0xCA`	BASE64_DECODE_LENGTH	Base64
`0xC9`	BASE64_DECODE_OUTPUT	Base64
`0xC8`	HASH_INPUT	Hash
`0xC7`	HASH_COMPUTE	Hash
`0xC6`	HASH_LENGTH	Hash
`0xC5`	HASH_OUTPUT	Hash
`0xC4`	GET_ADAPTERCONFIG_EXTENDED	System
`0xC3`	HASH_COMPUTE_NO_CLEAR	Hash
`0xC2`	HASH_CLEAR	Hash
`0xC1`	GET_HEAP	System
`0xBF`	QRCODE_OUTPUT	QR Code
`0xBE`	QRCODE_LENGTH	QR Code
`0xBD`	QRCODE_ENCODE	QR Code
`0xBC`	QRCODE_INPUT	QR Code
`0xA7`	GET_DEVICE8_FULLPATH	Device Slots
`0xA6`	GET_DEVICE7_FULLPATH	Device Slots
`0xA5`	GET_DEVICE6_FULLPATH	Device Slots
`0xA4`	GET_DEVICE5_FULLPATH	Device Slots
`0xA3`	GET_DEVICE4_FULLPATH	Device Slots
`0xA2`	GET_DEVICE3_FULLPATH	Device Slots
`0xA1`	GET_DEVICE2_FULLPATH	Device Slots
`0xA0`	GET_DEVICE1_FULLPATH	Device Slots
`0x57`	WRITE	Low-Level I/O
`0x53`	STATUS	Low-Level I/O
`0x52`	READ	Low-Level I/O
`0x4F`	OPEN	Low-Level I/O
`0x43`	CLOSE	Low-Level I/O
`0x3F`	HSIO_INDEX	Device Control
`0x02`	SEND_ERROR	System
`0x01`	SEND_RESPONSE	System
`0x00`	DEVICE_READY	System
`0x53` ('S')	GET_TIME_SOS	Clock
`0x49` ('I')	GET_TIME_ISO	Clock

WiFi Management Commands

0xFF - RESET

Resets the FujiNet device to its initial state.

Property	Value
Command	`0xFF`
Arguments	None
Reply	None

0xFE - GET_SSID

Retrieves the currently configured WiFi SSID.

Property	Value
Command	`0xFE`
Arguments	None
Reply	`data:s8` - SSID string with 8-bit length prefix

0xFD - SCAN_NETWORKS

Initiates a scan for available WiFi networks.

Property	Value
Command	`0xFD`
Arguments	None
Reply	`count:u8` - Number of networks found

0xFC - GET_SCAN_RESULT

Retrieves information about a discovered WiFi network.

Property	Value
Command	`0xFC`
Arguments	`index:u8` - Network index (0-based)
Reply	`data:s8` - Network information with 8-bit length prefix

0xFB - SET_SSID

Sets the WiFi SSID and password for connection.

Property	Value
Command	`0xFB`
Arguments	Implementation-specific (SSID + password structure)
Reply	None

0xFA - GET_WIFISTATUS

Returns the current WiFi connection status.

Property	Value
Command	`0xFA`
Arguments	None
Reply	`status:u8` - WiFi status code

Status Codes:
| Value | Status |
|-------|--------|
| 0 | Idle |
| 1 | No SSID available |
| 2 | Scan complete |
| 3 | Connected |
| 4 | Connect failed |
| 5 | Connection lost |
| 6 | Disconnected |

0xEA - GET_WIFI_ENABLED

Checks if WiFi is enabled.

Property	Value
Command	`0xEA`
Arguments	None
Reply	`data:s8` - WiFi enabled status

Host Slot Commands

FujiNet supports 8 host slots (0-7) for connecting to TNFS servers or other network hosts.

0xF4 - READ_HOST_SLOTS

Reads all eight host slot configurations.

Property	Value
Command	`0xF4`
Arguments	None
Reply	`data:f256` - 256 bytes containing 8 host slots (32 bytes each)

Data Structure: 8 × 32-byte null-terminated hostname strings.

0xF3 - WRITE_HOST_SLOTS

Writes all eight host slot configurations.

Property	Value
Command	`0xF3`
Arguments	`config:f256` - 256 bytes containing 8 host slots
Reply	None

0xF9 - MOUNT_HOST

Mounts (connects to) a host from the specified slot.

Property	Value
Command	`0xF9`
Arguments	`host_slot:u8` - Host slot number (0-7)
Reply	None

0xE6 - UNMOUNT_HOST

Unmounts (disconnects from) a host.

Property	Value
Command	`0xE6`
Arguments	`host_slot:u8` - Host slot number (0-7)
Reply	None

0xE1 - SET_HOST_PREFIX

Sets the current working directory prefix for a host.

Property	Value
Command	`0xE1`
Arguments	`host_slot:u8` - Host slot number (0-7) `prefix:f256` - 256-byte path string
Reply	None

0xE0 - GET_HOST_PREFIX

Gets the current working directory prefix for a host.

Property	Value
Command	`0xE0`
Arguments	`host_slot:u8` - Host slot number (0-7)
Reply	`prefix:f256` - 256-byte path string

Device Slot Commands

FujiNet supports 8 device slots (0-7) for virtual disk drives.

0xF2 - READ_DEVICE_SLOTS

Reads all device slot configurations.

Property	Value
Command	`0xF2`
Arguments	None
Reply	`data:f304` - 304 bytes containing device slot configuration

0xF1 - WRITE_DEVICE_SLOTS

Writes all device slot configurations.

Property	Value
Command	`0xF1`
Arguments	`config:f304` - 304 bytes containing device slot configuration
Reply	None

0xF8 - MOUNT_IMAGE

Mounts a disk image to a device slot.

Property	Value
Command	`0xF8`
Arguments	`device_slot:u8` - Device slot (0-7) `mode:u8` - Mount mode flags
Reply	None

Mode Flags:

Bit 0: Read-only if set
Bit 1: Create if not exists

0xE9 - UNMOUNT_IMAGE

Unmounts a disk image from a device slot.

Property	Value
Command	`0xE9`
Arguments	`device_slot:u8` - Device slot (0-7)
Reply	None

0xD7 - MOUNT_ALL

Mounts all configured device slots.

Property	Value
Command	`0xD7`
Arguments	None
Reply	None

0xE2 - SET_DEVICE_FULLPATH

Sets the full path (host, mode, and filename) for a device slot.

Property	Value
Command	`0xE2`
Arguments	`device_slot:u8` - Device slot (0-7) `host_slot:u8` - Host slot (0-7) `mode:u8` - Mount mode `filename:f256` - 256-byte filename
Reply	None

0xDA - GET_DEVICE_FULLPATH

Gets the full path for a device slot.

Property	Value
Command	`0xDA`
Arguments	`device_slot:u8` - Device slot (0-7)
Reply	`path:f256` - 256-byte path string

0xA0-0xA7 - GET_DEVICE[1-8]_FULLPATH

Quick access commands to get full path for specific device slots.

Command	Device Slot	Reply
`0xA0`	Device 1	`path:f256`
`0xA1`	Device 2	`path:f256`
`0xA2`	Device 3	`path:f256`
`0xA3`	Device 4	`path:f256`
`0xA4`	Device 5	`path:f256`
`0xA5`	Device 6	`path:f256`
`0xA6`	Device 7	`path:f256`
`0xA7`	Device 8	`path:f256`

Directory Commands

0xF7 - OPEN_DIRECTORY

Opens a directory for listing.

Property	Value
Command	`0xF7`
Arguments	`host_slot:u8` - Host slot (0-7) `path:s8` - Path string with 8-bit length
Reply	None

0xF6 - READ_DIR_ENTRY

Reads the next directory entry.

Property	Value
Command	`0xF6`
Arguments	`maxlen:u8` - Maximum entry length `addtl:u8` - Additional flags
Reply	`entry:s7` - Directory entry with 7-bit length prefix

0xF5 - CLOSE_DIRECTORY

Closes an open directory.

Property	Value
Command	`0xF5`
Arguments	None
Reply	None

0xE5 - GET_DIRECTORY_POSITION

Gets the current position in the directory listing.

Property	Value
Command	`0xE5`
Arguments	None
Reply	`position:u16` - Current position (16-bit)

0xE4 - SET_DIRECTORY_POSITION

Sets the current position in the directory listing.

Property	Value
Command	`0xE4`
Arguments	`position:u16` - Position to set (16-bit)
Reply	None

Disk Image Commands

0xE7 - NEW_DISK

Creates a new disk image.

Property	Value
Command	`0xE7`
Arguments	`size:u8` - Disk size code `host_slot:u8` - Host slot (0-7) `device_slot:u8` - Device slot (0-7) `filename:s8` - Filename with 8-bit length
Reply	None

0xD8 - COPY_FILE

Copies a file between hosts.

Property	Value
Command	`0xD8`
Arguments	`source_slot:u8` - Source host slot `dest_slot:u8` - Destination host slot `copy_spec:s8` - Copy specification with 8-bit length
Reply	None

App Key Commands

App Keys provide persistent key-value storage for applications.

0xDC - OPEN_APPKEY

Opens an app key for reading or writing.

Property	Value
Command	`0xDC`
Arguments	Structure: `{creator:u16, app:u8, key:u8, mode:i8, reserved:u8}`
Reply	None

Structure Fields:

creator:u16 - Creator ID (16-bit, values 0x00-0xFF reserved for FujiNet)
app:u8 - Application ID (8-bit)
key:u8 - Key ID (8-bit)
mode:i8 - Mode: 0=read, 1=write
reserved:u8 - Reserved byte

0xDD - READ_APPKEY

Reads data from an open app key.

Property	Value
Command	`0xDD`
Arguments	None
Reply	`data:f66` - Up to 66 bytes of data (length varies by platform)

0xDE - WRITE_APPKEY

Writes data to an open app key.

Property	Value
Command	`0xDE`
Arguments	`data:s16` - Data with 16-bit length prefix
Reply	None

0xDB - CLOSE_APPKEY

Closes an open app key.

Property	Value
Command	`0xDB`
Arguments	None
Reply	None

Base64 Encoding/Decoding Commands

Encoding Flow

0xD0 - BASE64_ENCODE_INPUT - Send data to encode
0xCF - BASE64_ENCODE_COMPUTE - Perform encoding
0xCE - BASE64_ENCODE_LENGTH - Get output length
0xCD - BASE64_ENCODE_OUTPUT - Retrieve encoded data

0xD0 - BASE64_ENCODE_INPUT

Sends data to be Base64 encoded.

Property	Value
Command	`0xD0`
Arguments	`length:u16` - Data length `data:s8` - Data with 8-bit length
Reply	None

0xCF - BASE64_ENCODE_COMPUTE

Performs the Base64 encoding operation.

Property	Value
Command	`0xCF`
Arguments	None
Reply	None

0xCE - BASE64_ENCODE_LENGTH

Gets the length of the encoded output.

Property	Value
Command	`0xCE`
Arguments	None
Reply	Encoded data length

0xCD - BASE64_ENCODE_OUTPUT

Retrieves the Base64 encoded data.

Property	Value
Command	`0xCD`
Arguments	`length:u16` - Number of bytes to retrieve
Reply	Encoded data

Decoding Flow

0xCC - BASE64_DECODE_INPUT - Send encoded data
0xCB - BASE64_DECODE_COMPUTE - Perform decoding
0xCA - BASE64_DECODE_LENGTH - Get output length
0xC9 - BASE64_DECODE_OUTPUT - Retrieve decoded data

0xCC - BASE64_DECODE_INPUT

Sends Base64 encoded data to be decoded.

Property	Value
Command	`0xCC`
Arguments	`length:u16` - Data length `data:s8` - Encoded data with 8-bit length
Reply	None

0xCB - BASE64_DECODE_COMPUTE

Performs the Base64 decoding operation.

Property	Value
Command	`0xCB`
Arguments	None
Reply	None

0xCA - BASE64_DECODE_LENGTH

Gets the length of the decoded output.

Property	Value
Command	`0xCA`
Arguments	None
Reply	Decoded data length

0xC9 - BASE64_DECODE_OUTPUT

Retrieves the decoded data.

Property	Value
Command	`0xC9`
Arguments	`length:u16` - Number of bytes to retrieve
Reply	Decoded data

Hash Commands

Hash Computation Flow

0xC8 - HASH_INPUT - Send data to hash
0xC7 - HASH_COMPUTE - Compute hash with algorithm
0xC6 - HASH_LENGTH - Get hash output length
0xC5 - HASH_OUTPUT - Retrieve hash result

0xC8 - HASH_INPUT

Sends data to be hashed.

Property	Value
Command	`0xC8`
Arguments	`data:s16` - Data with 16-bit length prefix
Reply	None

0xC7 - HASH_COMPUTE

Computes the hash using the specified algorithm.

Property	Value
Command	`0xC7`
Arguments	`algorithm:u8` - Hash algorithm ID
Reply	None

Algorithm IDs:
| Value | Algorithm |
|-------|-----------|
| 0 | MD5 |
| 1 | SHA-1 |
| 2 | SHA-256 |
| 3 | SHA-512 |

0xC6 - HASH_LENGTH

Gets the length of the hash output.

Property	Value
Command	`0xC6`
Arguments	`as_hex:b` - If true, return length of hex string
Reply	Hash length

0xC5 - HASH_OUTPUT

Retrieves the computed hash.

Property	Value
Command	`0xC5`
Arguments	`as_hex:b` - If true, return hash as hex string
Reply	Hash data

0xC3 - HASH_COMPUTE_NO_CLEAR

Computes the hash without clearing the input buffer (allows incremental hashing).

Property	Value
Command	`0xC3`
Arguments	None
Reply	None

0xC2 - HASH_CLEAR

Clears the hash input buffer.

Property	Value
Command	`0xC2`
Arguments	None
Reply	None

QR Code Commands

QR Code Generation Flow

0xBC - QRCODE_INPUT - Send data to encode
0xBD - QRCODE_ENCODE - Generate QR code
0xBE - QRCODE_LENGTH - Get output length
0xBF - QRCODE_OUTPUT - Retrieve QR code data

0xBC - QRCODE_INPUT

Sends data to be encoded as a QR code.

Property	Value
Command	`0xBC`
Arguments	`length:u16` - Data length `data:s8` - Data with 8-bit length
Reply	None

0xBD - QRCODE_ENCODE

Generates the QR code with specified parameters.

Property	Value
Command	`0xBD`
Arguments	`version:u8` - QR version (1-40) `ecc_mode:u8` - Error correction level `shorten:u8` - URL shortening flag
Reply	None

ECC Modes:
| Value | Level | Recovery |
|-------|-------|----------|
| 0 | L | ~7% |
| 1 | M | ~15% |
| 2 | Q | ~25% |
| 3 | H | ~30% |

0xBE - QRCODE_LENGTH

Gets the length of the QR code output.

Property	Value
Command	`0xBE`
Arguments	None
Reply	QR code data length

0xBF - QRCODE_OUTPUT

Retrieves the generated QR code data.

Property	Value
Command	`0xBF`
Arguments	`mode:u8` - Output mode
Reply	QR code data

Device Control Commands

0xD5 - ENABLE_DEVICE

Enables a device.

Property	Value
Command	`0xD5`
Arguments	`device:u8` - Device identifier
Reply	None

0xD4 - DISABLE_DEVICE

Disables a device.

Property	Value
Command	`0xD4`
Arguments	`device:u8` - Device identifier
Reply	None

0xD1 - DEVICE_ENABLE_STATUS

Gets the enable/disable status of devices.

Property	Value
Command	`0xD1`
Arguments	None
Reply	Device status bitmap

0xD6 - SET_BOOT_MODE

Sets the boot mode.

Property	Value
Command	`0xD6`
Arguments	`mode:u8` - Boot mode value
Reply	None

0xD9 - CONFIG_BOOT

Enables or disables automatic CONFIG boot.

Property	Value
Command	`0xD9`
Arguments	`enable:u8` - 0=disable, 1=enable
Reply	None

0xE3 - SET_HSIO_INDEX

Sets the High-Speed I/O index.

Property	Value
Command	`0xE3`
Arguments	Implementation-specific
Reply	None

0x3F - HSIO_INDEX

Gets or sets the High-Speed I/O index.

Property	Value
Command	`0x3F`
Arguments	None
Reply	None

0xEB - SET_BAUDRATE

Sets the communication baud rate.

Property	Value
Command	`0xEB`
Arguments	Implementation-specific
Reply	None

0xDF - SET_SIO_EXTERNAL_CLOCK

Configures external SIO clock settings.

Property	Value
Command	`0xDF`
Arguments	Implementation-specific
Reply	None

0xF0 - ENABLE_UDPSTREAM

Enables UDP streaming mode (used for MIDIMaze, etc.).

Property	Value
Command	`0xF0`
Arguments	Implementation-specific
Reply	None

Clock Commands

0x53 ('S') - GET_TIME_SOS

Gets the current time in SOS format.

Property	Value
Command	`0x53` ('S')
Arguments	None
Reply	Time in SOS format

0x49 ('I') - GET_TIME_ISO

Gets the current time in ISO format.

Property	Value
Command	`0x49` ('I')
Arguments	None
Reply	Time in ISO 8601 format

Low-Level I/O Commands

These commands provide basic I/O operations.

0x4F ('O') - OPEN

Opens a resource.

Property	Value
Command	`0x4F` ('O')
Arguments	`mode:u8` - Open mode `data:s` - Resource specification
Reply	None

0x43 ('C') - CLOSE

Closes a resource.

Property	Value
Command	`0x43` ('C')
Arguments	None
Reply	None

0x52 ('R') - READ

Reads data from a resource.

Property	Value
Command	`0x52` ('R')
Arguments	`handle:u8` - Resource handle
Reply	Data

0x57 ('W') - WRITE

Writes data to a resource.

Property	Value
Command	`0x57` ('W')
Arguments	`handle:u8` - Resource handle `data:s` - Data to write
Reply	None

0x53 ('S') - STATUS

Gets the status of a resource.

Property	Value
Command	`0x53` ('S')
Arguments	None
Reply	`status:u32` - 32-bit status value

System Commands

0xE8 - GET_ADAPTERCONFIG

Gets the network adapter configuration.

Property	Value
Command	`0xE8`
Arguments	None
Reply	`data:s8` - Configuration data with 8-bit length

0xC4 - GET_ADAPTERCONFIG_EXTENDED

Gets extended network adapter configuration.

Property	Value
Command	`0xC4`
Arguments	None
Reply	`data:s8` - Extended configuration data with 8-bit length

0xC1 - GET_HEAP

Gets heap memory information (for debugging).

Property	Value
Command	`0xC1`
Arguments	None
Reply	Heap information

0xD3 - RANDOM_NUMBER

Generates a random number.

Property	Value
Command	`0xD3`
Arguments	None
Reply	Random number

0x00 - DEVICE_READY

Checks if the device is ready.

Property	Value
Command	`0x00`
Arguments	None
Reply	None

0x01 - SEND_RESPONSE

Sends a response (internal).

Property	Value
Command	`0x01`
Arguments	None
Reply	None

0x02 - SEND_ERROR

Sends an error (internal).

Property	Value
Command	`0x02`
Arguments	None
Reply	None

Argument Type Reference

Type	Size	Description
`i8`	1 byte	8-bit signed integer (-128 to 127)
`i16`	2 bytes	16-bit signed integer (-32768 to 32767)
`u8`	1 byte	8-bit unsigned integer (0 to 255)
`u16`	2 bytes	16-bit unsigned integer (0 to 65535)
`u32`	4 bytes	32-bit unsigned integer
`b`	1 byte	Boolean (0=false, non-zero=true)
`s`	variable	Variable length string/bytes
`s7`	variable	String with 7-bit length prefix
`s8`	variable	String with 8-bit length prefix
`s16`	variable	String with 16-bit length prefix
`fNNN`	NNN bytes	Fixed-length string, zero-padded

References

Source File: fujinet-tests/unitrix/fuji_commands.py
FujiNet Firmware Repository: https://github.com/FujiNetWIFI/fujinet-firmware
FujiNet Wiki: https://github.com/FujiNetWIFI/fujinet-firmware/wiki
FujiNet Discord: https://discord.gg/7MfFTvD

This documentation was generated from the official FujiNet test suite source code.
Copyright 2024-2026 Contributors to the FujiNetWIFI project.

Wiki content is mirrored from the FujiNet Github Wiki