Revision History

Please refer to https://github.com/monowireless/mwm5 for the source code change history.

• Depending on the platform, the latest version distributed and the latest version in the revision history may not match.
• The latest version of the source code may not be registered at the above sites.

2.4.4 MWSTAGE2025_07 Release

Major Version Upgrade

• Added support for TWELITE STICK
• Enhanced serial port functionality
  • Added baud rate switching via ALT+B
  • Connection status now displayed in the title bar
• Makefile error message handling
  • Extracts the message part ... from errors output in the format $(error <MWERRM>...</MWERRM>)
  • These error messages are intended to be used when attempting to build projects for unsupported architectures (e.g., GOLD only, or BLUE/RED only)
• Support for language setting in interactive mode
  • Interactive mode language can now be specified at build time via TWE_LANG_PREF=(JP|EN)
  • When launching external tools (e.g., VSCode), the MWSDK_MAKE_LANG_PREF environment variable is now set

2.4.3

• For projects with multiple configuration types located in subfolders (and not directly under the root build), folder listing is now limited to only those that contain a build/ directory, preventing unnecessary folders from being shown
• Fixed a crash that occurred when error messages were too long during build errors
• Changed the order of serial protocol checks for determining BLUE/RED/GOLD: now tries GOLD first (for GOLD-targeted SDK)

2.4.2

• Added support for interactive mode transition control using the SET pin (CTS pin on MONOSTICK)
  • Behavior in TWELITE_Apps is as follows:
    • If SET pin is held for less than ~100ms → normal boot (prevents accidental interactive mode entry due to noise)
    • If held longer than the above → enter interactive mode on boot
    • If held for ~3 seconds or more → erase entire EEPROM on startup
    • Each app is informed of the interactive mode transition via a startup parameter
      • Apps receiving this parameter will, in principle:
        • Skip app-specific initialization
        • Skip interrupt handler setup, etc.
        • Automatically start interactive mode on UART0 at 115200 8N1
        • Suppress exit from interactive mode via +++
  • Under this spec, the STAGE app behaves as follows:
    • For regular transition to interactive mode, hold the SET pin for about 300ms
      • When holding [ C ] on the interactive mode guidance screen, SET pin is held for about 5 seconds
      • If Entering Interactive ... message is not received within timeout, fallback to trying +++ as per previous behavior
• Additional code cleanup

2.4.1

• Initial support for TWELITE GOLD
  • If a control command response from GOLD is received at startup, it’s recognized as GOLD; if it fails, control commands for the BLUE/RED series are attempted instead

1.3.8 MWSTAGE2022_08 Included Version

Major version upgrade.

• Changed internal rendering resolution from 320x240 to 640x480 pixels
• Added real-time graph for accelerometer sensor
• Added sensor graph that saves sensor data and displays graphs
• Supported English display
• Changed main manuals to local HTML files

1.0.8 MWSTAGE2021_09 Included Version

• There was a case where buttons [ A ] [ B ] [ C ] remained pressed even after the pointer moved away
• STAGE APP sends CRLF to TWELITE when Enter is input
• Updated Mac FTDI library to allow operation without serial intermediary program on Apple Silicon (M1)
• Internally set PATH for msys toolset on Windows to prevent unexpected make calls
• Allowed moving to the writing screen even if TWELITE is not connected (input B,R keys and specify the target TWELITE model)
• When configured to use VSCode, selecting act or TweApps opens the writing screen for .bin files under build/ without building (build is done from VSCode)
• Internally set several environment variables so that VSCode launched from TWELITE STAGE can refer to them, enabling proper builds and library resource referencing in VSCode
• Sample code is stored under MWSDK folder, but dropping a folder for build target allows build and write operations for folders other than MWSDK (folder names must not contain spaces or Japanese characters)
• Displayed internal folder settings and environment variable settings on the console screen at startup
• Waited 1 second before exiting STAGE APP on termination

1.0.7pre2

• Enhanced support for Raspberry Pi (1.0.7pre2)
  • Support for serial0 (TWELITE STAGE HAT)
  • Added build for Zero (build with supported libraries & disabled rendering fade feature)
  • Added build for X11 desktop
• Made it usable with general FTDI devices (FT232, FT230). Firmware writing mode must be done manually
• Added feature to display COM ports assigned in Windows by pressing c key on serial port selection screen
• Allowed changing baud rate from 115200bps
• Added command line option (-E 0) to disable rendering fade feature.

1.0.3 MWSTAGE2020_12 Included Version

• Supported TWELITE CUE (parser and CUE viewer)
• Enabled verification (comparison) during writing in the rewrite menu
• Provisional support for Apple Silicon (TWELITE_Stage.command is a universal app; external command sersrv_ftdi.command and Tools are rebuilt Intel binaries runnable with Rosetta2; serial communication is slower due to external command)
• Moved MWSTAGE/MWSDK/Tools to MWSTAGE/Tools (to allow direct use of MWSDK_COMMON repository)
• TWELITE_Stage.ini (removes extension from startup filename and adds .ini) is loaded at startup to allow selecting MWSDK folder (makes it easy to switch old library sets)
• Updated SDL2 library for screen rendering to 2.0.12 (Windows, MacOS, RaspberryPi)
• Static build on Windows with no DLL files required
• Set parallel build count for make -j to (number of physical CPUs - 1)
• Explicitly reopened serial port in several places in rewrite menu to improve recovery when USB connection is disconnected due to device removal
• When opening mwx or twesettings with Alt(Cmd)+Shift+m, t, opens folders listed in TWENET/usever.mk
• Fixed issue where writing menu transition failed on first startup at /dev/serial0 on Raspberry Pi

Known Issues

• Help message when pressing Alt(Cmd) at startup may not appear; can be shown by inputting Alt(Cmd)+0
• Line wrapping may be broken when filenames are too long in rewrite menu
• Apple Silicon operation has not been sufficiently tested

0.9.11 MWSTAGE2020_10, Raspberry Pi Version (Provisional)

(* This version is not comprehensively tested *)

• Operation on Raspberry Pi
• Other feature adjustments

0.9.9 - MWSTAGE2020_10 Included Version

• Added [Web] button to the top-level menu to open related links in browser
• Implemented folder, web, and VS Code open features for Linux version
• Sometimes difficult to transition to writing menu when TWELITE frequently outputs UART

0.9.8a

https://github.com/monowireless/TWELITE_STAGE_Bin_M5Stack/releases/tag/0.9.8a

M5Stack version made dual-licensed for MW-SLA-1J,E / MW-OSSLA-1J,E and updated readme-j.txt.

0.9.8

Added [Web] button to viewer list to open related sites.

Revision Details

• Added Commander to viewer
  • Standard app 0x80 command
  • NOTICE PAL LED control (send commands to App_Wings)
• NOTICE PAL support for viewer > PAL viewer
• Added menu for Act_extras
  • More advanced than Act_samples
  • Uses external open source libraries (e.g. sensor procedures)
• Expanded mouse operation (lists, buttons, tabs)
  • Focus on mouse move, confirm with left click, right click inputs [ESC] key
• Reduced screen rendering load
  • Disabled screensaver when app is in background
  • Reduced rendering frequency when app is in background to lower CPU load
• Enhanced build project list (act, TWE_Apps, Act_extras)
  • Show summary at bottom when selecting items (reads 000desc.txt, processed by TWE_Desc class)
  • Ability to open project folder (or open in VSCode)
  • Ability to open related websites
  • Open mwx library with Alt+Shift+m and twesettings library with Alt+Shift+t
  • Open selected folder or build error files in build menu
• Added logging (serial port input/output)
  • Start/stop log with (Alt/Cmd+L)
  • Log files saved in {folder containing TWELITE_Stage executable}/log
  • Filename format: twestage_{date-time}.log
  • Open log file folder with Shift+Alt/Cmd+L
• Other changes and fixes
  • Changed display method for serial (FTDI) device names and IDs
  • Fixed issue where App_UART did not transition to interactive mode
  • Changed behavior on folder drop (previously sometimes triggered binary write, now transitions menu)
  • On terminal long press [C], clears screen in addition to reset

Known Issues

• M5Stack may hang and reset settings to default when saving settings

0.8.9

2020_05 Release Version

• Added window icon
• Relaxed maximum list constraints on BIN file list screen (win/linux/mac)
• Added Glancer viewer
• Adjusted explanatory text
• Adjusted console screen rendering
• Fixed issue where setting destination screen after firmware write (interactive mode or terminal) did not work
• Changed assignment of Alt(or Cmd)+W
• Other bug fixes

0.8.6

Initial release of Linux version

0.8.5

Initial release