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
|
Usage
=====
Once you've installed the ``lirc`` python package, there will be a number
of things you can now import from it to get started.
.. code-block:: python
from lirc import (
Lirc,
LircResponse,
LircError,
LircSocketError,
LircSocketTimeoutError,
InvalidReplyPacketFormatError
)
The most relevant of these is ``Lirc``, since this is the main class
you will be using. ``LircResponse`` is the response object that is returned
when you send a command. All the others are just errors.
Initializing Lirc
-----------------
The ``Lirc`` class takes in three separate options: ``address``, ``socket``,
and ``timeout``. These all have default values that depend on the operating
system you are on. So the simplest way to construct ``Lirc`` is with no
arguments at all.
.. code-block:: python
from lirc import Lirc
lirc = Lirc()
Overriding LIRC Defaults on Initialization
------------------------------------------
However, if we the defaults don't work for us? Let's say we're on Windows
and we want to connect over TCP to a remote LIRC server on another Windows
machine. So we've passed in an ``address`` to override the default so it doesn't
look for the daemon on the localhost. ``socket`` and ``timeout`` are passed in
just to show that we can, these are already the defaults on Windows.
.. code-block:: python
import socket
from lirc import Lirc
lirc = Lirc(
address=("10.16.30.2", 8765),
socket=socket.socket(socket.AF_INET, socket.SOCK_STREAM),
timeout=5
)
LIRC Initialization Defaults per Operating System
-----------------------------------------------
From the options we may pass into ``Lirc``, ``address`` and ``socket`` will
change depending on the operating system you are using. The ``timeout`` always
defaults to 5 (seconds).
On Linux, this will attempt to connect to the lircd socket at
``/var/run/lirc/lircd`` and create a socket using ``AF_UNIX`` and
``SOCK_STREAM``.
On macOS, it will be almost identical to Linux except that all the paths
on macOS will be prefixed by ``/opt/local/`` so the connection to the lircd
socket will instead be at ``/opt/local/var/run/lirc/lircd``. The socket that
is created will be the same.
However if we are on Windows, we can't use unix domain sockets. So instead,
WinLIRC uses TCP to communicate with the lirc daemon. So instead of a string
for the address, it defaults to a tuple of ("localhost", 8765), the default on
WinLIRC. The first part contains the address whereas the second is the port.
Furthermore, the socket that is created uses ``AF_INET`` and ``SOCK_STREAM``
instead now.
|