2. Basic Information
- 2.1 ID
- 2.2 Version
- 2.3 Name
- 2.4 Device icon
- 2.5 Support platform
- 2.6 Device details
- 2.7 Code edit mode
- 2.8 mBlock version support
2.1 ID
ID is the unique identification of a device. Developers use ID to distinguish different devices. ID is also used as the identification of programs for different devices.
Naming conventions:
- Lower-case English characters or numbers
- Use "_" to connect multiple words, such as
arduino_uno
2.2 Version
Version refers to the identification number of project files. Developers use Version for version management.
Naming conventions:
- Supports three-digit version number "X.X.X" ("X" must be a number)
2.3 Name
The name of a device, which will be displayed to users.
Naming conventions:
- Less than 6 characters (recommended)
2.4 Device icon
The icon of the device, which will be displayed on the Device Library page.
Image formats:
- Background: transparent
- File type: png
- Size: 300 × 300
- Use clear front-view image of the device
2.5 Support platform
Select the mBlock 5 platform supported by the device. There are three options: mBlock PC, mBlock Web, and mBlock APP.
2.6 Device details
Set connection methods of the device.
2.6.1 Connection methods
| Connect method | Introduction | Examples |
|---|---|---|
| Serial | Connect device via USB serial port Note: Makeblock Bluetooth adapter works as serial port connection. |
  |
| Bluetooth | Connect device via built-in bluetooth of the PC, up to Bluetooth 4.0 currently |  |
| HID | A type of serial connection. Support direct connection. |  |
When all three methods are selected, HID will be prioritized, and the other two will not be displayed.
2.6.2 Allow connection via Live Mode
Set connection methods under Live Mode.
When a connection method is not selected in the "Connect methods options", and the method is selected in the "Allow connection via Live Mode", the specific connection method will not not enabled under Live Mode.
2.6.3 Allow connection via Upload Mode
Set connection methods under Upload Mode.
When a connection method is not selected in the "Connect methods options", and the method is selected in the "Allow connection via Upload Mode", the specific connection method will not not enabled under Upload Mode.
2.6.4 Live Mode as default
When a device is connected to mBlock 5, the default mode will be Live Mode, if the box is checked.
2.7 Code edit mode
Check this box to allow code editing in code mode. The supported programming languages can be set in "Transcode settings".
2.8 mBlock version support
Select the supported mBlock version.
