From 79b1757276a189f0b898903f5d85658e0b5c478a Mon Sep 17 00:00:00 2001 From: Alexandru Costache Date: Thu, 5 Dec 2024 11:59:50 +0200 Subject: [PATCH 1/4] contracts/hw.device-type: Update instructions for Orin flasher types Change-type: patch Signed-off-by: Alexandru Costache --- .../jetson-agx-orin-devkit-64gb/contract.json | 12 ++++++++---- .../jetson-orin-nano-devkit-nvme/contract.json | 10 ++++++---- .../jetson-orin-nano-seeed-j3010/contract.json | 10 ++++++---- .../jetson-orin-nx-seeed-j4012/contract.json | 10 ++++++---- 4 files changed, 26 insertions(+), 16 deletions(-) diff --git a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json index f6e8d5a9..b851d16d 100644 --- a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json +++ b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json @@ -28,12 +28,16 @@ "is_private": false }, "partials": { + "instructions": [ + "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "Connect a keyboard and a display to your {{name}}. These will be used for selecting the boot media in the UEFI firmware menu.", + "Use the form on the left to configure and download balenaOS for your new device." + ], "bootDeviceExternal": [ - "Put the device in force recovery mode.", - "Connect the USB-C data port of the Devkit to the Host PC.", - "Boot the device from the inserted USB Key by following the AGX Orin Devkit 64GB flashing steps." + "Power on the ${{name}} and interrupt booting by pressing the 'Esc' key when prompted by the UEFI firmware.", + "Enter the Boot Manager Menu of the UEFI firmware and select the attached USB key as boot media. This will trigger the provisioning process." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Power up the {{name}}"] + "bootDevice": ["Power up the {{name}}. A progress bar will show up on the display while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json b/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json index bb99f37b..65aa67c4 100644 --- a/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json +++ b/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json @@ -28,12 +28,14 @@ "is_private": false }, "partials": { + "instructions": [ + "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "Use the form on the left to configure and download balenaOS for your new device." + ], "bootDeviceExternal": [ - "Insert a NVME drive in the carrier board and put the device in force recovery mode.", - "Connect the USB-C port of the carrier board to the Host PC.", - "RCM boot the balenaOS kernel following the Orin Nano Flashing steps." + "Insert a NVME drive in the Devkit and power up the {{name}}." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Remove recovery mode jumper and power up the {{name}}"] + "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json b/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json index a0693de0..07993f91 100644 --- a/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json +++ b/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json @@ -28,12 +28,14 @@ "is_private": false }, "partials": { + "instructions": [ + "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "Use the form on the left to configure and download balenaOS for your new device." + ], "bootDeviceExternal": [ - "Put the device in force recovery mode.", - "Connect the USB-C port of the carrier board to the Host PC.", - "RCM boot the balenaOS kernel following the Seeed reComputer J3010 Flashing steps." + "Insert a NVME drive in the Devkit and power up the {{name}}" ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Remove recovery mode jumper and power up the {{name}}"] + "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json b/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json index 98546cdb..12fb6221 100644 --- a/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json +++ b/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json @@ -28,12 +28,14 @@ "is_private": false }, "partials": { + "instructions": [ + "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "Use the form on the left to configure and download balenaOS for your new device." + ], "bootDeviceExternal": [ - "Put the device in force recovery mode.", - "Connect the USB-C port of the carrier board to the Host PC.", - "RCM boot the balenaOS kernel following the Seeed reComputer J4012 Flashing steps." + "Insert a NVME drive in the Devkit and power up the {{name}}." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Remove recovery mode jumper and power up the {{name}}"] + "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] } } From bc18b77e16fc1f9a8ef17e42a5b6ee9f9bf05d4e Mon Sep 17 00:00:00 2001 From: Alexandru Costache Date: Thu, 5 Dec 2024 15:02:33 +0200 Subject: [PATCH 2/4] hw.device-type: Mention v6.1.16 as cut-off version for direct provisioning Signed-off-by: Alexandru Costache --- .../hw.device-type/jetson-agx-orin-devkit-64gb/contract.json | 3 ++- .../hw.device-type/jetson-orin-nano-devkit-nvme/contract.json | 3 ++- .../hw.device-type/jetson-orin-nano-seeed-j3010/contract.json | 3 ++- .../hw.device-type/jetson-orin-nx-seeed-j4012/contract.json | 3 ++- 4 files changed, 8 insertions(+), 4 deletions(-) diff --git a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json index b851d16d..39e83823 100644 --- a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json +++ b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json @@ -29,7 +29,8 @@ }, "partials": { "instructions": [ - "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", "Connect a keyboard and a display to your {{name}}. These will be used for selecting the boot media in the UEFI firmware menu.", "Use the form on the left to configure and download balenaOS for your new device." ], diff --git a/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json b/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json index 65aa67c4..d1cda054 100644 --- a/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json +++ b/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json @@ -29,7 +29,8 @@ }, "partials": { "instructions": [ - "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", "Use the form on the left to configure and download balenaOS for your new device." ], "bootDeviceExternal": [ diff --git a/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json b/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json index 07993f91..3fe975d0 100644 --- a/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json +++ b/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json @@ -29,7 +29,8 @@ }, "partials": { "instructions": [ - "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", "Use the form on the left to configure and download balenaOS for your new device." ], "bootDeviceExternal": [ diff --git a/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json b/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json index 12fb6221..b4dd1e89 100644 --- a/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json +++ b/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json @@ -29,7 +29,8 @@ }, "partials": { "instructions": [ - "Ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", "Use the form on the left to configure and download balenaOS for your new device." ], "bootDeviceExternal": [ From e28d75c6cf04d37c472b374a87f500903c42e904 Mon Sep 17 00:00:00 2001 From: Alexandru Costache Date: Sat, 7 Dec 2024 11:04:14 +0200 Subject: [PATCH 3/4] hw.device-type/jetson-agx-orin-devkit-64gb: Clarify when manual boot media selection is needed Signed-off-by: Alexandru Costache --- .../hw.device-type/jetson-agx-orin-devkit-64gb/contract.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json index 39e83823..860132e1 100644 --- a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json +++ b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json @@ -31,11 +31,10 @@ "instructions": [ "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", - "Connect a keyboard and a display to your {{name}}. These will be used for selecting the boot media in the UEFI firmware menu.", "Use the form on the left to configure and download balenaOS for your new device." ], "bootDeviceExternal": [ - "Power on the ${{name}} and interrupt booting by pressing the 'Esc' key when prompted by the UEFI firmware.", + "NOTE: Only If your device is already flashed with a balenaOS version older than v6.1.16, power it on and interrupt booting by pressing the 'Esc' key when prompted by the UEFI firmware.", "Enter the Boot Manager Menu of the UEFI firmware and select the attached USB key as boot media. This will trigger the provisioning process." ], "flashIndicator": ["power LED is off"], From ec076bf598d331edd2931a360fcd544921a687b2 Mon Sep 17 00:00:00 2001 From: Alexandru Costache Date: Fri, 13 Dec 2024 17:02:35 +0200 Subject: [PATCH 4/4] Reword provisioning instructions Signed-off-by: Alexandru Costache --- .../jetson-agx-orin-devkit-64gb/contract.json | 11 +++++------ .../jetson-orin-nano-devkit-nvme/contract.json | 9 ++++----- .../jetson-orin-nano-seeed-j3010/contract.json | 9 ++++----- .../jetson-orin-nx-seeed-j4012/contract.json | 9 ++++----- .../jetson-orin-nx-xavier-nx-devkit/contract.json | 10 ++++++---- 5 files changed, 23 insertions(+), 25 deletions(-) diff --git a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json index 860132e1..36cb4ecd 100644 --- a/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json +++ b/contracts/hw.device-type/jetson-agx-orin-devkit-64gb/contract.json @@ -29,15 +29,14 @@ }, "partials": { "instructions": [ - "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", - "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", - "Use the form on the left to configure and download balenaOS for your new device." + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Check and update the firmware version before proceeding.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide." ], "bootDeviceExternal": [ - "NOTE: Only If your device is already flashed with a balenaOS version older than v6.1.16, power it on and interrupt booting by pressing the 'Esc' key when prompted by the UEFI firmware.", - "Enter the Boot Manager Menu of the UEFI firmware and select the attached USB key as boot media. This will trigger the provisioning process." + "Power on the {{name}}.", + "NOTE: Only If your device is already flashed with a balenaOS version older than v6.1.16, power it on and interrupt booting by pressing the 'Esc' key when prompted by the UEFI firmware. Enter the Boot Manager Menu of the UEFI firmware and select the attached USB key as boot media, to trigger the provisioning process." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Power up the {{name}}. A progress bar will show up on the display while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] + "bootDevice": ["Power up the {{name}}. A progress bar will show up on the display while the UEFI firmware is updated. Please do not interrupt this process by turning off power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json b/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json index d1cda054..0305d9a2 100644 --- a/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json +++ b/contracts/hw.device-type/jetson-orin-nano-devkit-nvme/contract.json @@ -28,15 +28,14 @@ "is_private": false }, "partials": { - "instructions": [ - "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", - "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", - "Use the form on the left to configure and download balenaOS for your new device." + "instructions": [ + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Check and update the firmware version before proceeding.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide." ], "bootDeviceExternal": [ "Insert a NVME drive in the Devkit and power up the {{name}}." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] + "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by turning off power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json b/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json index 3fe975d0..058f2e89 100644 --- a/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json +++ b/contracts/hw.device-type/jetson-orin-nano-seeed-j3010/contract.json @@ -28,15 +28,14 @@ "is_private": false }, "partials": { - "instructions": [ - "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", - "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", - "Use the form on the left to configure and download balenaOS for your new device." + "instructions": [ + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Check and update the firmware version before proceeding.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide." ], "bootDeviceExternal": [ "Insert a NVME drive in the Devkit and power up the {{name}}" ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] + "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by turning off power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json b/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json index b4dd1e89..0d14fb85 100644 --- a/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json +++ b/contracts/hw.device-type/jetson-orin-nx-seeed-j4012/contract.json @@ -28,15 +28,14 @@ "is_private": false }, "partials": { - "instructions": [ - "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Click here for details on how to check or update your firmware version.", - "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide.", - "Use the form on the left to configure and download balenaOS for your new device." + "instructions": [ + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Check and update the firmware version before proceeding.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide." ], "bootDeviceExternal": [ "Insert a NVME drive in the Devkit and power up the {{name}}." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by cutting power or rebooting the device."] + "bootDevice": ["Power up the {{name}}. If you have a display or a debug UART cable connected to the device, a progress bar will show up while the UEFI firmware is updated. Please do not interrupt this process by turning off power or rebooting the device."] } } diff --git a/contracts/hw.device-type/jetson-orin-nx-xavier-nx-devkit/contract.json b/contracts/hw.device-type/jetson-orin-nx-xavier-nx-devkit/contract.json index fead8fb0..e02f05b3 100644 --- a/contracts/hw.device-type/jetson-orin-nx-xavier-nx-devkit/contract.json +++ b/contracts/hw.device-type/jetson-orin-nx-xavier-nx-devkit/contract.json @@ -28,12 +28,14 @@ "is_private": false }, "partials": { + "instructions": [ + "For balenaOS versions v6.1.16 and newer, please ensure your device is running UEFI firmware version 36.3. Check and update the firmware version before proceeding.", + "For balenaOS versions older than v6.1.16, please refer to the {{name}} legacy flashing guide." + ], "bootDeviceExternal": [ - "Insert a NVME drive in the carrier board and put the device in force recovery mode.", - "Connect the micro-USB port of the carrier board to the Host PC.", - "RCM boot the balenaOS kernel following the Orin NX Flashing steps." + "Insert a NVME drive in the Devkit and power up the {{name}}." ], "flashIndicator": ["power LED is off"], - "bootDevice": ["Remove recovery mode jumper and power up the {{name}}"] + "bootDevice": ["Power up the {{name}}. A progress bar will show up on the display while the UEFI firmware is updated. Please do not interrupt this process by turning off power or rebooting the device."] } }