TWELITE STAGE APP

• 1: TWELITE STAGE APP Manual
• 1.1: Obtaining the Package
• 1.2: How to Use
• 1.2.1: Key and Mouse Operations
• 1.2.2: Screen Operations
• 1.2.2.1: Serial Port Selection
• 1.2.2.2: Main Menu
• 1.2.2.2.1: Viewer
• 1.2.2.2.1.1: Terminal
• 1.2.2.2.1.2: Standard App Viewer
• 1.2.2.2.1.3: Graph
• 1.2.2.2.1.3.1: Accelerometer Real-Time Graph
• 1.2.2.2.1.3.2: Sensor Graph
• 1.2.2.2.1.4: Simple Monitor
• 1.2.2.2.1.4.1: CUE Viewer
• 1.2.2.2.1.4.2: ARIA Viewer
• 1.2.2.2.1.4.3: Glancer
• 1.2.2.2.1.5: Commander
• 1.2.2.2.2: Write App Firmware
• 1.2.2.2.2.1: Select from BIN
• 1.2.2.2.2.2: act Build & Write
• 1.2.2.2.2.3: TWELITE APPS Build & Write
• 1.2.2.2.2.4: Act_extras
• 1.2.2.2.2.5: Folder (Specify)
• 1.2.2.2.2.6: Last (Re-execute)
• 1.2.2.2.2.7: Build & Write Screen
• 1.2.2.2.3: Interactive Settings Mode
• 1.2.2.2.4: Settings of TWELITE STAGE
• 1.2.2.2.5: Select SERIAL port
• 1.2.3: Logging Function
• 1.3: Detailed Specifications
• 1.3.1: Detailed Settings with Command-line Arguments and ini Files
• 1.3.2: Environment Variables
• 1.3.3: Adding Project Descriptions with 000desc.txt
• 1.4: License
• 1.5: Revision History

1 - TWELITE STAGE APP Manual

It operates on various platforms:

• Windows 10
• macOS (High Sierra or later, supports both Intel and Apple Silicon Macs)
• Linux (Ubuntu 18.04)
• Raspberry Pi (Raspberry Pi 3 Model B, LCD Touch Screen, Raspberry Pi OS August 2020)
• (M5stack: Supported up to version 1.0. Versions 1.3 and later are not supported at the source level.)

※ Depending on the platform, operating conditions, distribution formats, and features may differ.

About this Document

• To indicate the target platforms, some pages specify the following:
  • Windows   – Windows 10
  • macOS   – Mac OS X, OS X, macOS
  • Linux   – Ubuntu, etc. (64bit)
  • RasPi   – Raspberry Pi

1.1 - Obtaining the Package

The latest TWELITE STAGE app can be obtained by one of the following methods.

Entire TWELITE STAGE SDK (Official Website)

The Mono Wireless official website distributes a complete set of development tools (for Windows/macOS/Linux), including the TWELITE STAGE app.

TWELITE STAGE-トワイライトステージ - MONO-WIRELESS.COM

TWELITE STAGE App Only (GitHub)

The Mono Wireless official repository distributes the standalone binary of the TWELITE STAGE app. Please use this if you want to update only the TWELITE STAGE app or obtain the M5Stack version. The version of each binary can be identified from the tags on GitHub.

Windows

monowireless/TWELITE_Stage_BIN_Win: Binary Distribution of TWELITE Stage.

macOS

monowireless/TWELITE_Stage_BIN_macOS: Binary distribution of TWELITE Stage for macOS

Linux

Linux binaries are not distributed separately. Please obtain binaries from the TWELITE STAGE SDK package or build from source code.

Raspberry Pi

Raspberry Pi binaries are not distributed separately. Please obtain binaries from the TWELITE STAGE SDK package or build from source code.

M5Stack

Versions up to 1.0.3a are distributed on the following page.

monowireless/TWELITE_STAGE_Bin_M5Stack

Source Code (MWM5 Library)

The MWM5 library, including the source code of TWELITE STAGE, is published on the following page.

monowireless/mwm5

The source code of the TWELITE STAGE app is placed in examples/TWELITE_Stage.

1.2 - How to Use

How to Launch the App

To launch the TWELITE STAGE app, execute the executable file located in {MWSTAGE Installation}.

The method of execution varies depending on the platform (Windows, macOS, Linux).

Executable Types of the App

The TWELITE STAGE APP has two types of executables.

• TWELITE_Stage.{extension} - Launches with standard settings.
• TWELITE_Stage_VSCode.{extension} - Configured to “Use VSCode” (settings saved in TWELITE_Stage_VSCode.ini). When the VSCode usage setting is enabled, the app operates in a way suitable for development work using VSCode.

App Interface

When you launch the app, two types of windows are displayed:

• Main Window
  • Displays the user interface of the TWELITE STAGE APP.
    • The serial port under connection (e.g. TWELITE-R or TWELITE STICK) is displayed in the title bar.
  • All operations of the TWELITE STAGE APP are performed within this window.
    • Press the ALT (Cmd) key to display the operating aid screen.
    • The [ A ] [ B ] [ C ] buttons appear at the bottom of the screen and are used for operation. These buttons can be pressed and held down to call up sub-functions.
• Command Window
  • Usually not used, but displays auxiliary information.
    • Shows serial communication content, making it ideal for checking logs.
    • When launched from the command line, the originating terminal acts as the command window.

Exiting the App

Exit the app by any of the following methods:

• Move the mouse pointer to the upper right of the execution screen and press the exit button displayed within the screen.
• Close the app window (on macOS, ⌘Q can also be used).

1.2.1 - Key and Mouse Operations

Windows   macOS   Linux   RasPi

Key Operations

Windows   macOS   Linux   RasPi

Key inputs performed while holding down Alt (Cmd) are assigned to operations such as changing the settings of TWELITE STAGE APP. Other key operations generally function as normal text input.

Common Keys

Windows   macOS   Linux   RasPi

Help Screen

Windows   macOS   Linux   RasPi

Hold down Alt (Cmd) to display the help screen. The help screen shows explanations of keys that can be used together with Alt (Cmd) and some operational status.

The help screen can also be displayed by moving the mouse pointer to the top-left corner of the screen.

Alt (Cmd) + Operations

Windows   macOS   Linux   RasPi

This section explains operations performed while holding down Alt (Cmd).

In the table below, the Alt (Cmd)+ prefix is omitted. You can check the available keys from the help screen above, but supplementary explanations are provided in the table below.

Other Operations

Mouse Operations

Windows   macOS   Linux   RasPi

Mouse operations mainly involve left-clicking, but right-click, right double-click, and the scroll wheel may be used.

Mouse Control of A, B, C Buttons

Windows   macOS   Linux   RasPi

When you move the mouse pointer to the menu display at the bottom of the screen, buttons labeled [ A ], [ B ], and [ C ] appear. TWELITE STAGE APP assigns functions of the hardware buttons arranged in this way to each screen. You can call the functions by left-clicking or long-pressing these buttons. (They can also be selected with Alt (Cmd)+a,s,d or Alt (Cmd)+Shift+a,s,d)

Mouse Control of Screen Operations

Windows   macOS   Linux   RasPi

On Windows/macOS/Linux, TWELITE STAGE APP screens are basically composed of text only, but menus, buttons, and tabs can be operated with the mouse.

The screen consists of text only, but the tabs at the top of the screen and inverted text can be selected by left-clicking with the mouse.

1.2.2 - Screen Operations

Windows   macOS   Linux   RasPi

Windows / macOS / Linux / Raspberry Pi

TWELITE STAGE APP is an application launched from the console screen (command line). It outputs information to both the console screen and window screen.

The console screen displays UART output similar to a terminal.

Raspberry Pi (nox)

Displays on the framebuffer without using X11.

Normally (when started from a shell screen on the framebuffer), the console screen is not displayed.

1.2.2.1 - Serial Port Selection

Windows   macOS   Linux   RasPi

Overview

On Windows / macOS / Linux, a screen to select the serial port connected to TWELITE is displayed at startup. However, the serial port can also be connected later.

Windows

Press the c key to display the COM port name of the serial port currently highlighted in the list.

Raspberry Pi

On Raspberry Pi, in addition to USB devices, if /dev/serial0 and /dev/serial1 exist, serial0 and serial1 will be displayed. Normally, serial0 is used.

1.2.2.2 - Main Menu

Windows   macOS   Linux   RasPi

This is the top level of the hierarchical menu.

On this screen, you select a menu. When a menu is highlighted, a brief explanation is displayed in green text at the bottom.

• Viewer: A viewer that interprets and displays packets received from TWELITE. In many cases, the receiving TWELITE is programmed with App_Wings.
• Write Firmware: Build the firmware and write it to the connected TWELITE.
• Interactive settigns mode: Configure the connected TWELITE settings via interactive mode.
• Settings of TWELITE STAGE: Configure various settings of the TWELITE STAGE app.
• Select SERIAL port: Select the serial port.
• Open MANUAL: Menu to display manuals. Opens the following manuals in a browser:
  • TWELITE STAGE App (this document)
  • MWX Library
  • TWENET_C Library

1.2.2.2.1 - Viewer

Windows   macOS   Linux   RasPi

The viewer is a feature for displaying information received from a connected TWELITE and sending commands.

1.2.2.2.1.1 - Terminal

Windows   macOS   Linux   RasPi

Overview

A general VT100-compatible serial terminal.

Supports TWELITE interactive mode and reset control.

Operations

1.2.2.2.1.2 - Standard App Viewer

Windows   macOS   Linux   RasPi

Overview

The TWELITE communicating partner should have App_Twelite (Standard App) programmed. When a message indicating the status of buttons or analog inputs of the Standard App (0x81 message) is received, its contents are interpreted and displayed using the mwm5 parser library.

Operations

1.2.2.2.1.3 - Graph

• Accelerometer Real-Time Graph: Displays accelerometer sensor packets in real time. Frequency domain display and CSV file saving are available.
• Sensor Graph: Saves data from various TWELITE sensors into an sqlite3 database and displays graphs.

1.2.2.2.1.3.1 - Accelerometer Real-Time Graph

Windows   macOS   Linux   RasPi

Overview

This refers to packets received from TWELITE CUE and TWELITE Motion Sensor PAL. It can display accelerometer data in real-time, and includes features for frequency analysis and CSV export.

It supports three modes: CUE mode, MOT mode, and 2525 FIFO mode.

When a continuous series of samples reaches a certain number (analysis window), frequency analysis of the XYZ axes is displayed. However, in 2525 FIFO mode, it is assumed to be always continuous.

When packet boundaries are explicit (e.g., when more than 3 seconds have elapsed since the previous packet, in CUE mode for each packet, or in MOT mode when the packet sequence number is discontinuous), four dummy samples are inserted and a pink background is shown.

Data from up to four nodes are stored on a first-come, first-served basis.

Operation

Sample Rate Estimation

The sampling rate is calculated from the packet reception times. It averages the reception times of multiple past samples to estimate one sample interval, so packet drops may cause significant errors. Also, the related log timestamp (T_SMPL) is an estimated value and is delayed compared to the packet acquisition time. Once sample rate estimation completes, graph scrolling becomes smooth.

Opening the CUE Graph Mode on Startup

Specify 31 in [STAGE Common Settings → Startup App Selection].

Log Output (Save Display Data)

Pressing the (c) Save Display Data button outputs up to 512 samples starting from the current display position (rightmost sample).

Log file name is {log folder}/acc_snap_{timestamp}.csv.

• Data has the newest sample at the right edge as sample number 512 (file end).
• When frequency analysis is performed, the last samples used for frequency analysis are included.
• Frequency analysis results are added to rows containing frequency analysis target samples (for 64 samples, results appear from sample 449 for 32 rows, showing from DC to high frequency components).

Additional Information

Log Output (Auto Save)

When the Accelerometer Real-Time Graph screen is opened and data is input, log files are automatically saved.

Log file name is log folder/accel_{serial number}_{timestamp}.csv.

Additional Information

1.2.2.2.1.3.2 - Sensor Graph

Windows   macOS   Linux   RasPi

Overview

Various sensor data are recorded in an SQLite database and displayed on the screen in graph format. The database file can also be accessed by external applications.

• The database uses SQLite (sqlite3) and is stored in the file {MW_STAGE Install}/log/{executable_name}_WSns.sqlite.
• Screen navigation is [List (with graph preview)] > [24-hour Data] > [Live View].
  • From [24-hour Data], you can further navigate to [Year], [Month], and [Day (with graph preview)] selection screens.
• About the [Live] display screen:
  • Select a specific node from the list.
  • Displays real-time data every second, showing data from the past 450 seconds.
• About the [24-hour Data] display screen:
  • Displays data for a specific day.
  • Updates every second; if multiple data points occur during that time, some are thinned out.
  • Except at maximum zoom (1 pixel = 1 second), the average value for the data within each pixel range is displayed.
  • If values exceed the screen, measurement points are shown at the top or bottom edges.
  • If the current time is included, the display updates with new data.
  • Mouse wheel or cursor keys ↑ and ↓: zoom in/out on the time axis.
  • Moving the mouse pointer: briefly displays the data corresponding to the time under the pointer.
    • Cursor keys → and ←: move to the adjacent data point.
  • Mouse click & drag: scroll (only when zoomed).
  • When zoomed, scrollbar operation is also possible.
  • The [CSV Export] function outputs all data in the database.

Operations

Editing Sensor Node Notes (Supplementary Information)

In the “24-hour Data” screen, left-clicking on the sensor node’s note area at the top right of the screen allows you to edit the note using a prompt.

Screen Navigation

The basic screens are divided into three types: List, 24-hour, and Live.

[List] <--> [24-hour] <--> [Live]
              ↓↑
          [Year/Month/Day Selection]

Starting Sensor Graph Mode on Launch

Specify 32 in [STAGE Common Settings → Launch App Specification].

About the Database Tables

sensor_data

Stores received data.

sensor_node

Stores text notes (supplementary information) for sensor nodes.

sensor_last

Manages the timestamp of the last received data.

1.2.2.2.1.4 - Simple Monitor

• CUE Viewer: Interprets packets from TWELITE CUE and displays them simply
• ARIA Viewer: Interprets packets from TWELITE ARIA and displays them simply
• Glancer: A simple monitor supporting many formats of TWELITE

1.2.2.2.1.4.1 - CUE Viewer

Windows   macOS   Linux   RasPi

Overview

Interprets and displays messages received from TWELITE CUE.

Operation of TWELITE CUE

The factory default setting of TWELITE CUE is configured to CUE mode.

In CUE mode, it operates intermittently to enable coin cell battery operation, waking from sleep due to several factors and transmitting various data.

Wake-up Factors

TWELITE CUE requires one of the following factors to wake from sleep:

• Wake-up by timer (periodic wake-up)
• Wake-up by acceleration detection
• Wake-up by magnetic sensor (when a magnet is detected nearby)

Types of Data Transmitted

TWELITE CUE sends the following data in packets:

• Detection events (see below)
• Module power voltage
• Magnetic sensor detection value
• Acceleration data

Packet Attributes

The attributes of received packets provide basic information.

Events

In CUE mode, acceleration events are always output. Regardless of the wake-up factor, a fixed number of acceleration samples are measured after waking. Events are determined based on the acceleration measurement results.

Voltage

Power supply voltage of the module [mV].

Magnet

Displays the detected magnetic pole or no detection.

Acceleration

Displays acceleration measured after waking.

• Samples: Displays the number of acceleration samples, fixed at 10 samples.
• Rate ID: Sample rate of acceleration, fixed at 04 (100Hz).
• X, Y, Z: Acceleration on three axes. Calculated as the average of 8 samples. Unit is milli-G (1000mG = 1G = 9.8m/s²).

Example Screens

1.2.2.2.1.4.2 - ARIA Viewer

Windows   macOS   Linux   RasPi

Overview

Interprets and displays messages received from TWELITE ARIA.

Operation of TWELITE ARIA

The factory default setting of TWELITE ARIA is TWELITE ARIA mode.

In TWELITE ARIA mode, it operates intermittently to allow coin battery power, waking from sleep due to several factors, and sending various data.

Wake-up Factors

TWELITE ARIA requires one of the following factors to wake from sleep:

• Wake-up by timer (periodic wake-up)
• Wake-up by magnetic sensor (when a magnet is detected nearby)

Types of Data Sent

TWELITE ARIA sends the following data packed in a packet:

• Module power supply voltage
• Magnetic sensor detection value
• Temperature and humidity data

Packet Attributes

Basic information can be obtained from the attributes of the received packet.

Temperature and Humidity Data Table

Displays the history of the last 9 data packets received from TWELITE ARIA. The latest data is displayed at the top.

Time [s]

Time [seconds] from when the TWELITE STAGE APP started until the data was received.

ID

Logical device ID of the module.

VCC (mV)

Power supply voltage of the module [mV].

Temperature (°C)

Temperature measured by the module (°C).

Humidity (%)

Humidity measured by the module (%).

Magnet

Displays the detected magnetic pole or no detection.

1.2.2.2.1.4.3 - Glancer

Windows   macOS   Linux   RasPi

Overview

Glancer provides a simplified display of the information contained in received messages.

By programming the connected TWELITE with App_Wings, it can display information received from communication partners’ TWELITE devices (App_Twelite, TWELITE PAL, … as long as the application ID and frequency channel match, mixed operation is possible).

Operation

Use by switching between the list display screen and the selection display screen.

List Display

Lists information from communication partners.

Displayed content includes message type, logical device ID, serial ID, LQI (Lq), power voltage (if included in the information), and timestamp.

Selection Display

By moving items and highlighting one in the list display, then performing a selection operation, you transition to this screen. It shows information related to a specific communication partner in order of arrival.

The number of received packets and the average LQI since selection are displayed.

1.2.2.2.1.5 - Commander

Windows   macOS   Linux   RasPi

Overview

Commander is a feature to send serial messages to TWELITE.

Operation

The first screen of the Commander displays important notes.

At the top of the screen, there are tabs represented by text, which you can navigate by clicking with the mouse to switch between tab screens.

Tab: TWELITE

This screen generates and sends the 0x80 command of the Standard App (App_Twelite).

Make sure the connected TWELITE has App_Twelite or parent/relay app (App_Wings) programmed, and after setting the application ID and channel, confirm that messages are being received from the communication partner.

Tab: NOTICE

This screen generates the LED control command of the Notification PAL (NOTICE PAL).

Make sure the connected TWELITE has App_Wings programmed, and after setting the application ID and channel, confirm that messages are being received from the communication partner.

Display at the bottom of the screen

At the bottom of the screen, the timestamp when the command was generated and the command starting with : are displayed. The clipboard copies the contents of this screen.

1.2.2.2.2 - Write App Firmware

Windows   macOS   Linux   RasPi

The firmware writing function allows you to write the TWELITE app (firmware).

• Write pre-built .BIN files
• Build from source files such as act and write

It eliminates the hassle of building source files, terminal disconnection, launching the writing utility, and terminal connection.

• Automatically recognize TWELITE
• After writing is complete, reset and then transition to interactive mode or terminal
• From the list of projects, launch the project folder or environments like VSCode (except Raspberry Pi version)
• From the list of projects, open related information web pages (except Linux and Raspberry Pi versions)

1.2.2.2.2.1 - Select from BIN

Windows   macOS   Linux   RasPi

Overview

You can write pre-built applications ( .BIN files ).

When you select the menu, a list of .BIN files will be displayed. Please select the firmware to write.

If you want to use a file other than the pre-prepared .BIN files, please store the file to be written in the following location before selecting the menu.

In the BIN folder, please store .BIN files built with TWELITE STAGE without renaming the files (they are stored under the build folder of each project).

../BIN/App_Wings_MONOSTICK_BLUE_L1304_V1-1-3.bin
       App_Wings_MONOSTICK_RED_L1304_V1-1-3.bin
       App_Twelite_BLUE_L1304_V1-9-1.bin
       App_Twelite_RED_L1304_V1-9-1.bin
       ...

1.2.2.2.2.2 - act Build & Write

Windows   macOS   Linux   RasPi

Overview

You can build and rewrite acts (act) written with the MWX library.

This screen displays a list of projects using acts placed in the following path.

{MWSTAGE installation folder}/MWSTAGE/Act_samples

Operation

You can build and write by selecting the project to write from the list.

After writing is finished, pressing ENTER or the [ B ] button will reset the TWELITE and transition to the interactive mode screen (or terminal screen, depending on settings).

Build and Write Screen

1.2.2.2.2.3 - TWELITE APPS Build & Write

Windows   macOS   Linux   RasPi

Overview

You can build and write TWELITE APPS written with the TWENET C library.

This screen displays a list of projects located in the following path:

{MWSTAGE installation folder}/MWSTAGE/Wks_TweApps

Operation

By selecting the project to write from the list, you can perform build and write operations.

After writing is completed, pressing ENTER or the [ B ] button will reset the TWELITE and transition to the interactive mode screen (or terminal screen, depending on settings).

Build and Write Screen

1.2.2.2.2.4 - Act_extras

Windows   macOS   Linux   RasPi

Overview

You can build and rewrite acts written with the MWX library.

This screen displays a list of projects using acts placed in the following path:

{MWSTAGE installation folder}/MWSTAGE/Act_extras

Operation

By selecting a project to write from the list, you can perform build and write operations.

After writing is complete, pressing ENTER or the [ B ] button will reset the TWELITE and transition to the interactive mode screen (or terminal screen, depending on settings).

Build and write screen

1.2.2.2.2.5 - Folder (Specify)

Windows   macOS   Linux  

By dragging and dropping a folder or .BIN file onto the TWELITE STAGE APP screen, you can write a specific project. Select the dropped target when performing build or write operations.

1.2.2.2.2.6 - Last (Re-execute)

Windows   macOS   Linux   RasPi  

Re-select the most recently rewritten or specified project.

1.2.2.2.2.7 - Build & Write Screen

Windows   macOS   Linux   RasPi  

During Build

This is the screen during the build (compile) process. The contents of the build command are output to the console screen. The ... in the middle of the screen indicates the number of files built, and the dark-colored display at the bottom shows the filenames currently being built.

Build Error

If a build error occurs, a screen like the one above is displayed. You can execute a rebuild or display the error log. Also, after a certain timeout, it will return to the previous menu.

Only representative error messages are displayed on the screen. When the build fails, there may be cases where the error message is not displayed.

During Write

When the build succeeds, the screen to write the firmware is displayed.

Write Failure

If writing results in an error, a screen like the one below is displayed.

Write Complete

When writing completes successfully, a screen like the one below is displayed.

1.2.2.2.3 - Interactive Settings Mode

Windows   macOS   Linux   RasPi

Overview

From this screen, you can use the interactive mode of the connected TWELITE.

This screen behaves almost the same as a terminal, but adds functions specific to interactive mode, such as operations to transition to interactive mode and detection of exit from it.

• The connected TWELITE must have firmware compatible with interactive mode pre-installed.
• Since TWELITE input/output is used, if garbled characters occur in serial communication, transitions to and exits from interactive mode may not work as expected.
• Mouse operations are not supported. Please use keyboard operations (cursor ↑ ↓ keys are usable).

Interactive Mode Screen Operation Flow

Below is an outline of the process flow.

[Set screen background to black]
  ↓
[Reset TWELITE (if controllable, SET=LO)]
  ↓
 --YES--> [Operation screen]
  ↓timeout
[Input '+' three times]
  ↓
 --YES--> [Operation screen]
  ↓timeout
[Operation screen] ※ This state is not interactive mode

[Operation screen]
  ↓
 --> [Exit]
  ↓
 --> [Exit]
  ↓
 ->  --NO-> [Exit]
  ↓            ↓
[Send input string to TWELITE]
  ↓
[Return to operation screen]

[Exit]
  ↓
[Reset TWELITE]
  ↓
[Exit screen] Exit the interactive mode screen and return to the previous screen

1.2.2.2.4 - Settings of TWELITE STAGE

Windows   macOS   Linux   RasPi

Overview

From this screen, you can configure various settings of the TWELITE STAGE APP.

Some menu items explained below may not exist on certain platforms, but all are listed and explained.

Color settings other than the common menu are omitted from the explanation.

Root Menu

Common
 Terminal
 Standard App Viewer
 Graph Viewer (Acceleration Real-time/Sensors)
 Simple Monitor (CUA/ARIA/Glancer)
 Commander
 Write firmware
 Interactive Settings Mode
Save Data Utilities (Dump/Erase)
Information

Common Settings

a: (      0x00) Startup App Specification
G: (      0x00) Screen Size and Drawing Method
F: (          ) Serial Device ID
f: (0x00FFFFFF) Foreground (Text) Color
b: (0x005A0032) Background Color
B: (    115200) Baud Rate

Write Firmware

f: (0x00FFFFFF) Foreground (Text) Color
b: (0x005A0032) Background Color
j: (         0) Number of make jobs at build time
v: (         0) Open a folder with VSCode
l: (         0) Disable LTO
n: (         0) Screen after rewriting is completed

Save Data Utilities

r: Read sector.
R: Read ALL sectors.
e: Erase sector.
E: Erase ALL sectors.

This screen is a utility for maintaining data save areas. It emulates EEPROM (64 bytes per sector, up to 60 sectors, 3840 bytes).

1.2.2.2.5 - Select SERIAL port

Windows   macOS   Linux   RasPi

Overview

On this screen, you can (re)select the serial port.

1.2.3 - Logging Function

Windows   macOS   Linux   RasPi

Operation

Start Recording

Press Alt(Cmd)+L.

Stop Recording

While recording, press Alt(Cmd)+L again.

The log recording will stop, and the log file at that point will be opened using the OS default application (Notepad on Windows, Console.app on macOS).

Specifications

Log Recording

Strings received from TWELITE are recorded as-is.

Strings sent to TWELITE are recorded one character at a time. On Windows, they are enclosed in ｢ ｣, and on macOS / Linux / Raspberry Pi, they are enclosed in « ». For example, «t» means that the character t was input from the keyboard.

Log Folder and File Name

Logs are saved in the {folder where the TWELITE STAGE APP executable is located}/log folder, with a file name based on the start date and time of the logging.

Press Alt(Cmd)+Shift+L to open that folder.

1.3 - Detailed Specifications

1.3.1 - Detailed Settings with Command-line Arguments and ini Files

Command-line Arguments

Command-line arguments configure some detailed settings of the TWELITE STAGE APP.

ini Files

ini files are used to configure basic settings of the TWELITE STAGE APP (such as referencing the MWSDK folder).

The ini file name is {base name of the TWELITE STAGE APP executable} + .ini. Usually, it is TWELITE_Stage.ini.

;;; Change the MWSDK reference.
; MWSDK=MWSDK
mwsdk=mwsdk2020_10

;;; Interface language
; LANG=en

;;; Window geometry
GEOM_X=200
GEOM_Y=100

Syntax

• ini files are written as plain text files.
• Keys and values are stored on a single line separated by = (e.g., KEY=value).
• The key and value strings start at the beginning of the line (no spaces or other characters allowed before the key).
• Spaces are not allowed between the key and the value.
• Comment lines start with ; or # at the beginning of the line.

Settings

Running TWELITE STAGE APP with Different Settings

If you need different settings for the TWELITE STAGE APP, copy the executable to the same folder as the TWELITE STAGE APP and create an .ini file with the same name.

For example, to use the English interface, copy TWELITE_Stage.exe (note: .exe is the Windows executable extension) to TWELITE_Stage_en.exe and write the setting LANG=en in TWELITE_Stage_en.ini to create an executable with the English interface enabled.

  TWELITE_Stage.exe
  TWELITE_Stage.ini | No special settings

  TWELITE_Stage_ja.exe | Copy of TWELITE_Stage.exe
  TWELITE_Stage_en.ini | LANG=en is set.

1.3.2 - Environment Variables

Environment Variables Set Internally

Reference

Excerpt from .vscode/settings.json configuration example:

    "C_Cpp.default.includePath": [
        "${env:MWSDK_TWENET_LIBSRC}/include/**",
        "${env:MWSDK_TWENET_LIBSRC}/src/**"
    ],
    "C_Cpp.default.browse.path": [
        "${env:MWSDK_TWENET_LIBSRC}/include/**",
        "${env:MWSDK_TWENET_LIBSRC}/src/**"
    ],

Definitions starting with "../../" are unnecessary when opening a project from the TWELITE STAGE app. These specify source reference paths in the default folder structure when the environment variable MWSDK_TWENET_LIBSRC is not set.

1.3.3 - Adding Project Descriptions with 000desc.txt

When you create a 000desc.txt file in the project folder, TWELITE STAGE APP displays its contents in the project folder list.

The file should be written as plain text in UTF-8 format. There are two formats as follows.

Format 1

LED lights up when the switch is pressed
act4 operates an act that lights up the LED when the switch connected to TWELITE DIP is pressed.
https://mono-wireless.com/jp/products/act/index.html

• The first line is the title line.
• The following lines describe details.
• If the last line starts with http, it becomes a link to a website.

Format 2

[JAPANESE]
TITLE=act template
DESC=This file contains only empty setup() and loop() functions.
Please use it to write a new act.
URL=jp/MWX/content/Act_samples/README.html
[ENGLISH]
TITLE=act empty template
DESC=This act file only contains empty setup() and loop(),
which is intended to write a new act.
URL=en/MWX/content/Act_samples/README.html

This format is like an ini file. The item name starting from the beginning of the line and the = character define the item, and the content after = is the item’s content.

About URL specification

1.4 - License

The executable format of TWELITE_Stage distributed by Mono Wireless Inc. is subject to MW-SLA-1J,1E.

Open Source Components Used

We appreciate the open source projects that provided high-quality source code.

1.5 - 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