MWings

Mono Wireless TWELITE Wings API for 32-bit Arduinos

日本語版はこちら

Contents

• About
• Installation
• Requirements
• Features
• Getting Started
• API reference
• License

About

MWings is a library that communicate with TWELITE wireless modules.

This library is suitable for TWELITE SPOT series.

You can receive packets from TWELITE child devices and send commands to TWELITE child devices through the connected TWELITE parent device.

Installation

Open the Library Manager from the Arduino IDE, then search for MWings and install it.

See details for Installing MWings Library.

Requirements

Built for ESP32 modules (e.g. TWELITE SPOT) and Arduino UNO R4 series.

8-bit Arduino boards (like UNO R3) are NOT supported.

It is strongly recommended to use App_Wings (>= v1.3.0) for the TWELITE parent device connected with the board.

Features

Receive and Parse Packets from

• App_Twelite
  • Get digital and analog input states.
  • Pre-installed on TWELITE (SMD) and TWELITE DIP series.
  • Example:
    • monitor_spot_app_twelite.ino
• App_ARIA (TWELITE ARIA mode)
  • Get air temperature, relative humidity and magnet state.
  • Pre-installed on TWELITE ARIA series.
  • Examples:
    • monitor_spot_app_aria.ino
    • plotter_spot_app_aria.ino
• App_CUE (TWELITE CUE mode)
  • Get acceleration and magnet state.
  • Pre-installed on TWELITE CUE series.
  • Example:
    • monitor_spot_app_cue.ino
• App_PAL (AMBIENT)
  • Get air temperature, relative humidity and illuminance.
  • Pre-installed on TWELITE PAL series (App_PAL).
  • Examples:
    • monitor_spot_app_pal_amb.ino
    • plotter_spot_app_pal_amb.ino
• App_PAL (MOTION) / App_CUE (MOTION PAL mode)
  • Get acceleration.
  • Pre-installed on TWELITE PAL series (App_PAL) and TWELITE CUE series (App_CUE).
  • Examples:
    • monitor_spot_app_pal_mot.ino
    • plotter_spot_app_pal_mot.ino
• App_PAL (OPENCLOSE) / App_CUE (OPENCLOSE PAL mode) / App_ARIA (OPENCLOSE PAL mode)
  • Get magnet state.
  • Pre-installed on TWELITE PAL series (App_PAL), TWELITE ARIA series (App_ARIA) and TWELITE CUE series (App_CUE).
  • Example:
    • monitor_spot_app_pal_openclose.ino
• App_Uart (Mode A, Simplified or Extended ASCII format)
  • Get serial data received on TWELITE child devices.
  • Pre-installed on TWELITE UART series.
  • Example:
    • monitor_spot_app_uart_ascii.ino
• App_IO
  • Get digital input states.
  • Example:
    • monitor_spot_app_io.ino

Receive Packets from

• Any TWELITE
  • Get binary payload with ASCII-formatted serial input (starts with : and ends with CRLF).
  • Example:
    • monitor_spot_any.ino
• Act
  • Get binary data from acts
  • Example:
    • monitor_spot_act.ino

Serialize and Send Commands to

• App_Twelite
  • Set digital output states and PWM duty ratios.
  • Pre-installed on TWELITE (SMD) and TWELITE DIP series.
  • Example:
    • commander_spot_app_twelite.ino
• App_IO
  • Set digital output states.
  • Example:
    • commander_spot_app_io.ino
• App_Uart (Mode A, Simplified ASCII format)
  • Set serial data to send on TWELITE child devices.
  • Pre-installed on TWELITE UART series.
  • Example:
    • commander_spot_app_uart_ascii.ino
• App_PAL (NOTICE)
  • Set full-color LED states.
  • Pre-installed on TWELITE PAL series (App_PAL).
  • Examples:
    • commander_spot_app_pal_notice.ino
    • commander_spot_app_pal_notice_detailed.ino
    • commander_spot_app_pal_notice_event.ino

Send Commands to

• Any TWELITE
  • Set some binary data with ASCII-formatted serial output (starts with : and ends with CRLF).
  • Examples:
    • commander_spot_app_twelite_manually.ino
    • commander_spot_app_twelite_fully_manually.ino

Getting Started

• See Receive data from the TWELITE child device.

API reference

• List of data types and procedures
• Class mwings::MWings

License

Copyright (C) 2023 Mono Wireless Inc. All Rights Reserved.
Released under MW-OSSLA-1J,1E (MONO WIRELESS OPEN SOURCE SOFTWARE LICENSE AGREEMENT).