Module management

Since MultiProg 2.2.54 / TGSN 3.2.6 the TGSN firmware ships in two layers:

• Bootloader (startup_firmware) — flashed once via the standard Install procedure.
• Modules — per-target-family payloads delivered by the Bootloader during install. Each module corresponds to one MCU family (RL78, NEC 78K0R, M16C, R32C, TMPM370, TMPM470, HART, …).

The full firmware is rewritten on every install — the split is not about partial updates. It exists to gate functionality per license / per account: each TGSN account gets the set of modules its license entitles it to, no more, no less.

Why modules?

• Per-license access — a TGSN Open license sees fewer modules than TGSN Full. Module set is decided server-side at install time based on the account.
• Per-account record — each installed module is tied to the TGSN account that pulled it, and the list is visible on the Version page (see below).
• Server-side gating — adding or removing a family from a license doesn't require shipping a new Bootloader; the next install reflects the new entitlement.

How modules get installed

Modules are installed through TGSN Installer in MultiProg (menu TGSN → TGSN Install).

The standard Install flow already covers them:

1. Flash Bootloader (startup_firmware) — first icon.
2. TEST — second icon.
3. WiFi setup + authorization — third icon.
4. Online installation (OTA) — fourth icon. The Bootloader talks to the server, downloads the system modules for the families you have access to, and stores them in flash.

If you open Update on the TGSN device before any modules are installed, the screen will show:

Please install modules via TGSN Installer
Required from version:
MultiProg 2.2.54 / TGSN 3.2.6

Module list on the device

Settings → Version (long-press the upper button on the Version menu item) shows:

• current firmware Version + git hash + build time;
• User: <username> — the account this TGSN is provisioned for;
• Modules (N): — count and a numbered list of installed modules, sorted alphabetically.

Updating modules

In the current release modules can only be (re)installed through TGSN Install in MultiProg — the on-device Settings → Update menu does not push modules.

To refresh modules:

1. Open TGSN → TGSN Install in MultiProg.
2. Run TEST to confirm the device is reachable.
3. Run Setup WiFi + authorization if needed.
4. Run Online installation (OTA) — the Bootloader pulls the current set of modules for your account.

Settings → Update on the device is reserved for Bootloader-level updates (when a newer Bootloader is published) and shows the "Please install modules via TGSN Installer" hint until the system modules are present.

Beta firmware

Since MultiProg 2.2.54 you can pull a beta version of the firmware via the Flash button context menu in TGSN Installer:

• right-click the Flash startup button (the first icon);
• a context-menu entry lets you select the beta build instead of the stable one;
• the choice is verified against the server-side beta record.

Use this only when asked by support, or for early testing of a new family. Beta builds may be unstable.

Troubleshooting

Symptom	Likely cause	Action
Please install modules via TGSN Installer on Update screen	Modules never installed	Run TGSN Install through stage 4 (OTA)
Update never finishes	WiFi dropped mid-OTA	Re-run Install from the TEST stage; modules already installed are preserved
Family missing in TGSN target list	No matching module installed for your account	Re-run OTA; if still missing, check your license has access to that family
Wrong username on Version page	TGSN was provisioned for a different account	Re-do WiFi setup + authorization in TGSN Installer to reauthenticate