summaryrefslogtreecommitdiffstats
path: root/serial/serial-api.txt
blob: 96b5d684eabba1eb05cb242aec848c6654b32f81 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
Bluetooth serial service API description
****************************************

Copyright (C) 2006-2007  Marcel Holtmann <marcel@holtmann.org>


Manager hierarchy
=================

Interface	org.bluez.serial.Manager
Object path	/org/bluez/serial

Methods		string CreateProxy(string uuid, string address)

			Creates a serial port proxy object.

			Service identifier must be provided in the uuid 128
			format. Addresses can be either TTY char devices,
			unix socket address or a local TCP port. Abstract
			namespace can be informed replacing the null byte
			by 'x00'. eg: "/dev/ttyS0", "/tmp/gps-data",
			"x00/org/bluez/echo", "localhost:2947".

			Possible errors:org.bluez.Error.InvalidArguments
					org.bluez.Error.NotAvailable
					org.bluez.Error.Failed

		void RemoveProxy(string path) [experimental]

			Removes the serial port proxy object for given path.

			Possible errors:org.bluez.Error.DoesNotExist

		string CreatePort(string address, string pattern) [experimental]

			Creates a serial port object.

			Possible errors:org.bluez.Error.InvalidArguments
					org.bluez.Error.Canceled
					org.bluez.Error.InProgress
					org.bluez.Error.ConnectionAttemptFailed
					org.bluez.Error.NotSupported
					org.bluez.Error.Failed

		void RemovePort(string path) [experimental]

			Removes the serial port object for given path.

			Possible errors:org.bluez.Error.DoesNotExist

		array{string} ListPorts() [experimental]

			Returns an array of available serial port paths.

		array{string} ListProxies() [experimental]

			Returns an array of available serial port proxy paths.

		string ConnectService(string address, string pattern)

			Connects to a specific RFCOMM based service on a
			remote device and then creates a RFCOMM TTY
			device for it. The RFCOMM TTY device is returned.

			Possible errors:org.bluez.Error.InvalidArguments
					org.bluez.Error.Canceled
					org.bluez.Error.InProgress
					org.bluez.Error.ConnectionAttemptFailed
					org.bluez.Error.NotSupported
					org.bluez.Error.Failed

		string ConnectServiceFromAdapter(string adapter,
				string address, string pattern) [experimental]

			Use the given adapter to connect to a specific RFCOMM
			based service on a remote device and then creates a
			RFCOMM TTY device for it. The RFCOMM TTY device is
			returned.

			Possible errors:org.bluez.Error.InvalidArguments
					org.bluez.Error.Canceled
					org.bluez.Error.InProgress
					org.bluez.Error.ConnectionAttemptFailed
					org.bluez.Error.NotSupported
					org.bluez.Error.Failed

		void CancelConnectService(string address, string pattern)

			Cancel a previous ConnectService method call.

			Possible errors:org.bluez.serial.InvalidArguments

		void DisconnectService(string device)

			Disconnect a RFCOMM TTY device that has been
			created via the ConnectService method.

			Possible errors:org.bluez.Error.InvalidArguments
					org.bluez.Error.DoesNotExist

Signals		void PortCreated(string path) [experimental]

		void PortRemoved(string path) [experimental]

		void ProxyCreated(string path) [experimental]

		void ProxyRemoved(string path) [experimental]

		void ServiceConnected(string device)

		void ServiceDisconnected(string device)


Port hierarchy (experimental)
=============================

Interface	org.bluez.serial.Port
Object path	/org/bluez/serial/rfcomm*

Methods		string GetAdapter() [experimental]

			Returns the adapter address.

		string GetAddress() [experimental]

			Returns the Bluetooth address of the ending point.

		string GetDevice() [experimental]

			Returns the TTY device node name

		dict GetInfo() [experimental]

			Returns the port properties.

		string GetName()

			Returns the name of the remote device.

		string GetServiceName()

			Returns the name of the remote service.
			e.g.: "Dial-up networking Gateway"

Proxy hierarchy (experimental)
=============================
Interface	org.bluez.serial.Proxy
Object path	/org/bluez/serial/rfcomm*

Methods:	void Enable() [experimental]

			Register the serial proxy service record and start
			listenning on the specified adapter/channel.

			Possible errors:org.bluez.Error.Failed

		void Disable() [experimental]

			Unregister the service record and stop listenning.
			
			Possible errors:org.bluez.Error.Failed

		dict GetInfo() [experimental]
			Returns the proxy properties

		void SetSerialParameters(string rate, byte databits,
				byte stopbits, string parity) [experimental]

			Change the TTY settings. Available rates: "50", "300",
			"600", "1200", "1800", "2400", "4800", "9600", "19200",
			"38400", "57600" and "115200". Available data bits: 5,
			6, 7 and 8. Available stop bits: 1 and 2. Available
			parity: "even", "odd", "mark", "space" and "none".

			Possible errors:org.bluez.Error.InvalidArguments
					org.bluez.Error.Failed