Usr255: Created page with "== Memory area == * TOPWAY Smart LCD provide RAM area for variables VP_N16, VP_N32, VP_N64, VP_STR, … * Be aware that data in RAM dissipates when Smart LCD power is cut. * There are multiple storage areas within Smart LCD. * Table below explains those areas and ways to access them. {| class="wikitable" |+ !Int RAM |'''HW RAM area''' * VP_N16/32/64 * VP_STR * VP_G16 | | |- !Int Flash |'''HW Flash area''' * cmd 0x94 W/R * cmd 0x90 W * cmd 0x91 R |'''Partition0''' * Di..."

2025-10-20T05:04:44Z

Created page with "== Memory area == * TOPWAY Smart LCD provide RAM area for variables VP_N16, VP_N32, VP_N64, VP_STR, … * Be aware that data in RAM dissipates when Smart LCD power is cut. * There are multiple storage areas within Smart LCD. * Table below explains those areas and ways to access them. {| class="wikitable" |+ !Int RAM |'''HW RAM area''' * VP_N16/32/64 * VP_STR * VP_G16 | | |- !Int Flash |'''HW Flash area''' * cmd 0x94 W/R * cmd 0x90 W * cmd 0x91 R |'''Partition0''' * Di..."

New page

== Memory area ==

* TOPWAY Smart LCD provide RAM area for variables VP_N16, VP_N32, VP_N64, VP_STR, …
* Be aware that data in RAM dissipates when Smart LCD power is cut.
* There are multiple storage areas within Smart LCD.
* Table below explains those areas and ways to access them.

{| class="wikitable"
|+
!Int RAM
|'''HW RAM area'''
* VP_N16/32/64
* VP_STR
* VP_G16
|
|
|-
!Int Flash
|'''HW Flash area'''
* cmd 0x94 W/R
* cmd 0x90 W
* cmd 0x91 R
|'''Partition0'''
* Display Project
* cmd 0x95 R usr.bin
* Lua R/(W)
|style=vertical-align:top|'''Partition2'''
* Lua R/W
|-
!Ext U-Drv
|
|style=vertical-align:top|'''Partition1'''
* Lua R/W
|
|-
|
!Hardware
! colspan="2" |File System
|}

=== HW RAM area (on-board internal RAM) ===

* It is for VP variables (VP_N16, VP_N32, VP_N64, VP_STR, VP_G16,…)
* VP variables' default values are either 0s or “blank” at startup
* TRAM is volatile memory
* VP variables can be accessed by Project Elements, Lua Commands, Serial commands

=== HW Flash area (on-board internal flash) ===

* It can be directly accessed by serial command
* Serial command 0x94: provides backup or restore function
* Serial command 0x90: write a data to Hardware Flash area
* Serial command 0x91: read a from Hardware Flash area
* Lua access via “hmt.runcmd” that by execute the above commands

Partition 0 (on-board internal flash)

* Display Project files are stored in this partition
* Constant data is stored in usr.bin file at design-time. User can use serial command 0x95 to retrieve that.
* Lua io.open, io.read commands can be used to access the partition (named as “disk0”). For data safety, DON’T use Lua io.write command in Partition 0.

=== Partition1 (External U-Drv) ===

* External USB storage is defined as partition 1.
* This partition (named as “disk1”) can be accessed by Lua io.open, io.read commands
* In most of the case, it is for backing up the internal stored data (with Lua script)

=== Partition2 (on-board internal flash) ===
* This partition can be config in SGTools (project config)
* This partition (named as “disk2”) can be access by Lua io.open, io.read command[[File:Project Setting 2nd Partition Size.png|640x640px]]
'''Note'''

We can assign a default value at run-time, by using "Page Function". The function will run before the host page is loaded.

[[File:Page Function Call.png]]

= PAGEs, Image-Resources and VP-Variables Ranges =
{| class="wikitable"
!'''icon'''
!'''Mnemonic'''
!'''Name'''
!'''Linked VP.'''
!'''Linked IMG'''
!'''Editor Limit'''
!'''Memory Limit'''
!'''Address range'''
|-
|[[File:PAGE.png|64x64px]]
|PAGE
|Page
|<nowiki>--</nowiki>
|IMG_BKG
|≤1000/project
|256M byte (*4)
|PG0000 ~ PG0999
|-
|[[File:BKG IMG.png|64x64px]]
|IMG_BKG
|Background Image
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤10000/project

(*1)
|
|DP0000 ~ DP9999
|-
|[[File:ICO IMG.png|64x64px]]
|IMG_ICO
|Icon
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤10000/project

(*2)
|
|DI0000 ~ DI9999
|-
|[[File:ANI IMG.png|64x64px]]
|IMG_ANI
|Animation
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤1000/project

(*2)(*3)
|
|ANI000 ~ ANI999
|-
|[[File:VP STR.png|64x64px]]
|VP_STR
|String Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤1024 / project
|1024(MAX) x (127+1)byte
|0x000000 ~ 0x01FF80
|-
|[[File:VP N16.png|64x64px]]
|VP_N16
|16bit Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤32512 / project
|32512(MAX) x (2)byte
|0x080000 ~ 0x08FDFE
|-
|[[File:VP N32.png|64x64px]]
|VP_N32
|32bit Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤16128 / project
|16128(MAX) x (4)byte
|0x020000 ~ 0x02FBFC
|-
|[[File:VP N64.png|64x64px]]
|VP_N64
|64bit Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤7936 / project
|7936(MAX) x (8)byte
|0x030000 ~ 0x03F7F8
|-
|[[File:VP G16.png|64x64px]]
|VP_G16
|16bit Graph Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤16384 / project
|16384(MAX) x (8)byte

(dynamic array allocation)
|0x060000 ~ 0x07FFF8
|-
|[[File:VP BP1.png|64x64px]]
|VP_BP1
|Bitmap Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤2048 / project
|2048(MAX) x (64)byte

(dynamic array allocation)
|0x060000 ~ 0x05FFBF
|-
|[[File:VP REG.png|64x64px]]
|VP_REG
|Register Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|0xFFFF00 ~ 0xFFFFFF
|-
|[[File:VP TMR.png|64x64px]]
|VP_TMR
|Timer Variable
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤8 / project
|<nowiki>--</nowiki>
|0x02FFE0 ~ 0x02FFFC
|}
Note:

<nowiki>*</nowiki>1. IMG_BKG must >1/2 of Full-Screen (SGTools auto resize to fit screen)

<nowiki>*</nowiki>2. IMG_ICON and IMG_ANI Size Limit
{| class="wikitable"
!Project resolution
!Size Limit
|-
|320x240
|320x240 max. (Full-Screen)
|-
|480x272
|480x272 max. (Full-Screen)
|-
|640x480
|131072pixels (42% of Full Screen)
|-
|800x480
|131072pixels (34% of Full Screen)
|-
|800x600
|131072pixels (27% of Full Screen)
|-
|1366X480
|131072pixels (20% of Full Screen)
|}
<nowiki>*</nowiki>3. 1~128frame max.

<nowiki>*</nowiki>4. Memory Size may vary by model.

= Elements in PAGE Limitation =
{| class="wikitable"
|'''icon'''
|'''Mnemonic'''
|'''Name'''
|'''Linked VP.'''
|'''Linked IMG'''
|'''Editor Limit'''
|'''Memory Limit'''
|'''ID range'''
|-
|[[File:TPK.png|64x64px]]
|'''TPK'''
|Touch Key
|<nowiki>--</nowiki>
|1x IMG_ICO or

1x IMG_BKG (*1)
|≤256 / PAGE
|<nowiki>--</nowiki>
|0 ~ 255 (each page)
|-
|[[File:VPK.png|64x64px]]
|'''VPK'''
|Virtual Key
|VP_N16 (*2)

VP_N32 (*2)
|<nowiki>--</nowiki>
|≤64 / PAGE
|<nowiki>--</nowiki>
|0 ~ 63 (each page)
|-
|[[File:STS.png|64x64px]]
|'''STS'''
|Static String
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤128 / PAGE
|<nowiki>--</nowiki>
|0 ~ 127 (each page)
|-
|[[File:STR.png|64x64px]]
|'''STR'''
|String Element
|VP_STR
|<nowiki>--</nowiki>
|≤128 / PAGE
|<nowiki>--</nowiki>
|0 ~ 127 (each page)
|-
|[[File:Num.png|64x64px]]
|'''N16'''

'''N32'''

'''N64'''
|Number Element
|VP_N16

VP_N32

VP_V64
|<nowiki>--</nowiki>
|≤120 / PAGE
|<nowiki>--</nowiki>

--

--
|0 ~ 119 (each page)
|-
|[[File:TMR.png|64x64px]]
|'''TMR'''
|Timer Display
|VP_N32

(timer only)
|<nowiki>--</nowiki>
|≤8 / PAGE
|<nowiki>--</nowiki>
|0 ~ 7 (each page)
|-
|[[File:RTC.png|64x64px]]
|'''RTC'''
|Real Time Clock
|<nowiki>--</nowiki>
|<nowiki>--</nowiki>
|≤8 / PAGE
|<nowiki>--</nowiki>
|0 ~ 7 (each page)
|-
|[[File:ICO.png|64x64px]]
|'''ICO'''
|Static Icon
|<nowiki>--</nowiki>
|1x IMG_ICO
|≤128 / PAGE
|<nowiki>--</nowiki>
|0 ~ 127 (each page)
|-
|[[File:ANI.png|64x64px]]
|'''ANI'''
|Animation Element
|<nowiki>--</nowiki>
|1x IMG_ANI
|≤8 / PAGE
|<nowiki>--</nowiki>
|0 ~ 7 (each page)
|-
|[[File:IDX BIT.png|64x64px]]
|'''IDX_BIT'''
|Bit Icon
|VP_N16

VP_N32
|2(MAX) x IMG_ICON
|≤64 / PAGE
|<nowiki>--</nowiki>
|0 ~ 63 (each page)
|-
|[[File:IDX.png|64x64px]]
|'''IDX'''
|Indexed Icon
|VP_N16
|10000(MAX) x IMG_ICON
| rowspan="2" |≤64 / PAGE
|<nowiki>--</nowiki>
| rowspan="2" |0 ~ 63 (each page)
|-
|[[File:TCM.png|64x64px]]
|'''TCM'''
|Tachometer
|VP_N16
|181(MAX) x IMG_ICON
|<nowiki>--</nowiki>
|-
|[[File:IDX DEC.png|64x64px]]
|'''I16'''

'''I32'''
|Decimal Icon
|VP_N16

VP_N32
|12x IMG_ICON

(0~9,”.”,”-“)
|≤32 / PAGE
|<nowiki>--</nowiki>
|0 ~ 31 (each page)
|-
|[[File:B16.png|64x64px]]
|'''B16'''
|Progress Bar
|VP_N16
|1x IMG_ICON
|≤32 / PAGE
|<nowiki>--</nowiki>
|0 ~ 31 (each page)
|-
|[[File:G16.png|64x64px]]
|'''G16'''
|Graph Element
|VP_G16
|<nowiki>--</nowiki>
|≤8 / PAGE
|<nowiki>--</nowiki>
|0 ~ 7 (each page)
|-
|[[File:BP1.png|64x64px]]
|'''BP1'''
|Bitmap Element
|VP_BP1
|<nowiki>--</nowiki>
|≤32 / PAGE
|<nowiki>--</nowiki>
|0 ~ 31 (each page)
|-
|[[File:QRC.png|64x64px]]
|'''QRC'''
|QR Code Element
|VP_STR

VP_N16 (in seq.)
|<nowiki>--</nowiki>
|≤4 / PAGE
|<nowiki>--</nowiki>
|0 ~ 3 (each page)
|-
|[[File:DPD.png|64x64px]]
|'''DPD'''
|Draw Pad
|VP_N16 (in seq.)
|<nowiki>--</nowiki>
|≤4 / PAGE
|<nowiki>--</nowiki>
|0 ~ 3 (each page)
|}
Note:

<nowiki>*</nowiki>1. IMG_ICO for key-down display, IMG_BKG will be cropped to key size for key-down display

<nowiki>*</nowiki>2. Monitoring values

<nowiki>*</nowiki>3. Element display Size: 8x8 (MIN), except Bitmap Element

<nowiki>*</nowiki>4. The above limitation is to ensure the display performance, though it can be override by the “config.ini” in the SGTools installation folder. (Remember to backup the file before edit!)

= System Registers =
{| class="wikitable"
|'''Address'''
|'''System Register'''
|'''Descriptions'''
|'''Note'''
|-
|0xFFFF00

<nowiki>:</nowiki>

0xFFFF07
|Timer_Ctrl0

<nowiki>:</nowiki>

Timer_Ctrl7
|D[0]=0 : stop the timer

D[0]=1 : start the timer

D[1]=0 : count down, time down to 0x00000000

D[1]=1 : count up, time up to 0x7fffffff

D[7:2]=000000 : reserved
|(*1)
|-
|0xFFFF10
|RTC_Year
|Value=0~99
| rowspan="7" |0xffff10~0xffff16

should be written at the same time
|-
|0xFFFF11
|RTC_Month
|Value=1~12
|-
|0xFFFF12
|RTC_Day
|Value=1~31
|-
|0xFFFF13
|RTC_Hour
|Value=0~23
|-
|0xFFFF14
|RTC_Minute
|Value=0~59
|-
|0xFFFF15
|RTC_Second
|Value=0~59
|-
|0xFFFF16
|RTC_Set
|Value=1 : sync the time
|-
|0xFFFF20
|Buzzer
|Value=0~63; buzzer beeping duration (*1)
| rowspan="2" |See Project Setting for details
|-
|0xFFFF21
|Backlight
|Value=0~63; Real time backlight brightness setting (*1)
|-
|0xFFFF22
|ScreenSaverBacklight
|Value=0~63; Screen Saver Backlight Brightness (*1)
| rowspan="7" |see Screen Saver section for details
|-
|0xFFFF23
|ScreenSaverPage_H
| rowspan="2" |Value=0~999; Screen Saver display Page (*2)
|-
|0xFFFF24
|ScreenSaverPage_L
|-
|0xFFFF25
|ScreenSaver Timer1_H
| rowspan="2" |Value=0~65535; Screen saver delay time 1 (*2)
|-
|0xFFFF26
|ScreenSaver Timer1_L
|-
|0xFFFF27
|ScreenSaver Timer2_H
| rowspan="2" |Value=0~65535; Screen saver delay time 2 (*2)
|-
|0xFFFF28
|ScreenSaver Timer2_L
|-
|0xFFFF30
|Font_CodePage
|Font Code Page index value (*1) (*3)
|
|-
|0xFFFF31
|Font_Country
|Font Country index value (*1) (*4)
|
|}
Note:

<nowiki>*</nowiki>1. Value can be update by command System_register_write (0xb3) to access the register

<nowiki>*</nowiki>2. Value should be written at the same time by command Sucesstive_write (0x82)

<nowiki>*</nowiki>3. Code Page index value
{|
|'''index'''
|'''Code Page'''
|..........
|'''index'''
|'''Code Page'''
|-
|1
|437(OEM United States)
|
|12
|1252(ANSI Latin I)
|-
|2
|737(OEM Greek437G)
|
|13
|1253(ANSI Greek)
|-
|3
|852(OEM Latin II)
|
|14
|1254(ANSI Turkish)
|-
|4
|860(OEM Portuguese)
|
|15
|1255(ANSI Hebrew)
|-
|5
|863(OEM Canadian French)
|
|16
|1256(ANSI Arabic)
|-
|6
|865(OEM Nordic)
|
|17
|1257(ANSI Baltic)
|-
|7
|866(OEM Russian)
|
|18
|1258(ANSI/OEM Viet Nam)
|-
|8
|874(ANSI/OEM Thai)
|
|19
|GB2312 (Simplified Chinese)
|-
|9
|932(ANSI/OEM Japanese Shift JIS)
|
|20
|GBK (Simplified Chinese)
|-
|10
|1250(ANSI Central Europe)
|
|21
|ECU-KR ( Korea )
|-
|11
|1251(ANSI Cyrillic)
|
|22
|BIG5 (Traditional Chinese)
|-
|0
|uni-code (with font config <3> TTF)
|
|
|
|}
<nowiki>*</nowiki>4. Country index value
{|
|'''index'''
|'''Code Page'''
|..........
|'''index'''
|'''Code Page'''
|-
|1
|USA
|
|7
|DenmarkⅡ
|-
|2
|France
|
|8
|Sweden
|-
|3
|Germany
|
|9
|Italy
|-
|4
|UK
|
|10
|Spain
|-
|5
|DenmarkⅠ
|
|11
|Japan
|-
|6
|DenmarkⅡ
|
|
|
|}

Memory & Ranges - Revision history