Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -102,7 +102,7 @@
102	102	* Smart Cities
103	103	* Smart Factory
104	104
105		-= 2.  Getting Started with Hello World =
	105	+= 2.  Getting Started with 'Hello World' =
106	106
107	107	== 2.1  About this demo ==
108	108
...	...	@@ -113,7 +113,6 @@
113	113	* Implementing functionality to navigate the Web UI to a new page when the button is clicked.
114	114	* Uploading the UI to the LTS5 device.
115	115
116		-
117	117	By completing this demo, you will gain foundational knowledge for customizing the LTS5 interface and building more advanced IoT applications.
118	118
119	119
...	...	@@ -120,19 +120,20 @@
120	120	== 2.2  Install Software Running Environment ==
121	121
122	122
123		-The **ESP MCU** supports development using **ESP-IDF**, **Arduino**, or **MicroPython**. For this project, we use **ESP-IDF** for compilation and **Visual Studio Code (VS Code)** as the development environment.
	122	+The **ESP MCU** supports development with **ESP-IDF**, **Arduino**, or **MicroPython**. We use **ESP-IDF** for compilation and **Visual Studio Code (VS Code)** as the development environment for this project.
124	124
125	125
126		-=== 2.2.1 Install VSCode and ESP-IDF extension ===
	125	+=== 2.2.1 Install VS Code and ESP-IDF extension ===
127	127
128	128
129		-Firstly, download and install VSCode for your computer's operating system from the official website: [[Download Visual Studio Code - Mac, Linux, Windows>>url:https://code.visualstudio.com/download]].
	128	+First, download and install **VS Code** for your operating system from the Visual Studio Code website: [[Visual Studio Code - Mac, Linux, Windows>>https://code.visualstudio.com/download]].
130	130
131		-Next, you need to install the ESP-IDF extension within VSCode. The detailed operation steps are illustrated in image 1.
	130	+Next, install the **ESP-IDF** extension within **VS Code**. Detailed steps for this process are shown in Image 1.
132	132
	132	+
133	133	[[image:image-20240928110211-5.png||height="508" width="866"]]
134	134
135		- image 1 ESP-IDF extension install
	135	+ Image 1: ESP-IDF extension install
136	136
137	137	Links for reference: [[Install ESP32 ESP-IDF on Windows and Integrate with VS code (esp32tutorials.com)>>url:https://esp32tutorials.com/install-esp32-esp-idf-windows-integrate-vs-code/#:~~:text=In%20this%20tutorial,%20we%20will%20show%20you%20how%20to%20install]]
138	138
...	...	@@ -140,54 +140,90 @@
140	140	=== 2.2.2 Install SquareLine Studio ===
141	141
142	142
143		-The version we are utilizing for this software is 1.4.2. You can download it from the official link: [[SquareLine Studio - Download the current version of SquareLine Studio>>url:https://squareline.io/downloads#lastRelease]].
	143	+Download and install the latest version of [[SquareLine Studio>>https://squareline.io/downloads#lastRelease]] on your computer. It supports Windows, Linux, and Mac OS. The software version we are using here is 1.4.2.
144	144
145		-Please note that this software necessitates the registration of a license prior to usage, and various licenses come with distinct limitations. For instance, the free version imposes restrictions such as a limit of 1 component, 150 widgets, and 10 screens. However, for first-time downloads, you are granted unrestricted access for a period of 30 days without the need for immediate registration.
	145	+[[image:squareline.io_downloads.png]]
146	146
147	147
148		-== 2.3 Simple usage of SquareLine Studio and export UI code ==
	148	+After installation, you can use SquareLine Studio with a **PERSONAL license plan**. Click **LOG IN** and create a free account using your email address. Then activate your PERSONAL license plan for free. You don’t need to provide any credit card information. However, the PERSONAL license plan has the following limitations:
149	149
	150	+* Max. 10 screens
	151	+* Max. 150 widgets
	152	+* Max. 5 global colors
	153	+* Max. 2 themes
	154	+* Max. 1 component
150	150
151		-After launching and logging in to this software, create a project as shown in the following image 2. The version of LVGL is 8.3.11.
	156	+== 2.3 Simple usage of SquareLine Studio and exporting UI code ==
152	152
	158	+
	159	+After launching and logging into the software, create a new project as shown in Image 2.
	160	+
	161	+* Select the major **LVGL** version as **8.3**.
	162	+* Select the **Desktop** tab.
	163	+* Select  **Eclipse with  SDL for  development on PC**:
	164	+* In the **PROJECT SETTINGS**, select **LVGL version** **8.3.11**
	165	+* Select the **CREATE **button.
	166	+
153	153	[[image:image-20240928103357-2.png||height="680" width="708"]]
154	154
155		- image 2 create a SquareLine project
	169	+ Image 2: Creating a new SquareLine project
156	156
157		-Next, we need to make some settings for this project. By clicking in the specified order on image 3, we can see the page as shown in image 4.
158	158
	172	+Next, you need to configure some settings for this project. By clicking in the specified order shown in Image 3, you will be directed to the page displayed in Image 4.
	173	+
	174	+* Select** File  -> Project Settings**
	175	+
159	159	[[image:1727229582471-566.png]]
160	160
161		- image 3 project settings
	178	+ Image 3 accessing project settings
162	162
	180	+
	181	+In the PROJECT SETTINGS dialog box, configure/modify the project settings:
	182	+
	183	+* **UI Files Export Root**: Select a folder on your computer to store the UI files.
	184	+* **LVGL Include Path**: Set this to **lvgl.h**
	185	+* **Click on the APPLY CHANGES button.**
	186	+
163	163	[[image:image-20240928105309-4.png||height="526" width="556"]]
164	164
165		- image 4 modify project settings
	189	+ Image 4 Configure/modify project settings
166	166
167		-Now we can start to use this software. Here are some usage information for this software.
168	168
169		-**~1. add widget**
	192	+Now you can start building the sample UI. Follow the steps below:
170	170
171		-To add a widget, you should click a widget you want to add at the area entitled “Widgets”. In image , demonstrate a add process of label, button, and image 5.
172	172
	195	+=== Add widgets ===
	196	+
	197	+To add widgets navigate to the **Widgets** area, then click on the widgets you want to add. The selected widgets will be added to the screen. You can reposition the widgets in the screen area by clicking and dragging them.
	198	+
	199	+Add a Label, Button, and Image to the screen as shown in **Image 5**.
	200	+
173	173	[[image:image-20240928111412-6.png||height="526" width="864"]]
174	174
175		- image 5 add widgets
	203	+ Image 5: Add widgets
176	176
177		-**2. modify widget**
	205	+=== Modify widget properties ===
178	178
179		-The area for modifying widgets is called "Inspector". There are four parts in the "Inspector" tab. We use three of them more frequently, excluding "COMPONENT". The second part is aimed at adjusting the layout, size, position, alignment, flags, and states, etc. of widgets. The name of the second part indicates the type of widget it is representing, and in image 6, it is "BUTTON".
	207	+The area for modifying widgets is called the **Inspector** tab. The Inspector tab consists of four sections: **COMPONENT**, **<WIDGET>**, **STYLE SETTINGS**, and **EVENTS**, as shown in Image 6.
180	180
	209	+The second section allows you to adjust a widget's layout, size, position, alignment, flags, states, and more. When you select a widget on the screen, the name of this section changes to match the name of the selected widget.
	210	+
181	181	[[image:1727485118799-984.png]]
182	182
183		- image 6 the button widget's "Inspector" tab
	213	+ Image 6: The button widget's "Inspector" tab
184	184
185		-Second part: "Layout" means a auto position-management for widgets contained in the parent widget. "Transform" includes size, position and align modification.
186	186
	216	+==== Changing the Button properties ====
	217	+
	218	+Click the Button. Under the **Label** section, type "Click for details..." in the **Text** textbox.
	219	+
	220	+Under the "Layout" you can
	221	+
187	187	[[image:1727485251053-655.png]]
188	188
189	189	image 7 the button widget's "BUTTON" tab
190	190
	226	+
191	191	Third part: It is an area of style setting.
192	192
193	193	Fourth part: It is an area for adding events. In image 8, it is adding a click event to a button. If the button is clicked after the click event is added as shown in image 8, the current screen will fade into another specified screen, and the switching process will last 500ms.
...	...	@@ -196,16 +196,19 @@
196	196
197	197	image 8 add event for button
198	198
199		-**3. change label widget content**
200	200
201		-Modify the content in text as shown in image 9, the text content of label widget will be changed accordingly.
	236	+==== Changing the label properties ====
202	202
	238	+Click the label. Under the **Label** section, type "Hello World!" in the **Text** textbox.
	239	+
	240	+
203	203	[[image:image-20240928090825-1.png||height="327" width="391"]]
204	204
205		- image 9 modify text content of label widget
	243	+ Image 9:  Modify text of label widget
206	206
207		-**4. Add image into project**
208	208
	246	+==== 4. Changing image properties ====
	247	+
209	209	To use the image widget, you should first add an image to your project. The image format must be PNG, and its resolution should not exceed 800x480 pixels. There are two ways to add an image file. One way is to move your image into the folder "…/squareline project/assets/", as shown in image 10. The other way is to click the "ADD FILE INTO ASSETS" button, then select an image from your computer to import. After adding, you can see the image in the "assets" area in SquareLine Studio, as demonstrated in image 11.
210	210
211	211	[[image:image-20240928113424-9.png||height="355" width="505"]]
...	...	@@ -228,10 +228,11 @@
228	228
229	229	image 13 move label1 to make label1 widget be a child of button1 widget(2)
230	230
231		-**6. Preview the final effect**
232	232
233		-An advantage of this kind of software is that you can edit the UI with quick previews. In other words, it provides a way of combining graphical programming with simulation immediately.
	271	+**6. Preview the screen**
234	234
	273	+You can test the result by clicking on the **PLAY** button. The screen will change into play mode.
	274	+
235	235	[[image:1727487368023-281.png]]
236	236
237	237	image 14 click on the triangle icon to start or end the simulation