aboutsummaryrefslogtreecommitdiff
path: root/src/bluetooth.vala
blob: 100bdf2a8a52495b8518efaa1982d55fa202d9c9 (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
/*
 * Copyright 2013 Canonical Ltd.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; version 3.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * Authors:
 *   Charles Kerr <charles.kerr@canonical.com>
 */


/**
 * Abstract interface for the Bluetooth backend.
 */
public interface Bluetooth: Object
{
  /* True if there are any bluetooth adapters on this system.
     This work as a proxy for "does this hardware support bluetooth?" */
  public abstract bool supported { get; protected set; }

  /* True if there are any bluetooth adapters powered up on the system.
     In short, whether or not this system's bluetooth is "on". */
  public abstract bool powered { get; protected set; }

  /* True if our system can be seen by other bluetooth devices */
  public abstract bool discoverable { get; protected set; }
  public abstract void try_set_discoverable (bool discoverable);

  /* True if bluetooth's blocked. This can be soft-blocked by software and
   * hard-blocked physically, eg by a laptop's network killswitch */
  public abstract bool blocked { get; protected set; }

  /* Try to block/unblock bluetooth. This can fail if it's overridden
     by the system, eg by a laptop's network killswitch */
  public abstract void try_set_blocked (bool b);

  /* Get a list of the Device structs that we know about */
  public abstract List<unowned Device> get_devices ();

  /* Emitted when one or more of the devices is added, removed, or changed */
  public signal void devices_changed ();

  /* Try to connect/disconnect a particular device.
     The device_key argument comes from the Device struct */
  public abstract void set_device_connected (uint device_key, bool connected);
}



/**
 * Base class for Bluetooth objects that use a killswitch to implement
 * the 'discoverable' property.
 */
public abstract class KillswitchBluetooth: Object, Bluetooth
{
  private KillSwitch killswitch;

  public KillswitchBluetooth (KillSwitch killswitch)
  {
    // always sync our 'blocked' property with the one in killswitch
    this.killswitch = killswitch;
    blocked = killswitch.blocked;
    killswitch.notify["blocked"].connect (() => blocked = killswitch.blocked );
  }

  public bool supported { get; protected set; default = false; }
  public bool powered { get; protected set; default = false; }
  public bool discoverable { get; protected set; default = false; }
  public bool blocked { get; protected set; default = true; }
  public void try_set_blocked (bool b) { killswitch.try_set_blocked (b); }

  // empty implementations
  public abstract void try_set_discoverable (bool b);
  public abstract List<unowned Device> get_devices ();
  public abstract void set_device_connected (uint device_key, bool connected);
}