// readme

🚀 JanOS-app

🧭 What This Script Does

A terminal-based Python controller for projectZero (JanOS) firmware over UART. JanOS_app.py connects to a LAB5 devices through a serial port and provides an interactive menu. The script sends text commands to projectZero over UART (115200), parses responses, and displays live status output.

📦 Requirements

  • Python 3.10+
  • pyserial
  • serial access to your JanOS device (/dev/ttyUSB0, /dev/cu.usbserial-*, etc.)

Install dependency:

python3 -m pip install -r requirements.txt

▶️ Usage

git clone https://github.com/D3h420/JanOS-app.git
cd JanOS-app
python3 JanOS_app.py

When started without arguments, the app waits for MonsterC5 and automatically opens its USB UART port. On macOS it prefers the /dev/cu.usbserial-* call-out device, so sudo and a manually supplied port are not required.

An explicit device path is still available as an override:

python3 JanOS_app.py /dev/cu.usbserial-230

M5Stack Cardputer Zero

The repository also contains a complete native ARM64 APPLaunch application for M5Stack Cardputer Zero. It uses the same…