Evaluation and Configuration with TWELITE STAGE APP

How to evaluate communication and change settings using TWELITE STAGE APP

By using the TWELITE STAGE APP included in the TWELITE STAGE SDK development and evaluation environment, you can verify communication and change settings.

Much of the content on this page is also applicable to the MONOSTICK series.

Basic Operation Check

Connect the TWELITE STICK

Connect the TWELITE STICK to the USB port of your PC.

The factory-shipped TWELITE is set to Parent mode of the Parent and Repeater App. It can send and receive data with child devices of the TWELITE series, and the logo mark should light up magenta.

If you have not yet installed the TWELITE STAGE SDK, please obtain it and then install it.

Check the Startup Message

To verify the operation of the TWELITE STICK, first check the startup message output during boot.

TWELITE STICK communicates with the PC using UART at 115200bps / 8-N-1.

With TWELITE STICK connected, launch TWELITE_Stage from the MWSTAGE folder. On the “Serial Port Selection” screen, TWELITE STICK will be listed.

If TWELITE STICK does not appear, try installing the FTDI D2XX driver.

On Windows, it appears as a COM port in Device Manager. On other systems, it appears as /dev/tty*.

When you select TWELITE STICK, the application proceeds to the main menu.

Selecting Viewer will take you to the viewer selection menu.

To return to the previous screen, long press the bottom left of the screen or press the ESC key.

Selecting Terminal will open a VT-100 compatible terminal screen, just like a typical terminal application.

By default, TWELITE STICK may already be outputting received packet data, as shown above.

Long-press the Firmware Write/Reset button in the lower-right corner to reset the TWELITE.

Long-press the lower-right corner to reset

A startup message will appear.

In the example above, the following message is shown:

!INF MW APP_WINGS(Parent) v1-03-2, SID=0x8300051A

If you see !INF MW APP_WINGS(Parent) in the output, it indicates that the Parent mode of the Parent and Repeater App (App_Wings) is running.

TWELITE STICK has started successfully!

Communicating with a TWELITE DIP Child Device

This section describes how to verify communication with a child device using the TWELITE DIP.

The TWELITE DIP runs the Extremely Simple! Standard App (App_Twelite) that is written at the factory.

Preparing the TWELITE DIP

Connect a switch between DI1 and GND, and connect an LED between DO1 and VCC. This setup is the same as used in Basic Communication Between Terminals Using the Extremely Simple! Standard App.

By using a TWELITE STICK in place of a TWELITE DIP parent, you can detect the button state on the PC side or control the LED from the PC.

Connecting the TWELITE STICK

Connect the TWELITE STICK to the USB port of your PC.

If it is set to Parent mode of the Parent and Repeater App, it will light up magenta.

Device Settings

No configuration changes are required. Communication will begin immediately using the factory default settings.

However, for confirmation, let’s check the current configuration.

To change TWELITE settings via UART, start the device in Interactive Mode. TWELITE STAGE APP provides functionality for working with Interactive Mode.

From the main menu, select Interactive Mode.

On the next screen, click anywhere or press the Enter key to continue.

If the following screen appears, the mode has started successfully.

If the Channel value, which physically separates networks, is 18, and the Application ID value, which logically separates networks, is 67720102, communication with the factory-shipped TWELITE DIP will be possible.

How to Operate Interactive Mode

Enter the ID shown on the left to edit each item (e.g., enter a to edit the Application ID)
After selecting an item, type the value and press the Enter key to confirm, or press the ESC key to cancel
Press the S key to apply the settings you’ve entered
To reset all settings to default, press the R key to reset, then press the S key to apply

For details about each setting item, see the documentation for the Parent and Repeater App (App_Wings).

Logo Lighting

With the TWELITE STICK connected to your PC, press the switch connected to DI1 on the TWELITE DIP.

If operating correctly, the logo will glow red and brighter while the button is pressed.

Logo lights up red when DI1 is pressed

If a switch is connected to DI2, the TWELITE STICK will glow green. If AI1 is disconnected from VCC and a voltage between 0–2V is applied, the brightness will vary depending on the button press on DI1 or DI2.

Standard App Viewer

TWELITE STAGE APP includes a feature to display data received from child devices running the Extremely Simple! Standard App.

Let’s read the status of the switch connected to DI1.

From the main menu, select Viewer.

On the viewer selection screen, select Standard App Viewer.

The Standard App Viewer displays the latest data received by the TWELITE STICK from the Extremely Simple! Standard App.

When you press the switch connected to DI1 on the TWELITE DIP, the D1 indicator will light up in red.

Standard App Viewer Items

Time CT: Timestamp of the packet
Id#: Logical Device ID of the child device
Serial Number: Serial ID of the child device (engraved on the can)
Dx: State of the DIx pins
Ax: Voltage input to the AIx pins (in mV, ranging from 0mV to 2000mV)

Standard App Commander

TWELITE STAGE APP also includes a function to send data to child devices running the Extremely Simple! Standard App. Let’s try controlling the LED connected to DO1.

From the main menu, open Viewer.

On the viewer selection screen, choose Commander.

Select App_Twelite 0x80 Command.

Click on DI1(1) or press the 1 key to control the lighting state of DI1.

Standard App Commander Items

Destination ID: Logical Device ID of the target device to which you want to send a state change
DIx(x): State change of the target device’s DOx pin
SEL(x): Enable flag for DIx(x)
PWMx(x): Change the duty cycle of the target device’s PWMx pin
Send (SPACE): Re-send with the current state

You’ve successfully confirmed the TWELITE STICK’s settings and its communication with a TWELITE DIP child device!

Communicating with TWELITE ARIA

This section describes how to verify communication with the temperature and humidity sensor tag TWELITE ARIA.

TWELITE ARIA runs the ARIA App (App_ARIA) that is written at the factory.

Preparing TWELITE ARIA

Insert a CR2032 battery into the TWELITE ARIA.

By using a TWELITE STICK as the parent device for TWELITE ARIA, you can obtain temperature, humidity, and magnetic proximity data on your PC.

Connecting the TWELITE STICK

Connect the TWELITE STICK to the USB port of your PC.

If it is set to Parent mode of the Parent and Repeater App, it will light up magenta.

Device Settings

No configuration changes are needed. Communication will start immediately with the factory default settings.

If the Channel, which physically separates networks, is set to 18, and the Application ID, which logically separates networks, is set to 67720102, then communication with the factory-configured TWELITE ARIA is possible.

Logo Lighting

With TWELITE STICK connected to the PC, bring a magnet close to the Hall sensor on TWELITE ARIA.

If working properly, TWELITE ARIA will send a packet each time a magnet is brought near, and TWELITE STICK’s logo will flash in response.

The logo will flash not only for ARIA packets but for any packets with the same channel and application ID.

Simple Monitor

TWELITE STAGE APP includes a simple monitor feature to display data received from TWELITE ARIA.

From the main menu, select Viewer.

On the viewer selection screen, choose Simple Monitor (CUE/ARIA/Glancer).

Next, select Simple Monitor for TWELITE ARIA.

The Simple Monitor screen displays the latest data received by the TWELITE STICK from TWELITE ARIA.

When a magnet is brought close to TWELITE ARIA, a new packet is received.

Simple Monitor Items

Packet: Information of the latest packet
- #: Packet sequence number (includes all types)
- Type: Packet type ID (fixed as 02)
- ID: Logical Device ID
- AD: Serial ID (engraved on the can of the device)
- LQ: Link Quality Indicator (LQI, higher is better, range: 0–255)
- SQ: Packet sequence number based on TWELITE ARIA data
History
- Time: Timestamp when received (not included in packet)
- ID: Logical Device ID
- VCC(mV): Supply voltage of TWELITE ARIA
- Temp(C): Temperature
- Humidity(%): Relative humidity
- Magnet: Hall sensor result (None, [N], [S])

Sensor Graph

TWELITE STAGE APP includes a feature to graphically display temperature and humidity data received from child devices.

From the main menu, open Viewer.

On the viewer selection screen, select Graph View (Accelerometer Real-Time / Sensor).

Next, select Sensor Graph.

From the list of nodes on the right, select one that begins with ARA.

By default, data for the past 24 hours is displayed. To view the most recent data, click [Live >>].

The latest data will be displayed. Bring a magnet close to the sensor or warm the sensor near the 7P interface to observe the changes in values.

For more details on the Sensor Graph, refer to the TWELITE STAGE APP Manual.

Communication with TWELITE ARIA has been successfully verified!

TWELITE STICK Start Guide

Communicating with Child Devices Using Python (Basic)