From patchwork Sun Mar 8 00:08:33 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Dario Binacchi X-Patchwork-Id: 4500 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-wm1-f69.google.com (mail-wm1-f69.google.com [209.85.128.69]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id 7E0523F33B for ; Sun, 8 Mar 2026 01:08:46 +0100 (CET) Received: by mail-wm1-f69.google.com with SMTP id 5b1f17b1804b1-4837bfcfe0dsf125593705e9.1 for ; Sat, 07 Mar 2026 16:08:46 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1772928526; cv=pass; d=google.com; s=arc-20240605; b=U4ABMGotnTCTeWhClo5nDEnU3zGcduSYyiL4S333E3lubhCqsoJz7isExGdH3R/Izl Y8ikAgMFmrmGeZlCOQ5c36sy0RTZ6HbOH4RNz5SQtr1jClEahkQYLp2Y3Y2iO1xnggBb MVsvi6ARAO6UgSeyxWbUFwu90u/0Le49FlAC3uRnT9Stwfav2zfJ07bZZgk99aQGCjrS CnANOMcNHzzV5GC1nGW4OP9wvLRwjeHbM0GH3N6JtVrlMQu19pnm9n9tX/mMLJWkeXKN I33rhZRuoIPmqyMB92qBnUpFz2WEcqreujWDx3pltLCDB1mNsE5GF8ayKkV0vvNDmTLx lqPw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=list-unsubscribe:list-archive:list-help:list-post:list-id :mailing-list:precedence:mime-version:message-id:date:subject:cc:to :from:dkim-signature; bh=qB/XGz6F7jQ08eo4I0rnzt3+Rs70HLbD3nlhgln8EzE=; fh=5TPGVG0cEgS+HAQUY6R/jukxDqVIiSkPyKsX48W2ux0=; b=Hd3Au2UJlUOeJWzoAivDamW0maLdQMAuocDFTzXBeFF7voOynmtoE6L23Aly1fTFBT d8BywY3unaEnfoXZ/sgdH0rhss7kK9E4ErCKFixCDZpFGWitUbSLHvVBe4z3rTxTwpKx 25TGjvzX5OdXBeO4TCnyho50jn/xJxCFcAPsGHcM6Dd0e0HUZG+zokENmJz3+JqQuY+M FrhMZFtPBhwXueb4S0DlHCMt2vv0hYPgM29R0937RVPTwwWKxKZeejZDoyYsar6V56/h ljCEo4faPcZ7wxBGhJi/mSPCXGuaTZQOeW21qcCztNA1hnmDaHEwYOp5bfWRpS87mp7R B89g==; darn=patchwork.amarulasolutions.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=QFRsUpc2; spf=pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=dario.binacchi@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com; dara=neutral header.i=@amarulasolutions.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amarulasolutions.com; s=google; t=1772928526; x=1773533326; darn=patchwork.amarulasolutions.com; h=list-unsubscribe:list-archive:list-help:list-post:list-id :mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:message-id:date:subject:cc:to:from :from:to:cc:subject:date:message-id:reply-to; bh=qB/XGz6F7jQ08eo4I0rnzt3+Rs70HLbD3nlhgln8EzE=; b=DcgeEVTkjXFqPlvLqc6vBEN+BgZOOWV+GBjO2u2jdDjIXnCwQ/eDjWIfp5DCIitNtQ oTVAmki6Bl31CweIrFUAgopEgYQIeFQbmExsmBaFkpRIUMwQHtatL7qyutY8Ocj/s9iq sSiPjP6M7yGTqQlxwLOwBsuJsLOiB3t46s8ew= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1772928526; x=1773533326; h=list-unsubscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:mime-version :message-id:date:subject:cc:to:from:x-gm-gg:x-beenthere :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=qB/XGz6F7jQ08eo4I0rnzt3+Rs70HLbD3nlhgln8EzE=; b=A0sIGdbqKhh+DPvS9vCjwdLGnnPd4dDHZbFjiasLLIZoFS1dmvsqDwZdRRyMCjc6Ow u0xlq2Ay5nydJtlfuOToCY0WEiMPJOoLjR4bVY/dWC6H2VcNz+sukJ2VUg45Ad/08RCN G2fRSbLUwyRSjEGvkCTCto+AtGA+/79n6j/fshqAVNBURBWzJOP4QTj3M82deVfPPDKX e6vsMFCd2/QgYOGfKTp6NLjHv7ght8w/VxFBHLrDQx0q7EPdC6E6msTNhuVupua0SM84 gwJ7oPAzM9BUeKCqm2GPSFkYI5N+rgxA6PTbGTOz+IqVeRLcthFDlvw5+XPUDKZxfKNn VaAw== X-Forwarded-Encrypted: i=2; AJvYcCUZ0LMDxR1Pkd5izPWpz0IuVqHMMvJK2mvPguNTSeNAV4uCOlTcD4JREkNWEEHC3FEc/bejI5FUWMKdfnBI@patchwork.amarulasolutions.com X-Gm-Message-State: AOJu0YxWHQ6cfVx37WFsRX//FCDHjEmBnxVn0mCyplxcDYldRtRTCrjp BpIuzPNdRYlAkT7L2pS+zZLTELJuiCbfjDP/qWX8pdHWtE7ry6X673xGOvg9Ko9aK4mopQ== X-Received: by 2002:a05:600c:a12:b0:483:6d42:25c6 with SMTP id 5b1f17b1804b1-48526967fd5mr109656685e9.23.1772928525830; Sat, 07 Mar 2026 16:08:45 -0800 (PST) X-BeenThere: linux-amarula@amarulasolutions.com; h="AV1CL+EOCHZjJNl8Ta/EhqiXRfr1QvFAJYtVTkwtt2YosVMimA==" Received: by 2002:a05:600c:1d0f:b0:480:6bcd:94b5 with SMTP id 5b1f17b1804b1-4851d46b0dbls22725035e9.0.-pod-prod-05-eu; Sat, 07 Mar 2026 16:08:44 -0800 (PST) X-Received: by 2002:a05:600c:4591:b0:477:9b4a:a82 with SMTP id 5b1f17b1804b1-4852697969fmr101909825e9.35.1772928523719; Sat, 07 Mar 2026 16:08:43 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1772928523; cv=none; d=google.com; s=arc-20240605; b=a+ndy7Nj7chdyGf3X41yLPVYqki0DMUHQZtTA1oE8tj1Gt1TndzdG2KNL63SNX2jt3 oekIBHZP/3praKLLyx3bj49A0HwacDpjlnFJewEHY1LvhPFAZ35inmeQtRndJmbWw/mt 78UYnyHaDkAqjhdK4kZS4XlL3judieqo/oma/d1dvaBlZutXRxpZ6GOj5fklBrj1vN5R nS7ip1edG55O/69kD4NU8/T5oOsnHq5d/DDAV5Sqgiusmvqudma4dEscZjWvol1qE8Ph vAZT/XPdnd1OQfxbrDbdv8cSQcvwPT4JkukV7y5wo2Oo9cLp2ujqa2zQ4Xkab3NL0dxY IfiA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:dkim-signature; bh=TT44xvXlgbGwzICp8t+J4pGO4g/hqxdo8XUUbT25ohI=; fh=PVQ6qK/apE8apMCQLUsBZ5FgEk1zvaf7+lv3UFNLduQ=; b=KBd9nWmMzd5aPJlmzduJUIwRcLL4rUc41BsnHXiKWqKrvitsA7xt3z1NoEgOAaUF9y Gc/gLqUlcceL5ZKlM/q5jM3K6ySzm7IrtCgB8AgyWfZTbUDo7KMqfCsICVjQp0/MRFWu Inu3baIO8U4cBNCh251paD1n7KduilfxStyykGao2EiOkUn31MEUOC2C6XMITCQL8P3r 9S4wYc9lm98ogKAx3h1I56vfdKeJGeNXu4tTfi3VOCjjli+Fwfde7rllQ90vYuhwPymc xTLgPXFD/aP0vabf4gs8DaixAmD3yzOamtxcMJ/4ONetoSTQeJB1LXa5rWW4shuTShg7 Dddw==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=QFRsUpc2; spf=pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=dario.binacchi@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com; dara=neutral header.i=@amarulasolutions.com Received: from mail-sor-f41.google.com (mail-sor-f41.google.com. [209.85.220.41]) by mx.google.com with SMTPS id 5b1f17b1804b1-48527683e58sor7307485e9.9.2026.03.07.16.08.43 for (Google Transport Security); Sat, 07 Mar 2026 16:08:43 -0800 (PST) Received-SPF: pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) client-ip=209.85.220.41; X-Gm-Gg: ATEYQzy0epPxEaED0EU8JQzyAVVta+/CTocbvSsfmxh07ur0MrPDw21/jRlnzblDA2/ vVKRenLfsQ6lm+npIsoDTma+Gj31OfcqMvUbkGPm+jj6+YiUj0f6nyPNGHJhxz+oqJfsgr8dE5U du1VEEaXBGCFmRZcIWMaMn3+j9yVSqHjev7u+40OJn5QRwfx1lHV6U/m0iNvpsh6ghm0wpXXHOV 93sKZIyxMK6FLUUoguT1tFyJ565u0gyPB/0vs4BBzf+9XF2EF/dW4OKDfjSUEEq/kHEjYqPohOe ucTwI+Fe6e6GKxQCT2LyClfWCF/hDc6rDR2bpQ4WVDSEp+/a08C0qguDNbkVUl6VUmtiDNcYbMW Mj5L1pKl9ucm+mmGoAfMROphXWmVUkVmq9/Gy0sxxPrVnIn67sPCKOUMnydn3J3ny6KMVQMan75 5rV089wPB+mfBeDL45bDszfIu/8XOPG5faCtuu46Nekp2kCMk/Z9YgMOX5WF6hOkSvgveXybIUc hEvwQ6PpI9/OZYd6ENXrhz0ZPR/EBzh7iz0CtsKlkOKuUS9RvCMR2VOKuQkfePyTXcarjg6sGau fQaprIotfttKIos4AbA= X-Received: by 2002:a05:600c:c10d:b0:485:2af3:3f90 with SMTP id 5b1f17b1804b1-4852af340c3mr63580655e9.2.1772928523075; Sat, 07 Mar 2026 16:08:43 -0800 (PST) Received: from dario-ThinkPad-P14s-Gen-5.amarulasolutions.com (host-95-248-31-95.retail.telecomitalia.it. [95.248.31.95]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4852e38c013sm158105705e9.8.2026.03.07.16.08.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 07 Mar 2026 16:08:42 -0800 (PST) From: Dario Binacchi To: swupdate@googlegroups.com Cc: linux-amarula@amarulasolutions.com, Dario Binacchi Subject: [PATCH 1/1] doc: handlers: document the eMMC handler Date: Sun, 8 Mar 2026 01:08:33 +0100 Message-ID: <20260308000833.3502752-1-dario.binacchi@amarulasolutions.com> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 X-Original-Sender: dario.binacchi@amarulasolutions.com X-Original-Authentication-Results: mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=QFRsUpc2; spf=pass (google.com: domain of dario.binacchi@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=dario.binacchi@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com; dara=neutral header.i=@amarulasolutions.com Content-Type: text/plain; charset="UTF-8" Precedence: list Mailing-list: list linux-amarula@amarulasolutions.com; contact linux-amarula+owners@amarulasolutions.com List-ID: X-Spam-Checked-In-Group: linux-amarula@amarulasolutions.com X-Google-Group-Id: 476853432473 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Document the emmc_boot and emmc_boot_toggle script handlers and provide usage examples. Signed-off-by: Dario Binacchi --- doc/source/handlers.rst | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/doc/source/handlers.rst b/doc/source/handlers.rst index f3ca094c1141..d9ac6c7ef44d 100644 --- a/doc/source/handlers.rst +++ b/doc/source/handlers.rst @@ -1036,6 +1036,42 @@ not set, variables set in bootenv are overwritten. In the example above, bootenv01key is not overwritten by a value in uEnv.txt because the flag "nooverride" is set. +eMMC handler +------------ + +This is a script handler used to manage the eMMC boot partitions. + +The ``emmc_boot`` selects the eMMC hardware boot partition based +on the device name. The number following ``boot`` in the device path +is used to determine the boot partition to be selected: + +- ``/dev/mmcblkXboot0`` selects boot partition 0 +- ``/dev/mmcblkXboot1`` selects boot partition 1 + +The ``emmc_boot_toggle`` toggles the active eMMC hardware boot +partition for the specified device. + +Example selecting boot partition 1: + +:: + + scripts: ( + { + type = "emmc_boot"; + device = "/dev/mmcblk1boot1"; + } + +Example toggling the active boot partition: + +:: + + scripts: ( + { + type = "emmc_boot_toggle"; + device = "/dev/mmcblk1"; + } + + Archive handler ---------------