firestarter 3.2.4__tar.gz → 3.2.6__tar.gz

{firestarter-3.2.4/firestarter.egg-info → firestarter-3.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firestarter
-Version: 3.2.4
+Version: 3.2.6
 Summary: EPROM programmer software for the Relatively Universal ROM Programmer
 Author-email: Henrik Olsson <henols@gmail.com>
 Project-URL: Homepage, https://github.com/henols/firestarter_app

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '3.2.4'
-__version_tuple__ = version_tuple = (3, 2, 4)
+__version__ = version = '3.2.6'
+__version_tuple__ = version_tuple = (3, 2, 6)
 
-__commit_id__ = commit_id = 'g3023daa'
+__commit_id__ = commit_id = 'g6a02a12'

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/chip_resolver.py

@@ -9,7 +9,7 @@ Single chokepoint between CLI dispatch and the EPROM database lookup/conversion.
 
 from typing import Any
 
-from firestarter.database import EpromDatabase
+from firestarter.database import ROM_CE, ROM_OE, EpromDatabase
 from firestarter.exceptions import (
     AmbiguousChipNameError,
     ChipNotFoundError,
@@ -133,6 +133,15 @@ def resolve_chip(name: str, db: EpromDatabase | None = None) -> dict[str, Any]:
     # A pin map with fewer address lines than the chip's size needs would
     # repeat one window of the chip across the whole operation, silently.
     bus = data.get("bus-config", {}).get("bus")
+    # The shield wires one socket pin to its CE driver and one to its OE
+    # driver. get_bus_config gives an address pin there the ROM_CE / ROM_OE
+    # sentinel, which is not a bus line the firmware can drive.
+    if bus and {ROM_CE, ROM_OE} & set(bus):
+        raise ChipNotImplementedError(
+            f"{name}: its pin map puts an address line on a socket pin that the "
+            "shield drives as CE or OE. The programmer cannot drive that "
+            "address line."
+        )
     if bus and data["memory-size"] > 1 << len(bus):
         raise ChipNotImplementedError(
             f"{name}: its pin map has {len(bus)} address lines, which reach "

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/cli_handlers.py

@@ -1443,9 +1443,11 @@ def erase(
 
     eprom_data = resolve_chip(eprom, db=app.db)
 
+    # The database leaves FLAG_CAN_ERASE clear for flash4, so `write` never
+    # carries it. The erase sets it for this command only; setup_command
+    # refuses it on firmware without the 5 V software chip erase.
     if flash4_erase_gate.is_flash4(eprom_data):
-        click.echo(flash4_erase_gate.refusal_text(eprom))
-        sys.exit(0 if ignore_unsupported else 1)
+        eprom_data = flash4_erase_gate.with_erase_flag(eprom_data)
 
     full_record = app.db.get_eprom(eprom) or {}
     if dip24_2816_erase_gate.is_affected(full_record.get("pin-map")):

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/codec.py

@@ -74,7 +74,8 @@ def format_message(msg_id: int, params: List[Any], entry: MessageDef) -> str | N
 
     P-02 MSG_OK_REV  — params[0]=physical u8, params[1]=effective u8
       effective==0xFF → "Rev{physical}" (no override)
-      effective!=0xFF → "Rev{effective}, Override HW: Rev{physical}"
+      effective!=0xFF → "Rev{effective}, Detected HW: Rev{physical}"
+      (the override is in effect; the second field is what the board detected)
 
     P-03 MSG_OK_CFG  — params[0]=r1 u32, params[1]=r2 u32, params[2]=override u8,
                        params[3]=bandgap_mv u16 (absent on firmware before 3.1.0b4)
@@ -104,7 +105,7 @@ def format_message(msg_id: int, params: List[Any], entry: MessageDef) -> str | N
         if effective == 0xFF:
             return phys_str
         eff_str = _REVISION_SILKSCREEN.get(effective, f"Rev{effective}")
-        return f"{eff_str}, Override HW: {phys_str}"
+        return f"{eff_str}, Detected HW: {phys_str}"
 
     if msg_id == MSG_OK_CFG and len(params) in (3, 4):
         r1, r2, override = params[0], params[1], params[2]

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/data/chip_database.json

@@ -1710,7 +1710,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "protocol-not-implemented",
+      "unsupported_reason": "protocol not implemented: pin map DIP28_27011 gives 14 address lines, which reach 16384 of the chip's 131072 bytes. The programmer implements no way to reach the rest."
     },
     {
       "electrical": {
@@ -5989,7 +5990,7 @@
         "vpp_mv": 12500
       },
       "part_number": "MBM27C1000P,MBM27C1000",
-      "pinout": "DIP32_27C020",
+      "pinout": "DIP32_27C301",
       "programming": {
         "algorithm": 8,
         "chip_id_check": true,
@@ -5999,7 +6000,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 500
       },
-      "support_status": "supported"
+      "support_status": "adapter-required",
+      "unsupported_reason": "adapter required: the shield drives chip pin 22 as CE and pin 24 as OE, but pin map DIP32_27C301 needs other functions on pins [2, 24]. An adapter must move those pins."
     },
     {
       "electrical": {
@@ -6058,7 +6060,7 @@
         "vpp_mv": 12500
       },
       "part_number": "MBM27C2000P,MBM27C2000",
-      "pinout": "DIP32_27C020",
+      "pinout": "DIP32_27C301",
       "programming": {
         "algorithm": 8,
         "chip_id_check": true,
@@ -6068,7 +6070,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "adapter-required",
+      "unsupported_reason": "adapter required: the shield drives chip pin 22 as CE and pin 24 as OE, but pin map DIP32_27C301 needs other functions on pins [2, 24]. An adapter must move those pins."
     },
     {
       "electrical": {
@@ -6464,7 +6467,7 @@
         "vpp_mv": 12500
       },
       "part_number": "HN27C301AG,HN27C301AP,HN27C301AFP",
-      "pinout": "DIP32_27C020",
+      "pinout": "DIP32_27C301",
       "programming": {
         "algorithm": 8,
         "chip_id_check": true,
@@ -6474,7 +6477,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "adapter-required",
+      "unsupported_reason": "adapter required: the shield drives chip pin 22 as CE and pin 24 as OE, but pin map DIP32_27C301 needs other functions on pins [2, 24]. An adapter must move those pins."
     },
     {
       "electrical": {
@@ -6486,7 +6490,7 @@
         "vpp_mv": 12500
       },
       "part_number": "HN27C301G",
-      "pinout": "DIP32_27C020",
+      "pinout": "DIP32_27C301",
       "programming": {
         "algorithm": 8,
         "chip_id_check": false,
@@ -6496,7 +6500,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "adapter-required",
+      "unsupported_reason": "adapter required: the shield drives chip pin 22 as CE and pin 24 as OE, but pin map DIP32_27C301 needs other functions on pins [2, 24]. An adapter must move those pins."
     },
     {
       "electrical": {
@@ -7407,7 +7412,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "protocol-not-implemented",
+      "unsupported_reason": "protocol not implemented: pin map DIP28_27011 gives 14 address lines, which reach 16384 of the chip's 131072 bytes. The programmer implements no way to reach the rest."
     },
     {
       "electrical": {
@@ -7429,7 +7435,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "protocol-not-implemented",
+      "unsupported_reason": "protocol not implemented: pin map DIP28_27011 gives 14 address lines, which reach 16384 of the chip's 131072 bytes. The programmer implements no way to reach the rest."
     },
     {
       "electrical": {
@@ -11966,7 +11973,7 @@
         "vpp_mv": 13000
       },
       "part_number": "M27C1000",
-      "pinout": "DIP32_27C020",
+      "pinout": "DIP32_27C301",
       "programming": {
         "algorithm": 8,
         "chip_id_check": true,
@@ -11976,7 +11983,8 @@
         "protect_on_after": false,
         "pulse_duration_us": 100
       },
-      "support_status": "supported"
+      "support_status": "adapter-required",
+      "unsupported_reason": "adapter required: the shield drives chip pin 22 as CE and pin 24 as OE, but pin map DIP32_27C301 needs other functions on pins [2, 24]. An adapter must move those pins."
     },
     {
       "electrical": {
@@ -15655,8 +15663,9 @@
       },
       "provenance": "VAR-05 / D-10 \u2014 TI 2532 is a physically real 4KB 24-pin UV-EPROM with a NON-JEDEC pinout (2532 != JEDEC 2732); absent from minipro infoic.xml. The 2516_EPROM.pdf is the TI 2500-series UV-EPROM family datasheet covering the 2516/2532 lineage; VPP=pin 21 / A11=pin 18 / !PD-PGM=pin 20 distinguishes the 2532 from the DIP24_2732 layout. Modeled by the new DIP24_2532 pinout entry. Carries the same UNVERIFIED posture as the 2516 row (no on-hand bench proof).",
       "source": "non-upstream-supplement",
-      "support_status": "supported",
-      "verification_note": "SAFE-04 / D-11: resolvable for read/info but NOT write-graduated \u2014 no on-hand 2532 silicon was bench-tested. Non-JEDEC 24-pin oddball; the DIP24_2532 pinout is a tentative leaf layout requiring bench validation. VPP lands on pin 21 (DIP24_2532 vpp-pin) per the TI family datasheet \u2014 the GATE-03 structural VPP guard is satisfied.",
+      "support_status": "adapter-required",
+      "unsupported_reason": "adapter required: the shield drives chip pin 18 as CE and pin 20 as OE, but on the 2532 pin 18 is A11 and pin 20 is PD/PGM. The shield cannot drive A11, so only the lower 2 KB can be addressed, and the program pulse would go to A11. An adapter must move those pins.",
+      "verification_note": "SAFE-04 / D-11: no on-hand 2532 silicon was bench-tested. Non-JEDEC 24-pin oddball; the DIP24_2532 pinout is a tentative leaf layout requiring bench validation. VPP lands on pin 21 (DIP24_2532 vpp-pin) per the TI family datasheet \u2014 the GATE-03 structural VPP guard is satisfied. Socket pin 18 is the shield's CE driver, not an address latch, so host 3.2.4 sent bus line 256 (ROM_CE) for A11; firmware 3.2.1 truncated it to line 0, and later firmware refuses the frame. resolve_chip now refuses the row on its status.",
       "verification_status": "UNVERIFIED"
     }
   ],
@@ -16441,6 +16450,33 @@
         "pulse_duration_us": 100
       },
       "support_status": "supported"
+    },
+    {
+      "datasheet": "datasheets/TMM27128AD.pdf",
+      "electrical": {
+        "pin_count": 28,
+        "size_bytes": 16384,
+        "type": "UV-EPROM",
+        "vcc_mv": 5000,
+        "vdd_mv": 6000,
+        "vpp_mv": 12500
+      },
+      "part_number": "TMM27128AD,TMM27128AD-15,TMM27128AD-150,TMM27128AD-20,TMM27128AD-200",
+      "pinout": "DIP28_27128",
+      "programming": {
+        "algorithm": 7,
+        "chip_id_check": true,
+        "chip_id_value": "0x000098d3",
+        "infoic_page_size_raw": 0,
+        "protect_off_before": false,
+        "protect_on_after": false,
+        "pulse_duration_us": 1000
+      },
+      "provenance": "Physically real 28-pin NMOS UV-EPROM (Toshiba TMM27128AD, 16384 x 8), absent from minipro infoic.xml, whose TOSHIBA/KIOXIA section has no 27128-class part. Datasheet attached to henols/firestarter#73 by the reporter, vendored as datasheets/TMM27128AD.pdf (Toshiba pages G-27 to G-36). Page G-27: pin 1 VPP, pin 20 CE, pin 22 OE, pin 26 A13, pin 27 PGM, pin compatible with i27128A (DIP28_27128). Page G-30 HIGH SPEED PROGRAM OPERATION: VCC 5.75/6.0/6.25 V, VPP 12.0/12.5/13.0 V, tPW 0.95/1.0/1.05 ms. Page G-33/G-34: 1 ms PGM pulses verified after each, up to 25 times, then an over-program pulse of 3 times the pulses used. Page G-35 ELECTRIC SIGNATURE MODE: manufacturer code 98, device code D3. Read VCC 5 V (page G-28).",
+      "source": "non-upstream-supplement",
+      "support_status": "supported",
+      "verification_note": "Resolvable for read/info. No working sample has been tested: the chip reported in henols/firestarter#73 was dead. The datasheet program VCC is 6.0 V, but the shield holds VCC at 5 V, and the firmware does not send the over-program pulse.",
+      "verification_status": "UNVERIFIED"
     }
   ],
   "WED": [
@@ -16669,7 +16705,7 @@
         "type": "EEPROM",
         "vcc_mv": 5000,
         "vdd_mv": 5000,
-        "vpp_mv": 13500
+        "vpp_mv": 12000
       },
       "part_number": "W27E257",
       "pinout": "DIP28_27256",

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/data/pinouts.json

@@ -115,6 +115,16 @@
             "ce-pin": [22], "oe-pin": [24], "pgm-pin": [31]
         }
     },
+    "DIP32_27C301": {
+        "name": "Mask-ROM-compatible 32-pin UV-EPROM (27C301 / 27C1000 — OE on pin 2, A16 on pin 24)",
+        "comment": "infoic.xml pin map 12 with protocol 0x08 and variant_lo 0x00. Only MBM27C1000, MBM27C2000, HN27C301G, HN27C301AG and M27C1000 carry it; variant_lo 0x01 in the same map is the JEDEC 27C020 layout. Pin functions are from datasheets/MBM27C1000.pdf (page 4-61 pin assignment, page 4-63 pin description): pin 1 VPP, pin 2 OE, pin 22 CE, pin 24 A16, pin 31 PGM, pin 30 NC. one-rom chip-types.json type 27C301 (aliases 27C1000, 27C100) gives the same OE and A16 pins. JEDEC 27C010/27C020 swap pins 2 and 24, so on DIP32_27C020 these parts drive OE high whenever A16 is 1 (henols/firestarter#70). Pin 30 is A17 for the 256K MBM27C2000 row: <maps> index 12 bonds it, and it is the only bonded pin that has no other function on this layout. No MBM27C2000 datasheet is vendored to confirm it.",
+        "pins": {
+            "vcc-pin": [32], "gnd-pin": [16], "vpp-pin": [1],
+            "address-bus-pins": [12, 11, 10, 9, 8, 7, 6, 5, 27, 26, 23, 25, 4, 28, 29, 3, 24, 30],
+            "data-bus-pins": [13, 14, 15, 17, 18, 19, 20, 21],
+            "ce-pin": [22], "oe-pin": [2], "pgm-pin": [31]
+        }
+    },
     "DIP32_27C801": {
         "name": "JEDEC 32-pin UV-EPROM 1M (27C080 / M27C801 — A19 on pin 1, VPP on pin 24)",
         "comment": "Per piersfinlayson/one-rom docs/CHIP-TYPES.md (datasheet-verified): the 8 Mbit 27C080/M27C801 class has 20 address lines (A0-A19) with A19 at pin 1, and VPP at pin 24 shared with /OE — the same OE/VPP sharing DIP28_27512 uses at pin 22. /PGM is pin 22 shared with /CE. Distinct from DIP32_STD (27C040 class: pin 1 = VPP, pin 31 = A18, 19 address lines) and from DIP32_27C020 (pin 31 = PGM). Assigned by resolve_pinout_key to pin_count=32 && pm_idx=12 && proto_id=0x08 && variant_lo=0x03 — the eight 1 MB rows AM27C080, AM27LV080, AT27C080, M27C801 (x2), MX27C8000, MX27C8000A, UPD27C8001. HARDWARE: A19 at pin 1 means socket pin 1 carries an address line, and on Rev 2.x shields socket pin 1 is also the VPP-enable line (JP5 = A19_CUT bridges it to the switched VPP node). JP5 must be cut for these parts, per the shield silkscreen.",

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/database.py

@@ -165,6 +165,11 @@ _MOVED_PIN_MAPS = {
         "chips. 27128/27C128 chips use DIP28_27128 and 27011 chips use "
         "DIP28_27011.",
     ),
+    "DIP32_27C020": (
+        ("DIP32_27C301",),
+        "Your pin-map override for DIP32_27C020 no longer applies to "
+        "27C301/27C1000 chips (OE on pin 2, A16 on pin 24). They use DIP32_27C301.",
+    ),
     "DIP32_28C512_EEPROM": (
         ("DIP32_28C040",),
         "Your pin-map override for DIP32_28C512_EEPROM is not used. "

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/firmware.py

@@ -335,8 +335,8 @@ class FirmwareManager:
         """Router: returns (resolved_version, download_url) or (None, None) on failure.
 
         channel='stable'  → delegates to fetch_latest_release_info (back-compat shim).
-        channel='pre'     → paginates /releases, filters prerelease=True, sorts by PEP 440
-                            descending, takes highest; falls back to stable if none.
+        channel='pre'     → paginates /releases, takes the highest non-draft release by
+                            PEP 440, stable or pre-release; falls back to stable if none.
         channel='pinned'  → fetches /releases/tags/{version} directly.
         """  # noqa: E501
         if channel == "stable":
@@ -374,10 +374,12 @@ class FirmwareManager:
                 logger.error(f"Failed to fetch releases for pre-release channel: {e}")
                 return None, None
 
-            # Filter: prerelease=True AND draft=False, skip unparseable tags.
+            # Every non-draft release, stable or pre-release, as `pip --pre`
+            # does: a stable 3.2.2 must win over an older 3.1.1b2. Skip
+            # unparseable tags.
             candidates = []
             for r in all_releases:
-                if not r.get("prerelease") or r.get("draft"):
+                if r.get("draft"):
                     continue
                 tag = r.get("tag_name", "")
                 try:
@@ -387,7 +389,7 @@ class FirmwareManager:
 
             if not candidates:
                 logger.info(
-                    "No pre-release firmware available — falling back to stable "
+                    "No firmware release with a parseable tag — falling back to stable "
                     "(matches pip --pre semantics)."
                 )
                 return self.fetch_latest_release_info(board=board)
@@ -517,8 +519,13 @@ class FirmwareManager:
         avrdude_path_override: str | None,
         avrdude_config_override: str | None,
         target_port: str | None,
+        force: bool = False,
     ) -> bool:
-        """Internal method to perform the Avrdude flashing process."""
+        """Internal method to perform the Avrdude flashing process.
+
+        `force` adds avrdude's `-F`, which skips the device-signature check,
+        for example for a 328PB clone bootloader that reports a 328P signature.
+        """
         start_time = time.time()
 
         partno, programmer_id, baud_rate = (
@@ -594,7 +601,9 @@ class FirmwareManager:
                     avrdude_config_path=avrdude_config_path,
                 )
 
-                stderr_output, return_code = avrdude.flash_firmware(hex_file_path)
+                stderr_output, return_code = avrdude.flash_firmware(
+                    hex_file_path, extra_flags=["-F"] if force else None
+                )
                 if return_code == 0:
                     logger.info(
                         f"Firmware successfully updated on {port_to_flash} ({time.time() - start_time:.2f}s)"  # noqa: E501
@@ -741,6 +750,7 @@ class FirmwareManager:
         avrdude_config_override: str | None,
         target_port: str | None,
         usb_id: str | None = None,
+        force: bool = False,
     ) -> bool:
         """Dispatch to the flasher for this board.
 
@@ -755,6 +765,7 @@ class FirmwareManager:
             avrdude_path_override=avrdude_path_override,
             avrdude_config_override=avrdude_config_override,
             target_port=target_port,
+            force=force,
         )
 
     def manage_firmware_update(
@@ -778,7 +789,7 @@ class FirmwareManager:
         Returns True if an operation (check or install) was successful in some sense, False on major failure.
 
         channel='stable'  → uses /releases/latest (default, INST-01 non-regression).
-        channel='pre'     → selects highest pre-release.
+        channel='pre'     → selects the highest release, stable or pre-release.
         channel='pinned'  → uses exact tag from pinned_version.
         """  # noqa: E501
         connected_port, current_version, current_board = self.check_current_firmware(
@@ -969,6 +980,7 @@ class FirmwareManager:
                 avrdude_config_override=avrdude_config_override,
                 target_port=port_to_use,
                 usb_id=usb_id,
+                force=bool(force_install),
             )
             # Clean up downloaded file
             if os.path.exists(hex_file):

firestarter-3.2.6/firestarter/flash4_erase_gate.py

@@ -0,0 +1,104 @@
+"""
+Project Name: Firestarter
+Copyright (c) 2024 Henrik Olsson
+
+Permission is hereby granted under MIT license.
+
+Flash4 (protocol 0x05) erase policy.
+
+Firmware 3.2.2 added a software chip erase for protocol 0x05 (the six-cycle
+AA/55/80/AA/55/10 sequence, 5 V only). Older firmware is not safe to send
+that erase to:
+
+- 3.0.0b8 to 3.0.0b26 erase a 0x05 part with the VPP regulator and VPE
+  switched on: 12 V on a 5 V part.
+- 3.0.0b27 to 3.2.1 answer "not supported".
+
+So `FLAG_CAN_ERASE` stays clear for algorithm 5 in the database
+(`erase_support.erase_accepted`), and `write` never carries it. Only the
+`erase` command sets it, for that one command
+(`with_erase_flag`), and `SerialCommunicator.setup_command` refuses the
+command before the operation starts when the firmware is older than
+`ERASE_MIN_FIRMWARE` (`needs_newer_firmware`).
+
+Like `jp5_gate.py` and `sdp_capability.py`, this is a pure predicate module:
+no I/O, no environment reads, no serial access.
+
+`is_flash4` FAILS OPEN on absent evidence (a wire dict with no `algorithm`
+key is "not flash4"), unlike `jp5_gate` and `sdp_capability`. Refusing every
+chip this predicate cannot classify would break `erase` for chips that are
+not flash4 at all.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Any, Mapping  # noqa: UP035
+
+from firestarter.constants import COMMAND_ERASE, FLAG_CAN_ERASE
+
+FLASH4_PROTOCOL_ID = 5
+
+# The first firmware with the software chip erase for protocol 0x05.
+ERASE_MIN_FIRMWARE = (3, 2, 2)
+
+_FIRMWARE_REFUSAL_FORMAT = (
+    "Erasing this chip needs firmware {minimum} or later; this board runs "
+    "{version}. Update it with 'firestarter fw --install'."
+)
+
+
+def is_flash4(programmer_data: Mapping[str, Any] | None) -> bool:
+    """True when the wire dict's `algorithm` value is the flash4 protocol id.
+
+    The comparison is against `algorithm`, not `flags & FLAG_CAN_ERASE`: the
+    flag is also clear for UV-EPROM and SRAM parts, so a flag-based
+    predicate would widen this past its flash4-only scope.
+
+    Returns False for a missing, `None`, or empty `programmer_data`, and for
+    a dict with no `algorithm` key.
+    """
+    if not programmer_data:
+        return False
+    return programmer_data.get("algorithm") == FLASH4_PROTOCOL_ID
+
+
+def with_erase_flag(programmer_data: Mapping[str, Any]) -> dict[str, Any]:
+    """A copy of `programmer_data` with `FLAG_CAN_ERASE` set, for `erase` only."""
+    data = dict(programmer_data)
+    data["flags"] = int(data.get("flags") or 0) | FLAG_CAN_ERASE
+    return data
+
+
+def _version_tuple(version: str | None) -> tuple[int, int, int] | None:
+    match = re.match(r"(\d+)\.(\d+)\.(\d+)", version or "")
+    if not match:
+        return None
+    return (int(match.group(1)), int(match.group(2)), int(match.group(3)))
+
+
+def needs_newer_firmware(
+    command: Mapping[str, Any], firmware_version: str | None
+) -> bool:
+    """True when `command` is a flash4 erase that `firmware_version` cannot run safely.
+
+    Only an erase command that carries `FLAG_CAN_ERASE` for a flash4 part is
+    affected; every other command returns False. A version that cannot be
+    parsed counts as too old, because the 3.0.0 pre-releases with the 12 V
+    erase are older than every version this check accepts. A pre-release
+    or development build of 3.2.2 (`3.2.2rc1`, `3.2.2.dev5`) counts as 3.2.2.
+    """
+    if command.get("cmd") != COMMAND_ERASE or not is_flash4(command):
+        return False
+    if not int(command.get("flags") or 0) & FLAG_CAN_ERASE:
+        return False
+    parsed = _version_tuple(firmware_version)
+    return parsed is None or parsed < ERASE_MIN_FIRMWARE
+
+
+def firmware_refusal_text(firmware_version: str | None) -> str:
+    """The one-line refusal for a flash4 erase on firmware that is too old."""
+    return _FIRMWARE_REFUSAL_FORMAT.format(
+        minimum=".".join(str(n) for n in ERASE_MIN_FIRMWARE),
+        version=firmware_version or "an unknown version",
+    )

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/ic_layout.py

@@ -12,6 +12,7 @@ from typing import Dict, List  # noqa: UP035
 from firestarter import jumper_table
 from firestarter.database import EpromDatabase, format_mv
 from firestarter.erase_support import erase_accepted, is_electrically_erasable
+from firestarter.flash4_erase_gate import FLASH4_PROTOCOL_ID
 from firestarter.vpp_display import shows_programming_vpp
 
 logger = logging.getLogger("EpromSpecBuilder")
@@ -19,6 +20,7 @@ logger = logging.getLogger("EpromSpecBuilder")
 CAN_ERASE_YES = "yes (electrically erasable)"
 CAN_ERASE_UV_ONLY = "no (UV erase only)"
 CAN_ERASE_NOT_SUPPORTED = "no (erase is not supported for this chip)"
+CAN_ERASE_FLASH4 = "yes (needs firmware 3.2.2 or later)"
 
 
 class EpromSpecBuilder:
@@ -524,6 +526,11 @@ class EpromSpecBuilder:
             etype, eprom_data.get("protocol-id"), eprom_data.get("pin-map")
         ):
             output_data["can_erase_str"] = CAN_ERASE_YES
+        elif is_electrically_erasable(etype) and (
+            eprom_data.get("protocol-id") == FLASH4_PROTOCOL_ID
+        ):
+            # `erase` sets FLAG_CAN_ERASE for flash4 itself (flash4_erase_gate).
+            output_data["can_erase_str"] = CAN_ERASE_FLASH4
         elif is_electrically_erasable(etype):
             output_data["can_erase_str"] = CAN_ERASE_NOT_SUPPORTED
         elif etype == "UV-EPROM":

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/jumper_table.py

@@ -401,6 +401,16 @@ JUMPER_TABLE: Mapping[str, JumperEntry] = {
         rev20_jp4=Jp4Rev20.OPEN,
         rev22_jp4=Jp4Rev22.NO_JUMPER,
     ),
+    # Pins 1, 28, 30 and 32 have the DIP32_27C020 functions; only pins 2 and 24 differ.
+    "DIP32_27C301": JumperEntry(
+        vpp_lands=VppLanding.SOCKET_1,
+        pin1_signal="VPP",
+        jp1=Jp1.A13,
+        jp2=Jp2.A17,
+        jp3=Jp3.PIN32,
+        rev20_jp4=Jp4Rev20.OPEN,
+        rev22_jp4=Jp4Rev22.NO_JUMPER,
+    ),
     # VPP shares OE. Chip pin 1 is A19. The JP5 gate (jp5_gate.py) controls write and erase.
     "DIP32_27C801": JumperEntry(
         vpp_lands=VppLanding.OE,

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter/serial_comm.py

@@ -20,6 +20,7 @@ import serial.serialutil
 import serial.tools.list_ports
 
 import firestarter.codec as codec
+import firestarter.flash4_erase_gate as flash4_erase_gate
 import firestarter.transport_counters as transport_counters
 from firestarter.config import ConfigManager  # Assuming ConfigManager is refactored
 from firestarter.constants import (
@@ -957,9 +958,17 @@ class SerialCommunicator:
             # to major=3 later. Set FIRESTARTER_DEV_ALLOW_PRE_V12=1 to bypass when  # noqa: E501
             # bench-testing a current host against a historical (v2.x) firmware build.  # noqa: E501
             SerialCommunicator._validate_firmware_version(
-                version_match.group(0),
+                version_match.group(0).rstrip("."),
                 allow_pre_v12=os.environ.get("FIRESTARTER_DEV_ALLOW_PRE_V12") == "1",
             )
+            # A flash4 erase on firmware older than 3.2.2 reaches either a
+            # 12 V erase (3.0.0b8-b26) or a "not supported" answer.
+            if flash4_erase_gate.needs_newer_firmware(command_to_send, identity):
+                raise FirmwareOutdatedError(
+                    flash4_erase_gate.firmware_refusal_text(
+                        identity.split(":")[0] if identity else None
+                    )
+                )
 
         # Shield-revision gate — ordered after the version check because
         # firmware old enough to fail that check cannot be trusted to have

{firestarter-3.2.4 → firestarter-3.2.6/firestarter.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firestarter
-Version: 3.2.4
+Version: 3.2.6
 Summary: EPROM programmer software for the Relatively Universal ROM Programmer
 Author-email: Henrik Olsson <henols@gmail.com>
 Project-URL: Homepage, https://github.com/henols/firestarter_app

{firestarter-3.2.4 → firestarter-3.2.6}/firestarter.egg-info/scm_file_list.json

@@ -26,6 +26,7 @@
     "datasheets/MBM27C4001.pdf",
     "datasheets/MX27C4000.pdf",
     "datasheets/SST39SF0x0A.pdf",
+    "datasheets/TMM27128AD.pdf",
     "datasheets/TMS2764.pdf",
     "datasheets/UPD27128.pdf",
     "datasheets/W27C020.pdf",

firestarter-3.2.6/firestarter.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "3.2.6",
+  "distance": 0,
+  "node": "g6a02a12",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-27"
+}

{firestarter-3.2.4 → firestarter-3.2.6}/tests/__snapshots__/test_characterization.ambr

@@ -595,6 +595,8 @@
   Eprom Info          
   Name:               MBM27C1000P,MBM27C1000
   Manufacturer:       FUJITSU
+  Support status:      adapter-required
+  Reason:              adapter required: the shield drives chip pin 22 as CE and pin 24 as OE, but pin map DIP32_27C301 needs other functions on pins [2, 24]. An adapter must move those pins.
   Number of pins:     32
   Memory size         0x20000
   Type:               UV-EPROM
@@ -610,14 +612,14 @@
          32-DIP package
           -----v-----
     VPP -|  1     32 |- VCC   
-    A16 -|  2     31 |- PGM   
+    OE  -|  2     31 |- PGM   
     A15 -|  3     30 |- A17   
     A12 -|  4     29 |- A14   
     A7  -|  5     28 |- A13   
     A6  -|  6     27 |- A8    
     A5  -|  7     26 |- A9    
     A4  -|  8     25 |- A11   
-    A3  -|  9     24 |- OE    
+    A3  -|  9     24 |- A16   
     A2  -| 10     23 |- A10   
     A1  -| 11     22 |- CE    
     A0  -| 12     21 |- D7    
@@ -1441,6 +1443,7 @@
   | TC54256AF,TC54256AP | TOSHIBA/KIOXIA   |   28 | 0x98C4     | UV-EPROM    | 12.0v|
   | TC57256D            | TOSHIBA/KIOXIA   |   28 | 0x9845     | UV-EPROM    | 13.0v|
   | TC57512AD           | TOSHIBA/KIOXIA   |   28 | 0x9885     | UV-EPROM    | 13.0v|
+  | TMM27128AD,TMM27128…| TOSHIBA/KIOXIA   |   28 | 0x98D3     | UV-EPROM    | 12.5v|
   | WE128K8             | WED              |   32 |            | Flash/EEPROM| -    |
   | WE256K8             | WED              |   32 |            | Flash/EEPROM| -    |
   | WE512K8             | WED              |   32 |            | Flash/EEPROM| -    |
@@ -1450,7 +1453,7 @@
   | W27C04,W27C040,W27E…| WINBOND          |   32 | 0xDA86     | EEPROM      | 12.0v|
   | W27C257             | WINBOND          |   28 | 0xDA02     | EEPROM      | 12.0v|
   | W27C512,W27E512     | WINBOND          |   28 | 0xDA08     | EEPROM      | 12.0v|
-  | W27E257             | WINBOND          |   28 | 0xDA02     | EEPROM      | 13.5v|
+  | W27E257             | WINBOND          |   28 | 0xDA02     | EEPROM      | 12.0v|
   | W29C010,W29C011,W29…| WINBOND          |   32 | 0xDAC1     | Flash/EEPROM| -    |
   | W29C020,W29C020C,W2…| WINBOND          |   32 | 0xDA45     | Flash/EEPROM| -    |
   | W29C040,W29C042     | WINBOND          |   32 | 0xDA46     | Flash/EEPROM| -    |
@@ -1579,7 +1582,7 @@
   | W27C04,W27C040,W27E…| WINBOND          |   32 | 0xDA86     | EEPROM      | 12.0v|
   | W27C257             | WINBOND          |   28 | 0xDA02     | EEPROM      | 12.0v|
   | W27C512,W27E512     | WINBOND          |   28 | 0xDA08     | EEPROM      | 12.0v|
-  | W27E257             | WINBOND          |   28 | 0xDA02     | EEPROM      | 13.5v|
+  | W27E257             | WINBOND          |   28 | 0xDA02     | EEPROM      | 12.0v|
   +---------------------+------------------+------+------------+-------------+------+
   
   '''