Professional,Creditable,Successful DWIN Beauty Screen Development Guide
DWIN Beauty Screen
Development Guide
DWIN Technology 1 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
Contents
1. Product Overview ........................................................................................................................... 3
1.1 Application Introduction ............................................................................................................................. 3
1.2 Product Features ....................................................................................................................................... 3
2. Product Selection ........................................................................................................................... 4
3. System Variable Interface .............................................................................................................. 5
3.1 Basic Function Interface for Beauty screen .............................................................................................. 5
3.2 Application Interface for Video Playback .................................................................................................. 9
3.3 Other Application Programming Interfaces .............................................................................................10
4. Serial Port Protocol ...................................................................................................................... 12
4.1 Communication Data Frame ................................................................................................................... 12
4.2 Interface Instruction Description ..............................................................................................................12
4.3 Commands Instance ............................................................................................................................... 13
5. Common Questions ...................................................................................................................... 14
6. Revision Records ..........................................................................................................................18
DWIN Technology 2 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
1. Product Overview
1.1 Application Introduction
The DGUS beauty screen mainly comprises of T5L ASIC and specialized beauty care module. T5L ASIC, as
the main control chip running on standard DGUS software,it enables display of HD image captured by the
camera.
Hardware interface diagram
1.2 Product Features
(1) The beauty screen is equipped with a “DWIN Magic Mirror” high-definition (5MP, 1080P) camera as the
acquisition source. Leveraging state-of-the-art AI skin detection technology, the captured images are
analyzed to provide a multi-dimensional assessment of skin quality. This includes the detection of wrinkles,
blackheads, eye bags, dark circles, and hyperpigmentation.
(2) Skin magnification analysis: The USB camera enables up to 500x magnification, providing high-resolution
images for detailed skin analysis. The system can capture 3-6 images for time-lapse comparison, with all
images fully zoomable.
(3) Cloud synchronization view: Synchronize the screen data to the cloud via WeChat mini apps for an easier
viewing of all pictures and analysis results. Please ensure a stable internet connection.
(4) Video Playback: Support video playback directly from USB drive and SD card.
DWIN Technology 3 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
2. Product Selection
2.1 Beauty Screen Selection Table
Operating Operating
LCD Touch Video Skin
Model Size Resolution Color voltage Temperature
Type Type Playback Analysis
(V) (℃)
DT321X190020 Capacitive
7.0 800*480 TN 24 bit,16.7M 6~15 -20~70 × √
Z240103C touch
DT321X190020 Capacitive
8.0 800*600 TN 24 bit,16.7M 6~15 -20~70 × √
Z240103D touch
DT321X190020 Capacitive
10.1 1024*600 IPS 24 bit,16.7M 6~15 -20~70 × √
Z240103E touch
DT321X190020 Capacitive
15.6 1920*1080 IPS 24 bit,16.7M 12~36 -10~60 × √
Z240103H touch
DT321X190020 Capacitive
10.4 1024*768 TN 24 bit,16.7M 7~36 -20~70 √ ×
Z240103K touch
DT321X190020 Capacitive
10.1 1024*600 IPS 24 bit,16.7M 6~15 -20~70 √ ×
Z240103L touch
DT321X190020 Capacitive
15.6 1920*1080 IPS 24 bit,16.7M 12~36 -10~60 √ ×
Z240103M touch
* K/L/M/N models come with the screen only, without camera, Wi-Fi or other accessories.
DWIN Technology 4 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
3. System Variable Interface
A portion of the variable address space is already allocated to the beauty screen function. As a result, these
addresses are unavailable for use in DGUS development. The beauty screen is primarily controlled through
variable address 0x0600.
0x0000-0x0FFF: System variable addresses, reserved for the DGUS system.
0x1000-0x2FFF: Dedicated to the basic display logic of the beauty screen. Specifically, 0x1100-0x17FF stores
the analysis results from the magic mirror, 0x1800-0x18FF displays flag bits, and 0x2800-
0x2FFF displays QR code data. The remaining addresses are reserved for future use.
0x7000-0xFFFF: Allocated for image storage expansion, generally not activated.
Should you need to modify the address listed above, it will require an update to the underlying code. Please
reach out to your dedicated sales engineers for assistance.
3.1 Basic Function Interface for Beauty screen
Key value Functional classification Description
Take a photo.Then it will switch to transition page 19. Once
0x5A01 Magic Mirror Analysis
the data returns, it will switch to page 21.
Upload the photo. Upon photo upload, the system will verify
the user's authentication status (determining if it's a personal
or business account) and switch to transitory page 22. If not
0x5A02 Magic Mirror Analysis authenticated, it will switch to page 23 and display a payment
QR code. If authenticated, it will switch to page 24, upload the
photo, and then switch to the "Magic Mirror Result" page 27
once the processing is complete.
Return from”Take a photo”, and the camera will automatically
0x5A03 Magic Mirror Analysis
restart.
When switching from “Magnifying Glass” mode to “Magic
Mirror Analysis” mode, the magnifying glass camera will be
0x5A04 Magic Mirror Analysis turned off and the magic mirror analysis camera will be
activated. The system will then switch to transition page 18.
Once the analysis results are ready, it will switch to page 20.
Return from the zoom in function of the magic mirror analysis
0x5A05 Magic Mirror Analysis
result page.
0x5A06 Magic Mirror Analysis Return from the QR code payment page.
0x5A07 Magic Mirror Analysis Return from the request transitory page.
Enter the zoom in function of the magic mirror analysis result
0x5A08 Magic Mirror Analysis
page. Go to page 28 if there’s a picture.
Return from the switching page and go back to the previous
0x5A09 Magic Mirror Analysis
mode.
Choose one magic mirror analysis result and activate
0x5A10-0x5A20 Magic Mirror Analysis
playback if there’s an image.
DWIN Technology 5 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
Key value Functional classification Description
a) For factory project with “Magic Mirror Analysis”
Activate the “Magnifying Glass” mode. Ensure the magic mirror
analysis result camera is off before turning on the magnifying
glass camera. This will switch to page 18. Once the result is
0xA501 Magnifying Glass
returned, the page will switch to 50.
b) For factory project with “Video Payback “
Activate “Magnifying Glass” mode directly, and the page will
automatically switch to 50 after completion.
Take a screenshot. Capture the area indicated by the cursor. If
0xA502 Magnifying Glass
there is already an image, it will be replaced.
0xA503 Magnifying Glass Delete screenshot. Delete the picture indicated by the cursor.
0xA504 Magnifying Glass Cursor moves to the left
0xA505 Magnifying Glass Cursor moves to the right
a) For factory project with “Magic Mirror Analysis”
Go to the magnifying glass details page, then switch to page 51.
0xA506 Magnifying Glass
b) For factory project with “Video Playback”
No more available.
Return from the magnifying glass details page and switch to
0xA507 Magnifying Glass
page 50.
Upload the screenshot to the cloud platform. The system will
0xA508 Magnifying Glass then switch to page 53. Once the upload is complete, it will
return to page 50.
Switch from the magnifying glass page to the picture details
0xA509 Magnifying Glass
page. It will switch to page 51, and turn on the camera.
a) Factory project with “Magic Mirror Analysis”
Unavailable
0xA50A Magnifying Glass
b) For Factory project with “Video Playback”
Turn off the camera and return to the menu page.
0xA510-0xA516 Magnifying Glass Select a picture to zoom in.
Zoom in on the picture shot by “Magic Mirror Analysis”.
0x5001: Move left
0x5002: Move right
0x5003: Move up
0x50** Magic Mirror Analysis
0x5004: Move down
0x5005: Zoom in
0x5006: Zoom out
0x5007: Reset
DWIN Technology 6 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
Key value Functional classification Description
Zoom in on the returned picture outputted by “Magic Mirror
Analysis”.
0x5001: Move left
0x5002: Move right
0x51** Magic Mirror Analysis 0x5003: Move up
0x5004: Move down
0x5005: Zoom in
0x5006: Zoom out
0x5007: Reset
Zoom in on the picture shot by “Magnifying Glass”.
0x5001: Move left
0x5002: Move right
0x5003: Move up
0x52** Magnifying Glass
0x5004: Move down
0x5005: Zoom in
0x5006: Zoom out
0x5007: Reset
0xAA07 WIFI Settings Connect to WIFI.
0xAA08 WIFI Settings Connection canceled.
Scan WIFI and it will switch to transitory page 17. Once the
0xAA09 WIFI Settings
results are returned, it will switch to page 25.
Scan the Wi-Fi swipe-up page and it will switch to transitory
0xAA12 WIFI Settings
page 17. Once the results are returned, it will switch to page 25.
Scan the Wi-Fi swipe-down page and it will switch to transitory
0xAA13 WIFI Settings
page 17. Once the results are returned, it will switch to page 25.
Five results will appear after each scan. Use “Page up” and
0xAF01-0xAF05 WIFI Settings
“Page down” for selection.
DWIN Technology 7 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
Note:
(1) For models that don't come with Magic Mirror analysis from the factory, all addresses related to Magic Mirror
analysis has been annotated. Please avoid using it.
(2) The transition page has been fixed during the design process. If you plan to develop your own project, please
avoid using the transition page shown in the table. For further customization, please contact support team.
(3) Upon powering on, the factory project with magic mirror analysis will switch to the magnifying glass main page,
while the factory project with video playback will switch to page 10.
(4) The following are fixed number of special pages.
a) Factory projects with magic mirror analysis:
Magic mirror analysis main page: 20
Magic mirror analysis confirmation page: 21
WIFI scan page : 25
WIFI connection page : 26
Magic mirror analysis result page: 27
Store page: 29
Magnifying glass main page: 50
Magnifying glass detail page: 51
Magnifying glass thumbnail enlargement page: 52
b) Factory project with video playback:
WIFI scan page: 25
WIFI connection Page: 26
Magic mirror analysis result page: 27
Store page: 29
Magnifying glass page: 50
Magnifying glass detail page: 51
Magnifying glass thumbnail enlargement page: 52
Video playback page: 61
Video full-screen playback page: 62
DWIN Technology 8 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
3.2 Application Interface for Video Playback
Video playback function is achieved through variable address 0x0600 (refer to table below). The program
scans the "VIDEO" directory for video files and the "MUSIC" directory for audio files. It is imperative that
video/audio files are saved in correct named directory, otherwise audio and video files may not play properly.
Key value Functional classification Description
Scroll down the video playlist. It needs to be queried before
0x0001 Video Playback
flipping pages.
Scroll up the video playlist. It needs to be queried before
0x0002 Video Playback
flipping pages.
0x002b Video Playback Query videos from internal flash storage
0x002a Video Playback Query videos from U-disk driver
0x0020 Video Playback Query videos from SD card
0x000d Video Playback Pause
0x0013 Video Playback Resume playback
0x0004 Video Playback Pause
0x0021-0x0025 Video Playback Select the 1st to 5th video for playback
DWIN Technology 9 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
3.3 Other Application Programming Interfaces
For the functions of other system variable interfaces for beauty screens,please refer to the following table.
VP address Definition Remark
Storage location of Wi-Fi Each occupies 16 words, with a 0x10 address interval each
0x1900-0x19f0
scan results time.
0x0000: 1920*1080
0x0001: 1024*600
0x0002: 800*600
0x0003: 800*480
0x0580 Resolution setting
0x0004: 1024*768
This setting is for the screen resolution. Specific display
settings are configured for different resolutions. Other values
are invalid and factory-set, please do not modify them.
Range: 7-12
This setting is for the frequency division factor. It is
Frequency division factor
0x0581 recommended to use divide-by-7 for 2K resolution and divide-
setting
by-12 for other resolutions. It’s preset at factory mode and
please don’t modify it arbitrarily.
Range: 50-85.
0x0582 Image quality setting Higher photo quality requires more storage space.
Suggested value: 80.
0x0583 Quantity of screenshots 3-6.
0x0000: Default
0x0001: yuyv
0x0002: NV21
0x0004: mjpeg
0x0584 Camera format
Configure based on supported resolutions and formats. By
clicking "Debug Camera", you can view the supported formats
and resolutions. Based on the results, select a suitable
camera format.
0x0000: 1920*1080
0x0001: 1024*600
0x0002: 800*600
0x0003: 800*480
0x0004: 640*480
0x0585 Camera resolution
0x0005: 320*240
0x0006: 1280*720
By clicking "Debug Camera" to view the supported formats
and resolutions. Select a suitable camera resolution based on
the results.
DWIN Technology 10 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
VP address Definition Remark
Display height of the
0x0586 “Magnifying Glass” main
interface
Display width of the
0x0587 “Magnifying Glass” main
This setting is used to set the camera display position on
interface
page 50. Please note that the display position for page 51 has
X coordinate of the vertex
been predetermined and is not adjustable.
0x0588 in “Magnifying Glass” main
interface
Y coordinate of the vertex
0x0589 in “Magnifying Glass” main
interface
DWIN Technology 11 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
4. Serial Port Protocol
The beauty screen product offers two serial ports (UART2 and UART4) for external connectivity. UART2 is
preconfigured to use the DWIN 82/83 protocol and allows the Baud Rate and CRC check to be configured via
the CFG file. UART4 allows users to analyze and customize protocols based on specific requirements.
UART2 is preset with the default configuration of 115200, 8N1, indicating the Baud Rate of 115200, 8 data bits,
no check bit, and 1 stop bit.
4.1 Communication Data Frame
Data block 1 2 3 4 5
CRC verification
Definition Frame header Data length Command Data
(optional)
Data length 2 1 1 N 2
Including
Description 0x5AA5 commands, data, 0x82/0x83
and verification
Example
0x5AA5 04 83 00 10 04
(without verification)
Example
0x5AA5 06 83 00 10 04 25 A3
(with verification)
4.2 Interface Instruction Description
Command Data Description Response
Variable space first address Write data to a specified
0x82 None
(0x0000-0xFFFF)+written data address in the variable space
Variable space first address Read the specified length Starting address of variable
0x83 (0x0000-0xFFFF)+read data in data from the specified space+Variable data in word
word length (0x01-0x7D) address in the variable space length+Read variable data
DWIN Technology 12 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
4.3 Commands Instance
(1). Scan WIFI
82 command: 5A A5 05 82 06 00 AA09
Command meaning: Frame Header Command length 82 (Write variable space) System variable address
Command content
Description: This command is used to scan WIFI, the demo will switch page automatically after execution.
(2). Read the first result of the scanned WIFI
83 command: 5A A5 04 83 19 00 10
Command meaning: Frame header Command length 83 (Read variable space) System variable address Read
data length (in words)
Returned command: 5A A5 0* 83 19 00 DATA
Command meaning: Frame header Command length 83 (Read variable space) System variable address The
returned SSID result of WIFI
Description: This command can read the first scanned SSID information of WIFI .
DWIN Technology 13 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
5. Common Questions
1. How to connect to the WIFI network?
Method 1: Use Notepad to open the "wpa_supplicant. conf" file on the USB disk, fill in your written WIFI name
(SSID) and password in the following format, save the file, and make sure to place it in the root directory of the
USB disk. After the screen is powered on, the file parameters will be automatically read and WIFI configuration
will be performed.
ctrl_interface=/etc/wifi/sockets
disable_scan_offload=1
update_config=1
network={
ssid="WIFI name"
psk="WIFI password"
}
Method 2: Manually search and connect to WIFI through the advertising screen interface, enter the WIFI
password, and then connect to the network.
2. Why does the screen get stuck in an animation after clicking?
Upon powering on the screen, the system will boot up and automatically open the default camera after a "beep"
sound. You can proceed with the operation once it’s complete.
3. Why can’t the camera be activated?
Please check if the camera is connected properly. If the issue persists after reconnecting the camera, try
restarting the device.
4. Why can't the picture of face analysis move around?
You can't move the original size picture. You must zoom in first before you can move it. The more you zoom in,
the more you can move it.
5. Why is it stuck on the camera switch animation?
Check if the other camera is properly connected.
6. Why does the face photo keep failing to upload?
(1) Please make sure to face the camera directly and center your face on the screen, ensuring that both ears
are visible.
(2) Please check your network connection and try reconnecting.
DWIN Technology 14 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
7. Why does facial analysis have no result for a long time?
The facial analysis process typically requires 15-20 seconds to complete.
8. Why can't I find WIFI in the search?
Ensure that the WIFI antenna is securely connected to the specified antenna port on the dedicated beauty
device module. Avoid connecting it to the chip port on the motherboard. Please refer to the image below.
9. Why can't I find the WIFI I want to connect to?
Click on any displayed WIFI and delete it, manually enter the name of the WIFI you want to connect to, or
refresh it again.
It supports scanning up to 15 WIFI networks with the strongest signals
10. How to use the WeChat Mini App?
After connecting to the internet, A QR code will automatically display in the home page. Scan the code to enter
the Magic Mirror Mini Program, and you could view your usage history.
11. How to set up camera control?
Use the icon overlay control. Please refer to the image below for variable addresses and parameter settings.
Do not modify them without authorization.
DWIN Technology 15 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
12. How to update the firmware of the beauty module?
Step 1: Format the SD card used as a flashcard. The parameter settings are shown in the following image.
Step 2: Open the flashing tool "PhoenixCardv4.2.8". Select the firmware storage path, “Product”, and ”Burn” in
sequence. Please wait patiently for the flashing process to complete.
Step 3: Remove the SD card, insert it into the module's firmware flashing slot, power on and wait 3-5 minutes
for the flashing process to finish.
DWIN Technology 16 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
13. What should be noted when storing audio and video files?
When saving audio and video files to the USB drive or SD card, they should be stored in the root directory
folder. As shown in the image, video files need to be saved in the "VIDEO" folder, and audio files need to be
saved in the "MUSIC" folder.
DWIN Technology 17 www.dwin-global.com
Professional,Creditable,Successful DWIN Beauty Screen Development Guide
6. Revision Records
Version Revise Date Content Editor
1.0 2024-09-25 First Edition Joyce Jiang
Please contact us if you have any questions about the use of this document or our products,or if you would like to
know the latest information about our products:
Customer service Tel: +86 400 018 9008
Customer service email: dwinhmi@dwin.com.cn
DWIN Developer Forum: https://forums.dwin-global.com/
Thank you all for continuous support of DWIN,and your approval is the driving force of our progress!
DWIN Technology 18 www.dwin-global.com
