client: server: add hid keyboard

src/rpcclient/rpcclient/darwin/client.py

@@ -10,6 +10,7 @@
 from rpcclient.darwin import objective_c_class
 from rpcclient.darwin.consts import kCFNumberSInt64Type, kCFNumberDoubleType, CFStringEncoding, kCFAllocatorDefault
 from rpcclient.darwin.fs import DarwinFs
+from rpcclient.darwin.hid import Hid
 from rpcclient.darwin.ioregistry import IORegistry
 from rpcclient.darwin.location import Location
 from rpcclient.darwin.media import DarwinMedia
@@ -69,6 +70,7 @@ def __init__(self, sock, sysname: str, hostname: str, port: int = None):
         self.xpc = Xpc(self)
         self.syslog = Syslog(self)
         self.time = Time(self)
+        self.hid = Hid(self)
 
     @property
     def modules(self) -> typing.List[str]:

src/rpcclient/rpcclient/darwin/hid.py

@@ -0,0 +1,65 @@
+import contextlib
+import logging
+import time
+from enum import Enum
+
+from rpcclient.darwin.consts import kCFAllocatorDefault
+from rpcclient.exceptions import BadReturnValueError
+
+logger = logging.getLogger(__name__)
+
+
+class Keycode(Enum):
+    VOLUME_UP = 0xe9
+    VOLUME_DOWN = 0xea
+    HOME = 0x40
+    POWER = 0x30
+
+
+class Hid:
+    def __init__(self, client):
+        self._client = client
+
+    def send_double_home_button_press(self):
+        self.send_home_button_press()
+        self.send_home_button_press()
+
+    def send_home_button_press(self):
+        self.send_key_press(Keycode.HOME.value)
+
+    def send_power_button_press(self, interval: int = 0):
+        self.send_key_press(Keycode.POWER.value, interval=interval)
+
+    def send_volume_down_button_press(self, interval: int = 0):
+        self.send_key_press(Keycode.VOLUME_DOWN.value, interval=interval)
+
+    def send_volume_up_button_press(self, interval: int = 0):
+        self.send_key_press(Keycode.VOLUME_UP.value, interval=interval)
+
+    def send_key_press(self, key_code: int, interval: int = 0):
+        self.send_keyboard_event(key_code, True)
+        if interval:
+            time.sleep(interval)
+        self.send_keyboard_event(key_code, False)
+
+    def send_keyboard_event(self, key_code: int, down: bool):
+        event = self._client.symbols.IOHIDEventCreateKeyboardEvent(kCFAllocatorDefault,
+                                                                   self._client.symbols.mach_absolute_time(),
+                                                                   0x0c, key_code, down, 0)
+        self.dispatch(event)
+
+    @contextlib.contextmanager
+    def create_hid_client(self):
+        client = self._client.symbols.IOHIDEventSystemClientCreate(0)
+
+        if not client:
+            raise BadReturnValueError('IOHIDEventSystemClientCreate() failed')
+
+        try:
+            yield client
+        finally:
+            self._client.symbols.CFRelease(client)
+
+    def dispatch(self, event):
+        with self.create_hid_client() as hid_client:
+            self._client.symbols.IOHIDEventSystemClientDispatchEvent(hid_client, event)

src/rpcserver/ents.plist

@@ -22,6 +22,14 @@
     <true/>
     <key>com.apple.locationd.status</key>
     <true/>
+    <key>com.apple.private.hid.client.admin</key>
+    <true/>
+    <key>com.apple.private.hid.client.event-dispatch</key>
+    <true/>
+    <key>com.apple.private.hid.client.event-filter</key>
+    <true/>
+    <key>com.apple.private.hid.client.event-monitor</key>
+    <true/>
     <key>task_for_pid-allow</key>
     <true/>
     <key>com.apple.private.tcc.allow</key>