From patchwork Tue Dec 17 10:48:56 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Ujfalusi X-Patchwork-Id: 181856 Delivered-To: patch@linaro.org Received: by 2002:a92:3001:0:0:0:0:0 with SMTP id x1csp5566164ile; Tue, 17 Dec 2019 02:48:55 -0800 (PST) X-Google-Smtp-Source: APXvYqwulPUTV8JxRzwZaskeQa/9l0lo+9fRf0qdzTkCLCk7QpppQHzNnG6fNrUjYBcPWZb+0BCD X-Received: by 2002:a9d:7357:: with SMTP id l23mr35579939otk.10.1576579735059; Tue, 17 Dec 2019 02:48:55 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1576579735; cv=none; d=google.com; s=arc-20160816; b=EYIoMreayv1qqAEZS0tHDXFgDC13JTOe4x/qutDzumyly28DRBK44NUV5mUcq5totJ TlXtq0K6Fsad1fF6FUxYFPF06dFQr0b3xgTMe/+EyL2RgmXTX2IomqSgwggOXBmf8d1/ xGkZUaoesVxnWm4ct4At0FGmjG9r4b20IOz4oyXwWZ8ZSqLjLhz18f5umClAKJw8eV65 rtyVOC6y2c8YKFBBCxF7aR+bz0D2U6PC6X3dTXq5fYd4Qj7oaIWlVpnZgpmA+eFB5VpC QQLXsrL3GmydF0UoVT3CB9VXCEMc17Dh8TrqGCu7NwU92CV+mvrWlwTk9abHNcFp1sIA EMtg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=T3CMfOvjx9ecvb9eaAPNLrofr0AxqpXdmnvNE+n/PCk=; b=JV/Oqrj8utJM8UepqTTQD+wrmB0J2N6lldpshi1x8oiPBqnZlPjAGsNnq68io6ANhf 9WKmElKFC7rwI9MvK3hRtp6v4Nsac6tceDfesP2hsKEVzYSFqWSaSxVlGdYl8NeGoJAA XMzx34Yq67S0mM7mvKGX6FcvNwNA5ceDoR59VcUtJJSyvth1T2pjcrXISncKcKY+tYRB ynO8+j52Jbd1CKCqhPZkSBb5ADHDBVC58MaU7oIMjwxxrreDd0YiG1UGb+j4JkL2cloR toqryLn3obiXH3eU5gDqpxxyAQ8t44cwQs7Zc0PxGETzXRc2af3EdpCJUiwFxu4E/5D1 w5bw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=ZdEizmhc; spf=pass (google.com: best guess record for domain of linux-acpi-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-acpi-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id 3si11929619oir.132.2019.12.17.02.48.54; Tue, 17 Dec 2019 02:48:55 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-acpi-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@ti.com header.s=ti-com-17Q1 header.b=ZdEizmhc; spf=pass (google.com: best guess record for domain of linux-acpi-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-acpi-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=NONE dis=NONE) header.from=ti.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1725870AbfLQKsy (ORCPT + 7 others); Tue, 17 Dec 2019 05:48:54 -0500 Received: from fllv0015.ext.ti.com ([198.47.19.141]:35608 "EHLO fllv0015.ext.ti.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726655AbfLQKsw (ORCPT ); Tue, 17 Dec 2019 05:48:52 -0500 Received: from lelv0266.itg.ti.com ([10.180.67.225]) by fllv0015.ext.ti.com (8.15.2/8.15.2) with ESMTP id xBHAmihR056883; Tue, 17 Dec 2019 04:48:44 -0600 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ti.com; s=ti-com-17Q1; t=1576579724; bh=T3CMfOvjx9ecvb9eaAPNLrofr0AxqpXdmnvNE+n/PCk=; h=From:To:CC:Subject:Date; b=ZdEizmhcKA80AK6pc8WJjjoNy3fSuXzf8i++I4jbHgq1HHWRXqEdxgdLfu1dtlJh4 4KiziI+4GZldQWBj2WmDohVEKZ/oJVA3Mx4xalCh4JlnozmbfkcS5nGkx5OThfHwuG WbfdStAR4Zc/AdhYOEmWp10bSHfwrbOj/5Yrt8+Y= Received: from DFLE102.ent.ti.com (dfle102.ent.ti.com [10.64.6.23]) by lelv0266.itg.ti.com (8.15.2/8.15.2) with ESMTPS id xBHAmijj093336 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 17 Dec 2019 04:48:44 -0600 Received: from DFLE114.ent.ti.com (10.64.6.35) by DFLE102.ent.ti.com (10.64.6.23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1847.3; Tue, 17 Dec 2019 04:48:43 -0600 Received: from fllv0039.itg.ti.com (10.64.41.19) by DFLE114.ent.ti.com (10.64.6.35) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1847.3 via Frontend Transport; Tue, 17 Dec 2019 04:48:43 -0600 Received: from feketebors.ti.com (ileax41-snat.itg.ti.com [10.172.224.153]) by fllv0039.itg.ti.com (8.15.2/8.15.2) with ESMTP id xBHAmfcv016608; Tue, 17 Dec 2019 04:48:42 -0600 From: Peter Ujfalusi To: , CC: , , Subject: [PATCH] docs: firmware-guide: acpi: Change dma_request_slave_channel to dma_request_chan Date: Tue, 17 Dec 2019 12:48:56 +0200 Message-ID: <20191217104856.24987-1-peter.ujfalusi@ti.com> X-Mailer: git-send-email 2.24.0 MIME-Version: 1.0 X-EXCLAIMER-MD-CONFIG: e1e8a2fd-e40a-4ac6-ac9b-f7e9cc9ee180 Sender: linux-acpi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-acpi@vger.kernel.org dma_request_chan() is the preferred API to request slave channels. Signed-off-by: Peter Ujfalusi --- .../firmware-guide/acpi/enumeration.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) -- Peter Texas Instruments Finland Oy, Porkkalankatu 22, 00180 Helsinki. Y-tunnus/Business ID: 0615521-4. Kotipaikka/Domicile: Helsinki diff --git a/Documentation/firmware-guide/acpi/enumeration.rst b/Documentation/firmware-guide/acpi/enumeration.rst index 0a72b6321f5f..c13fee8b02ba 100644 --- a/Documentation/firmware-guide/acpi/enumeration.rst +++ b/Documentation/firmware-guide/acpi/enumeration.rst @@ -71,8 +71,8 @@ DMA support DMA controllers enumerated via ACPI should be registered in the system to provide generic access to their resources. For example, a driver that would like to be accessible to slave devices via generic API call -dma_request_slave_channel() must register itself at the end of the probe -function like this:: +dma_request_chan() must register itself at the end of the probe function like +this:: err = devm_acpi_dma_controller_register(dev, xlate_func, dw); /* Handle the error if it's not a case of !CONFIG_ACPI */ @@ -112,15 +112,15 @@ could look like:: } #endif -dma_request_slave_channel() will call xlate_func() for each registered DMA -controller. In the xlate function the proper channel must be chosen based on +dma_request_chan() will call xlate_func() for each registered DMA controller. +In the xlate function the proper channel must be chosen based on information in struct acpi_dma_spec and the properties of the controller provided by struct acpi_dma. -Clients must call dma_request_slave_channel() with the string parameter that -corresponds to a specific FixedDMA resource. By default "tx" means the first -entry of the FixedDMA resource array, "rx" means the second entry. The table -below shows a layout:: +Clients must call dma_request_chan() with the string parameter that corresponds +to a specific FixedDMA resource. By default "tx" means the first entry of the +FixedDMA resource array, "rx" means the second entry. The table below shows a +layout:: Device (I2C0) {