Debian on APF - Revision history

JulienB: /* Copying the filesystem on the APF */

2025-01-17T10:50:27Z

Copying the filesystem on the APF

← Older revision		Revision as of 12:50, 17 January 2025
Line 116:		Line 116:
	* To generate a .ext4 image from the ''rootfs/'' directory:		* To generate a .ext4 image from the ''rootfs/'' directory:
	<pre class="host">		<pre class="host">
			# $ARMADEUS_BSP_PATH/buildroot/output/host/usr/sbin/mkfs.ext4 -d ./rootfs/ -r 1 -N 0 -m 5 -L "rootfs" -I 256 -O ^64bit,^metadata_csum,uninit_bg opos_debian_bookworm_rootfs.ext4 384M

	# PATH=$PATH:$ARMADEUS_BSP_PATH/buildroot/output/host/usr/bin/:$ARMADEUS_BSP_PATH/buildroot/output/host/usr/sbin/ \		# PATH=$PATH:$ARMADEUS_BSP_PATH/buildroot/output/host/usr/bin/:$ARMADEUS_BSP_PATH/buildroot/output/host/usr/sbin/ \
	mke2img -G 4 -R 1 -d ./rootfs/ -o apf_debian_jessie_rootfs.ext4		mke2img -G 4 -R 1 -d ./rootfs/ -o apf_debian_jessie_rootfs.ext4

JulienB at 17:23, 16 January 2025

2025-01-16T17:23:50Z

← Older revision		Revision as of 19:23, 16 January 2025
Line 44:		Line 44:
	* Let's run the first step. That one consists in downloading all the deb packages and unpacking the files, but without running the scripts :		* Let's run the first step. That one consists in downloading all the deb packages and unpacking the files, but without running the scripts :
	<pre class="host">		<pre class="host">
	# debootstrap --foreign --arch=armel ~~jessie~~ rootfs http://ftp.debian.org/debian		# debootstrap --foreign --arch=armel bookworm rootfs http://ftp.debian.org/debian
	</pre>		</pre>
	* The ''--foreign'' option makes debootstrap stop right after unpacking.		* The ''--foreign'' option makes debootstrap stop right after unpacking.
Line 76:		Line 76:
	</pre>		</pre>

	* ~~The~~ debian mirror also has to be specified in the APT configuration, in order to install new debian packages later :		* 'If not already done', the debian mirror also has to be specified in the APT configuration, in order to install new debian packages later :
	<pre class="host">		<pre class="host">
	# echo 'deb http://ftp.debian.org/debian ~~jessie~~ main' > rootfs/etc/apt/sources.list		# echo 'deb http://ftp.debian.org/debian bookworm main' > rootfs/etc/apt/sources.list
	</pre>		</pre>

Line 96:		Line 96:
	* Copy kernel image and modules:		* Copy kernel image and modules:
	<pre class="host">		<pre class="host">
	# export ~~YOUR_BSP_PATH~~=your_armadeus_bsp_path		# export ARMADEUS_BSP_PATH=your_armadeus_bsp_path
	# cp -r ${~~YOUR_BSP_PATH~~}/buildroot/output/target/boot rootfs/		# cp -r ${ARMADEUS_BSP_PATH}/buildroot/output/target/boot rootfs/
	# cp -r ${~~YOUR_BSP_PATH~~}/buildroot/output/target/lib/modules rootfs/lib/		# cp -r ${ARMADEUS_BSP_PATH}/buildroot/output/target/lib/modules rootfs/lib/
	</pre>		</pre>
	* Finally we can clean the APT cache (we no longer need the deb files, and that will save quite some disk space):		* Finally we can clean the APT cache (we no longer need the deb files, and that will save quite some disk space):
Line 112:		Line 112:
	* To finalize installation you will need ''resize2fs'' tool (recent version of Armadeus BSP), so copy it to Debian rootfs (Armadeus binaries for [[APF6]]/[[OPOS6UL]] are compatible with Debian armhf port):		* To finalize installation you will need ''resize2fs'' tool (recent version of Armadeus BSP), so copy it to Debian rootfs (Armadeus binaries for [[APF6]]/[[OPOS6UL]] are compatible with Debian armhf port):
	<pre class="host">		<pre class="host">
	~~# YOUR_BSP_PATH=your_armadeus_bsp_path~~		# cp $ARMADEUS_BSP_PATH/buildroot/output/target/sbin/resize2fs rootfs/sbin/
	# cp $~~YOUR_BSP_PATH~~/buildroot/output/target/sbin/resize2fs rootfs/sbin/
	</pre>		</pre>
	* To generate a .ext4 image from the ''rootfs/'' directory:		* To generate a .ext4 image from the ''rootfs/'' directory:
	<pre class="host">		<pre class="host">
	~~# YOUR_BSP_PATH=your_armadeus_bsp_path~~		# PATH=$PATH:$ARMADEUS_BSP_PATH/buildroot/output/host/usr/bin/:$ARMADEUS_BSP_PATH/buildroot/output/host/usr/sbin/ \
	# PATH=$PATH:$~~YOUR_BSP_PATH~~/buildroot/output/host/usr/bin/:$~~YOUR_BSP_PATH~~/buildroot/output/host/usr/sbin/ \
	mke2img -G 4 -R 1 -d ./rootfs/ -o apf_debian_jessie_rootfs.ext4		mke2img -G 4 -R 1 -d ./rootfs/ -o apf_debian_jessie_rootfs.ext4
	# cp apf_debian_jessie_rootfs.ext4 /tftpboot/XXX-rootfs.ext4 (where XXX is the name of your module)		# cp apf_debian_jessie_rootfs.ext4 /tftpboot/XXX-rootfs.ext4 (where XXX is the name of your module)

JulienB: /* Requirements */

2025-01-16T17:03:51Z

Requirements

← Older revision		Revision as of 19:03, 16 January 2025
Line 2:		Line 2:

	==Requirements==		==Requirements==
	* an APF ~~board~~ (with corresponding docking board)		* an APF/OPOS SOM (with corresponding docking/devt board)
	* a development PC running linux		* a development PC running linux
	* the debootstrap program installed on the development PC		* the debootstrap program installed on the development PC

JulienB: /* 1] Overwriting default rootfs on Flash (APF6/OPOS6UL) */

2019-10-08T16:23:09Z

1] Overwriting default rootfs on Flash (APF6/OPOS6UL)

← Older revision		Revision as of 18:23, 8 October 2019
Line 113:		Line 113:
	<pre class="host">		<pre class="host">
	# YOUR_BSP_PATH=your_armadeus_bsp_path		# YOUR_BSP_PATH=your_armadeus_bsp_path
	# cp $YOUR_BSP_PATH/buildroot/output/target~~/usr~~/sbin/resize2fs rootfs~~/usr~~/sbin/		# cp $YOUR_BSP_PATH/buildroot/output/target/sbin/resize2fs rootfs/sbin/
	</pre>		</pre>
	* To generate a .ext4 image from the ''rootfs/'' directory:		* To generate a .ext4 image from the ''rootfs/'' directory:

JulienB: /* 1] Overwriting default rootfs on Flash (APF6/OPOS6UL) */

2019-10-08T16:21:02Z

1] Overwriting default rootfs on Flash (APF6/OPOS6UL)

← Older revision		Revision as of 18:21, 8 October 2019
Line 127:		Line 127:
	BIOS> run update_rootfs		BIOS> run update_rootfs
	</pre>		</pre>
	* If the rootfs image is too big for your ~~module~~ RAM, you can also use [[U-Boot_UMS_on_APF_%26_OPOS\|UMS]] USB mode of U-Boot to flash this image.		* If the rootfs image is too big for your SoM RAM size, you can also use [[U-Boot_UMS_on_APF_%26_OPOS\|UMS]] USB mode of U-Boot to flash this image.
			* Congratulations, you can go to [[Debian_on_APF#First_login\|first login]]

	===2] Using Debian on Flash while keeping default rootfs (APF6/APF51)===		===2] Using Debian on Flash while keeping default rootfs (APF6/APF51)===

JulienB: /* Tweaking the filesystem */

2019-10-08T16:13:54Z

Tweaking the filesystem

← Older revision		Revision as of 18:13, 8 October 2019
Line 70:		Line 70:
	==Tweaking the filesystem==		==Tweaking the filesystem==

	* After the ~~filesystem~~ has been generated by debootstrap, some adjustments need to be done.		* After the file system has been generated by debootstrap, some adjustments need to be done.
	* First, we need to have debian run a getty on the console serial port (replace ''ttyXXX'' with ''ttymxc2'' on [[APF51]], ''ttySMX0'' on [[APF27]], ''ttymxc3'' on [[APF6]], ''ttymxc0'' on [[OPOS6UL]]), otherwise no login prompt will be available on the console port :		* First, we need to have debian run a getty on the console serial port (replace ''ttyXXX'' with ''ttymxc2'' on [[APF51]], ''ttySMX0'' on [[APF27]], ''ttymxc3'' on [[APF6]], ''ttymxc0'' on [[OPOS6UL]]), otherwise no login prompt will be available on the console port :
	<pre class="host">		<pre class="host">
Line 81:		Line 81:
	</pre>		</pre>

	* The hostname of the debian system has to be set properly (here ''~~apf51~~'', change it accordingly to your board):		* The hostname of the debian system has to be set properly (here ''apf6'', change it accordingly to your board):
	<pre class="host">		<pre class="host">
	# echo '~~apf51~~' > rootfs/etc/hostname		# echo 'apf6' > rootfs/etc/hostname
	# echo '127.0.1.1 ~~apf51~~' >> rootfs/etc/hosts		# echo '127.0.1.1 apf6' >> rootfs/etc/hosts
	</pre>		</pre>
	* Remove root password (for first login):		* Remove root password (for first login):
Line 96:		Line 96:
	* Copy kernel image and modules:		* Copy kernel image and modules:
	<pre class="host">		<pre class="host">
	# YOUR_BSP_PATH=your_armadeus_bsp_path		# export YOUR_BSP_PATH=your_armadeus_bsp_path
	# cp -r $YOUR_BSP_PATH/buildroot/output/target/boot rootfs/		# cp -r ${YOUR_BSP_PATH}/buildroot/output/target/boot rootfs/
	# cp -r $YOUR_BSP_PATH/buildroot/output/target/lib/modules rootfs/lib/		# cp -r ${YOUR_BSP_PATH}/buildroot/output/target/lib/modules rootfs/lib/
	</pre>		</pre>
	* Finally we can clean the APT cache (we no longer need the deb files, and that will save quite some disk space) :		* Finally we can clean the APT cache (we no longer need the deb files, and that will save quite some disk space):
	<pre class="host">		<pre class="host">
	# chroot rootfs apt-get clean		# chroot rootfs apt-get clean

JulienB: /* First login */

2017-06-15T14:55:00Z

First login

← Older revision		Revision as of 16:55, 15 June 2017
Line 336:		Line 336:
	<pre class="apf">		<pre class="apf">
	root@apfxx:~# apt-get install xinput-calibrator xvkbd		root@apfxx:~# apt-get install xinput-calibrator xvkbd
			</pre>
			* if you want a lightweight Web browser:
			<pre class="apf">
			root@apfxx:~# apt-get install netsurf
	</pre>		</pre>
	* If you want a desktop manager (requires >300 MBytes o_O):		* If you want a desktop manager (requires >300 MBytes o_O):

JulienB: /* First login */

2017-06-13T17:09:05Z

First login

← Older revision		Revision as of 19:09, 13 June 2017
Line 332:		Line 332:
	<pre class="apf">		<pre class="apf">
	root@apfxx:~# apt-get install xdm		root@apfxx:~# apt-get install xdm
			</pre>
			* if you want a touchscreen calibrator and a virtual keyboard:
			<pre class="apf">
			root@apfxx:~# apt-get install xinput-calibrator xvkbd
	</pre>		</pre>
	* If you want a desktop manager (requires >300 MBytes o_O):		* If you want a desktop manager (requires >300 MBytes o_O):

JulienB: /* First login */

2017-06-13T16:20:40Z

First login

← Older revision		Revision as of 18:20, 13 June 2017
Line 318:		Line 318:
	* Other packages that may also be useful (for development):		* Other packages that may also be useful (for development):
	<pre class="apf">		<pre class="apf">
	root@apfxx:~# apt-get install build-essential gcc-4.8 tftp vim strace i2c-tools iw		root@apfxx:~# apt-get install build-essential gcc-4.8 tftp vim strace i2c-tools iw psmisc
	</pre>		</pre>

JulienB: /* Automatically starts your custom application */

2017-06-12T16:33:10Z

Automatically starts your custom application

← Older revision		Revision as of 18:33, 12 June 2017
Line 424:		Line 424:
	esac		esac
	</source>		</source>
			* make it executable:
			<pre class="apf">
			root@opos6ul:~# chmod a+x /etc/init.d/myapp
			</pre>
	* create a symlink to start the previous script in runlevel 5:		* create a symlink to start the previous script in runlevel 5:
	<pre class="apf">		<pre class="apf">