NixOS on ARM/Firefly AIO-3399C - Revision history

Pigs: Add category

2025-05-18T05:35:06Z

Add category

← Older revision		Revision as of 05:35, 18 May 2025
Line 139:		Line 139:
	* [http://en.t-firefly.com/product/industry/aio_3399c Official product page]		* [http://en.t-firefly.com/product/industry/aio_3399c Official product page]
	* [http://wiki.t-firefly.com/en/AIO-3399C/ Firefly Wiki Page for the AIO-3399c]		* [http://wiki.t-firefly.com/en/AIO-3399C/ Firefly Wiki Page for the AIO-3399c]

			[[Category:NixOS on ARM]]

Phanirithvij: fix web archive link

2024-09-14T08:23:04Z

fix web archive link

← Older revision		Revision as of 08:23, 14 September 2024
Line 122:		Line 122:

	=== Firefly upgrade_tool ===		=== Firefly upgrade_tool ===
	Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash. To be sure use the [https://archive.org/details/AIO-~~33399C~~ archive.org mirror].		Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash. To be sure use the [https://archive.org/details/AIO-3399C archive.org mirror].

	However, because the software is essentially a blob, you will need to either patchelf the thing or use '''steam-run''':		However, because the software is essentially a blob, you will need to either patchelf the thing or use '''steam-run''':

imported>Makefu: new link to maskrom

2023-08-27T14:56:15Z

new link to maskrom

← Older revision		Revision as of 14:56, 27 August 2023
Line 133:		Line 133:

	=== Rockchip MaskROM Mode ===		=== Rockchip MaskROM Mode ===
	Maskrom mode is a way to get extended privileges when flashing but you need to shorten two trace points on the board. Follow [~~http~~://wiki.t-firefly.com/en/AIO-3399C/maskrom_mode.html the official documentation]. However the loader mode should be enough for most things.		Maskrom mode is a way to get extended privileges when flashing but you need to shorten two trace points on the board. Follow [https://wiki.t-firefly.com/en/AIO-3399C/04-maskrom_mode.html the official documentation]. However the loader mode should be enough for most things.

	== Resources ==		== Resources ==

imported>Makefu: fix markup

2019-02-18T22:04:16Z

fix markup

← Older revision		Revision as of 22:04, 18 February 2019
Line 54:		Line 54:
	== Board-specific installation notes ==		== Board-specific installation notes ==

	=== Installation onto eMMC ==		=== Installation onto eMMC ===
	{{note\|it may be necessary to first flash the ubuntu gpt image before overriding the partitions with NixOS, use <code>upgrade_tool UF ./AIO-3399C-UBUNTU16.04-LVDS-GPT.img</code>}}		{{note\|it may be necessary to first flash the ubuntu gpt image before overriding the partitions with NixOS, use <code>upgrade_tool UF ./AIO-3399C-UBUNTU16.04-LVDS-GPT.img</code>}}
	==== boot parts ====		==== boot parts ====
Line 110:		Line 110:
	Now cross fingers, the system should boot into NixOS now, the getty BAUD rate		Now cross fingers, the system should boot into NixOS now, the getty BAUD rate
	will change to <code>115200</code>.		will change to <code>115200</code>.


	== Compatibility notes ==		== Compatibility notes ==

imported>Makefu: add installation instructuions for emmc

2019-02-18T22:03:31Z

add installation instructuions for emmc

← Older revision		Revision as of 22:03, 18 February 2019
Line 23:		Line 23:
	</div>		</div>
	== Status ==		== Status ==
			The board '''boots NixOS from eMMC''' with the downstream u-boot and Rockchip trusted boot blob. Also flashing Rockchip tertiary bootloader (idbloader).

	~~It can boot the~~ image provided by firefly on [http://www.t-firefly.com/doc/download/54.html the chinese download page], click on '''Ubuntu (GPT)'''. The image has also been uploaded to [https://archive.org/details/AIO-3399C archive.org].		Additionally image provided by firefly on [http://www.t-firefly.com/doc/download/54.html the chinese download page], click on '''Ubuntu (GPT)'''. The image has also been uploaded to [https://archive.org/details/AIO-3399C archive.org].

	The official documentation, which is a pretty good state, can be found at [http://wiki.t-firefly.com/en/AIO-3399C/ the wiki of firefly]. ~~However as of right now i was unable to:~~		The official documentation, which is a pretty good state, can be found at [http://wiki.t-firefly.com/en/AIO-3399C/ the wiki of firefly].

	* build an nixos image which can be booted as root image from the emmc (root image must be build as "android" boot)
	* build an sd-image with a kernel which detects the card at stage one with NixOS (cannot find rootfs)
	* build the the bootloader with NixOS (blobs and trustedboot comes from rockchip)

	~~== Board-specific installation notes ==~~		== Serial console ==

	== Serial console==
	On the board there are 3 pins which have a 2.54mm pitch, this is the debug console with the text DEBUG on it. Starting from the middle to the side of the board:		On the board there are 3 pins which have a 2.54mm pitch, this is the debug console with the text DEBUG on it. Starting from the middle to the side of the board:

Line 51:		Line 47:
	<syntaxHighlight lang=nix>		<syntaxHighlight lang=nix>
	{		{
	boot.kernelParams = ["console=ttyS2,1500000n8" "earlycon=uart8250,mmio32,0xff1a0000" "earlyprintk"];		boot.kernelParams = lib.mkForce ["console=ttyS2,1500000n8" "earlycon=uart8250,mmio32,0xff1a0000" "earlyprintk"];
	}		}
	</syntaxHighlight>		</syntaxHighlight>
	== ~~Compatibility~~ notes ==		Make sure you disable other consoles (tty0) as they seem to interfere with the output.
	~~See~~ the ~~[http:~~/~~/opensource~~.~~rock~~-~~chips~~.~~com~~/~~wiki_Status_Matrix Rockchip compatibility matrix]. Uboot requires~~ the ~~Rockchip Miniloader and an arm trusted~~ boot image.
			== Board-specific installation notes ==

			=== Installation onto eMMC ==
			{{note\|it may be necessary to first flash the ubuntu gpt image before overriding the partitions with NixOS, use <code>upgrade_tool UF ./AIO-3399C-UBUNTU16.04-LVDS-GPT.img</code>}}
			==== boot parts ====
			For booting the Image you will need the following parts:

			# idbloader (rockchip proprietary)
			# u-boot customized by firefly
			# ARM Trusted image customized for working with uboot

			The whole setup can be built by hand with the following scripts originally from user '''samueldr'''.

	=~~== Downstream kernel ===~~		<syntaxHighlight lang=bash>
			git clone https://github.com/makefu/ROC-RK3399-PC-overlay.git builder && cd builder
			nix-build -A pkgsCross.aarch64-multiplatform.AIO-3399C.firmware
			ls result/
			cp result/{idbloader.img,uboot.img,trust.img} .
			</syntaxHighlight>

	The ~~downstream~~ kernel ~~sources~~ can ~~be found on github at~~ [https://~~github~~.~~com~~/~~FireflyTeam~~/~~kernel]~~. ~~The stable kernel branch they are maintaining is <code>4~~.~~4</code>, however mainline 4~~.~~19 should already work according to the [http~~:~~//opensource~~.~~rock~~-~~chips~~.~~com/wiki_Status_Matrix Rockchip compatibility matrix~~].		==== boot and rootfs ====
			The latest linux kernel (4.19 and up) is working with this board. Instead of building the image yourself you can fetch the latest sd-image from hydra and dd the created images onto the separate partitions.
			You can find all the successful builds in [https://hydra.nixos.org/job/nixos/release-18.09-aarch64/nixos.sd_image.aarch64-linux hydra @ nixos:release-18.09-aarch64:nixos.sd_image.aarch64-linux]

	=~~== u-boot ===~~		<syntaxHighlight lang=bash>
	~~Firefly maintains an own u-boot fork at [~~https://~~github~~.~~com~~/~~FireflyTeam~~/u-boot]		# get the latest link directly from hydra
			wget https://hydra.nixos.org/build/89033499/download/1/nixos-sd-image-18.09.2227.ea0820818a7-aarch64-linux.img -O sd.img
			udisksctl loop-setup -f sd.img -r
			dd if=/dev/loop0p1 boot.img
			dd if=/dev/loop0p2 root.img
			</syntaxHighlight>

	=== ~~Flashing via~~ Rockchip ~~Loader Mode~~ ===		==== Bringing the device into Rockchip loader mode ====
	The board can easily be flashed by booting the device into the Rockchip ''loader'' mode.		The board can easily be flashed by booting the device into the Rockchip ''loader'' mode. The device exposes the emmc with the rockusb protocol to a connected host pc.

	To bring the device in the loader mode:		To bring the device in the loader mode:
Line 74:		Line 94:
	# Short press the 'reset' button and release the 'Recovery' button afterwards		# Short press the 'reset' button and release the 'Recovery' button afterwards

	==== Firefly upgrade_tool ====		==== flashing all boot parts ====
			<syntaxHighlight lang=bash>
			# You should have the following files available:
			$ ls *.img
			boot.img root.img trust.img uboot.img idbloader.img

			# enter loader or maskrom mode
			nix-build -A AIO-3399C.upgrade_tool
			# optional: re-flash the rockchip loader, haven't tested
			# result/bin/upgrade_tool UL idbloader.img
			result/bin/upgrade_tool di -u uboot.img -t trust.img -boot ./boot.img -rootfs root.img
			result/bin/upgrade_tool rd # reset
			</syntaxHighlight>

			Now cross fingers, the system should boot into NixOS now, the getty BAUD rate
			will change to <code>115200</code>.


			== Compatibility notes ==
			See the [http://opensource.rock-chips.com/wiki_Status_Matrix Rockchip compatibility matrix]. Uboot requires the Rockchip Miniloader and an arm trusted boot image.

			=== Downstream kernel ===

			The downstream kernel sources can be found on github at [https://github.com/FireflyTeam/kernel]. The stable kernel branch they are maintaining is <code>4.4</code>, however mainline 4.19 is already work according to the [http://opensource.rock-chips.com/wiki_Status_Matrix Rockchip compatibility matrix].

			=== u-boot ===
			Firefly maintains an own u-boot fork at [https://github.com/FireflyTeam/u-boot].

			=== Firefly upgrade_tool ===
	Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash. To be sure use the [https://archive.org/details/AIO-33399C archive.org mirror].		Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash. To be sure use the [https://archive.org/details/AIO-33399C archive.org mirror].

	However, because the software is essentially a blob, you will need to either patchelf the thing or use '''steam-run''':		However, because the software is essentially a blob, you will need to either patchelf the thing or use '''steam-run''':
	<syntaxHighlight lang=bash>nix-shell -p steam-run --run "steam-run ./upgrade_tool"</syntaxHighlight>		<syntaxHighlight lang=bash>nix-shell -p steam-run --run "steam-run ./upgrade_tool"</syntaxHighlight>

			I tried flashing with the open-source rkflashtool (in the same repo as the
			u-boot stuff), however i was unable to actually connect to the device neither in
			"loader" nor in "maskrom" mode. I resorted to using the closed source blob
			<code>upgrade_tool</code> which works directly.

	=== Rockchip MaskROM Mode ===		=== Rockchip MaskROM Mode ===

imported>Makefu: fix archive.org link

2019-02-09T18:25:01Z

fix archive.org link

← Older revision		Revision as of 18:25, 9 February 2019
Line 24:		Line 24:
	== Status ==		== Status ==

	It can boot the image provided by firefly on [http://www.t-firefly.com/doc/download/54.html the chinese download page], click on '''Ubuntu (GPT)'''. The image has also been uploaded to [https://archive.org/details/AIO-~~33399C~~ archive.org].		It can boot the image provided by firefly on [http://www.t-firefly.com/doc/download/54.html the chinese download page], click on '''Ubuntu (GPT)'''. The image has also been uploaded to [https://archive.org/details/AIO-3399C archive.org].

	The official documentation, which is a pretty good state, can be found at [http://wiki.t-firefly.com/en/AIO-3399C/ the wiki of firefly]. However as of right now i was unable to:		The official documentation, which is a pretty good state, can be found at [http://wiki.t-firefly.com/en/AIO-3399C/ the wiki of firefly]. However as of right now i was unable to:

imported>Makefu: set bootloader

2019-01-29T23:38:49Z

set bootloader

← Older revision		Revision as of 23:38, 29 January 2019
Line 13:		Line 13:
	\|-		\|-
	!Bootloader		!Bootloader
	\|?		\| u-boot with ARM trusted boot and Rockchip Miniloader
	\|-		\|-
	!Boot order		!Boot order

imported>Makefu: add documentation even though nothing works yet :)

2019-01-29T23:35:07Z

add documentation even though nothing works yet :)

← Older revision		Revision as of 23:35, 29 January 2019
Line 4:		Line 4:
	!colspan="2" class="title"\|Firefly AIO-3399C		!colspan="2" class="title"\|Firefly AIO-3399C
	\|-		\|-
	\|colspan="2"\|[[File:Firefly_AIO-3399C.png\|frameless\|256px\|A Firefly AIO-3399C ~~with eMMC.~~]]		\|colspan="2"\|[[File:Firefly_AIO-3399C.png\|frameless\|256px\|A Firefly AIO-3399C attached to LVDS]]
	\|-		\|-
	!Manufacturer		!Manufacturer
Line 16:		Line 16:
	\|-		\|-
	!Boot order		!Boot order
	\| eMMC~~,SD~~		\| official: eMMC
	\|-		\|-
	!Maintainer		!Maintainer
Line 24:		Line 24:
	== Status ==		== Status ==

	It can boot the image provided by firefly on [http://www.t-firefly.com/doc/download/54.html the chinese download page], click on '''Ubuntu (GPT)'''. ~~You will need a pan~~.~~baidu~~.~~com account~~.		It can boot the image provided by firefly on [http://www.t-firefly.com/doc/download/54.html the chinese download page], click on '''Ubuntu (GPT)'''. The image has also been uploaded to [https://archive.org/details/AIO-33399C archive.org].

	The official documentation, which is a pretty good state, can be found at [http://wiki.t-firefly.com/en/AIO-3399C/ the wiki of firefly]		The official documentation, which is a pretty good state, can be found at [http://wiki.t-firefly.com/en/AIO-3399C/ the wiki of firefly]. However as of right now i was unable to:

			* build an nixos image which can be booted as root image from the emmc (root image must be build as "android" boot)
			* build an sd-image with a kernel which detects the card at stage one with NixOS (cannot find rootfs)
			* build the the bootloader with NixOS (blobs and trustedboot comes from rockchip)

	== Board-specific installation notes ==		== Board-specific installation notes ==

	== Serial console==		== Serial console==
			On the board there are 3 pins which have a 2.54mm pitch, this is the debug console with the text DEBUG on it. Starting from the middle to the side of the board:

			* GND (Black Wire)
			* RX (White Wire)
			* TX (Green Wire)
			* VCC, only the silver trace point and not a pin

			Baud rate is <code>1500000</code>
			Connect to it via:
			<syntaxHighlight lang=bash>
			nix-shell -p picocom --run "picocom -b 1500000 /dev/ttyUSB0"
			</syntaxHighlight>

			When you build your own image, you need the following extra kernel command-line parameters to get serial output:
			<syntaxHighlight lang=nix>
			{
			boot.kernelParams = ["console=ttyS2,1500000n8" "earlycon=uart8250,mmio32,0xff1a0000" "earlyprintk"];
			}
			</syntaxHighlight>
	== Compatibility notes ==		== Compatibility notes ==
			See the [http://opensource.rock-chips.com/wiki_Status_Matrix Rockchip compatibility matrix]. Uboot requires the Rockchip Miniloader and an arm trusted boot image.

	=== Downstream kernel ===		=== Downstream kernel ===

			The downstream kernel sources can be found on github at [https://github.com/FireflyTeam/kernel]. The stable kernel branch they are maintaining is <code>4.4</code>, however mainline 4.19 should already work according to the [http://opensource.rock-chips.com/wiki_Status_Matrix Rockchip compatibility matrix].

			=== u-boot ===
			Firefly maintains an own u-boot fork at [https://github.com/FireflyTeam/u-boot]

	=== Flashing via Rockchip Loader Mode ===		=== Flashing via Rockchip Loader Mode ===
Line 47:		Line 75:

	==== Firefly upgrade_tool ====		==== Firefly upgrade_tool ====
	Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash.		Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash. To be sure use the [https://archive.org/details/AIO-33399C archive.org mirror].

			However, because the software is essentially a blob, you will need to either patchelf the thing or use '''steam-run''':
			<syntaxHighlight lang=bash>nix-shell -p steam-run --run "steam-run ./upgrade_tool"</syntaxHighlight>

	=== Rockchip MaskROM Mode ===		=== Rockchip MaskROM Mode ===
	Maskrom mode is a way to get extended privileges when flashing but you need to shorten two trace points on the board. Follow [http://wiki.t-firefly.com/en/AIO-3399C/maskrom_mode.html the official documentation].		Maskrom mode is a way to get extended privileges when flashing but you need to shorten two trace points on the board. Follow [http://wiki.t-firefly.com/en/AIO-3399C/maskrom_mode.html the official documentation]. However the loader mode should be enough for most things.

	~~=== Flashing from U-Boot ===~~

	== Resources ==		== Resources ==

	* [~~https~~://~~www~~.~~pine64~~.~~org~~/~~?page_id=46823~~ Official product page]		* [http://en.t-firefly.com/product/industry/aio_3399c Official product page]
	* [http://wiki.t-firefly.com/en/AIO-3399C/ Firefly Wiki Page for the AIO-3399c]		* [http://wiki.t-firefly.com/en/AIO-3399C/ Firefly Wiki Page for the AIO-3399c]

imported>Samueldr: Removes unnecessary spaces

2019-01-19T22:12:30Z

Removes unnecessary spaces

← Older revision		Revision as of 22:12, 19 January 2019
Line 22:		Line 22:
	\|}		\|}
	</div>		</div>


	== Status ==		== Status ==

Line 31:		Line 29:

	== Board-specific installation notes ==		== Board-specific installation notes ==



	== Serial console==		== Serial console==


	== Compatibility notes ==		== Compatibility notes ==

	=== Downstream kernel ===		=== Downstream kernel ===




	=== Flashing via Rockchip Loader Mode ===		=== Flashing via Rockchip Loader Mode ===
Line 61:		Line 53:

	=== Flashing from U-Boot ===		=== Flashing from U-Boot ===



	== Resources ==		== Resources ==

imported>Makefu: add loader mode, maskrom

2019-01-19T22:12:01Z

add loader mode, maskrom

← Older revision		Revision as of 22:12, 19 January 2019
Line 44:		Line 44:


	=== Flashing ~~from with~~ Rockchip ~~upgrade_tool~~ ===		=== Flashing via Rockchip Loader Mode ===
			The board can easily be flashed by booting the device into the Rockchip ''loader'' mode.

			To bring the device in the loader mode:
			# Disconnect from power
			# Connect USB-C from the board to your computer
			# Hold 'Recovery' button pressed
			# Connect power, wait for 2 (or more) seconds
			# Short press the 'reset' button and release the 'Recovery' button afterwards

			==== Firefly upgrade_tool ====
			Firefly provides an <code>upgrade_tool</code> which is a modified [http://opensource.rock-chips.com/wiki_Upgradetool rock-chip upgrade tool]. Using the upstream tool however may result in weird errors like being unable to flash the image or being unable to erase the flash.

			=== Rockchip MaskROM Mode ===
			Maskrom mode is a way to get extended privileges when flashing but you need to shorten two trace points on the board. Follow [http://wiki.t-firefly.com/en/AIO-3399C/maskrom_mode.html the official documentation].

	=== Flashing from U-Boot ===		=== Flashing from U-Boot ===