8ms Visual Development Platform Operation Manual: All Rights Reserved by Wireless-Tag Technology Co., LTD
8ms Visual Development Platform Operation Manual: All Rights Reserved by Wireless-Tag Technology Co., LTD
Revision History
Wen
1 V1.0 C Create the document March 13, 2020
Zhougang
*Changes:C――create,A——add,M——modify,D——delete
Contents
1 Overview...................................................................................................................................................4
1.1 Purpose of writing........................................................................................................................ 4
1.2 Terms and Abbreviations............................................................................................................. 4
1.2.1 Terms................................................................................................................................ 4
1.2.2 Abbreviations................................................................................................................... 4
1.3 Reference Documents.................................................................................................................. 4
2 Software Overview.................................................................................................................................5
2.1 Software Use.................................................................................................................................5
2.2 Framework Introduction.............................................................................................................. 5
2.3 Software Operation...................................................................................................................... 6
3 Functional Descriptions.................................................................................................................... 7
3.1 New Project.................................................................................................................................. 7
3.2 Workspace Description.............................................................................................................. 10
3.3 Toolbar........................................................................................................................................13
3.3.1 File................................................................................................................................ 13
Save........................................................................................................................................ 13
Save and copy.........................................................................................................................13
New screen............................................................................................................................. 13
Delete selected screen............................................................................................................ 14
3.3.2 Edit................................................................................................................................ 14
Undo....................................................................................................................................... 14
Redo........................................................................................................................................14
3.3.3 Compile.......................................................................................................................... 14
Compile.................................................................................................................................. 14
Preview................................................................................................................................... 15
Refresh....................................................................................................................................16
Download source.................................................................................................................... 16
Download Bin.........................................................................................................................16
3.3.4 Layout............................................................................................................................ 16
Designer..................................................................................................................................16
Hybrid..................................................................................................................................... 16
Blockly....................................................................................................................................17
4 Widgets Usage.......................................................................................................................................18
4.1 Page Layout................................................................................................................................ 18
4.1.1 Tab View........................................................................................................................ 18
4.1.2 Tile View.......................................................................................................................18
4.2 Basic Display............................................................................................................................... 19
4.2.1 Text................................................................................................................................ 19
4.2.2 Image.............................................................................................................................. 20
4.2.3 Arch................................................................................................................................ 21
4.2.4 Text area...................................................................................................................... 21
1 Overview
The purpose of writing this software operation manual is to fully describe the functions and
operating environment that the software can achieve, so that users can understand the scope and
method of the software, and it provides necessary information for the maintenance and update of
the software.
1.2.1 Terms
None
1.2.2 Abbreviations
None
2 Software Overview
8ms visual development platform is a web-based visual design system for UI and applications of
embedded or MCU terminals, which can improve the versatility of peripheral application and UI.
You can implement editing interface and writing logic code by dragging a mouse or using a touch
screen. Low code or even zero code is used in the design and development of application and UI.
Currently, the platform supports ESP32, Sigmastar SSD201 and Unisound’s Hummingbird &
Hummingbird M. The GUI library uses littlevGL7.3 and the code logic uses Google's Blockly.
GUI editor
It provides visual editing functions and generates project description files, including pages
(traditional pages, Tab sub-pages, window pages), widgets (supporting 20 kinds of widgets
temporarily), and saves them in JSON format.
Widget events and pages in GUI support code logic. When editing code in GUI, you can enter
Blockly to add new code blocks or select existing code blocks. Code blocks can control all the
widgets in GUI, but can’t add or modify widget names. After editing, it’s saved to the background
and gets CodeID returned.
3 Functional Descriptions
Notes:
Visit this website and log in. If you haven’t got an account, please register an account first.
b) Enter your username (only consists of letters and numbers, at least 5 characters), password (it cannot be empty,
at least 6 characters), Email address used to retrieve your password, company name and mobile phone number .
2. Enter the registered "Username" and "Password", click "User Login" to login your account as
shown in Figure 3.
Figure 3 Project category
Notes:
At present, the platform supports the following hardware chips, including ESP32 of Espressif, Sigmastar, Unisound,
Allwinner and RK.
3. Click the selected item, such as "ESPRESSIF", and enter it as shown in Figure 4.
Figure 4 New project
If you need to edit a project, hover the mouse over "..." on the target project and click "Edit
Basic Information" on the pop-up menu.
If you need to delete a project, hover the mouse over "..." on the target project and click
"Remove Items" on the pop-up menu.
If you need to clone a project, hover the mouse over "..." on the target project and click
"Clone" on the pop-up menu.
The workspace of a project consists of seven areas, as shown in Figure 6. The detailed
descriptions of them are shown in Table 3.
Figure 6Workspace
Table 3 Workspace
No. Name Function Descriptions
File, Edit, Compile, Layout and File
Help. Save
Save and copy
Create screen
Delete selected screen
Edit
Undo
Redo
Compile
Compile
Preview
1 Toolbar Refresh
Download source
Download bin
Layout
Designer
Hybrid
Blockly
Help
User guide
Get started
Cases
About
Save, Undo, Redo, Format brush, Alignment includes:
Alignment, Compile, Run and Align left
Download source. Horizontal center
Shortcut
2 Align right
button
Align top
Vertical center
Align bottom
The main_screen is the default To create a new screen, please refer to
screen, and you can create a new "New Screen".
3 Screens
screen according to the project
requirements.
You can choose a light or dark
theme color as default. You can also
4 Theme
create a new theme according to the
project.
It contains: Hover over a widget icon with the mouse
Layout to display the name of the widget. Click a
5 Widget bar
Basic display widget and drag it to the widget editing
Dynamic display area to add it to the current screen. For
Notes:
Widgets differ in their respective properties. Take the "label" widget as an example to show the basic properties
Notes:
ID is the unique identifier of the widget, which is unique in the entire project. You can adjust the actual effect of
3.3 Toolbar
3.3.1 File
Save
You can save a project by clicking “File”--- “save” in the toolbar, or you can also save it by
clicking the shortcut button . If a project hasn’t been compiled after design, when you click
“Save”, the project will be compiled first.
New screen
You can create a screen by clicking “File” --- “Create screen” in the toolbar, or you can also
directly click “Create screen” in the “Screens” area. After clicking “Create screen”, you will enter
the name of the screen and click “Confirm”, as shown in Figure 8.
Figure 8 New screen
After creating a screen, you can set the screen type and background color in the screen properties
area on the right. The screen types are described as follows:
“Screen” is a standard screen page.
“Dialog” is a pop-up page. You can set the position and size of the pop-up window.
“Tabpage” is a tabview embedded page.
“Console” is a console program, i.e. no serial port is displayed.
To delete a screen, you can only delete the screen created by yourself, not a system screen. If you
need to delete a self-built screen, you can click “Delete selected screen” and then click “Confirm”,
as shown in Figure 9.
Figure 9 Delete selected screen
3.3.2 Edit
Undo
Redo
3.3.3 Compile
Compile
To compile a project, you can click “Compile” in the toolbar, and you can also click a shortcut
button to achieve it. The initial state of compiling a project is shown in Figure 10.
Figure 10 Initial state of compilation
The platform will compile the designed project in the cloud, generate the corresponding download
firmware, and display the compilation log in the browser. In the compilation log, you can check
the firmware programming address or the reason for a compilation error, as shown in Figure 11.
Figure 11 Compilation error
The platform will compile the designed project, generate the correct download firmware, and
display the compilation log.
Figure 12 Compilation completed status
Preview
Refresh
Download source
To download the source code, you can click “Compile” --- “Download Source” in the toolbar, or
you can click the shortcut button to achieve it. Click "Compile\Download Source", define the
source file name and select the save path.
Download Bin
To download bin, you can click “Compile”--- “Download Bin”, define the bin file name and select
the save path.
3.3.4Layout
Designer
A new project is in the Designer environment by default, and the Designer environment contains
seven areas. Please refer to “3.2Workspace Description”.
Hybrid
Hybrid is used to achieve synchronous design, on which Designer and Blockly share the same
working interface, as shown in Figure 13.
Figure 13 Hybrid
Blockly
Click to enter “Blockly” and edit widget logic, as shown in Figure 14.
Figure 14 Blockly operation interface
Notes:
Widgets are under the category of UI controls, and the widgets used can be found in widgets variables.
For the specific operation of Blockly, please refer to Blockly user manual.
4 Widgets Usage
Tab View is a widget used to switch screens by selecting tabs. Before creating a Tab view, you
need to create screens. There is a one-to-one correspondence between tabs and screens. To create a
Tab view, drag and drop the Tab view widget from the widget bar on the left to the editing area,
and then click the Tab drop-down to enter the tab name and screen ID.
Notes:
Drag and drop a Tile View widget from the widget bar on the left to the editing area to create a
Tile View, as shown in Figure 15.
Figure 15 Create a Tile View
4.2.1 Text
2. Set a text
Click the content drop-down in the widget properties area to set the content and appearance of the
text. Set the text according to the needs of the project, and the actual effect after setting is shown
in Figure 17.
Figure 17 Text effect
4.2.2 Image
Notes:
a.The image selected cannot be named in Chinese and the pixel is no larger than the current screen.
c.It is recommended to set the image size to be the same as the actual size, because the image size burned into the
Drag and drop an image widget from the widget bar on the left to the editing area, then click the
content drop-down on the right to add an image.
4.2.3 Arch
1. Create an arch
Drag and drop the arch widget from the widget bar to the editing area to create an arch as shown
in Figure 19.
Figure 19 Create an arch
2. Set an arch
Click the content drop-down of the widget properties area to set the start and end angles and the
style of the arch, as shown in Figure 20.
Figure 20 Set an arch
When we log in a platform, the area where we enter the username and password is a textarea.
1. Create a textarea
Drag and drop a textarea widget from the widget bar on the left to the editing area and create a
default textarea.
2. Set a textarea
Set a textarea by filling in the widget properties area with default value and placeholder, select the
password mode(masked or unmasked) and the line mode(multi or single). Click action and content
change action need to program code blocks.
4.3.1 Slider
A slider is similar to a progress bar with a knob. When you drag the knob, the value will change.
1. Create a slider
Drag and drop the slider widget from the widget bar on the left to the editing area, and create a
default slider, as shown in Figure 21.
Figure 21 Create a slider
2. Set a slider
Click the content drop-down in the widget properties area to set the default value and appearance
of the slider.
4.3.2 Checkbox
1. Create a checkbox
Drag and drop the check box widget from the widget bar on the left to the editing area to create a
check box, as shown in Figure 22.
Figure 22 Checkbox
2. Set a checkbox
Click the content drop-down in the widget properties area to set the checkbox text related
properties.
4.3.3 Switch
1. Create a switch
Drag and drop the switch widget from the widget bar on the left to the editing area to create a
switch, as shown in Figure 23.
Figure 23 Create a switch
2. Set a switch
Click the content drop-down in the widget properties area and set the default value and actual
style of a switch.
4.3.4 Bar
A bar is basically composed of background and indicator parts, used to show the progress of
things. For example, when we watch a video, there is always a progress bar below to show the
progress of the video.
1. Create a bar
Drag and drop the bar widget from the widget bar on the left to the editing area to create a bar, as
shown in Figure 24.
Figure 24 Create a bar
2. Set a bar
Click the content drop-down in the widget properties area and set the default value and actual
style of a bar.
4.3.5 Drop-down
1. Create a drop-down
Drag and drop the drop-down widget from the widget bar on the left to the editing area to create a
drop-down, as shown in Figure 25.
Figure 25 Create a drop-down
2. Set a drop-down
Click the content drop-down in the widget properties area to add options, as shown in Figure 26.
Figure 26 Set a drop-down
4.3.7 Preloader
1. Create a preloader
Drag and drop the preloader widget from the widget bar on the left to the editing area and create a
default preloader.
4.3.8 Roller
1. Create a roller
Drag and drop the roller widget from the widget bar on the left to the editing area and set the text
information of the roller in the widget properties area, as shown in Figure 29.
Figure 29 Create a roller
3. Selected style
Click the selected style in the widget properties area and set the actual effect when the roller is
selected, as shown in Figure 31.
Figure 31 Set selected style properties
4.4 HMI
4.4.1 Button
When a button is pressed or released, its state and style will change. Correspondingly, it can
trigger some event when a button changes its state. For example, if a button is pressed, the screen
will jump to another one.
1. Create a button
Drag and drop a button widget from the widget bar on the left to the editing area, and create a
default button, as shown in Figure 32.
Figure 32 Button
The added image is not named in Chinese, and the pixels are not larger than the current screen. If a button is set
Click the content drop-down in the widget properties area. You can modify the content of the
button and its actual style, and add an image to the button.
4.4.2 List
1. Create a list
Drag and drop the list widget from the widget bar on the left to the editing area. Click the content
drop-down in the widget properties area and add contents to create a list, as shown in Figure 33.
Figure 33 Create a list
2. Click event
The click event can be achieved by editing code blocks.
4.4.3 Line
1. Create a line
Notes:
You need to add two or more coordinates and the added coordinate points must be on the screen,
4.5.1 Calendar
1. Create a calendar
Drag and drop the calendar widget from the widget bar on the left to the editing area to create a
default calendar, as shown in Figure 35.
Figure 35 Create a calendar
4.5.2 Gauge
1. Create a gauge
Drag and drop the gauge widget from the widget bar on the left to the editing area and create a
default gauge, as shown in Figure 36.
Figure 36 Create a gauge
2. Set a gauge
Click the content drop-down in the widget properties area and set the style and values of the gauge,
as shown in Figure 37.
Figure 37 Set a gauge
4.5.3 LED
1. Create an LED
Drag and drop the LED control from the widget bar on the left to the editing area and create an
LED as shown in Figure 38.
Figure 38 Create an LED
2. Set an LED
Click the basic drop-down in the widget properties area to set the color and default value of the
LED, as shown in Figure 39.
Figure 39 Set an LED
5 Programming
This article mainly introduces the programming methods of ESP32 and Sigmastar SSD201
developed on the system.
3. Download the firmware, and flash the firmware according to the compiled address.
Figure 40 Download firmware
5. Open the firmware save path, and copy the firmware DEMO to "Tftp32" in the installation
directory of the programming tool, and replace the file in the target folder.
6. Open Xshell and create a new session, such as “test”. Define the name of the new session, select
“connection protocol”, select “host address”, such as “192.168.1.1” and port number "23".
7. Click OK, select the newly created session, and enter Xshell.
9. Enter the command "rm -f demo" to delete the previously existing demo on the development
board.
10. Enter the command "tftp -g -r demo server address (such as: 192.168.1.156)", to start
programming, as shown in Figure 50. When the status is displayed as 100% , the programming is
complete.
Figure 44 Programming completed
11. Enter the commands "chmod +x demo" and "./demo" to confirm whether the programming is