arrow-left

全てのページ
gitbookGitBook提供
1 / 5

Loading...

Loading...

Loading...

Loading...

Loading...

Other specifications etc.

Others

About environment variables

Command line args and ini file

Command line arguments and ini file.

hashtag
command line arguments

Command line arguments provides some minor settings of TWELITE Stage.

Arg
Desc.

hashtag
an ini file.

The ini file is used to set some fundamental settings of TWELITE STAGE (like reference MWSDK folder).

The ini file name is {basename of TWELITE STAGE app executable} + .ini, which is normally TWELITE_Stage.ini.

hashtag
Syntax

  • The ini file is described as a plain text file.

  • A key and value is stored in a single line separated with = character (e.g. KEY=value).

hashtag
Settings

Key
Value.

hashtag
different settings of TWELITE STAGE App.

If you need to different setting type of TWELITE STAGE App, just copy an executable at same folder of the original TWELITE_Stage executable.

e.g. if you needs English interface vesion, you just copy TWELITE_Stage.exe(Note: .exe is suffix of Windows executable) to TWELITE_Stage_en.exe and create .ini file with LANG=en setting.

About folder structure

About Folder Structure

The TWELITE STAGE APP runs as a front-end application in the TWELITE STAGE SDK package. Here is its folder structure.

hashtag
MWSDK folder

The MWSDK folder contains libraries for building software for the TWELITE wireless microcontroller, samples, and source code for the TWELITE APPS.

hashtag
TWELITE_Stage.sav

Records configuration information within the TWELITE Stage application.

The file name is the TWELITE_Stage app file name + .sav.

hashtag
TWELITE_Stage.ini

see for details.

  • MWSDK= Edit to specify a different folder instead of the MWSDK/ folder. This is useful if you want to mix multiple library versions. The above example uses the MWSDK2020_10 folder.

  • LANG= Specify LANG=en to set the display language of TWELITE Stage to English.

hashtag
Run TWELITE Stage with different settings

Copy TWELITE_Stage.exe (on Windows) with a different file name. For example, if you change it to TWS1.exe, it refers to the configuration files TRS1.sav and TRS1.ini.

hashtag
BIN folder

When you select the TWELITE STAGE APP's menu, the firmware files (.BIN) for the TWELITE radio microcontroller in this folder are enumerated.

hashtag
log folder

Log files are stored in this folder when the serial port is performed in the TWELITE STAGE APP.

This folder is also used to store databases when using the graphing function and to output csv files.

hashtag
Tools folder

This folder contains toolchains for gcc, g++, and other cross-compilers.

Platform specific utilities are also stored in this folder. See Tools/reame-j.txt for details.

hashtag
About the build project folder

circle-exclamation

This function is introduced as an extra function. It may work differently from what is described.

hashtag
Search order of folders

Search for build project folders (e.g., Act_samples) in the following order

  1. the folder where the TWELITE STAGE app was launched

  2. the folder where the TWELITE STAGE app executable is located

  3. {MWSDK folder}/...

circle-info

MWSDK searches starting from the folder where the TWELITE STAGE APP executable is located.

hashtag
Wks_Acts

If the Wks_Acts folder exists, this folder is referenced from the menu item Act Build & Rewrite instead of the Act_samples folder.

circle-info

This folder is intended to be used to store build projects that you create yourself in Wks_Acts.

... /MWSTAGE/           TWELITE STAGE SDK Installation.
    /TWELITE_Stage.???? Executable (Windows .exe, macOS .command, Linux .run)
    /TWELITE_Stage.sav  Configuration file
    /TWELITE_Stage.ini  Other settings
    /TWELITE_Stage/     TWELITE STAGE APP related files

    /MWSDK/             MWSDK libraries, etc.
    /BIN/               Destination for [BIN file selection
    /log/               Logs and databases

    /Tools/             gcc compiler and other tools
MWSDK/
  Act_samples/ : sample code by mwx library 
  Wks_TweApps/ : source code for TWELITE APPS 
  Act_extras/  : more specialized samples by mwx library, citing other libraries
  TWENET/      : TWENET library (mwx library and others) 
  ChipLib/     : semiconductor library  
  MkFiles/     : body processing part of Makefile     
  docs/        : Library manuals, etc.   
  000manifest  : Version information of MWSDK

{MWSDK folder}/..

this
BINから選択
logging function
A key value string shall begin with line head. (No spaces or other character allowed before a key string.)
  • No space allowed between the = character.

  • Comment line is started from ; or # characacter.

  • -E 0

    Disable graphical effect like fading out

    -R {type}

    Set rendering type by {type} value: 0: default 1: OpenGL 2: DirectX(Windows) Metal(macOS) 3: Software.

    -J

    Enable game controller.

    -x {x_pos}, -y {y_pos}

    Set position of TWELITE STAGE App graphical winodow at launch. The {x_pos} and {y_pos} is the screen coordinate of window top-left.

    MWSDK

    Change MWSDK folder to another one. The default folder is MWSDK at the same folder where TWELITE STAGE App executable is located. If you need to use older or custom MWSDK, you can specify the name of its folder.

    LANG

    LANG=en will change the user interface language from default(Japanese) to English.

    GEOM_X, GEOM_Y

    Change the location of TWELITE STAGE App window is shown

    ;;; change MWSDK reference.
    ; MWSDK=MWSDK
    MWSDK=MWSDK2020_10
    
    ;;; Interface language
    LANG=en
    
    ;;; Window geometry
    ;GEOM_X=200
    ;GEOM_Y=100
      TWELITE_Stage.exe 
      TWELITE_Stage.ini     | no special settings
    
      TWELITE_Stage_en.exe  | copy of TWELITE_Stage.exe
      TWELITE_Stage_en.ini  | LANG=en is set

    000desc.txt

    000desc.txt

    If 000desc.txt is created in the project folder, TWELITE STAGE APP will display its contents in the list of project folders.

    Example of display with 000desc.txt

    The file is written in UTF-8. There are two types of formats.

    hashtag
    Format 1

    • The first line is the title line.

    • The second and subsequent lines are descriptions of the details.

    • If the last line starts with http, it is a link to a website.

    hashtag
    Format 2

    The format is like an ini file. The item name starting at the beginning of the line and up to the = character is the item definition, and the rest is the content of the item.

    Item Definition
    Details

    hashtag
    About URL specification

    Turn on LED when switch is pressed
    act4 runs an act that turns on an LED when a switch connected to the TWELITE DIP is pressed.
    https://mono-wireless.com/jp/products/act/index.html

    [JAPANESE], [ENGLISH]

    block delimiter

    title line

    description of details.

    DESC=

    description of details. Can be multiple lines including line breaks.

    URL=

    Link to a website or file

    URL=

    Details

    starting with https:, http:

    open that address

    other than that

    relative folder starting with {MWSDK_ROOT}/docs/. If you specify a/b/c.html, it will be converted to {MWSDK_ROOT}/docs/a/b/c.html.

    [JAPANESE]
    TITLE=Actのテンプレート
    DESC=中身が何もない setup(), loop() のみのファイルです。
    新しく 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