Received: by 2002:ab2:1c04:0:b0:1f7:53ba:1ebe with SMTP id f4csp111606lqg; Fri, 26 Apr 2024 10:05:38 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCVDn3GgvfgDk4bDIa2blM6bn9sivUcJuve4cp1QZjBs8574RnhW+GhEc9hCIVw7KCk6drEKVQ8Scu7BHuxyir9iDDXdbYXlUo7+c1QMtg== X-Google-Smtp-Source: AGHT+IEZRhM8nO8nUB0hTr9tK4+PzQ5DM4D5mZi2lYylifCB3AyVKs2LqnmiLlASrrR9P9dl91N6 X-Received: by 2002:a05:6a20:9154:b0:1aa:9561:1342 with SMTP id x20-20020a056a20915400b001aa95611342mr4106045pzc.35.1714151138076; Fri, 26 Apr 2024 10:05:38 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1714151138; cv=pass; d=google.com; s=arc-20160816; b=NfI8jEkEiuyAsJjdf1Eel9voMps3npn+9+RxhqzMwqIM8jAr+RFaWh3YFcWkdmuJ6d KK9iFhN+TgjW6ybtjrUtwPG/Q2H3nsTEWHIlZ2+kFFVvOLGJvDtg+PoDPK45Y5uBxLUH vorYXxHE00UIdimdy3zX1oCSFGAx8ZnP51Zeh/1NUU9ZmB1wPjOYJYYAIlLAl+NYmpdX UqPFQyktZYUIOhFaZiuBJc481LDNGAn6a2y4Esbok8RimprLl97F+/+M54pH75unI0KF BgxWB/KvKISUQeSQHFtkW6YutDqv3OalM5K9UiwFEp085DItMpBbJttdXxlLKDARdm8G AMMQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:list-unsubscribe:list-subscribe:list-id:precedence :subject:date:from:dkim-signature; bh=iSUU7C4Fcf6ZvY0mTm+OdGB1Q5lauGV6mB1GfXERmdg=; fh=nltZftsxQXuWoLpedj6X+btMoFrrKx13QYCe+HaZVzI=; b=Agj+rEzQGxCtTzPsN6FyyTsQd3eg+UmkAird0Uky6++GUZUbmhnuz34Xb6yJRm8z7d SwML+i3L//DGQU5ASEl4k+P2B1PtpzQWh2QgDodR8+Z4E1QfqUvoUnnpDMEeY/q5PUOr Gjn7Xgp0K3iAk3vhm6/4KgUv/lcA7jKEOF8dr28AGRPiQ+pZ3sVWh8q+GQR58wIRnz3B Obwq0/UMq4FjDa4kPpm3LNca1Judthz/0YxtoTlN+AubeV64l2mCTC4JniDo+uZoWvil 9Rfq0wypTpxiY20VDAkIM5vNvyYspD+DXm76KgSQ4D0iCPg8/QgsmTwofCQWb35PMAVW b25A==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=Mbvn6Lit; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-160423-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-160423-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Return-Path: Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org. [147.75.48.161]) by mx.google.com with ESMTPS id 9-20020a630209000000b00601da71ac96si8492315pgc.583.2024.04.26.10.05.37 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Apr 2024 10:05:38 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-160423-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) client-ip=147.75.48.161; Authentication-Results: mx.google.com; dkim=pass header.i=@bootlin.com header.s=gm1 header.b=Mbvn6Lit; arc=pass (i=1 spf=pass spfdomain=bootlin.com dkim=pass dkdomain=bootlin.com dmarc=pass fromdomain=bootlin.com); spf=pass (google.com: domain of linux-kernel+bounces-160423-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.48.161 as permitted sender) smtp.mailfrom="linux-kernel+bounces-160423-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=bootlin.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 88E62B24235 for ; Fri, 26 Apr 2024 16:58:07 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 90BC916F273; Fri, 26 Apr 2024 16:56:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b="Mbvn6Lit" Received: from relay9-d.mail.gandi.net (relay9-d.mail.gandi.net [217.70.183.199]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id CEE0B168AE6; Fri, 26 Apr 2024 16:56:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=217.70.183.199 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1714150614; cv=none; b=a2mOG7gktyk2L9hmeIOAIPEtYP2U5wkV+h/PBSmKYAdU6h3zOUBpcmz4pIa3N3jRggMWD2+9hTniNcYlv5EvpDvRDGkx2t/YeTz62th6dfXrTpGROhDodJdSEezgtxmOdOpr2CSEAq61sblzJFbeXqZljivAddFoNgiguGrfzv4= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1714150614; c=relaxed/simple; bh=Y9CUnck7THjoN6x8IrAFw09G6hJUpUvGCNUaNkYbzZY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=EGsfsf5z06ZWPAxLdxX3YmJGIlIglxKmFSMDyZ5ZT8ETWBXEg/NCCNAx5WZ+pH6KAdjxe8OnIGHxxq1/VLvTsFwVf5C8tLzKIDk8XTVZYP8Nn3+3yxQF5sZFsHz7Xp/PAxna1uvFDHPmpt7AfNg2BLimqVJTyXTco9HIcJi8KSQ= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com; spf=pass smtp.mailfrom=bootlin.com; dkim=pass (2048-bit key) header.d=bootlin.com header.i=@bootlin.com header.b=Mbvn6Lit; arc=none smtp.client-ip=217.70.183.199 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=bootlin.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=bootlin.com Received: by mail.gandi.net (Postfix) with ESMTPSA id 8FF8DFF807; Fri, 26 Apr 2024 16:56:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=gm1; t=1714150611; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=iSUU7C4Fcf6ZvY0mTm+OdGB1Q5lauGV6mB1GfXERmdg=; b=Mbvn6LitXY8/acwBgzfvXmcLNflwTmAotthAi+skuIcs/SEo6PyF/35YB3sqEZmdlKRRYD InRnupPiBEGpwAiojpf+aCKVS3+TI/JY7D21kI4NmhSD3eTzF6MDN/ylyOasMEKQp4Voke B45kf31txw1sqap7oVgNQABdQJPBJFYfVCo3eCWL0fKMLWfDIu9bbl4wnyMc9DANbZzHUL 3Cg6Pk4qYa+k+8RfbELBTosvISUPGz+6zkkIhcAxDBIPp8wbUjac91WpZ56Uw1/VJGX3Vx RIv2extlaWJhfDLuOMj5GUTamE+Ewdhu5+6U7lD8HDZTK0N1KdyavYPnpYcKuQ== From: Luca Ceresoli Date: Fri, 26 Apr 2024 18:56:39 +0200 Subject: [PATCH v2 06/12] ASoC: doc: dapm: replace "map" with "graph" Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20240426-dapm-docs-v2-6-87b07547eb5b@bootlin.com> References: <20240426-dapm-docs-v2-0-87b07547eb5b@bootlin.com> In-Reply-To: <20240426-dapm-docs-v2-0-87b07547eb5b@bootlin.com> To: Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Jonathan Corbet Cc: Alexandre Belloni , Bagas Sanjaya , Thomas Petazzoni , linux-sound@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Luca Ceresoli X-Mailer: b4 0.13.0 X-GND-Sasl: luca.ceresoli@bootlin.com DAPM is actually based on a graph, so use this specific term instead of the more generic "map". Reviewed-by: Alexandre Belloni Signed-off-by: Luca Ceresoli --- Documentation/sound/soc/dapm.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/sound/soc/dapm.rst b/Documentation/sound/soc/dapm.rst index f96a32f137aa..11f7f2f685af 100644 --- a/Documentation/sound/soc/dapm.rst +++ b/Documentation/sound/soc/dapm.rst @@ -49,7 +49,7 @@ Stream domain stopped respectively. e.g. aplay, arecord. All DAPM power switching decisions are made automatically by consulting an audio -routing map of the whole machine. This map is specific to each machine and +routing graph of the whole machine. This graph is specific to each machine and consists of the interconnections between every audio component (including internal codec components). All audio components that affect power are called widgets hereafter. @@ -230,7 +230,7 @@ to any stream event or by kernel PM events. Virtual Widgets --------------- -Sometimes widgets exist in the codec or machine audio map that don't have any +Sometimes widgets exist in the codec or machine audio graph that don't have any corresponding soft power control. In this case it is necessary to create a virtual widget - a widget with no control bits e.g. :: @@ -248,7 +248,7 @@ Codec/DSP Widget Interconnections Widgets are connected to each other within the codec, platform and machine by audio paths (called interconnections). Each interconnection must be defined in -order to create a map of all audio paths between widgets. +order to create a graph of all audio paths between widgets. This is easiest with a diagram of the codec or DSP (and schematic of the machine audio system), as it requires joining widgets together via their audio signal -- 2.34.1