0   File not found. 7 li~ Je8q 1h 0a4()P@ ;q)F l4()P@ ;q)F 0  iÿ>/* SPDX-License-Identifier: GPL-2.0+ */ /* * Surface System Aggregator Module (SSAM) bus and client-device subsystem. * * Main interface for the surface-aggregator bus, surface-aggregator client * devices, and respective drivers building on top of the SSAM controller. * Provides support for non-platform/non-ACPI SSAM clients via dedicated * subsystem. * * Copyright (C) 2019-2021 Maximilian Luz */ #ifndef _LINUX_SURFACE_AGGREGATOR_DEVICE_H #define _LINUX_SURFACE_AGGREGATOR_DEVICE_H #include #include #include #include /* -- Surface System Aggregator Module bus. --------------------------------- */ /** * enum ssam_device_domain - SAM device domain. * @SSAM_DOMAIN_VIRTUAL: Virtual device. * @SSAM_DOMAIN_SERIALHUB: Physical device connected via Surface Serial Hub. */ enum ssam_device_domain { SSAM_DOMAIN_VIRTUAL = 0x00, SSAM_DOMAIN_SERIALHUB = 0x01, }; /** * enum ssam_virtual_tc - Target categories for the virtual SAM domain. * @SSAM_VIRTUAL_TC_HUB: Device hub category. */ enum ssam_virtual_tc { SSAM_VIRTUAL_TC_HUB = 0x00, }; /** * struct ssam_device_uid - Unique identifier for SSAM device. * @domain: Domain of the device. * @category: Target category of the device. * @target: Target ID of the device. * @instance: Instance ID of the device. * @function: Sub-function of the device. This field can be used to split a * single SAM device into multiple virtual subdevices to separate * different functionality of that device and allow one driver per * such functionality. */ struct ssam_device_uid { u8 domain; u8 category; u8 target; u8 instance; u8 function; }; /* * Special values for device matching. * * These values are intended to be used with SSAM_DEVICE(), SSAM_VDEV(), and * SSAM_SDEV() exclusively. Specifically, they are used to initialize the * match_flags member of the device ID structure. Do not use them directly * with struct ssam_device_id or struct ssam_device_uid. */ #define SSAM_ANY_TID 0xffff #define SSAM_ANY_IID 0xffff #define SSAM_ANY_FUN 0xffff /** * SSAM_DEVICE() - Initialize a &struct ssam_device_id with the given * parameters. * @d: Domain of the device. * @cat: Target category of the device. * @tid: Target ID of the device. * @iid: Instance ID of the device. * @fun: Sub-function of the device. * * Initializes a &struct ssam_device_id with the given parameters. See &struct * ssam_device_uid for details regarding the parameters. The special values * %SSAM_ANY_TID, %SSAM_ANY_IID, and %SSAM_ANY_FUN can be used to specify that * matching should ignore target ID, instance ID, and/or sub-function, * respectively. This macro initializes the ``match_flags`` field based on the * given parameters. * * Note: The parameters @d and @cat must be valid &u8 values, the parameters * @tid, @iid, and @fun must be either valid &u8 values or %SSAM_ANY_TID, * %SSAM_ANY_IID, or %SSAM_ANY_FUN, respectively. Other non-&u8 values are not * allowed. */ #define SSAM_DEVICE(d, cat, tid, iid, fun) \ .match_flags = (((tid) != SSAM_ANY_TID) ? SSAM_MATCH_TARGET : 0) \ | (((iid) != SSAM_ANY_IID) ? SSAM_MATCH_INSTANCE : 0) \ | (((fun) != SSAM_ANY_FUN) ? SSAM_MATCH_FUNCTION : 0), \ .domain = d, \ .category = cat, \ .target = __builtin_choose_expr((tid) != SSAM_ANY_TID, (tid), 0), \ .instance = __builtin_choose_expr((iid) != SSAM_ANY_IID, (iid), 0), \ .function = __builtin_choose_expr((fun) != SSAM_ANY_FUN, (fun), 0) /** * SSAM_VDEV() - Initialize a &struct ssam_device_id as virtual device with * the given parameters. * @cat: Target category of the device. * @tid: Target ID of the device. * @iid: Instance ID of the device. * @fun: Sub-function of the device. * * Initializes a &struct ssam_