From patchwork Fri Aug 9 00:48:50 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Caleb Connolly X-Patchwork-Id: 818096 Delivered-To: patch@linaro.org Received: by 2002:a5d:5711:0:b0:367:895a:4699 with SMTP id a17csp88074wrv; Thu, 8 Aug 2024 17:50:12 -0700 (PDT) X-Forwarded-Encrypted: i=2; AJvYcCWp3z6QrLCLlPSy6TwOSE/Djqslw7jQDTay3URPrqIERysEBx4UnS2zyA4ZkmWfJ5+vTQwIWty1XSthBKZ6gKbg X-Google-Smtp-Source: AGHT+IF1c04qW9EIolHprmbezJtTJxtEbpLRmshdEVn2dlvQtYaEGbA13wX5Tdre6UQQ837GZtnP X-Received: by 2002:a17:906:eec2:b0:a6f:dd93:7ffb with SMTP id a640c23a62f3a-a8091ec812dmr310480466b.1.1723164612062; Thu, 08 Aug 2024 17:50:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1723164612; cv=none; d=google.com; s=arc-20160816; b=yJhTFlMXDSoDMhljN+ScX1Xd4niTtwI4wgDb7CuMDk/FkFwReL2M8A0+bC5Clr+Azp ox765/+zpY2+Eq8LtIf2tP0fOgjK3ZwL485u8U/5r3tN7Wceb51LNYQoHy0GzHZjKWa6 U2t6IuHOGzXF6Xb4s8eJAz3ILumSfbfyz98h9+54QBqRQFEl6AzcZv/GKqOEM8YrLO9+ hSdGzi3axfPUk43dL3p1QaQBW34XCzyYlGZ7+U/jTOsjpDabSH4P0BH9QzV6z+bmcogP Avos3oM9HB6qBx+O9hpLdielz23YcoMKQ3GEhC/gTUEc9h3Bniry2WO8aggChOcApTr2 Ef9A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:cc:to:in-reply-to:references :message-id:content-transfer-encoding:mime-version:subject:date:from :dkim-signature; bh=NUIaIDYuarjZ2xvaAjlE4GF6abjF8tFPSzm38GjGbjU=; fh=Ro0cnTVooG9MaZDVXOehdeJMAZn3oMxKdBjF/qqrBN0=; b=L4kAZAJnm6T5PpBfRCmyiuigNrb8GFbBTZ8m8jYvub8f0J42SdXQPBA+nLdWEuv6wj kxSfCYWLS/xhRsQlfklQR2U5cejjPwRyhBfIz+he3stPb1PePZI8bfPrPoAscXAkkUVU JV24ZDauFxxk7I3TNhIbV0nn+OlNIDF2BH7cVbITNuWCOoc5RAlFqgGTFZiS7KnOVb/g KB2p5Iqz2h4poVUjys8oAX2DL3TD4Kf+5aHhl9j9YARA1VzaUNwQX9aO86+HCJgrKAFQ PFQ6G8Utfc780qAne4pFUL2oukmLKXm6fU3ocBv0B6QaOuLa/sJFR2d0Bp1Diibg+MqU nNcw==; dara=google.com ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=G8x2jMmV; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org; dara=neutral header.i=@linaro.org Return-Path: Received: from phobos.denx.de (phobos.denx.de. [2a01:238:438b:c500:173d:9f52:ddab:ee01]) by mx.google.com with ESMTPS id 4fb4d7f45d1cf-5bbb2d22ad2si1388799a12.393.2024.08.08.17.50.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 08 Aug 2024 17:50:12 -0700 (PDT) Received-SPF: pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; Authentication-Results: mx.google.com; dkim=pass header.i=@linaro.org header.s=google header.b=G8x2jMmV; spf=pass (google.com: domain of u-boot-bounces@lists.denx.de designates 2a01:238:438b:c500:173d:9f52:ddab:ee01 as permitted sender) smtp.mailfrom=u-boot-bounces@lists.denx.de; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linaro.org; dara=neutral header.i=@linaro.org Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 6E6A188B63; Fri, 9 Aug 2024 02:49:04 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=linaro.org header.i=@linaro.org header.b="G8x2jMmV"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 1E92988B8B; Fri, 9 Aug 2024 02:49:01 +0200 (CEST) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2 Received: from mail-ej1-x632.google.com (mail-ej1-x632.google.com [IPv6:2a00:1450:4864:20::632]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id CF11E88B81 for ; Fri, 9 Aug 2024 02:48:58 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=linaro.org Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=caleb.connolly@linaro.org Received: by mail-ej1-x632.google.com with SMTP id a640c23a62f3a-a7ac469e4c4so251518566b.0 for ; Thu, 08 Aug 2024 17:48:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1723164538; x=1723769338; darn=lists.denx.de; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=NUIaIDYuarjZ2xvaAjlE4GF6abjF8tFPSzm38GjGbjU=; b=G8x2jMmVKM94AqLASjd7VxHrESTRRKO+QCOfaXOlvWM97Qcbqd3RiVfZpgXrKbKhYS 6u4B5vJzTKJ6wS5sDsEvRbQm942uj6eU/Y9PXwLx0ZC+KiYA8pjvT75qGIWnpR9iefUL ISaFOdf6A5fvqc8g3e73cZZTkisetl3SX+fpqBXdG1Dzmp9MJAE89Q6clGSDKAmdzwMf u1u7ee7Z2FXeWXvZqhqy0uFHuRpUpRw6/KVNJlPo2hNdGEX4SVY2l4kTrc9CzhZ3d5oh sQx8UrqmErP8MMr06aMm8ENXA32wrNRQdjrkMPS4UYqx3KoP8cRh7VYAEmfQDJRBUUFP wbtg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1723164538; x=1723769338; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=NUIaIDYuarjZ2xvaAjlE4GF6abjF8tFPSzm38GjGbjU=; b=sXtdpUq1FKBM8rlwyp3oWaYCIAbSzEEx0l3+i9GmkJpBhwXQpT2PsZbMeJ8pBsUw49 CW3ICHs0wvhzltHMNBM7Jvn2JGmgaqkKha5EXAfvtTvc3iWcZFesQ9Ns6HHB9J8we2Es 1yc5HUqGB5VbmP/zDAr4ckTh3fsENkpwzXl+4tx8qUA4D6Wxy55gq3h3qYys8njdRYLj VvUNnC8ABcqJpnH2IwHcysnEhlCA5vEH4ZSn3vZgMeam6Tiros1guse9J4c08Tx/76+D s6vp9m+DX2vOmyUATa38hS4tqD9tdnIWNYTx+8GWOKF4baxYTLqvkRHUVTs35L2Th9yX OBWQ== X-Gm-Message-State: AOJu0YxDbFuxDKxx5rIMNYL7cy+z40P8mfvoXxQ+zHHhHMa3DXPaIgTu aKfkzaWLNdC5XeP+SyEbwjngsmNSm8yqvzdxcrR9bD3iIr4gbMs1VpP/q5zDIIY= X-Received: by 2002:a17:907:8692:b0:a7c:d284:4f1d with SMTP id a640c23a62f3a-a8091fd825emr299663466b.28.1723164538202; Thu, 08 Aug 2024 17:48:58 -0700 (PDT) Received: from [192.168.0.113] ([2a02:8109:aa0d:be00::7424]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-a7dc9c0c9f5sm789811466b.50.2024.08.08.17.48.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 08 Aug 2024 17:48:57 -0700 (PDT) From: Caleb Connolly Date: Fri, 09 Aug 2024 02:48:50 +0200 Subject: [PATCH 7/7] doc: board/qualcomm: document rb3gen2 building/flashing MIME-Version: 1.0 Message-Id: <20240809-b4-rb3gen2-v1-7-7c73fe05b37a@linaro.org> References: <20240809-b4-rb3gen2-v1-0-7c73fe05b37a@linaro.org> In-Reply-To: <20240809-b4-rb3gen2-v1-0-7c73fe05b37a@linaro.org> To: Tom Rini , Lukasz Majewski , Sean Anderson , Caleb Connolly , Neil Armstrong , Sumit Garg Cc: u-boot@lists.denx.de, u-boot-qcom@groups.io X-Mailer: b4 0.14-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=2652; i=caleb.connolly@linaro.org; h=from:subject:message-id; bh=fa/zwrgeBCF/rj9hYeapEO2qsL2gMploXGaV1bqs5n0=; b=owEBbQKS/ZANAwAIAQWDMSsZX2S2AcsmYgBmtWdwDbDFcSMC7Qy6n4f8cEfUDtoAcY/uwczEQ nmSCYP8ZGeJAjMEAAEIAB0WIQS2UaFGPGq+0GkMVc0FgzErGV9ktgUCZrVncAAKCRAFgzErGV9k tmByD/9swVPZ0LryqY/GV8lk50fCIwc5XNT1gFkFGnhv6OM7sYflnpqI4+esT4FAa0J7PURDrgq exYXro0iJ8/Apf3na6hQ9yFW/7CrHdl8ZTb9rU9kpe8+DDQ43/M/MhvG9onkMTL+SCLzMGVRT1N vU6kaMekeNTTpyjuNmTk8n1zD8tJmLrXy9EaHgYLikBK8hF3cPxnebpHjvtgh9HocDqLr/ByZ0x zazk8dPBnFMEpP4OqNcZvrOLXfZWb+iCnbTkFbXLS4i1oAUcV79DDGJ+945OL7K6htX5MSa9Vpj Jd+7giiVUxEY3OmS/fFEcX6k7kl6ZB4za3GgjHslBXYvg/H8I1BGo09uBWJ3TS8PVrTpmW2cB3w cvPWoxtlBgdOASh3UKG3igf73mLtHietMgtQqxXprBRxXLzKHXUlUf+WIhlEhHc80hpuzkJ3s/8 qFlBjiBmmoVmh55ymG+bnKW+AGqmnHsEG/zIZdfXvYgecyr/4Tf3XD7R88CAmRYiUgbGV7V3ZU8 yUQEFCbUv6ZobKXQJ5A7sIxDcaqA/hHYrGst0UcqTrfsCsg8dbIN/xRoABtDwUSJwZuGGgDvlVH isXWgWAAGzmYMyGHRZ2G+65Grdob31viWVm4x2q1j1dinEqmiwxfPTwn4tD0BpCO80MHzSg4Fh2 QngBiG2M4bfTINA== X-Developer-Key: i=caleb.connolly@linaro.org; a=openpgp; fpr=83B24DA7FE145076BC38BB250CD904EB673A7C47 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.8 at phobos.denx.de X-Virus-Status: Clean The process here is almost identical to the Dragonboard 410c, we've come full circle! Signed-off-by: Caleb Connolly --- doc/board/qualcomm/rb3gen2.rst | 53 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/doc/board/qualcomm/rb3gen2.rst b/doc/board/qualcomm/rb3gen2.rst new file mode 100644 index 000000000000..4240606224f5 --- /dev/null +++ b/doc/board/qualcomm/rb3gen2.rst @@ -0,0 +1,53 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. sectionauthor:: Caleb Connolly + +Qualcomm Robotics RB3 Gen 2 +=========================== + +The RB3 Gen 2 is a development board based on the Qualcomm QCM6490 SoC (a derivative +of SC7280). More information can be found on `Qualcomm's product page`_. + +U-Boot can be used as a replacement for Qualcomm's original EDK2 bootloader by +flashing it directly to the uefi_a (or _b) partition. + +.. _Qualcomm's product page: https://www.qualcomm.com/developer/hardware/rb3-gen-2-development-kit + +Installation +------------ +First, setup ``CROSS_COMPILE`` for aarch64. Then, build U-Boot for ``qcm6490``:: + + $ export CROSS_COMPILE= + $ make qcm6490_defconfig + $ make -j8 + +This will build ``u-boot.elf`` in the configured output directory. + +Although the RB3 Gen 2 does not have secure boot set up by default, +the firmware still expects firmware ELF images to be "signed". The signature +does not provide any security in this case, but it provides the firmware with +some required metadata. + +To "sign" ``u-boot.elf`` you can use e.g. `qtestsign`_:: + + $ qtestsign -v6 aboot -o u-boot.mbn u-boot.elf + +Then install the resulting ``u-boot.mbn`` to the ``uefi_a`` partition +on your device with ``fastboot flash uefi_a u-boot.mbn``. + +U-Boot should be running after a reboot (``fastboot reboot``). + +Note that fastboot is not yet supported in U-Boot on this board, as a result, +to flash back the original firmware, or new versoins of the U-Boot, EDL mode +must be used. This can be accessed by pressing the EDL mode button as described +in the Qualcomm Linux documentation. A tool like bkerler's `edl`_ can be used +for flashing with the firehose loader binary appropriate for the board. + +.. _qtestsign: https://github.com/msm8916-mainline/qtestsign +.. _edl: https://github.com/bkerler/edl + +Usage +----- + +The USB Type-A ports are connected via a PCIe USB hub, which is not supported yet. +However, the Type-C port can be used with a powered USB dock to connect peripherals +like a USB stick.