1 // SPDX-License-Identifier: GPL-2.0
3  * Defines interfaces for interacting with the Raspberry Pi firmware's
9 #include <linux/dma-mapping.h>
17 #include <soc/bcm2835/raspberrypi-firmware.h>
41 	complete(&fw->c);  in response_callback()
45  * Sends a request to the firmware through the BCM2835 mailbox driver,
57 	reinit_completion(&fw->c);  in rpi_firmware_transaction()
58 	ret = mbox_send_message(fw->chan, &message);  in rpi_firmware_transaction()
60 		if (wait_for_completion_timeout(&fw->c, HZ)) {  in rpi_firmware_transaction()
63 			ret = -ETIMEDOUT;  in rpi_firmware_transaction()
64 			WARN_ONCE(1, "Firmware transaction timeout");  in rpi_firmware_transaction()
67 		dev_err(fw->cl.dev, "mbox_send_message returned %d\n", ret);  in rpi_firmware_transaction()
75  * rpi_firmware_property_list - Submit firmware property list
76  * @fw:		Pointer to firmware structure from rpi_firmware_get().
80  * Submits a set of concatenated tags to the VPU firmware through the
85  * See struct rpi_firmware_property_tag_header for the per-tag
98 		return -EINVAL;  in rpi_firmware_property_list()
100 	buf = dma_alloc_coherent(fw->cl.dev, PAGE_ALIGN(size), &bus_addr,  in rpi_firmware_property_list()
103 		return -ENOMEM;  in rpi_firmware_property_list()
105 	/* The firmware will error out without parsing in this case. */  in rpi_firmware_property_list()
111 	buf[size / 4 - 1] = RPI_FIRMWARE_PROPERTY_END;  in rpi_firmware_property_list()
122 		 * But single-tag is the most common, so go with it.  in rpi_firmware_property_list()
124 		dev_err(fw->cl.dev, "Request 0x%08x returned status 0x%08x\n",  in rpi_firmware_property_list()
126 		ret = -EINVAL;  in rpi_firmware_property_list()
129 	dma_free_coherent(fw->cl.dev, PAGE_ALIGN(size), buf, bus_addr);  in rpi_firmware_property_list()
136  * rpi_firmware_property - Submit single firmware property
137  * @fw:		Pointer to firmware structure from rpi_firmware_get().
142  * Submits a single tag to the VPU firmware through the mailbox
163 		return -ENOMEM;  in rpi_firmware_property()
166 	header->tag = tag;  in rpi_firmware_property()
167 	header->buf_size = buf_size;  in rpi_firmware_property()
168 	header->req_resp_size = 0;  in rpi_firmware_property()
195 	dev_info(fw->cl.dev, "Attached to firmware from %ptT\n", &date_and_time);  in rpi_firmware_print_firmware_revision()
208 	rpi_hwmon = platform_device_register_data(dev, "raspberrypi-hwmon",  in rpi_register_hwmon_driver()
209 						  -1, NULL, 0);  in rpi_register_hwmon_driver()
214 	struct device_node *firmware;  in rpi_register_clk_driver()  local
217 	 * Earlier DTs don't have a node for the firmware clocks but  in rpi_register_clk_driver()
219 	 * have a node for the firmware clocks, just bail out here.  in rpi_register_clk_driver()
221 	firmware = of_get_compatible_child(dev->of_node,  in rpi_register_clk_driver()
222 					   "raspberrypi,firmware-clocks");  in rpi_register_clk_driver()
223 	if (firmware) {  in rpi_register_clk_driver()
224 		of_node_put(firmware);  in rpi_register_clk_driver()
228 	rpi_clk = platform_device_register_data(dev, "raspberrypi-clk",  in rpi_register_clk_driver()
229 						-1, NULL, 0);  in rpi_register_clk_driver()
242 		 * If our firmware doesn't support that operation, or fails, we  in rpi_firmware_clk_get_max_rate()
257 	mbox_free_channel(fw->chan);  in rpi_firmware_delete()
263 	kref_put(&fw->consumers, rpi_firmware_delete);  in rpi_firmware_put()
276 	struct device *dev = &pdev->dev;  in rpi_firmware_probe()
281 	 * released their firmware handles. Don't use devm_kzalloc() here.  in rpi_firmware_probe()
285 		return -ENOMEM;  in rpi_firmware_probe()
287 	fw->cl.dev = dev;  in rpi_firmware_probe()
288 	fw->cl.rx_callback = response_callback;  in rpi_firmware_probe()
289 	fw->cl.tx_block = true;  in rpi_firmware_probe()
291 	fw->chan = mbox_request_channel(&fw->cl, 0);  in rpi_firmware_probe()
292 	if (IS_ERR(fw->chan)) {  in rpi_firmware_probe()
293 		int ret = PTR_ERR(fw->chan);  in rpi_firmware_probe()
298 	init_completion(&fw->c);  in rpi_firmware_probe()
299 	kref_init(&fw->consumers);  in rpi_firmware_probe()
333 	{ .compatible = "raspberrypi,bcm2835-firmware", },
345  * rpi_firmware_get - Get pointer to rpi_firmware structure.
346  * @firmware_node:    Pointer to the firmware Device Tree node.
350  * Returns NULL is the firmware device is not ready.
364 	if (!kref_get_unless_zero(&fw->consumers))  in rpi_firmware_get()
367 	put_device(&pdev->dev);  in rpi_firmware_get()
372 	put_device(&pdev->dev);  in rpi_firmware_get()
378  * devm_rpi_firmware_get - Get pointer to rpi_firmware structure.
379  * @dev:              The firmware device structure
380  * @firmware_node:    Pointer to the firmware Device Tree node.
382  * Returns NULL is the firmware device is not ready.
402 		.name = "raspberrypi-firmware",
412 MODULE_DESCRIPTION("Raspberry Pi firmware driver");