From patchwork Thu Aug 26 11:37:05 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Babic X-Patchwork-Id: 1521056 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::237; helo=mail-lj1-x237.google.com; envelope-from=swupdate+bncbcxploxj6ikrbz7ztweqmgqeerigany@googlegroups.com; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20210112 header.b=LVyEthP8; dkim-atps=neutral Received: from mail-lj1-x237.google.com (mail-lj1-x237.google.com [IPv6:2a00:1450:4864:20::237]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4GwLRc597tz9sWc for ; Thu, 26 Aug 2021 21:37:15 +1000 (AEST) Received: by mail-lj1-x237.google.com with SMTP id c39-20020a2ebf270000b029019c5777f07fsf1031726ljr.1 for ; Thu, 26 Aug 2021 04:37:15 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1629977831; cv=pass; d=google.com; s=arc-20160816; b=NuBpk/5qqVBWGATF4fwbyxqL3hn73fmY288el5cvtc6q8QE/WE65LD6qZA5TWBDOML 7sf4jBQWb8xVDmnnw6Ixf6pEu52ViXDlxUg1xPG7t1Ab1rCV0EveOr9DQX+aOcsuBVdk OgkGowNHPxN0YIoVhagAsX+iWttc6D/Cs27RbKkCfaz4hLI5d2n3i/sSrGBqmq1L+gU5 I2zAx09cAwDHzt64MLF/JZsU/nzaMQueFT0UMGX9LmeEPfmX3tZvNu0rFXZJkDpgr6ic KNJyW2Aof5vsZN7Djg0/NCnqg5RNZu0c4KndGDmDT+S7ZmzuCGtExXdKFAGbKwsVSDtB mYYQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:message-id:date :subject:cc:to:from:sender:dkim-signature; bh=Omm+qvvfxWq0eq5GG2qmVVPuiFLjcSuPdDXCEma0xIU=; b=xmIiKa5+XTsmndtTTBHGTZri/eYhEzg96/VUyyoCKkImzWFIFkkFHiG1dfmue8+fAO SXBc3FVWvEn09Eie42iLVpbLkpHn6prS4UJrtZCgnBL/4AJE6f2L77YK9swNFj1YzKPL nFDwGZm7TfO1JgsnDk4Uro0dWZvY2C52wYEe3SbAavf6qYx6tYH7Pm2l3asVqY829Ckz GAGakCfNLtPaTTjq1IPvam9D1jp6rQwPIjSx95gyqqsCk+HPTkRu1mKfqPSc5yVkCajD 4r4ftShA5Cy86CZexjwYjW6yHis3tKMYTN//dls3/aO8kBl5EXg6qdUI3LXqq8vSVmAt BpxA== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=neutral (google.com: 212.18.0.9 is neither permitted nor denied by domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=sender:from:to:cc:subject:date:message-id:mime-version :x-original-sender:x-original-authentication-results:precedence :mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=Omm+qvvfxWq0eq5GG2qmVVPuiFLjcSuPdDXCEma0xIU=; b=LVyEthP8YJ/8pEu3gpItnTiEOjyq/Ec0tbZd/zb+KXjCWrL5j71Nu8BkH0b9yUa4Ic ZpAbD06EuCYNvg3f/IoupaSiMeQd6lHeZpCuAmTyzBVnngORAsjDHi8st78JD9OQjUSl KrNDehuB6JDhaVY9gnn2aDQhEJvUfl/Mroa3VsDYMyiUlDXTKaBCISQQ8M/WmvNXazbW 8rDrisQbtqxPs7CeerBouFLbXUCxYQ6h10RDMGBKefUh5sQgZ/LPU9WnVj/Qnszb3uLh uAZUVnz5ZtjnzDHTcgjybTQ8KzB7OpJ23FyS7TDNXdEp8iYTc0NesRA8UUFQt3roZwqg kZRA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=Omm+qvvfxWq0eq5GG2qmVVPuiFLjcSuPdDXCEma0xIU=; b=Hc2yb6AbQGcMw8m/OX0z7w+TiUcED38wSbH3c29ZSoB+V3PyNfvHLOJSmYByY2VwFw /7/IAIWS2aZh74j82MhaARPRASPCfqhsTSHxJybh7Zo8RnfASaTIdJX6phPau/bgt4UA vkHh8fH5qF7AgszEGJHkD9r9coz12B9SO/733ywNaIR8IrkWfJ06MtjLTgTU7UkTqT/u ABAee/bt1vfdY52vqAp8Ej/BrM9xeOXDgC+Q/T8zncjJxA1wy0khTxUHoaDkXCyOem1+ L48i04CX/L36PiT7IAI+f6eB4gYZDHXdERQkwLcQRbKVPijsZ1kJPmsHV80gxVF+fXtG WtSw== Sender: swupdate@googlegroups.com X-Gm-Message-State: AOAM5338G/sWnLqYR4OA6RiOFIkxZrBa0Q1U0MdrlbpjCVXT4VHJkDzZ QTZhWpaXpkPINt+rJD+I3WI= X-Google-Smtp-Source: ABdhPJx+6PCSCbtnIaQ3qx6eHWIE4qwbiwQ/3AAi0ZPTIRsV9EAp3OJczs6tjQHoSB1+Ee0M6ZkaYg== X-Received: by 2002:a05:6512:45b:: with SMTP id y27mr2354482lfk.619.1629977831721; Thu, 26 Aug 2021 04:37:11 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 2002:ac2:4146:: with SMTP id c6ls357687lfi.2.gmail; Thu, 26 Aug 2021 04:37:10 -0700 (PDT) X-Received: by 2002:ac2:5963:: with SMTP id h3mr2389996lfp.203.1629977830813; Thu, 26 Aug 2021 04:37:10 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1629977830; cv=none; d=google.com; s=arc-20160816; b=pg/JgM7oIguVGpu6eK0E6t1o/AsDHV5cw+31V0KkBkEvVK1VS/cVI1UnsVPV7U7aYz NTW0nCRc8+hIXoZuBF49hA8YfDuKhTXomscc0j3a3iI+CVrwl3IokfWBdlYC2oz0LYi/ 9DEvOEN1EfuUA6Q2g1gEmnIJYRGOgGMw9dTykvz00dg4G0VewwNBOAiu5raA0KpNr4yc 8xUiQJlW+Hw/99M62ptXrGtfEPZjYBPucy1hRhFJfwinDTQiqH8jx0S6exOGynwVfhiC yz2HhZojdbfPgT56wJ4KI8rVmypq9Qu5SMIEdL7ZAQhwLcBpOlNufrP+R+WqJ67EuMkQ lx2Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from; bh=0HaDYcvuku+1sNJM0m+x0scdiv3dZA3hRiBJ2jBBgsU=; b=YF9yy7ioX4mBpggp8QyslNRdEOBaHVpbtt0pdC2Q2Fxo6j1k/+qAAhGjwCdlzQQwC5 g1UUZ4PcqLjP/HlUPXJql7zhntw1MtLjmDs1rWeZa4UgAqF0G5dRfYvN92aVK+aercL0 /30Rtm+alu+k8J5qKiaWKXSCNAhQYHBAKL3i8P0s3OY89ueqOQPGdwPmhnYRtCPWWGJ2 01l2hKyit4AA4oZREsFc9oU+JcLl9EuzyyjnuFm3KqHXk5E68mQWPuy7aqb9Zd0tVWdu wJmdgKb9FHDMd9/RgWBxXMIgCiRZ5PepaFHR7E27LQyRsk016PDBn60quZj/DA83MvXP Gm9w== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 212.18.0.9 is neither permitted nor denied by domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de Received: from mail-out.m-online.net (mail-out.m-online.net. [212.18.0.9]) by gmr-mx.google.com with ESMTPS id n6si160763lft.8.2021.08.26.04.37.10 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 26 Aug 2021 04:37:10 -0700 (PDT) Received-SPF: neutral (google.com: 212.18.0.9 is neither permitted nor denied by domain of sbabic@denx.de) client-ip=212.18.0.9; Received: from frontend01.mail.m-online.net (unknown [192.168.8.182]) by mail-out.m-online.net (Postfix) with ESMTP id 4GwLRV2TSYz1qxHW; Thu, 26 Aug 2021 13:37:10 +0200 (CEST) Received: from localhost (dynscan1.mnet-online.de [192.168.6.70]) by mail.m-online.net (Postfix) with ESMTP id 4GwLRV2G6Zz1r6Np; Thu, 26 Aug 2021 13:37:10 +0200 (CEST) X-Virus-Scanned: amavisd-new at mnet-online.de Received: from mail.mnet-online.de ([192.168.8.182]) by localhost (dynscan1.mail.m-online.net [192.168.6.70]) (amavisd-new, port 10024) with ESMTP id zEhNokdkqqT6; Thu, 26 Aug 2021 13:37:09 +0200 (CEST) Received: from babic.homelinux.org (host-88-217-136-221.customer.m-online.net [88.217.136.221]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.mnet-online.de (Postfix) with ESMTPS; Thu, 26 Aug 2021 13:37:09 +0200 (CEST) Received: from localhost (mail.babic.homelinux.org [127.0.0.1]) by babic.homelinux.org (Postfix) with ESMTP id 546BA4541281; Thu, 26 Aug 2021 13:37:09 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at babic.homelinux.org Received: from babic.homelinux.org ([IPv6:::1]) by localhost (mail.babic.homelinux.org [IPv6:::1]) (amavisd-new, port 10024) with ESMTP id 1L79AY1tMPLX; Thu, 26 Aug 2021 13:37:07 +0200 (CEST) Received: from paperino.fritz.box (paperino.fritz.box [192.168.178.48]) by babic.homelinux.org (Postfix) with ESMTP id 0EA864540226; Thu, 26 Aug 2021 13:37:07 +0200 (CEST) From: Stefano Babic To: swupdate@googlegroups.com Cc: Stefano Babic Subject: [swupdate] [PATCH] doc: describe usage of swupdate-image class in OE Date: Thu, 26 Aug 2021 13:37:05 +0200 Message-Id: <20210826113705.328392-1-sbabic@denx.de> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-Original-Sender: sbabic@denx.de X-Original-Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 212.18.0.9 is neither permitted nor denied by domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de Precedence: list Mailing-list: list swupdate@googlegroups.com; contact swupdate+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: swupdate@googlegroups.com X-Google-Group-Id: 605343134186 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Signed-off-by: Stefano Babic --- doc/source/building-with-yocto.rst | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/doc/source/building-with-yocto.rst b/doc/source/building-with-yocto.rst index bc7d90c..b410dc0 100644 --- a/doc/source/building-with-yocto.rst +++ b/doc/source/building-with-yocto.rst @@ -246,3 +246,24 @@ Template for recipe using the class SWUPDATE_IMAGES_FSTYPES[uImage] = ".bin" inherit swupdate + +Simplified version for just image +--------------------------------- + +In many cases there is a single image in the SWU. This is for example when +just rootfs is updated. The generic case described above required an additional +recipe that must be written and maintained. For this reason, a simplified version +of the class is introduced that allowed to build the SWU from the image recipe. + +Users just need to import the `swupdate-image` class. This already sets some variables. +A sw-description must still be added into a `files` directory, that is automatically searched by the class. +User still needs to set SWUPDATE_IMAGE_FSTYPES[`your image`] to the fstype that should be packed +into the SWU - an error is raised if the flasg is not set. + +In the simple way, your recipe looks like + +:: + + + SWUPDATE_IMAGES_FSTYPES[] = + inherit swupdate-image