Skip to content

Support the MultiTech MT9234MU USB modem (TUSB3410 driver, firmware import) - #56

Merged
Neo-Desktop merged 2 commits into
mainfrom
claude/project-thread-2y4er4
Nov 17, 2026
Merged

Neo-Desktop merged 2 commits into
mainfrom
claude/project-thread-2y4er4

Conversation

@Neo-Desktop

@Neo-Desktop Neo-Desktop commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Requested by Sydney · project thread

What

The MultiTech MultiMobile MT9234MU (USB 06E0:F114) and MT9234ZBA-USB (06E0:F115, 06E0:0319) can now be the line "A phone line, through a modem on a USB serial adapter".

These modems are not CDC-ACM. They have a TI TUSB3410 USB UART with no EEPROM, so the modem shows only the chip's boot ROM until the host downloads the firmware into its RAM (Linux does this in ti_usb_3410_5052).

  • TiSerialDriver.kt: our own usb-serial-for-android driver for the TUSB3410: configuration 2, SET_CONFIG (divisor, flags, format), OPEN_PORT / START_PORT / PURGE_PORT, DTR/RTS and break through the MCR/LCR in XDATA, CD/CTS/DSR/RI from GET_PORT_STATUS.
  • TiFirmwareLoader.kt: SerialAdapters.open sees a modem in its boot ROM, sends the firmware (header fixed, 64-octet bulk packets), resets the device (new JNI call nativeUsbReset, USBDEVFS_RESET), waits for it to come back, and opens it. The modem line, the local Linux's /dev/ttyUSB0 and the USB bridge all get this.
  • The app ships MultiTech's mts_mt9234mu.fw in app/src/main/assets/firmware, with a README.md notice: its licence is unknown (linux-firmware listed it as "Licence: Unknown" and removed it in June 2026), and the AGPL and commercial licences do not apply to it. Settings, Line shows which file is used ("built in" or "imported"), can import another file, and can go back to the built-in one.
  • The USB device filter and probe table have the three IDs.
  • docs/adapters.md: a new section (STE), with the firmware notice, the country command AT%T19,0,<code> and the two-page ATI11.

The MT9234MU-CDC models are CDC-ACM and already work through the existing CDC driver.

Tests

  • TiSerialTest (12 tests): the IDs, divisors, the configuration block, the open sequence, MCR/LCR writes, the status, the firmware header and packets, and that the shipped asset is MultiTech's file. UsbSerialAdaptersTest has the MultiTech IDs. Both pass locally (testDebugUnitTest).
  • Not tested with a real MT9234MU. The open questions are whether USBDEVFS_RESET is allowed on every phone (the TUSB3410 needs a reset to run its firmware) and how the modem's firmware maps DCD.

🤖 Generated with Claude Code

https://claude.ai/code/session_01B82eRTNWiwCE3duMg28226

The MT9234MU (06E0:F114) and MT9234ZBA-USB (06E0:F115, 06E0:0319)
have a TI TUSB3410 USB UART between USB and the modem. The chip has
no firmware of its own, so the modem shows only its boot ROM until
the host downloads the firmware.

- TiSerialDriver: our own usb-serial-for-android driver for the
  TUSB3410 (configuration 2, SET_CONFIG, OPEN/START/PURGE, the MCR
  and LCR in XDATA, the lines from GET_PORT_STATUS).
- TiFirmwareLoader: the firmware (header fixed, 64-octet packets) to
  the boot ROM, a usbfs reset (new JNI call), and a wait for the
  modem to come back. SerialAdapters.open does this before it opens
  the port, so the line, the local Linux and the USB bridge all get it.
- TiFirmwareStore and a Settings button: the user imports
  mts_mt9234mu.fw. The app does not ship it: its licence is unknown
  and linux-firmware removed it in 2026.
- The device filter, the probe table, unit tests and docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B82eRTNWiwCE3duMg28226
@Neo-Desktop Neo-Desktop self-assigned this Nov 16, 2026
The MT9234MU now works with no import step. The app has MultiTech's
firmware file in assets/firmware, with a README that gives its source
(linux-firmware before June 2026) and that its licence is unknown, and
that the AGPL and commercial licences do not apply to it.

TiFirmwareStore uses an imported file first, else the built-in one.
Settings, Line says which one ("built in" / "imported") and has "Use the
built-in file" to remove an import. docs/adapters.md and a unit test
(the asset is the known file and a valid image) follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B82eRTNWiwCE3duMg28226
@Neo-Desktop
Neo-Desktop merged commit 70e645b into main Nov 17, 2026
9 checks passed
@Neo-Desktop
Neo-Desktop deleted the claude/project-thread-2y4er4 branch November 17, 2026 11:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants