DHCOM How to use the Update Mechanism - Revision history

Jneuhauser at 11:03, 20 February 2020

2020-02-20T11:03:30Z

← Older revision		Revision as of 13:03, 20 February 2020
Line 156:		Line 156:
	==> It is safe to turn off the system!!		==> It is safe to turn off the system!!
	~ #</nowiki>		~ #</nowiki>

			= Troubleshooting =

			<pre style="color: red">TODO: Add common errors and mistakes</pre>

Jneuhauser: Add update target system

2020-02-20T10:59:33Z

Add update target system

← Older revision		Revision as of 12:59, 20 February 2020
Line 100:		Line 100:
	* Make sure that the update files are located in the root directory of your prepared USB stick.		* Make sure that the update files are located in the root directory of your prepared USB stick.
	:[[File:How_to_update_mechanism-windows_extract_files_3.JPG\|500px]]		:[[File:How_to_update_mechanism-windows_extract_files_3.JPG\|500px]]

			= Update target system =

			# Insert the prepared USB stick into a USB port of the baseboard
			# Switch on or restart the device to start the update from USB stick automatically from the bootloader <br>Note: If the update doesn´t start automatically, execute <code>update auto</code> from the bootloader shell
			# Wait until the update has been applied successfully

			'''If the update was started successfully, the serial console output should look like:'''
			<nowiki>
			U-Boot 2015.10 (Jun 27 2017 - 10:01:06 +0200)

			DH version 1.1.0.6

			CPU: Freescale i.MX6SOLO rev1.1 at 792 MHz
			Reset cause: POR
			Board: DHCOM i.MX6
			DRAM: 512 MiB
			I2C: ready
			MMC: FSL_SDHC: 0, FSL_SDHC: 1, FSL_SDHC: 2
			Load DH settings...
			44 bytes read in 81 ms (0 Bytes/s)
			Info: Can't load DH settings file from eeprom
			1152054 bytes read in 240 ms (4.6 MiB/s)
			Unable to allocate framebuffer memory
			In: serial
			Out: serial
			Err: serial
			Net: FEC [PRIME]
			Press DEL to abort autoboot in 0 seconds

			--> Update INFO: No MMC/SD - Card detected!
			--> Update: Try to initialize USB Stick on Host Port:starting USB...
			USB0: Port not available.
			USB1: USB EHCI 1.00
			scanning bus 1 for devices... 3 USB Device(s) found
			scanning usb for storage devices... 1 Storage Device(s) found
			scanning usb for ethernet devices... 0 Ethernet Device(s) found
			reading DHupdate.ini
			180 bytes read in 18 ms (9.8 KiB/s)

			--> Update: found DHupdate.ini (180 bytes)

			==> Update: Start to Load Update Kernel
			reading zImage_imx6s-dhcom4.update
			8975788 bytes read in 288 ms (29.7 MiB/s)
			Kernel image @ 0x12000000 [ 0x000000 - 0x886b50 ]

			Starting kernel ...
			...</nowiki>

			'''If the update was successful, the output should look like:'''
			<nowiki>
			...
			==> Update executed successful ...
			==> It is safe to turn off the system!!
			~ #</nowiki>

Jneuhauser: Add extract file on linux

2019-11-11T15:57:08Z

Add extract file on linux

← Older revision		Revision as of 17:57, 11 November 2019
Line 84:		Line 84:

	== Linux ==		== Linux ==

			* Open the '''''Extract to''''' dialog by right-clicking on the downloaded update zip file.
			:[[File:How_to_update_mechanism-linux_extract_files_1.JPG\|500px]]
			* Select the the prepared USB flash drive as the destination.
			:[[File:How_to_update_mechanism-linux_extract_files_2.JPG\|500px]]
			* Make sure that the update files are located in the root directory of your prepared USB stick.
			:[[File:How_to_update_mechanism-linux_extract_files_3.JPG\|500px]]

	== Windows ==		== Windows ==

Jneuhauser: Add extract file on windows

2019-11-11T15:37:14Z

Add extract file on windows

← Older revision		Revision as of 17:37, 11 November 2019
Line 82:		Line 82:

	= Place Update Files on the USB stick =		= Place Update Files on the USB stick =

			== Linux ==

			== Windows ==

			* Open the '''''Extract All''''' dialog by right-clicking on the downloaded update zip file.
			:[[File:How_to_update_mechanism-windows_extract_files_1.JPG\|500px]]
			* Select the root directory of the prepared USB flash drive as the destination.
			:[[File:How_to_update_mechanism-windows_extract_files_2.JPG\|500px]]
			* Make sure that the update files are located in the root directory of your prepared USB stick.
			:[[File:How_to_update_mechanism-windows_extract_files_3.JPG\|500px]]

Jneuhauser at 14:25, 23 October 2019

2019-10-23T14:25:40Z

← Older revision		Revision as of 16:25, 23 October 2019
Line 78:		Line 78:
	* Create a new partition with '''''New Simple Partition''''' in the right-click menu of the unallocated space.		* Create a new partition with '''''New Simple Partition''''' in the right-click menu of the unallocated space.
	:[[File:Windows_disk_mgmt_new_partition.JPG\|500px]]		:[[File:Windows_disk_mgmt_new_partition.JPG\|500px]]
	* Use all defaults in the wizard, except in the Format Partition step, choose <span style="color: orange;">File system: FAT32</span>.		* Use all defaults in the wizard, except in the '''''Format Partition''''' step, choose <span style="color: orange;">File system: FAT32</span>.
	:[[File:Windows_disk_mgmt_fat32_partition.JPG\|500px]]		:[[File:Windows_disk_mgmt_fat32_partition.JPG\|500px]]

	= Place Update Files on the USB stick =		= Place Update Files on the USB stick =

Jneuhauser at 14:21, 23 October 2019

2019-10-23T14:21:26Z

← Older revision		Revision as of 16:21, 23 October 2019
Line 12:		Line 12:
	= Prepare a USB stick for the Update Mechanism =		= Prepare a USB stick for the Update Mechanism =

	The bootloader update mechanism expects a single FAT32 partition on a storage device such as a USB stick or SD card.		The bootloader update mechanism expects a single FAT32 partition on a removable storage device such as a USB stick or SD card.

	Make the ~~USB stick~~ available in your system by connecting it to your computer. If you work with a virtual machine, then connect the newly connected ~~USB stick~~ to your virtual machine.		Make the removable device available in your system by connecting it to your computer. If you work with a virtual machine, then connect the newly connected device to your virtual machine.

	== Linux ==		== Linux ==

Jneuhauser at 14:20, 23 October 2019

2019-10-23T14:20:28Z

← Older revision		Revision as of 16:20, 23 October 2019
Line 10:		Line 10:
	* Baseboard with USB port like [https://www.dh-electronics.com/produkte/dhsom-system-on-modules/dh-pdk2 PDK2] / [https://www.dh-electronics.com/produkte/dhsom-system-on-modules/dh-picoitx2 picoITX2] / [https://www.dh-electronics.com/produkte/dhcon-controls-connectivity/dhcon-drc02 DRC02]		* Baseboard with USB port like [https://www.dh-electronics.com/produkte/dhsom-system-on-modules/dh-pdk2 PDK2] / [https://www.dh-electronics.com/produkte/dhsom-system-on-modules/dh-picoitx2 picoITX2] / [https://www.dh-electronics.com/produkte/dhcon-controls-connectivity/dhcon-drc02 DRC02]

	= Prepare a USB stick ~~or SD card~~ for the ~~update process~~ =		= Prepare a USB stick for the Update Mechanism =

	The bootloader update mechanism expects a single FAT32 partition on a storage device such as a USB stick or SD card.		The bootloader update mechanism expects a single FAT32 partition on a storage device such as a USB stick or SD card.

Jneuhauser at 14:17, 23 October 2019

2019-10-23T14:17:23Z

Jneuhauser at 13:48, 23 October 2019

2019-10-23T13:48:11Z

← Older revision		Revision as of 15:48, 23 October 2019
Line 72:		Line 72:
	<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>		<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>
	* Create a empty dos partition table with '''''Create Partition Table''''' in the '''''Device''''' menu and ensure you select <span style="color: orange;">msdos</span> as type.		* Create a empty dos partition table with '''''Create Partition Table''''' in the '''''Device''''' menu and ensure you select <span style="color: orange;">msdos</span> as type.
	:[[File:~~Gparted_create_partition_table~~.JPG\|500px]]		:[[File:Windows_disk_mgmt_delete_partition.JPG\|500px]]

	=== Create FAT32 partition ===		=== Create FAT32 partition ===
	<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>		<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>
	* Create a empty dos partition table with '''''Create Partition Table''''' in the '''''Device''''' menu and ensure you select <span style="color: orange;">msdos</span> as type.		* Create a empty dos partition table with '''''Create Partition Table''''' in the '''''Device''''' menu and ensure you select <span style="color: orange;">msdos</span> as type.
	:[[File:~~Gparted_create_partition_table~~.JPG\|500px]]		:[[File:Windows_disk_mgmt_new_partition.JPG\|500px]]
			:[[File:Windows_disk_mgmt_fat32_partition.JPG\|500px]]

	= Place Update Files on the USB stick =		= Place Update Files on the USB stick =

Jneuhauser at 13:36, 23 October 2019

2019-10-23T13:36:07Z

← Older revision		Revision as of 15:36, 23 October 2019
Line 66:		Line 66:
	:[[File:Windows_disk_mgmt_partition_properties.JPG\|500px]]		:[[File:Windows_disk_mgmt_partition_properties.JPG\|500px]]
	:[[File:Windows_disk_mgmt_check_format_type.JPG\|500px]]		:[[File:Windows_disk_mgmt_check_format_type.JPG\|500px]]
			: If you don´t see <span style="color: orange;">File system: FAT32</span> continue at [[#Remove existing partitions]]
			* Congratulations your USB stick is already prepared for the Update Mechanism and you can head over to [[#Place Update Files on the USB stick]]

	=== Remove existing partitions ===		=== Remove existing partitions ===

← Older revision		Revision as of 16:17, 23 October 2019
Line 21:		Line 21:

	=== Open GParted and select device ===		=== Open GParted and select device ===
	* Open the disk utility '''GParted'''		* Open the disk utility '''GParted'''.
	: <span style="color: gray;">Note: You will be asked for your user password to gain super user right through sudo.</span>		: <span style="color: gray;">Note: You will be asked for your user password to gain super user right through sudo.</span>
	* Choose your device in the drop down menu right at the top of the user interface		* Choose your device in the drop down menu right at the top of the user interface.
	:[[File:Gparted_select_device.JPG\|500px]]		:[[File:Gparted_select_device.JPG\|500px]]
	: <span style="color: red;">Warning: Be sure that you have selected the correct device for the following steps.</span>		: <span style="color: red;">Warning: Be sure that you have selected the correct device for the following steps.</span>
Line 30:		Line 30:
	* Verify that you already have a DOS partition table and that the first partition is formatted as FAT32 by selecting '''''Device Information''''' in the '''''View''''' menu		* Verify that you already have a DOS partition table and that the first partition is formatted as FAT32 by selecting '''''Device Information''''' in the '''''View''''' menu
	:[[File:Gparted_show_device_info.JPG\|500px]]		:[[File:Gparted_show_device_info.JPG\|500px]]
	* If you see <span style="color: orange;">Partition table: msdos</span> and <span style="color: orange;">File System: fat32</span> your USB stick is already prepared for the Update Mechanism and you can head over to [[#Place Update Files on the USB stick]]		* If you see <span style="color: orange;">Partition table: msdos</span> and <span style="color: orange;">File System: fat32</span> your USB stick is already prepared for the Update Mechanism and you can head over to [[#Place Update Files on the USB stick]].
	* If you only see <span style="color: orange;">Partition table: msdos</span> head over to [[#Create FAT32 formatted partition]]		* If you only see <span style="color: orange;">Partition table: msdos</span> head over to [[#Create FAT32 formatted partition]].
	* And if you don´t see anything like in the picture follow the next steps		* And if you don´t see anything like in the picture follow the next steps.

	=== Create DOS partition table ===		=== Create DOS partition table ===
Line 41:		Line 41:
	=== Create FAT32 formatted partition ===		=== Create FAT32 formatted partition ===
	<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>		<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>
	* Remove any existing partition by selecting them and choosing '''''Delete''''' in '''''Partition''''' menu		* Remove any existing partition by selecting them and choosing '''''Delete''''' in '''''Partition''''' menu.
	* Create a FAT32 formatted partition with '''''New''''' in the '''''Partition''''' menu and ensure you select <span style="color: orange;">File system: fat32</span>.		* Create a FAT32 formatted partition with '''''New''''' in the '''''Partition''''' menu and ensure you select <span style="color: orange;">File system: fat32</span>.
	:[[File:Gparted_create_partition.JPG\|500px]]		:[[File:Gparted_create_partition.JPG\|500px]]
	* Apply all operations to write changes to disk		* Apply all operations to write changes to disk.
	:[[File:Gparted_apply_operations.JPG\|500px]]		:[[File:Gparted_apply_operations.JPG\|500px]]

Line 58:		Line 58:

	=== Check current partition table and partition format ===		=== Check current partition table and partition format ===
	* Open the dialog '''''Properties''''' with a right-click on the device		* Open the dialog '''''Properties''''' with a right-click on the device.
	:[[File:Windows_disk_mgmt_check_properties.JPG\|500px]]		:[[File:Windows_disk_mgmt_check_properties.JPG\|500px]]
	* Check for <span style="color: orange;">Partition style: Master Boot Record (MBR)</span> in the '''''Volumes''''' tab		* Check for <span style="color: orange;">Partition style: Master Boot Record (MBR)</span> in the '''''Volumes''''' tab.
	:[[File:Windows_disk_mgmt_check_partition_type.JPG\|500px]]		:[[File:Windows_disk_mgmt_check_partition_type.JPG\|500px]]
	: If you don´t see <span style="color: orange;">Partition style: Master Boot Record (MBR)</span> follow [https://docs.microsoft.com/en-us/windows-server/storage/disk-management/change-a-gpt-disk-into-an-mbr-disk#converting-using-a-command-line Convert to MBR using a command line] and continue with [[#Create FAT32 partition]] afterwards		: If you don´t see <span style="color: orange;">Partition style: Master Boot Record (MBR)</span> follow [https://docs.microsoft.com/en-us/windows-server/storage/disk-management/change-a-gpt-disk-into-an-mbr-disk#converting-using-a-command-line Convert to MBR using a command line] and continue with [[#Create FAT32 partition]] afterwards.
	* Check for <span style="color: orange;">File system: FAT32</span> in the '''''General''''' tab of the '''''Properties''''' windows of the '''''Volume'''''		* Check for <span style="color: orange;">File system: FAT32</span> in the '''''General''''' tab of the '''''Properties''''' windows of the '''''Volume'''''.
	:[[File:Windows_disk_mgmt_partition_properties.JPG\|500px]]		:[[File:Windows_disk_mgmt_partition_properties.JPG\|500px]]
	:[[File:Windows_disk_mgmt_check_format_type.JPG\|500px]]		:[[File:Windows_disk_mgmt_check_format_type.JPG\|500px]]
	: If you don´t see <span style="color: orange;">File system: FAT32</span> continue at [[#Remove existing partitions]]		: If you don´t see <span style="color: orange;">File system: FAT32</span> continue at [[#Remove existing partitions]].
	* Congratulations your USB stick is already prepared for the Update Mechanism and you can head over to [[#Place Update Files on the USB stick]]		* Congratulations your USB stick is already prepared for the Update Mechanism and you can head over to [[#Place Update Files on the USB stick]].

	=== Remove existing partitions ===		=== Remove existing partitions ===
	<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>		<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>
	* ~~Create a empty dos partition table with~~ '''''~~Create Partition Table~~''''' in the ~~'''''Device'''''~~ menu ~~and ensure you select <span style="color: orange;">msdos</span> as type~~.		* Select '''''Delete Volume''''' in the right-click menu to delete the existing partition on the device.
	:[[File:Windows_disk_mgmt_delete_partition.JPG\|500px]]		:[[File:Windows_disk_mgmt_delete_partition.JPG\|500px]]

	=== Create FAT32 partition ===		=== Create FAT32 partition ===
	<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>		<span style="color: red;">Warning: The following steps will cause data loss on the selected device!</span>
	* Create a ~~empty dos~~ partition ~~table~~ with '''''~~Create~~ Partition ~~Table~~''''' in the ~~'''''Device'''''~~ menu ~~and ensure you select <span style="color: orange;">msdos</span> as type~~.		* Create a new partition with '''''New Simple Partition''''' in the right-click menu of the unallocated space.
	:[[File:Windows_disk_mgmt_new_partition.JPG\|500px]]		:[[File:Windows_disk_mgmt_new_partition.JPG\|500px]]
			* Use all defaults in the wizard, except in the Format Partition step, choose <span style="color: orange;">File system: FAT32</span>.
	:[[File:Windows_disk_mgmt_fat32_partition.JPG\|500px]]		:[[File:Windows_disk_mgmt_fat32_partition.JPG\|500px]]

	= Place Update Files on the USB stick =		= Place Update Files on the USB stick =