picoZ80 Benutzerhandbuch

picoZ80 Benutzerhandbuch

Board-Übersicht

Anschlüsse und Anzeigen

Debug-Header Pinbelegung

Hinweis: Pins 1, 2 und 5 werden für SWD-Debugging verwendet (SWCLK, SWDIO, GND). Pins 3 und 6 werden nur für die Erstprogrammierung benötigt. Pin 4 wird verwendet, wenn der ESP32 während des RP2350-Boots nicht starten soll (z.B. während der ersten ESP32-Firmware-Programmierung).

Erste Schritte

Schritt 1 — RP2350-Bootloader flashen

Schritt 2 — ESP32-Firmware flashen

python3 -m venv ./venv/
source ./venv/bin/activate
cd $HOME/esptool

PORT=/dev/ttyUSB0       # Linux — bei Bedarf anpassen
# PORT=/dev/tty.usbmodem141403  # macOS

BINPATH=/path/to/esp32/build

python3 ./esptool.py \
  -p ${PORT} -b 115200 \
  --before default_reset --after hard_reset \
  --chip esp32s3 \
  write_flash \
  --flash_mode dio --flash_size 4MB --flash_freq 80m \
  0x0     ${BINPATH}/bootloader.bin \
  0x8000  ${BINPATH}/partition-table.bin \
  0x9000  ${BINPATH}/ota_data_initial.bin \
  0x10000 ${BINPATH}/sd_card.bin

Hinweis: Alle weiteren ESP32-Firmware-Updates können über die OTA-Webseite (ota-esp32.htm) durchgeführt werden, sobald der erste Flash-Vorgang abgeschlossen ist.

Schritt 3 — SD-Karte vorbereiten

Schritt 4 — Installation im Host-Computer

Hinweis: Der picoZ80 bezieht seine Stromversorgung über den 5V-Anschluss am Z80-Sockel VCC-Pin. Der integrierte Abwärtswandler liefert 3,3V an alle Board-Komponenten. Stellen Sie sicher, dass die 5V-Versorgung Ihres Host-Computers mindestens 500mA liefern kann — der picoZ80 kann unter Spitzenlast bis zu 400mA aufnehmen (RP2350 bei 300MHz mit aktivem WiFi).

WiFi-Einrichtung

Verbindung im Access-Point-Modus

Client-Modus (Station-Modus)

http://192.168.1.192

Web-Oberfläche

Dashboard (index.htm)

Konfigurationseditor (config.htm)

Hinweis: Der Konfigurationseditor arbeitet direkt mit der Datei auf der SD-Karte. Es ist empfehlenswert, vor wesentlichen Änderungen eine Sicherungskopie einer funktionierenden config.json auf Ihrem PC aufzubewahren.

GUI-Konfiguration (configgui.htm)

Dateimanager (filemanager.htm)

Persona-Auswahl (personality.htm)

Firmware-Updates (OTA)

WiFi-Manager (wifimanager.htm)

Grundkonfiguration

{
  "esp32": {
    "core": {
      "device": "Z80",
      "mode":   0
    },
    "wifi": {
      "override":  1,
      "wifimode":  "client",
      "ssid":      "YourNetwork",
      "password":  "YourPassword",
      "ip":        "192.168.1.192",
      "netmask":   "255.255.255.0",
      "gateway":   "192.168.1.1",
      "dhcp":      0,
      "webfs":     "webfs",
      "persist":   0
    }
  },
  "rp2350": {
    "core": {
      "cpufreq":   300000000,
      "psramfreq": 133000000,
      "voltage":   1.10
    },
    "z80": [
      {
        "memory": [
          {
            "enable":   1,
            "addr":     "0x0000",
            "size":     "0x1000",
            "type":     "ROM",
            "bank":     0,
            "tcycwait": 0,
            "tcycsync": 0,
            "task":     "",
            "file":     "/ROM/mz700.rom",
            "fileofs":  0
          },
          {
            "enable":   1,
            "addr":     "0x1000",
            "size":     "0xCFFF",
            "type":     "RAM",
            "bank":     0,
            "tcycwait": 0,
            "tcycsync": 0,
            "task":     "",
            "file":     "",
            "fileofs":  0
          },
          {
            "enable":   1,
            "addr":     "0xD000",
            "size":     "0x3000",
            "type":     "PHYSICAL_VRAM",
            "bank":     0,
            "tcycwait": 2,
            "tcycsync": 1,
            "task":     "",
            "file":     "",
            "fileofs":  0
          }
        ],
        "io":      [],
        "drivers": []
      }
    ]
  }
}

Netzwerk-Dateiserver-Einrichtung

# Dateien aus dem aktuellen Verzeichnis auf dem Standardport 6800 bereitstellen:
python3 netfs.py --dir ./mzf_files

# Dateien auf einem benutzerdefinierten Port mit mehreren Unit-Verzeichnissen bereitstellen:
python3 netfs.py --port 6800 --dir ./games --dir2 ./utilities --dir3 ./basic_programs

# Jedes --dirN wird auf NETx: in BASIC abgebildet (--dir = NET1:, --dir2 = NET2:, usw.)

DIR NET1:                  Dateien auf Netzwerk-Unit 1 auflisten (PC-Verzeichnis)
LOAD "NET1:MYPROG"         Ein Programm vom PC laden
SAVE "NET1:MYPROG"         Ein Programm auf dem PC speichern
LOAD "NET3:GAME"           Von Unit 3 laden (zugeordnet zu --dir3)

Treiber und Schnittstellen

Sharp MZ / X1 Serie

"drivers": [
  {
    "name": "MZ700",
    "enable": 1,
    "type": "VIRTUAL",
    "if": [
      {
        "name": "RFS",
        "type": "VIRTUAL",
        "enable": 1,
        "rom": [
          {
            "file": "roms/MROM_PICOZ80_256.bin",
            "enable": 1,
            "loadaddr": [
              { "enable": 1, "position": "0x0", "addr": "0x0",
                "bank": 32, "size": "0x80000", "tcycwait": 0, "tcycsync": 0 }
            ]
          },
          {
            "file": "roms/USER_ROM_PICOZ80_256.bin",
            "enable": 1,
            "loadaddr": [
              { "enable": 1, "position": "0x0", "addr": "0x0",
                "bank": 40, "size": "0x80000", "tcycwait": 0, "tcycsync": 0 }
            ]
          }
        ]
      },
      {
        "name": "MZ-1E05",
        "type": "VIRTUAL",
        "enable": 1,
        "param": [
          { "file": "dsk/MZ-2Z009-RFS.dsk", "enable": 1 }
        ]
      },
      {
        "name": "MZ-1E19",
        "type": "VIRTUAL",
        "enable": 1,
        "param": [
          { "file": "qd/BASIC_5Z008A_RFS.qd", "enable": 1 },
          { "file": "qd/BASIC_5Z008B.qd", "enable": 1 }
        ]
      },
      {
        "name": "Celestite",
        "type": "VIRTUAL",
        "enable": 1,
        "param": [
          { "file": "ram/celestite_r12.ram", "enable": 1 },
          { "file": "ram/celestite_r37.ram", "enable": 1 },
          { "ip": "192.168.1.210:6800", "enable": 1 }
        ]
      }
    ]
  }
]

{ "ip": "192.168.1.210:6800", "enable": 1 }

{
  "name": "MZ-1E30",
  "type": "VIRTUAL",
  "enable": 1,
  "rom": [{ "file": "roms/MZ-1E30.ROM", "enable": 1 }],
  "param": [
    { "file": "hdd/boot.hdd", "enable": 1 },
    { "file": "hdd/data.hdd", "enable": 1 }
  ]
}

Amstrad PCW Serie

Tatung Einstein Serie

Weitere Maschinen

ICE (Debug-Shell)

Fehlerbehebung

Host-Computer startet nicht

Verbindung zur Web-Oberfläche nicht möglich

SD-Karte wird nicht erkannt

ROM-Images werden nicht geladen

Board setzt sich unerwartet zurück oder startet neu

OTA-Update schlägt fehl

Referenzseiten

FCC / RED Regulatorischer Hinweis