Skip to content

Dutchconsolefreak/FZ35-Shell-Project

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FZ-35S Shell Project

Overview

This project aims to provide a functional development environment for the M2 Portfolio OS, focusing on serial communication via the NS16550 UART - RS232 port.

The standard ROM-based shell is unusable for development because the kernel's native printf OS-calls are hardwired to the CDE2 ASIC UART. This project bypasses those limitations by reimplementing core system commands to use the NS16550 UART for serial communication (e.g., via TeraTerm).

Specifically developed and tested on the Panasonic FZ-35S. Compatibility with other M2 variants is unknown due to potential differences in serial port availability.

Knipsel

Technical Setup & Line Endings

This project is developed using the original M2 SDK inside the SheepShaver (Mac OS 9) emulator.

Line Ending Conversion (CR vs. LF)

Because Classic Mac OS uses CR (\r) line endings while GitHub and modern tools prefer LF (\n), this repository uses a custom Git filter to ensure compatibility:

  • In Git/GitHub: Files are stored using LF for proper web display and diffs.
  • In Workspace (SheepShaver): Files are automatically converted to CR upon checkout to remain compatible with the M2 SDK compiler and tools.

Required Git Configuration

To work with this repository without breaking the Mac OS 9 source files, you must configure the custom mac-classic filter on your local machine:

git config filter.mac-classic.clean "tr '\r' '\n'"
git config filter.mac-classic.smudge "tr '\n' '\r'"
git config core.autocrlf false

TeraTerm Serial Console Settings

To ensure correct communication with the M2 Shell, configure TeraTerm with the following settings:

Connection → Serial

Setting Value
Speed (Baud) 57600
Data bits 8
Stop bits 1
Parity None
Flow Control None

Terminal → New-line

  • Receive: LF
  • Transmit: CR

Keyboard → Transmit DEL by:

  • Delete key (Ensures correct character deletion in the shell)

Note: Tested with TeraTerm 5.6.1 on Windows 10. These settings match the NS16550 UART configuration used in the project's source code.

About

A custom shell and toolkit for the Panasonic FZ-35S M2 Unit.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors