/
Release verification 0.95 (batch #2) instructions and tips

Release verification 0.95 (batch #2) instructions and tips

This is the home page for our effort to validate the MEGA65 firmware and system software for the Q4’2022 shipping batch, known as “release 0.95.” If you have a batch #1 MEGA65 (“R3”) or a Dev Kit, or a Nexys 4DDR board, you can help!

We especially need people to test with a batch #1 MEGA65 (“R3”). If you have a JTAG interface and a clean SD card, you can set up your MEGA65 to most closely resemble a factory install, with the release candidate core in slot 0. If you do not have a JTAG interface, you can still test the firmware and system software with the core in slot 1.

Current release candidate

Latest release candidate SD card contents (possibly newer than in the release candidate archive):

There are also test distributions for R2 and Nexys 4DDR boards, though issues specific to these boards will need to be considered separately from this release.

Known issues

See [R0.95] MEGA65 Release 0.95 (Batch 2) Milestone · MEGA65/mega65-core for major known issues being tracked for this release.

Additionally:

  • “having trouble running GEOS65 in the past please try to mount GEOS65.d81 from clean ready prompt oder set it to default image in config”

How to report issues

Please check whether a bug has already been filed before creating a new issue! This helps us with de-duplicating and triage. When possible, comment on an existing issue.

If you have found a new issue with the core in slot 0, the Onboarding tool, the Config Tool, or the Flasher menu, click New Issue on that page to associate the new issue with the release milestone.

To report an issue with the release prep disk, visit mega65-release-pre Github Issues, then click new Issue. It will be triaged to the appropriate repo and priority for release.

Requested tests

We are currently focusing on: Testing everything!

Note: first flash your MEGA, then do the other tests!

  • If you have a JTAG connector:

    • (Consider doing the slot 1 tests, below, before installing the core into slot 0.)

    • Flash the COR into slot 0. (See instructions below.)

    • Test the configuration utility.

      • Hold ALT while powering on.

      • Test RTC setting. See updated date formatting.

      • Test MAC address: press R to randomize.

    • Test the onboarding utility.

      • From configuration utility, Exit and Reboot to Onboarding.

      • Test RTC setting. See updated date formatting.

    • Test the core utility.

      • Hold NO SCROLL while powering on.

      • Try installing different cores in different slots.

      • Press HELP to get version information. (If HELP asks for a file, you have an old version of the flasher.)

      • Try to break it!

    • Press and hold random keys while powering on.

  • Install the COR into slot 1.

    • Copy the COR onto the SD card.

    • Hold NO SCROLL while powering on to enter the core installation/selection menu.

    • Press Ctrl + 1, then select MEGA65R3.COR and follow prompts to install the COR in slot 1.

  • With the COR in slot 1:

    • Hold ALT while powering on to access Configuration. It should say v1.0, using the Configuration menu from the slot 1 core.

    • Hold ALT while powering on to access the SD Card utility. It should say v0.24, using the SD Card menu from the slot 1 core.

  • Prepare a fresh SD card using the sdcard-files provided in the release candidate download.

    • Linux and macOS: Use the copy-flash.sh script to install the files onto a previously-prepared SD card. (This copies the files with the recommended defragmentation technique.)

    • If you have a full-size SD card that you’re willing to fully erase:

      • Open the case and insert it into the internal SD card slot.

      • Use the SD Card utility (from the Alt boot menu) to prepare, erase, and install the system software in the internal slot.

      • Move the SD card to your PC and install all files from mega65-release-prep.

      • Eject it from your PC and reinsert it into the internal SD card slot.

      • This (plus the core in slot 0) is the complete launch configuration for batch #2.

  • Test all programs on the MEGA65.D81 disk.

  • Test GEOS65.D81 (included in mega65-release-prep).

  • Try the Turrican Engine Demo by Shallan.

  • Test other programs that you use, develop, or own.

How to flash a core to slot 0

Note: there is a updated version here Slot 0 Upgrade (Work in Progress)archived

You must use the m65 command line tool (the “refactor” version). Using M65Connect will currently not work!

  1. Copy the latest release COR file to the SD card, using a short filename such as R3RC1.COR.
    Make sure that you also have all required files on your sdcard, as using jtagflash needs a running MEGA65 System!

  2. Turn off your MEGA65.

  3. Open the MEGA65 case.

  4. Set DIP switch 3 to ON. (Switch 1 is closest to the front of the case. “ON” is to the left.)