include/linux/thunderbolt.h

1 /* SPDX-License-Identifier: GPL-2.0 */
40  * enum tb_security_level - Thunderbolt security level
58  * struct tb - main thunderbolt bus structure
94 	return (link - 1) / TB_LINKS_PER_PHY_PORT;  in tb_phy_port_from_link()
98  * struct tb_property_dir - XDomain property directory
120  * struct tb_property - XDomain property
122  * @key: Key for the property (always terminated).
123  * @type: Type of the property
124  * @length: Length of the property data in dwords
125  * @value: Property value
162 #define tb_property_for_each(dir, property)			\  argument
163 	for (property = tb_property_get_next(dir, NULL);	\
164 	     property;						\
165 	     property = tb_property_get_next(dir, property))
171  * struct tb_xdomain - Cross-domain (XDomain) connection
211  * non-standard properties but they need hold @lock when doing so
226 	bool is_unplugged;
227 	bool resume;
228 	bool needs_uuid;
258 	mutex_lock(&tb->lock);  in tb_xdomain_find_by_uuid_locked()
260 	mutex_unlock(&tb->lock);  in tb_xdomain_find_by_uuid_locked()
270 	mutex_lock(&tb->lock);  in tb_xdomain_find_by_route_locked()
272 	mutex_unlock(&tb->lock);  in tb_xdomain_find_by_route_locked()
280 		get_device(&xd->dev);  in tb_xdomain_get()
287 		put_device(&xd->dev);  in tb_xdomain_put()
290 static inline bool tb_is_xdomain(const struct device *dev)  in tb_is_xdomain()
292 	return dev->type == &tb_xdomain_type;  in tb_is_xdomain()
311  * tb_protocol_handler - Protocol specific handler
339  * struct tb_service - Thunderbolt service
365 		get_device(&svc->dev);  in tb_service_get()
372 		put_device(&svc->dev);  in tb_service_put()
375 static inline bool tb_is_service(const struct device *dev)  in tb_is_service()
377 	return dev->type == &tb_service_type;  in tb_is_service()
388  * tb_service_driver - Thunderbolt service driver
414 	return dev_get_drvdata(&svc->dev);  in tb_service_get_drvdata()
419 	dev_set_drvdata(&svc->dev, data);  in tb_service_set_drvdata()
424 	return tb_to_xdomain(svc->dev.parent);  in tb_service_parent()
428  * struct tb_nhi - thunderbolt native host interface
436  * @msix_ida: Used to allocate MSI-X vectors for rings
440  *		    MSI-X is used.
451 	bool going_away;
457  * struct tb_ring - thunderbolt TX or RX ring associated with a NHI
459  *	  nhi->lock.
471  * @irq: MSI-X irq number if the ring uses MSI-X. %0 otherwise.
472  * @vector: MSI-X vector number the ring uses (only set if @irq is > 0)
492 	bool is_tx:1;
493 	bool running:1;
509 typedef void (*ring_cb)(struct tb_ring *, struct ring_frame *, bool canceled);
512  * enum ring_desc_flags - Flags for DMA ring descriptor
530  * struct ring_frame - For use with ring_rx/ring_tx
564  * tb_ring_rx() - enqueue a frame on an RX ring
568  * @frame->buffer, @frame->buffer_phy have to be set. The buffer must
571  * @frame->callback will be invoked with @frame->size, @frame->flags,
572  * @frame->eof, @frame->sof set once the frame has been received.
575  * @frame->callback will be called with canceled set to true.
577  * Return: Returns %-ESHUTDOWN if ring_stop has been called. Zero otherwise.
581 	WARN_ON(ring->is_tx);  in tb_ring_rx()
586  * tb_ring_tx() - enqueue a frame on an TX ring
590  * @frame->buffer, @frame->buffer_phy, @frame->size, @frame->eof and
591  * @frame->sof have to be set.
593  * @frame->callback will be invoked with once the frame has been transmitted.
595  * If ring_stop() is called after the packet has been enqueued @frame->callback
598  * Return: Returns %-ESHUTDOWN if ring_stop has been called. Zero otherwise.
602 	WARN_ON(!ring->is_tx);  in tb_ring_tx()
611  * tb_ring_dma_device() - Return device used for DMA mapping
619 	return &ring->nhi->pdev->dev;  in tb_ring_dma_device()