LeapFrog Pollux Platform: Surgeon - Revision history

Jrspruitt: /* Didj Patches */

2013-02-26T07:19:45Z

‎Didj Patches

Jrspruitt at 05:14, 22 October 2012

2012-10-22T05:14:49Z

Jrspruitt: /* Compiling */

2012-10-22T05:04:02Z

‎Compiling

Jrspruitt: Created page with "Surgeon is a special USB Bootable firmware designed for the LeapPad Explorer and Leapster Explorer, that is used during the firmware updating process. [[Leapster_Explorer..."

2012-10-15T06:32:57Z

Created page with "Surgeon is a special USB Bootable firmware designed for the LeapPad Explorer and Leapster Explorer, that is used during the firmware updating process. [[Leapster_Explorer..."

New page

Surgeon is a special USB Bootable firmware designed for the [[LeapPad Explorer]] and [[Leapster Explorer]], that is used during the firmware updating process. [[Leapster_Explorer:_Emerald_Boot|Emerald Boot]] is required for [[Leapster_Explorer:_USB_Boot| USB Booting]], which comes stock with both LeapPad and Explorer. The [[Didj]] can be modified to run [[Didj_Emerald_Boot|Emerald-Boot]] also, but requires some work.

=== Anatomy ===
Surgeon is wrapped in a [[LeapFrog_Pollux_Platform:_File_Format_CBF| CBF]] layer. Inside is a basic gzip compressed zImage with an initramfs that includes all of the programs necessary to run the basic Linux and updating software.

Once in USB boot mode, either with [[Leapster_Explorer:_USB_Boot|LFConnect]] or [[Leapster_Explorer:_USB_Boot| with out]] the surgeon.cbf file can be sent to the device, where it is loaded by Emerald Boot and executed.

This will start the [[LeapFrog_Pollux_Platform:_DFTPdevice|DFTP Device]] which is basically a modified FTP server. You can use [[LeapFrog_Pollux_Platform:_OpenLFConnect|OpenLFConnect]] to exploit various functionality of the server. Using the update command the kernel, erootfs and bulk firmwares can be flashed to NAND. You can also mount the already installed firmware partitions, if you need to fix an issue that can not be done during normal booting. Do remember Surgeon is completely temporary, anything you modifying with in Surgeon, will not remain after a reboot, which can make it an excellent means of non-destructive testing.

=== Versions ===
{| border="1" cellpadding="7" cellspacing="0"
!| Device
!| Language
!| File
!| kernel_load
!| kernel_jump
!| compressed
!| initramfs
!| Size Limit
!| DFTP Version

|-
|LeapPad
|English
|Surgeon.cbf
|0x00010000
|0x00010000
|True
|True
| 8MB Memory Limited
| 1.12

|-
|Explorer
|English
|Surgeon.cbf
|0x00008000
|0x00008000
|True
|True
| 8MB Memory Limited
|1.12

|-
|Explorer
|French
|Surgeon.cbf
|0x00008000
|0x00008000
|True
|True
| 8MB Memory Limited
|1.8
|}

== Building ==
=== Prerequisites ===
[[LeapFrog_Pollux_Platform:_Build_Environment|Set Up Build Environment]]

[[LeapFrog_Pollux_Platform:_Kernel_Configuration|Kernel Configuration]]

=== Software Needed ===
[[LeapFrog_Pollux_Platform:_OpenLFConnect|OpenLFConnect]]

[[LeapFrog_Pollux_Platform:_Source_Code|Kernel Sources LeapPad or Explorer]]
RootFS
* Build your own
* Use OpenLFConnect to extract one from Surgeon

=== Rootfs ===
The easiest way is to use OpenLFConnect, and extract one from a factory Surgeon file. These commands will download the Surgeon package, extract it, then extract the initramfs(rootfs) to <current dir>/rootfs.lx/
package_download LX surgeon
package_extract LX_surgeon<version>.lfp
surgeon_extract_rootfs lx surgeon.cbf

This will

=== Compiling ===
Nothing out of the ordinary here, there is a supplied config file for surgeon, and just need SURGEONFS on the command line to point to your rootfs.
make lf1000_ts_surgeon_defconfig
SURGEONFS=/path/to/your/rootfs ./install.sh

In either <lf_sources>/linux-2.6/arch/arm/boot/ or <lf_sources>/target/tftp you'll find a zImage file of roughly 5.8mb depending on LeapPad or Explorer sources.

Next using OpenLFConnect again, the file needs to be wrapped in CBF. High(0x00010000) or Low(0x00008000) memory is according to your device, check the versions chart.
cbf_wrap high surgeon.cbf path/to/zImage

=== Booting ===
Set the device in USB Boot mode, with cord connected. Again with OpenLFConnect boot surgeon.
surgeon_boot /path/to/surgeon.cbf

Once the command line returns, your device should be booting up. You can then connect to the DFTP if you like thru OpenLFConnect
dftp_device

You should get a summary of data, and you can now play around with Surgeon.

@@ Line 89: / Line 89: @@
 [http://files.poxlib.org/LeapFrog/elinux_downloads/Didj_Surgeon_Patch.tar.gz Didj Surgeon Patch]
-These patches take care of a few minor adjustments with the RootFS and Kernel to allow Surgeon to work as normal with [[Didj_Emerald_Boot|Emerald Boot]] on the [[Didj]].
+These patches take care of a few minor adjustments with the RootFS and Kernel to allow Surgeon to work as normal with [[Didj_Emerald_Boot|Emerald Boot]] on the [[Didj]]. Complied version included.
 === Booting ===

← Older revision		Revision as of 05:14, 22 October 2012
Line 1:		Line 1:
−	Surgeon is a special USB Bootable firmware designed for the [[LeapPad Explorer]] and [[Leapster Explorer]], that is used during the firmware updating process. [[Leapster_Explorer:_Emerald_Boot\|Emerald Boot]] is required for [[Leapster_Explorer:_USB_Boot\| USB Booting]], which comes stock with both LeapPad and Explorer. The [[Didj]] can be modified to run [[Didj_Emerald_Boot\|Emerald-Boot]] also, but requires some work.	+	Surgeon is a special initramfs USB Bootable firmware designed for the [[LeapPad Explorer]] and [[Leapster Explorer]], that is used during the firmware updating process. [[Leapster_Explorer:_Emerald_Boot\|Emerald Boot]] is required for [[Leapster_Explorer:_USB_Boot\| USB Booting]], which comes stock with both LeapPad and Explorer. The [[Didj]] can be modified to run [[Didj_Emerald_Boot\|Emerald-Boot]] also, but requires some work.

	=== Anatomy ===		=== Anatomy ===

@@ Line 85: / Line 85: @@
 Next using OpenLFConnect again, the file needs to be wrapped in CBF. High(0x00010000) or Low(0x00008000) memory is according to your device, check the versions chart.
   cbf_wrap high surgeon.cbf path/to/zImage
 === Booting ===