catarrh
14d15b1fe8
Redraw the inline card-into-reader SVG after sim.svg: a rounded card with the top-right cut corner and the 3x2 contact pad, sliding behind the reader bar. The viewBox grew to 72x48 and the resting position is 0, so the card is no longer clipped at the top; the insert slide is 20px. The currentColor/Tailwind theming and the reduced-motion fallback are unchanged. 1024 Python + 1063 frontend; simple-v472.
239 lines
13 KiB
Markdown
239 lines
13 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to SIMple (the PWA and `pysim-simple-server`).
|
||
The format follows [Keep a Changelog](https://keepachangelog.com/);
|
||
versions use `MAJOR.MINOR.PATCH` (see the README).
|
||
|
||
History before the first packaged release (v3.31.1) lives in the git log —
|
||
every change carries a descriptive commit message.
|
||
|
||
## [Unreleased]
|
||
|
||
## [3.36.0] — 2026-10-23
|
||
|
||
### Added
|
||
|
||
- The batch **"waiting for the next card"** state is now a deliberate cue: the status
|
||
modal shows a card-into-reader animation next to the prompt, a short chime sounds
|
||
**once per card** when the run enters the waiting phase (Web Audio — no audio asset;
|
||
edge-triggered in the 2 s poll, so it does not repeat), and while the tab is hidden the
|
||
title hints "Insert next card". The speaker button next to the status mutes the chime
|
||
and the choice is remembered (`simple_ram_batch_sound`); the chime is unlocked by the
|
||
Start click (browser autoplay policy); reduced-motion users get the static card-above-
|
||
the-slot picture. The card follows the app's SIM silhouette (`sim.svg`): a cut corner
|
||
and the contact pad, sliding behind the reader bar.
|
||
|
||
### Changed
|
||
|
||
- A **batch delete that finds the object already gone** is still a success — the goal is met
|
||
and the run continues — but it is no longer reported as a plain "OK": the attempt's verdict
|
||
reads **Already absent**, the delete run's counts separate real deletions from no-ops
|
||
(`Deleted: N · Already absent: M`), and the notice says the card was already absent. The
|
||
counts gain an `already_absent` bucket (the attempt result is `already_absent`); a
|
||
reinstall's tolerated pre-delete is *not* affected — its outcome is still the install.
|
||
|
||
### Fixed
|
||
|
||
- The prebuilt `style.css` had gone stale: a rebuild restored utility classes the UI
|
||
already used but the output lacked (e.g. `bg-blue-50` on the batch notice, `inline-flex`,
|
||
`mx-2`, `max-h-48`, `w-44`, `min-w-24`).
|
||
|
||
## [3.35.0] — 2026-10-23
|
||
|
||
### Added
|
||
|
||
- **EF.SMSP decoded editor** — the full SMS-parameter form (TS 31.102 §4.2.27): alpha,
|
||
TP-Destination Address and TS-Service Centre Address (each with its own length
|
||
convention and a TON select; an empty SCA means the default SMSC), TP-PID, TP-DCS and
|
||
the relative TP-VP — every parameter with an *absent (the ME default applies)* toggle.
|
||
Live hints decode the DCS (TS 23.038 §4: coding group, alphabet, class, compression,
|
||
message-waiting) and the relative validity period (TS 23.040 §9.2.3.12.1). Unchanged
|
||
parameters keep their exact bytes (a card quirk such as a DCS marked absent with byte
|
||
`00` survives), alphanumeric TON addresses are preserved read-only, and all checked
|
||
records are validated before anything is written.
|
||
- **Edit decoded, wave 2** — new editors for the service tables **EF.UST / EF.IST /
|
||
EF.EST** (a filterable bit grid preserving services the table does not model), the
|
||
scalars **EF.ACC**, **EF.PHASE**, **EF.HPPLMN** and **EF.AD**, the PLMN lists
|
||
**EF.PLMNsel / EF.FPLMN / EF.EHPLMN**, the identities **EF.ICCID / EF.IMSI** (behind a
|
||
confirmation — writing them changes the card identity) and the cell-broadcast lists
|
||
**EF.CBMI / EF.CBMID / EF.CBMIR**. **EF.SST** is deliberately left read-only: its
|
||
SIM layout is 2 bits per service (allocated + activated), which needs its own editor.
|
||
- The file-format survey (`docs/decoded-editing.md`) now records the shipped waves and
|
||
marks **EF.DIR / EF.ARR / EF.SMS / EF.PBR** as postponed by decision (read-only).
|
||
|
||
### Fixed
|
||
|
||
- `efDecSmsp` mapped the parameter indicators shifted (SCA on bit 5, PID on bit 2, DCS
|
||
on bit 3, VP on bit 4); the spec order is DA/SCA/PID/DCS/VP on bits 1–5 with bits 6–8
|
||
reserved — a record with a mixed indicator (e.g. `E9`) showed DCS and hid VP.
|
||
- The read-only EF.SMSP view decoded the TP-DA length as octets, although it is the digit
|
||
count (TS 23.040 §9.1.2.5); a slot padded with `00` gained phantom digits.
|
||
- The **Read decoded** pill no longer looks disabled when it is enabled: an inactive-but-
|
||
enabled pill is now an outlined button (blue on white/slate), and the grey fill and
|
||
dimming are left to the actually disabled state.
|
||
- **EF.ACC** class numbering (TS 31.102 4.2.15): byte 1 b8…b1 codes classes 15…8 and
|
||
byte 2 classes 7…0 — the decoder counted class 0 at the MSB (an all-FF ACC read as
|
||
class 0 instead of classes 0–15).
|
||
- **EF.AD** (TS 31.102 4.2.18): the operation mode is a whole-byte enum
|
||
(00/80/01/81/02/04), not bits 0-1 plus a test bit; the MNC length may be 0 (service
|
||
n°130 available) or absent (3-byte SIM form) — the editor previously refused both.
|
||
- **EF.SST** (TS 51.011 10.3.7): the SIM service table is decoded with its 2-bits-per-
|
||
service layout (allocated + activated) instead of the UST 1-bit codec.
|
||
- **EF.IMSI**: the parity/type nibble is `9` for an odd digit count and `1` for an even
|
||
one (TS 24.008 10.5.1.4); the encoder always wrote `9`.
|
||
- Saving a PLMN/CB list with no edits no longer rewrites it as all-FF (the collected rows
|
||
and the list encoders disagreed on the value shape).
|
||
|
||
## [3.33.0] — 2026-10-23
|
||
|
||
### Added
|
||
|
||
- **Edit decoded** in the file manager: a file is read raw, decoded into its own editable
|
||
form, re-encoded in the browser and written through the normal update path. The first
|
||
wave covers **EF.SPN**, **EF.PLMNwAcT / EF.OPLMNwAcT / EF.HPLMNwAcT**, the dialling-number
|
||
files **EF.ADN / EF.FDN / EF.SDN / EF.MSISDN / EF.LND / EF.BDN** and **EF.PNN**. Shapes:
|
||
a flat transparent form (SPN), a transparent list editor with add/remove rows (PLMN+ACT),
|
||
per-record forms with a selection checkbox that is auto-checked when a field changes
|
||
(dialling numbers, PNN) and per-record TLV item rows with add/remove/edit (PNN's full and
|
||
short names plus the PLMN additional information). All checked records are encoded and
|
||
validated before anything is written; unchanged fields, record lengths, extension
|
||
pointers (EF.EXT1–EXT5), the BDN comparison-method byte and unknown PNN TLVs are
|
||
preserved, and an edit that would break a reference (a number continued in an extension
|
||
file, a dropped mandatory PNN full name) is refused.
|
||
- `docs/decoded-editing.md`: the file-format survey behind the design (every known EF
|
||
classified by structure/coding into the editor's shapes S0–S10, with the release waves).
|
||
|
||
### Removed
|
||
|
||
- The file manager's decoded view no longer carries the collapsed **pySim JSON (server)**
|
||
disclosure — the view is the client-side EF decoder's table only. The disclosure was an
|
||
unrelated *second* decode: opening it issued another `/api/read` with `mode: 'decoded'`
|
||
to run pySim's `read_binary_decoded`/`read_records_decoded`, and it was reachable only
|
||
when our decoder covered the file (`Read decoded` is decoder-gated), so the one case
|
||
where a second opinion would matter — a file our decoders do not cover — never offered
|
||
it. `/api/read` keeps `mode: 'decoded'` for API callers; the help, READMEs and project
|
||
notes say the decoded table is built in the browser from the same raw bytes.
|
||
|
||
### Fixed
|
||
|
||
- **EF.BDN** decodes and encodes with its own `X+15` layout (the trailing Comparison Method
|
||
Pointer); the shared ADN codec had treated it as `X+14`.
|
||
- `efPlmnAct` decoded the EC-GSM-IoT-only ACT (`b8=1,b4=1,b3=0`, `0x0088`) as nothing while
|
||
checking the impossible `0x0086` (TS 31.102 Table 4.2.5.2).
|
||
- PNN network names: the decoder now trusts a non-zero spare-bit count before the
|
||
"all bytes < 0x80 → uncompressed" heuristic, so a valid packed name can no longer be
|
||
misread (and later written back wrong).
|
||
- `/api/write` and `/api/read` report a cmd2 exception in the captured output as a failure
|
||
instead of `success: true` with `SW: 9000`.
|
||
- The empty amber **preset-mismatch banner** no longer flashes on the SCP80/RAM view.
|
||
`ramOpChanged()` (v3.28.0) un-hid `#ram-preset-warning` by the operation kind, but the
|
||
banner's text *and* visibility belong to `spPresetWarningRender()` (which also handles
|
||
the batch suppression): with no warning text the empty bordered box stayed visible until
|
||
the next status poll re-hid it — on every RAM view and operation switch. The visibility
|
||
is content-driven again; `frontend/tests/ram.test.js` pins it (the pre-fix code fails
|
||
the test).
|
||
|
||
## [3.32.5] — 2026-10-21
|
||
|
||
### Fixed
|
||
|
||
- A card removed during the **startup initialization** no longer leaves the server
|
||
reporting a phantom equipped card. The init caught the PC/SC error (and printed a
|
||
traceback) but kept the card object it had already built, so `card_present` and
|
||
`_CARD_CONNECTED` stayed True — and the auto-equip then skipped every later insertion
|
||
(its `_CARD_CONNECTED` early return), leaving only a manual Equip or a restart. A
|
||
PC/SC error now prints one line (`INIT: card removed during initialization …`), drops
|
||
the half-initialized session and lets the presence monitor equip the next card.
|
||
|
||
## [3.32.4] — 2026-10-21
|
||
|
||
### Fixed
|
||
|
||
- The auto-equip's captured traceback now always includes the **exception line**: cmd2
|
||
renders a rich-box traceback longer than the logged head, so the actual error was cut
|
||
off. The tail is appended after a `...` marker; the "releasing the old link failed"
|
||
message now says it continues with a fresh link (a removed card's dead PC/SC handle
|
||
always fails to disconnect).
|
||
- A card insertion now marks the PC/SC link for a rebuild, so the **first** auto-equip
|
||
attempt already uses a fresh link. On Windows the old link cannot connect after a
|
||
swap — v3.32.2 recovered it, but only on the second attempt, after a failed init, a
|
||
2–4 s delay and a traceback in the log. A link created at a cardless startup has
|
||
never connected either, which the same mark covers. The rebuild still runs in the
|
||
equip worker (never in the pyscard monitor thread) and `_ensure_transport` releases
|
||
the old link first.
|
||
|
||
## [3.32.2] — 2026-10-21
|
||
|
||
### Fixed
|
||
|
||
- **The auto-equip loop after a card swap on Windows.** A failed initialization with
|
||
the card still present was reported as "card gone during initialization" and treated
|
||
as a no-op success — so the three retries never ran and the watchdog re-armed every
|
||
few seconds forever. It is a failure now, and **every failed attempt marks the
|
||
PC/SC transport for a rebuild**, so the retry starts from a fresh link (the release
|
||
of the old link happens first, so it cannot inherit a stale card handle). The error
|
||
pySim swallowed is printed as `AUTO-EQUIP: init output:` with its traceback.
|
||
|
||
## [3.32.1] — 2026-10-21
|
||
|
||
### Added
|
||
|
||
- **"Start counter value"** in the outfile import: the counter every created keyset
|
||
starts from. It defaults to the store's value (`1`); raise it for cards whose
|
||
counters are already past it. The API takes `start_counter` (1–10 hex digits;
|
||
a bad value is a 400), and the preview carries the value.
|
||
|
||
## [3.32.0] — 2026-10-21
|
||
|
||
### Added
|
||
|
||
- **Updating a packaged install** — `update.sh` / `update.bat` (and `tools/update.py`
|
||
beneath them): downloads the latest release package, replaces the application files
|
||
in place and re-installs the app into the **existing `.venv`**. pysim and its
|
||
prerequisites (the slow part: pyscard builds from source on Linux) are kept, so an
|
||
update takes seconds. `--check` reports the current and latest versions, `--version`
|
||
picks a specific release, `--zip` updates from a local package (offline), `--no-pip`
|
||
refreshes the files only, `--force` re-applies the same version.
|
||
- The release workflow now takes the release notes from this file's matching version
|
||
section (falling back to generated notes when it is missing).
|
||
|
||
### Changed
|
||
|
||
- Installs made from the v3.31.x packages have no updater yet: copy `update.sh`,
|
||
`update.bat` and `tools/update.py` from this package once (or re-run `setup` from it).
|
||
Later updates use `update.sh` / `update.bat` — or `git pull` for a clone.
|
||
|
||
## [3.31.2] — 2026-10-20
|
||
|
||
### Changed
|
||
|
||
- The **SCP81 TLS-PSK listener states its Python requirement**: it needs Python 3.13+
|
||
(`ssl`'s PSK callbacks exist only since 3.13). Below that it raises a clear error
|
||
instead of `AttributeError`, and the PSK tests are skipped (they run on 3.13+).
|
||
- The READMEs and the setup scripts: **Windows strongly recommends Python 3.13**
|
||
(pyscard has wheels up to 3.13; on 3.14 pyscard and some pysim dependency wheels are
|
||
unavailable and build from source with MSVC).
|
||
|
||
## [3.31.1] — 2026-10-20
|
||
|
||
The first packaged release (`simple-3.31.1.zip`).
|
||
|
||
### Added
|
||
|
||
- **EF_PBR (phonebook reference) support** — the PBR is decoded in the decoded file
|
||
views (the `A8`/`A9`/`AA` containers, the `C0`–`CC` kinds, the master EF), and the
|
||
phonebook files it references (they are not in pySim's model) are added to the file
|
||
tree server-side, selectable and readable.
|
||
- **In-app dialogs** — the native alert/confirm/prompt dialogs are replaced by a shared
|
||
modal (queued, keyboard-aware, focus-trapped, ARIA-labelled).
|
||
- **Windows console encoding guard** — the `start.bat` PowerShell pipe can no longer
|
||
kill the server on a character the ANSI code page lacks.
|
||
- **GPL-2.0-or-later licensing** (`LICENSE`, `THIRD-PARTY-NOTICES`), matching pysim.
|
||
- The curated **release package** (`tools/build_release.py`) and the tag-triggered
|
||
`.github/workflows/release.yml`.
|
||
|
||
### Changed
|
||
|
||
- `setup.sh` / `setup.bat` and the READMEs: on Linux `pyscard` builds from source and
|
||
needs the PC/SC headers (`libpcsclite-dev`).
|