1 <?xml version="1.0" encoding="UTF-8"?>
3 <protocol name="wl_tdm">
5 <interface name="wl_tdm" version="1">
7 <description summary="the private protocol for TDM">
8 TDM uses the wayland protocol to communicate between tdm client and tdm server.
11 <event name="debug_message">
12 <arg name="message" type="string"/>
15 <event name="debug_done" />
17 <request name="debug">
18 <arg name="options" type="string" summary="debug options"/>
21 <request name="create_output">
22 <arg name="name" type="string" summary="output's name. 'primary' or 'default' can be used for default."/>
23 <arg name="id" type="new_id" interface="wl_tdm_output"/>
26 <request name="create_voutput">
27 <arg name="name" type="string" summary=""/>
28 <arg name="id" type="new_id" interface="wl_tdm_voutput"/>
33 <interface name="wl_tdm_output" version="1">
34 <description summary="TDM client output object">
35 When the DPMS of connection status of the output is changed, TDM server
36 will send wl_tdm_output.mode and wl_tdm_output.dpms event.
40 <arg name="width" type="uint"/>
41 <arg name="height" type="uint"/>
42 <arg name="refresh" type="uint"/>
43 <arg name="error" type="uint" summary="error status enumeration"/>
46 <event name="connection">
47 <arg name="value" type="uint"/>
48 <arg name="error" type="uint" summary="error status enumeration"/>
52 <arg name="value" type="uint"/>
53 <arg name="error" type="uint" summary="error status enumeration"/>
56 <request name="destroy" type="destructor"/>
58 <request name="create_vblank">
59 <arg name="id" type="new_id" interface="wl_tdm_vblank"/>
62 <request name="watch_output_changes">
63 <arg name="enable" type="uint"/>
66 <request name="get_connection"/>
68 <request name="get_mode"/>
70 <request name="get_dpms"/>
74 <interface name="wl_tdm_voutput" version="1">
75 <description summary="TDM client virtual output object">
78 <request name="destroy" type="destructor"/>
80 <event name="ack_message">
81 <arg name="msg" type="uint" enum="message" summary=""/>
84 <entry name="unknown" value="0" summary=""/>
85 <entry name="added" value="1" summary=""/>
86 <entry name="permission_denied" value="2" summary=""/>
90 <interface name="wl_tdm_vblank" version="1">
93 <arg name="stamp" type="uint"/>
97 <arg name="req_id" type="uint" summary="wait_vblank request ID"/>
98 <arg name="sequence" type="uint" summary="the sequence number of the vblank"/>
99 <arg name="tv_sec" type="uint" summary="sec of the vblank"/>
100 <arg name="tv_usec" type="uint" summary="usec of the vblank"/>
101 <arg name="error" type="uint" summary="error status enumeration"/>
104 <event name="ttrace">
105 <arg name="enable" type="uint"/>
108 <request name="destroy" type="destructor"/>
110 <request name="set_name">
111 <arg name="name" type="string"/>
114 <request name="set_fps">
115 <arg name="fps" type="uint"/>
118 <request name="set_offset">
119 <arg name="offset" type="int"/>
122 <request name="set_enable_fake">
123 <arg name="enable_fake" type="uint"/>
126 <request name="wait_vblank">
127 <description summary="Wait for a HW vblank">
128 When wl_tdm_vblank.wait_vblank is called, TDM server will send the
129 wl_tdm_vblank.done event after interval vblanks. If enable_fake == 1,
130 TDM server will send the done event always. Otherwise, TDM server will
131 send the done event with TDM error value.
134 <arg name="interval" type="uint"/>
135 <arg name="req_id" type="uint" summary="wait_vblank request ID"/>
136 <arg name="req_sec" type="uint" summary="sec of the request time in client side"/>
137 <arg name="req_usec" type="uint" summary="usec of the request time in client side"/>
140 <request name="wait_vblank_seq">
141 <arg name="sequence" type="uint" summary="the target sequence number"/>
142 <arg name="req_id" type="uint" summary="wait_vblank request ID"/>
143 <arg name="req_sec" type="uint" summary="sec of the request time in client side"/>
144 <arg name="req_usec" type="uint" summary="usec of the request time in client side"/>