Weston: Difference between revisions
m typo |
m →Troubleshooting: Specify lang for syntaxhighlight blocks |
||
(9 intermediate revisions by 7 users not shown) | |||
Line 8: | Line 8: | ||
Weston is the reference implementation of a [https://wayland.freedesktop.org/ Wayland] compositor. | Weston is the reference implementation of a [https://wayland.freedesktop.org/ Wayland] compositor. | ||
=== Installation === | === Installation === | ||
Line 16: | Line 15: | ||
This will package weston libraries as well as demos for your device, see <code>weston*</code> commands. | This will package weston libraries as well as demos for your device, see <code>weston*</code> commands. | ||
Weston | Weston will be launched automatically on boot by TinyDM. | ||
=== [https://en.wikipedia.org/wiki/Remote_Desktop_Protocol RDP] (Remote Desktop Protocol) === | |||
Prerequisite: | Prerequisite: | ||
Line 29: | Line 25: | ||
Create a Self-Signed SSL Certificate: | Create a Self-Signed SSL Certificate: | ||
* <code>sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout mypublic.key -out mycrt.crt</code> | * <code>sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout mypublic.key -out mycrt.crt</code> | ||
Start weston with RDP backend: | Start weston with RDP backend: | ||
Line 37: | Line 32: | ||
* <code>xfreerdp /v:172.16.42.1 /sec:tls</code> | * <code>xfreerdp /v:172.16.42.1 /sec:tls</code> | ||
== Guide == | |||
Follow the [https://wiki.postmarketos.org/wiki/Display Display] guide to change and fix display related issues. | |||
== Troubleshooting == | |||
Weston is very commonly used for testing new ports and as a demo ([[:Category:Interface]]). Unfortunately, upstream changes can make maintenance difficult. The common backend fbdev has been deprecated and disabled by default in [https://lists.freedesktop.org/archives/wayland-devel/2022-February/042103.html weston 10.0.0]. | |||
Choosing weston as the interface (<code>pmbootstrap init</code>) on an unmaintained or irregularly maintained device that uses the fbdev backend will likely result in blank screen after the "pmbootstrap loading" splash screen. Log in via ssh and check the file <code>/etc/xdg/weston/weston.ini</code> for an entry such as <code>backend=fbdev-backend.so</code>. Compare this to the value in <code>weston.ini.default</code>, likely <code>backend=drm-backend.so</code>. | |||
The tinydm.log in case of fbdev may have entries such as: | |||
<syntaxhighlight lang="text"> | |||
Session: /usr/share/wayland-sessions/weston.desktop | |||
Desktop: weston | |||
Exec: dbus-run-session start_weston.sh | |||
... | |||
failed to connect to Wayland display: No such file or directory | |||
failed to create display: No such file or directory | |||
</syntaxhighlight> | |||
The <code>logread</code> command may show entries such as: | |||
<syntaxhighlight lang="text"> | |||
Using config file '/etc/xdg/weston/weston.ini' | |||
... | |||
Loading module '/usr/lib/libweston-10/fbdev-backend.so' | |||
Failed to load module: Error loading shared library /usr/lib/libweston-10/fbdev-backend.so: No such file or directory | |||
fatal: failed to create compositor backend | |||
</syntaxhighlight> |
Latest revision as of 20:00, 13 April 2024
![]() | |
Name | Weston |
---|---|
In postmarketOS | |
Package | postmarketos-ui-weston |
Status | Available |
Weston is the reference implementation of a Wayland compositor.
Installation
pmbootstrap init
User interface: weston
This will package weston libraries as well as demos for your device, see weston*
commands.
Weston will be launched automatically on boot by TinyDM.
RDP (Remote Desktop Protocol)
Prerequisite:
apk add weston-backend-rdp
apk add openssl
Create a Self-Signed SSL Certificate:
sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout mypublic.key -out mycrt.crt
Start weston with RDP backend:
weston --backend=rdp-backend.so --rdp-tls-cert=/path/to/mycrt.crt --rdp-tls-key=/path/to/mypublic.key --socket=wayland-1 --width=540 --height=600
On host:
xfreerdp /v:172.16.42.1 /sec:tls
Guide
Follow the Display guide to change and fix display related issues.
Troubleshooting
Weston is very commonly used for testing new ports and as a demo (Category:Interface). Unfortunately, upstream changes can make maintenance difficult. The common backend fbdev has been deprecated and disabled by default in weston 10.0.0.
Choosing weston as the interface (pmbootstrap init
) on an unmaintained or irregularly maintained device that uses the fbdev backend will likely result in blank screen after the "pmbootstrap loading" splash screen. Log in via ssh and check the file /etc/xdg/weston/weston.ini
for an entry such as backend=fbdev-backend.so
. Compare this to the value in weston.ini.default
, likely backend=drm-backend.so
.
The tinydm.log in case of fbdev may have entries such as:
Session: /usr/share/wayland-sessions/weston.desktop
Desktop: weston
Exec: dbus-run-session start_weston.sh
...
failed to connect to Wayland display: No such file or directory
failed to create display: No such file or directory
The logread
command may show entries such as:
Using config file '/etc/xdg/weston/weston.ini'
...
Loading module '/usr/lib/libweston-10/fbdev-backend.so'
Failed to load module: Error loading shared library /usr/lib/libweston-10/fbdev-backend.so: No such file or directory
fatal: failed to create compositor backend