Linux - Revision history

User890104 at 17:51, 6 April 2026

2026-04-06T17:51:23Z

← Older revision		Revision as of 17:51, 6 April 2026
Line 2:		Line 2:
	== Current: Freemyipod Linux ==		== Current: Freemyipod Linux ==

	We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5G]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux]. Aditionaly [[ZeOne]] is working on making it work with the [[~~nano~~ 6G]] you can read more about that on his page.		We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5G]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux]. Aditionaly [[User:ZeOne]] is working on making it work with the [[Nano 6G]] you can read more about that on his page.

	=== User Guide ===		=== User Guide ===

ZeOne: Added the note that im working on the nano 6G

2026-04-06T16:04:29Z

Added the note that im working on the nano 6G

← Older revision		Revision as of 16:04, 6 April 2026
Line 2:		Line 2:
	== Current: Freemyipod Linux ==		== Current: Freemyipod Linux ==

	We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5G]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux].		We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5G]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux]. Aditionaly [[ZeOne]] is working on making it work with the [[nano 6G]] you can read more about that on his page.

	=== User Guide ===		=== User Guide ===

ZeOne: changed main focus note at start from nano 5g to 7g

2026-04-03T23:29:03Z

changed main focus note at start from nano 5g to 7g

← Older revision		Revision as of 23:29, 3 April 2026
Line 2:		Line 2:
	== Current: Freemyipod Linux ==		== Current: Freemyipod Linux ==

	We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux].		We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5G]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux].

	=== User Guide ===		=== User Guide ===

ZeOne: changed main focus note at start from nano 5g to 7g

2026-04-03T23:27:30Z

changed main focus note at start from nano 5g to 7g

← Older revision		Revision as of 23:27, 3 April 2026
Line 2:		Line 2:
	== Current: Freemyipod Linux ==		== Current: Freemyipod Linux ==

	We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 5G]], there are also builds for [[Nano 2G]] and [[Nano 7G]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux].		We are working on supporting Samsung/S5L-based devices which have an MMU. Currently our main focus is the [[Nano 7G]], there are also builds for [[Nano 2G]] and [[Nano 5]]. An experimental source tree is available on [https://github.com/freemyipod/linux github.com/freemyipod/linux].

	=== User Guide ===		=== User Guide ===

User890104: we have a display driver already

2026-03-21T22:19:40Z

we have a display driver already

← Older revision		Revision as of 22:19, 21 March 2026
Line 6:		Line 6:
	=== User Guide ===		=== User Guide ===

	Not yet available, as the Linux port isn't yet practical to use. We have no storage drivers~~, no screen driver~~, no sound driver...		Not yet available, as the Linux port isn't yet practical to use. We have no storage drivers, no sound driver...

	=== Developer Guide ===		=== Developer Guide ===

User890104 at 23:59, 8 January 2026

2026-01-08T23:59:20Z

← Older revision		Revision as of 23:59, 8 January 2026
Line 32:		Line 32:
	$ make apple_n33_defconfig # for Nano 5G OR		$ make apple_n33_defconfig # for Nano 5G OR
	$ make apple_n31_defconfig # for Nano 7G		$ make apple_n31_defconfig # for Nano 7G
	$ make CROSS_COMPILE=arm-none-eabi- ~~u-boot.bin~~ -j $(nproc)		$ make CROSS_COMPILE=arm-none-eabi- -j $(nproc) u-boot.bin

	Third, Linux:		Third, Linux:

User890104: /* Running */

2026-01-08T21:14:20Z

Running

← Older revision		Revision as of 21:14, 8 January 2026
Line 54:		Line 54:
	==== Running ====		==== Running ====

	Connect your ~~Nano 5G~~ in DFU mode.		Connect your iPod nano in DFU mode.

	Run u-boot using wInd3x:		Run u-boot using wInd3x:
Line 60:		Line 60:
	$ ./wInd3x cfw run ../u-boot/u-boot.bin		$ ./wInd3x cfw run ../u-boot/u-boot.bin

	This should start u-boot. Running this for the first time will take a while, as some bootloader stages need to be downloaded, decrypted and modified. A new USB device (05ac:~~2137~~) appear on your host. Use dfu-util to upload mImage:		This should start u-boot. Running this for the first time will take a while, as some bootloader stages need to be downloaded, decrypted and modified. A new USB device (05ac:8007) appear on your host. Use dfu-util to upload mImage:

	dfu-util -d 05ac:~~2137~~ -D ~~linux/~~mImage -R		dfu-util -d 05ac:8007 -D mImage && dfu-util -d 05ac:8007 -e

	Then, in the serial console you'll see Linux booting:		Then, in the serial console you'll see Linux booting:

User890104 at 12:02, 27 December 2025

2025-12-27T12:02:03Z

← Older revision		Revision as of 12:02, 27 December 2025
Line 40:		Line 40:
	$ git checkout n5g-wip # for Nano 5G OR		$ git checkout n5g-wip # for Nano 5G OR
	$ git checkout n7g-wip # for Nano 7G		$ git checkout n7g-wip # for Nano 7G
	$ make ARCH=arm nano5g_defconfig		$ make ARCH=arm nano5g_defconfig # for Nano 5G
			$ make ARCH=arm apple_n31_defconfig # for Nano 7G
	$ make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j $(nproc) zImage		$ make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j $(nproc) zImage

User890104 at 11:13, 27 December 2025

2025-12-27T11:13:47Z

User890104 at 23:18, 23 December 2025

2025-12-23T23:18:15Z

← Older revision		Revision as of 23:18, 23 December 2025
Line 32:		Line 32:
	$ make apple_n33_defconfig # for Nano 5G OR		$ make apple_n33_defconfig # for Nano 5G OR
	$ make apple_n31_defconfig # for Nano 7G		$ make apple_n31_defconfig # for Nano 7G
	$ make CROSS_COMPILE=arm-none-eabi- u-boot.bin -j 32		$ make CROSS_COMPILE=arm-none-eabi- u-boot.bin -j $(nproc)

	Third, Linux:		Third, Linux:
Line 38:		Line 38:
	$ git clone https://github.com/freemyipod/linux		$ git clone https://github.com/freemyipod/linux
	$ cd linux		$ cd linux
	$ git checkout n5g-wip		$ git checkout n5g-wip # for Nano 5G OR
			$ git checkout n7g-wip # for Nano 7G
	$ make ARCH=arm nano5g_defconfig		$ make ARCH=arm nano5g_defconfig
	$ make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j 32 zImage		$ make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j $(nproc) zImage

	By this point, have a initramfs ready. If you wanna boot directly from nfs, edit CMDLINE in the kernel .config accordingly.		By this point, have a initramfs ready. If you wanna boot directly from nfs, edit CMDLINE in the kernel .config accordingly.

← Older revision		Revision as of 11:13, 27 December 2025
Line 20:		Line 20:
	First, wInd3x: this will be used to run u-boot.		First, wInd3x: this will be used to run u-boot.

	$ git clone https://github.com/freemyipod/wInd3x		$ git clone https://github.com/freemyipod/wInd3x
	$ cd wInd3x		$ cd wInd3x
	$ go build ./cmd/wInd3x		$ go build ./cmd/wInd3x

	Second, U-Boot:		Second, U-Boot:

	$ git clone https://github.com/freemyipod/u-boot		$ git clone https://github.com/freemyipod/u-boot
	$ cd u-boot		$ cd u-boot
	$ git checkout s5l87xx		$ git checkout s5l87xx
	$ make apple_ipodnano2g_defconfig # for Nano 2G OR		$ make apple_ipodnano2g_defconfig # for Nano 2G OR
	$ make apple_n33_defconfig # for Nano 5G OR		$ make apple_n33_defconfig # for Nano 5G OR
	$ make apple_n31_defconfig # for Nano 7G		$ make apple_n31_defconfig # for Nano 7G
	$ make CROSS_COMPILE=arm-none-eabi- u-boot.bin -j $(nproc)		$ make CROSS_COMPILE=arm-none-eabi- u-boot.bin -j $(nproc)

	Third, Linux:		Third, Linux:

	$ git clone https://github.com/freemyipod/linux		$ git clone https://github.com/freemyipod/linux
	$ cd linux		$ cd linux
	$ git checkout n5g-wip # for Nano 5G OR		$ git checkout n5g-wip # for Nano 5G OR
	$ git checkout n7g-wip # for Nano 7G		$ git checkout n7g-wip # for Nano 7G
	$ make ARCH=arm nano5g_defconfig		$ make ARCH=arm nano5g_defconfig
	$ make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j $(nproc) zImage		$ make ARCH=arm CROSS_COMPILE=arm-none-eabi- -j $(nproc) zImage

	By this point, have a initramfs ready. If you wanna boot directly from nfs, edit CMDLINE in the kernel .config accordingly.		By this point, have a initramfs ready. If you wanna boot directly from nfs, edit CMDLINE in the kernel .config accordingly.
Line 47:		Line 47:
	Finally, bundle together an u-boot image containing the kernel, your initramfs, and the device-tree (built by u-boot):		Finally, bundle together an u-boot image containing the kernel, your initramfs, and the device-tree (built by u-boot):

	$ mkimage -A arm -C none -O linux -T multi -a 0x08000000 -e 0x08000000 -d arch/arm/boot/zImage:initramfs.gz:../u-boot/arch/arm/dts/s5l8730.dtb mImage		$ mkimage -A arm -C none -O linux -T multi -a 0x08000000 -e 0x08000000 -d arch/arm/boot/zImage:initramfs.gz:../u-boot/arch/arm/dts/s5l8730.dtb mImage

	''mImage'' is your combined image.		''mImage'' is your combined image.
Line 57:		Line 57:
	Run u-boot using wInd3x:		Run u-boot using wInd3x:

	$ ./wInd3x cfw run ../u-boot/u-boot.bin		$ ./wInd3x cfw run ../u-boot/u-boot.bin

	This should start u-boot. Running this for the first time will take a while, as some bootloader stages need to be downloaded, decrypted and modified. A new USB device (05ac:2137) appear on your host. Use dfu-util to upload mImage:		This should start u-boot. Running this for the first time will take a while, as some bootloader stages need to be downloaded, decrypted and modified. A new USB device (05ac:2137) appear on your host. Use dfu-util to upload mImage:

	dfu-util -d 05ac:2137 -D linux/mImage -R		dfu-util -d 05ac:2137 -D linux/mImage -R

	Then, in the serial console you'll see Linux booting:		Then, in the serial console you'll see Linux booting:

	## Booting kernel from Legacy Image at 08000000 ...		## Booting kernel from Legacy Image at 08000000 ...
	...		...
	Starting kernel ...		Starting kernel ...

	[ 0.000000] Booting Linux on physical CPU 0x0		[ 0.000000] Booting Linux on physical CPU 0x0
	[ 0.000000] Linux version 6.2.0-rc4-00476-g4c4af4d7e53c (q3k@mimeomia) (arm-none-eabi-gcc (GNU Arm Embedded Toolchain 10.3-2021.10) 10.3.1 20210824 (release), GNU ld (GNU Arm Embedded Toolchain 10.3-2021.10) 2.36.1.20210621) #70 Fri Jan 20 18:02:56 CET 2023		[ 0.000000] Linux version 6.2.0-rc4-00476-g4c4af4d7e53c (q3k@mimeomia) (arm-none-eabi-gcc (GNU Arm Embedded Toolchain 10.3-2021.10) 10.3.1 20210824 (release), GNU ld (GNU Arm Embedded Toolchain 10.3-2021.10) 2.36.1.20210621) #70 Fri Jan 20 18:02:56 CET 2023
	...		...

	The LCD display should start up and show a boot log. If not, try adding <code>console=tty0</code> to your CMDLINE? You might also use <code>fbcon=rotate:1</code> to rotate the framebuffer 90 degrees.		The LCD display should start up and show a boot log. If not, try adding <code>console=tty0</code> to your CMDLINE? You might also use <code>fbcon=rotate:1</code> to rotate the framebuffer 90 degrees.

	If everything goes well, the kernel should boot up and attempt to mount a rootfs. It's up to you to get this part working, at least until we streamline the process. The USB CDC EEM ethernet gadget should also appear on your host (probably as usb0, or some long systemd predictable name). The other end will be visible as 'usb0' on the device.		If everything goes well, the kernel should boot up and attempt to mount a rootfs. It's up to you to get this part working, at least until we streamline the process. The USB CDC EEM ethernet gadget should also appear on your host (probably as usb0, or some long systemd predictable name). The other end will be visible as 'usb0' on the device.

			On [[Nano 7G]] you'll need a DCSD cable (Alex/Magico), and the command line to get proper serial output:

			picocom --baud 115200 --imap lfcrlf /dev/ttyUSB0

	Now go on and have a go at reverse-engineering some peripherals! :)		Now go on and have a go at reverse-engineering some peripherals! :)