Fonts

Built-in Fonts~

The ESP8266 firmware only has 1 built-in font: Unscii with font size 8pt.

The ESP32 firmware builds additionally contain the Roboto Condensed font in four font sizes depending on the display resolution:

320x240: 12, 16, 24 and 32pt
480x320: 16, 24, 32 and 48pt

Including selected glyphs of Latin-1 character set and MaterialDesign icons below.

The built-in fonts can be set by using the pointsize as parameter. For example:

p4b1.text_font=24
p4b2.value_font=12

Note

It is possible to create custom builds with built-in fonts of other sizes (choose any four of 12, 14, 16, 20, 22, 24, 26, 28, 32, 36, 38, 40, 44, 48) and supporting Latin-2 or Cyrillic character sets (even combined) by customizing user_config_override.h.

Built-in Icons~

The icons in the list below are included with the built-in font sizes. Included are a range of arrows, navigation, climate, controls, devices, energy, lights, places, presence, security, sound, time and wireless icons.

Code	Name	Code	Name
`E045`	arrow-down	`F2A3`	battery-high
`E6C0`	arrow-down-box	`F2A1`	battery-low
`E04D`	arrow-left	`F2A2`	battery-medium
`E054`	arrow-right	`E08E`	battery-outline
`E05D`	arrow-up	`E5F1`	ev-station
`E6C3`	arrow-up-box	`E32A`	leaf
`E140`	chevron-down	`F40B`	lightning-bolt
`E141`	chevron-left	`E425`	power
`E142`	chevron-right	`E6A5`	power-plug
`E143`	chevron-up	`E769`	ceiling-light
`E60C`	subdirectory-arrow-left	`F020`	coach-lamp
`E01B`	air-conditioner	`E95F`	desk-lamp
`E957`	cloud-search-outline	`E8DD`	floor-lamp
`E238`	fire	`E6B5`	lamp
`E438`	radiator	`E335`	lightbulb
`EAD7`	radiator-disabled	`E6E8`	lightbulb-on
`E717`	snowflake	`F054`	outdoor-lamp
`E50F`	thermometer	`F2BA`	string-lights
`E58C`	water	`F1E1`	vanity-light
`E58E`	water-percent	`E91C`	wall-sconce
`E590`	weather-cloudy	`E12C`	check
`E591`	weather-fog	`E156`	close
`E592`	weather-hail	`E493`	cog
`E593`	weather-lightning	`E1D9`	dots-vertical
`E67E`	weather-lightning-rainy	`E2DC`	home
`E594`	weather-night	`E6A1`	home-outline
`E595`	weather-partly-cloudy	`E374`	minus
`E596`	weather-pouring	`E415`	plus
`E597`	weather-rainy	`E2E3`	bed
`E598`	weather-snowy	`E10B`	car
`E67F`	weather-snowy-rainy	`E176`	coffee
`E599`	weather-sunny	`E606`	pool
`E59D`	weather-windy	`E9A0`	shower
`E59E`	weather-windy-variant	`EA70`	silverware-fork-knife
`E5A8`	white-balance-sunny	`E4B9`	sofa
`E0ED`	calendar	`E9AB`	toilet
`E150`	clock-outline	`E004`	account
`E2DA`	history	`E64A`	human-greeting
`E51B`	timer-outline	`E70E`	run
`E0AF`	bluetooth	`E026`	alert
`E5A9`	wifi	`E7AE`	cctv
`E0AC`	blinds	`E81B`	door-closed
`F011`	blinds-open	`F0AF`	door-closed-lock
`F2D4`	garage-open-variant	`E81C`	door-open
`F2D3`	garage-variant	`E30B`	key-variant
`F11C`	window-shutter	`E33E`	lock
`F11D`	window-shutter-alert	`EFC6`	lock-open-variant
`F11E`	window-shutter-open	`E565`	shield-check
`E09A`	bell	`E68A`	shield-home
`E11C`	cellphone	`E99D`	shield-lock
`EAAC`	dishwasher	`F1DB`	window-closed-variant
`E1FA`	engine	`EF5F`	monitor-speaker
`E210`	fan	`E75A`	music
`E96B`	fountain	`E3E4`	pause
`E28F`	fridge-outline	`E40A`	play
`E5FA`	kettle	`E456`	repeat
`E322`	laptop	`E457`	repeat-off
`EC99`	microwave	`E458`	repeat-once
`F39D`	recycle-variant	`E49D`	shuffle
`F1F3`	robot-mower-outline	`E49E`	shuffle-disabled
`E70D`	robot-vacuum	`E4AD`	skip-next
`E4DE`	stove	`E4AE`	skip-previous
`E502`	television	`E4C3`	speaker
`EA7A`	trash-can-outline	`E4DB`	stop
`E917`	tumble-dryer	`E57E`	volume-high
`E72A`	washing-machine	`E580`	volume-medium
`E58F`	water-pump	`E75F`	volume-mute

To use an icon in a text you need to prefix the UTF-8 character code with \u. To ensure proper decoding the payload should be used with a json or jsonl command.

jsonl example:

{"page":2,"id":1,"obj":"label","x":10,"y":50,"w":150,"h":50,"text":"\uE64A Hello world!","text_font":24}

json example:

["p2b1.text=\uE64A Hello world!"]

Character Sets~

The characters are encoded in UTF-8. All character sets include the Ascii 0x20-0x7E characters, the non-braking-space (NBSP) and 10 universal symbols. Each set contains roughly the same extended characters from its equivalent iso-8859 standard. All character sets also contain about 130 standard Material Design Icons for home automation use.

The default font in pre-compiled binaries is Roboto-Condensed-Regular with the Latin 1 character set. There is no support for right-to-left scipts.

For example: To display the ÷ character on the plate you need to use \u00F7 in json or jsonl commands, or send the encoded UTF-8 bytes 0xC3 0xB7 in other commands.

Ascii~

Includes all ASCII 0x20-0x7E characters extended with these 11 universal symbols:

NBSP £ ° ± ² ³ µ × ÷ € •

Latin 1~

The default character set for the pre-compiled firmware binary files.
Includes all characters and symbols from the Ascii range above.

Covers Northern, Western and Southern European languages: English (en), French (fr), Spanish (es), Portuguese (pt), Italian (it), Dutch (nl), German (de), Danish (da), Swedish (sv), Norwegian (no), Finnish (fi), Albanian (sq), Turkish (tr)

¡ ¿ À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ø ù ú û ü ý þ ÿ Ğ ğ İ ı Œ œ Ş ş Š š Ž ž ẞ

Latin 2~

Needs compiling with customization. Includes all characters and symbols from the Ascii range above.

Covers Central and Eastern European languages: Czech (cs), Hungarian (hu), Polish (pl), Romanian (ro), Croatian (hr), Slovak (sk), Slovenian (sl), Sorbian (sb)

Á Â Ä É Í Î Ó Ô Ö Ú Ü Ý á â ä é í î ó ô ö ú ü ý Ă ă Ą ą Ć ć Č č Ď ď Đ đ Ĕ ĕ Ę ę Ě ě Ĺ ĺ Ľ ľ Ł ł Ń ń Ň ň Ő ő Ŕ ŕ Ř ř Ś ś Ş ş Š š Ţ ţ Ť ť Ů ů Ű ű Ź ź Ż ż Ž ž Ǎ ǎ Ȁ ȁ Ȃ ȃ Ȅ ȅ Ȇ ȇ Ȉ ȉ Ȋ ȋ Ȍ ȍ Ȏ ȏ Ȑ ȑ Ȓ ȓ Ȕ ȕ Ȗ ȗ Ș ș Ț ț

Cyrillic~

Needs compiling with customization. Includes all characters and symbols from the Ascii range above.

Covers the Slavic languages that use a Cyrillic alphabet, including Belarusian, Bulgarian, Macedonian, Russian, Serbian, and Ukrainian

Ѐ Ё Ђ Ѓ Є Ѕ І Ї Ј Љ Њ Ћ Ќ Ѝ Ў Џ А Б В Г Д Е Ж З И Й К Л М Н О П Р С Т У Ф Х Ц Ч Ш Щ Ъ Ы Ь Э Ю Я а б в г д е ж з и й к л м н о п р с т у ф х ц ч ш щ ъ ы ь э ю я ѐ ё ђ ѓ є ѕ і ї ј љ њ ћ ќ ѝ ў џ

Greek~

Needs compiling with customization. Includes all characters and symbols from the Ascii range above.

Covers the Greek (el) language:

Ά Έ Ή Ί Ό Ύ Ώ ΐ Α Β Γ Δ Ε Ζ Η Θ Ι Κ Λ Μ Ν Ξ Ο Π Ρ Σ Τ Υ Φ Χ Ψ Ω ά έ ή ί ΰ α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ ς σ τ υ φ χ ψ ω ϊ ϋ ό ύ ώ

External Fonts~

You can also add a custom .zi font by uploading it to the internal flash. Apply it as the default font on the Configuration > HASP Settings page. To use it, set the pointsize parameter of the property to 0.

Last update: 2023-12-09