Magic Lantern Firmware Wiki
Magic Lantern Firmware Wiki
Advertisement

General Notes[]

This is a small page of information for new developers trying to assemble a FIR file to run initial code on a camera. I will compile from a few sources to (hopefully) make one easy to read page. This is just for older cameras that didn't use encryption, I do not understand encryption at all but if someone wants to add that be my guest :). => See Fir_Security and Firmware_file.

- Coutts


Background[]

Here are notes from a PM from englemarkus. He is explaining how to use the perl script assemble_fw. This is referencing the 1000d and 400d:

Booting:
1. If there's an AUTOEXEC.BIN on the sd card, the firmware will load it to RAM and try to boot it.
2. For booting from an AUTOEXEC.BIN, you have to use FAT16 as a file system and you have to use "EOS_DEVELOP" as a label.
3. You have an address space from 0x00000000 - 0xFFFFFFFF... The original firmware is mapped to 0xFF800000 and is 8 MB in size (= 0x800000). 0xFF800000 + 0x800000 = 0xFFFFFFFF.
4. Fir files are always loaded to 0x800000.

Structure of a fir file:
1. Flash Header (0x120 Bytes)
2. Flasher
3. Data Header
4. Data

The flasher starts at 0x800120 after the fir file is loaded, as the header is 288 bytes in size. So "$offset" has to be 0x120!

And an email from chuchin regarding getting started with the 1000d:

Hi Andrew, first you will need to decrypt the update flasher use the dissect_fw3_2 tool. In the command line type:
  x:\1000d dissect_fw3_2.exe e6kr5107.fir
It should give you 4 files. You only need the header and the flasher which I have included. With perl use the command line and type:
x:\1000d perl assemble_fw
It should give you a .fir file. Replace my autoexec.bin file - it is not for the 1000d.

Useful Tools[]

There are a few tools that are quite useful for developers working with FIR files. Each name links to its download location.

dissect_fw3_2.c[]

A windows program that splits the firmware up into the different parts explained earlier so that you can pack your own autoexec.bin to replace the payload in the original firmware update. You will get 3 files, the header, the flasher and the payload. Use these with assemble_fw as explained next.

assemble_fw[]

A perl script that takes your autoexec.bin and combines it with the header and flasher from the updater fir, to create your new fir. The checksum is also corrected before the final .fir file is spit out. You will need to edit the offset setting depending on what camera you are working on. This is what englemarks was referring to earlier about an offset of 0x120 (this is for 1000d).

fir_tool2.py[]

A python script used for analyzing FIR files. It gives a lot of useful information in an easy to read format; each offset and the information there. It can also extract the payload from a .FIR file and decrypt it (some, i think. Not sure about AES encrypted cameras). Here is a sample output, from a 1000d v1.0.7 update:

coutt1aj:downloads coutt1aj$ python fir_tool2.py e6kr5107.fir
Fir_tool 0.5 (20Mar2010)

fileLen = 0x715cfc
---.fir header---
0x000: modelId = 0x80000254, (1000D / Rebel XS, VxWorks)
0x010: version = 1.0.7
0x020: checksum = 0xc7902bcd
0x024: updater1 header = 0xb0
0x028: updater1 offset = 0x120
0x02c: updater2 offset = 0xffffffff
0x030: firmware offset = 0x1a0190
0x034: 0xffffffff
0x038: embedded file size = 0x715cfc
0x03c: 0x0
0x040: sha1 seed = 0xd54a6484
0x044: 0x00000004 0x00000000 0x00000020 0x00000024 0x00000044 0x000000b0 0x001a00e0
0x060: 0x1a0190
0x064: firmware length = 0x575b6c
0x068: updater1 hmac-sha1 = 9d131fc81c605427a4bb4490f04669efbc510e11
0x088: firmware hmac-sha1 = 6f31a5573fec1b159290228aadbeec4d71ce5c2b
---updater1 header---
0x0b0: updater1 length = 0x1a0070. starts at 0x120
0x0b4: 0x1a0070
0x0b8: 0x0
0x0bc: xor seed value = 0x933629ce
0x120: --- updater1 (ciphered) ---
---firmware header---
0x1a0190: (+0x000), offset to decryption data = 0xc
0x1a0194: (+0x004), offset to encrypted data = 0x7c. starts at 0x1a0190
0x1a0198: (+0x008), total firmware length (including header) = 0x575b6c. starts at 0x1a0190
-
0x1a019c: (+0x00c), firmware length (encrypted part) = 0x575af0. starts at 0x1a020c
0x1a01a0: (+0x010), 0x00575aea
0x1a01a4: (+0x014), 0x0
0x1a01a8: (+0x018), 0xba510112
0x1a01ac: (+0x01c), 7c5bb4cfd6c106db1246f70e541961c1
0x1a01bc: (+0x02c), e3ea4f2f40551f7fcb1413f2288f50237c920d289a46e6cc6c3c013faee45faf
0x1a01dc: (+0x04c), da5bd5dbcdecd8c318d17d763a11149b
0x1a01ec: (+0x05c), 0de3c8cabf01ced75a08583ffefd4f8fee9f22c44167d15840f269e96d556cd0
---firmware (encrypted)---
0x1a020c: (+0x07c)
==Useful links / readings==

A list of commands:

coutt1aj:downloads coutt1aj$ python fir_tool2.py -h
Usage: fir_tool2.py [options] filename

Options:
  -h, --help      show this help message and exit
  -z, --zeros     print fields usually filled with zeros
  -c, --checksum  verify checksum(s)
  -x, --extract   extract updater(s) code
  -v, --verbose   verbose mode
==Where do I start??==

First you must analyze a Canon update to extract a firmware dump from that (well, a partial one, at least enough to look through).

Then create a small project to run, something simple like dump the firmware so that you can view a bin file. After you have a firmware dump, you can find functions like the EnableBootDisk function which sets the bootflag (camera will load autoexec.bin files on bootable sd cards without needing to run FIR files anymore), dumpf to view the debug message log, and LED addresses.

I have hosted in a repository on my bitbucket a very simple project Indy has sent me from his testings on a 450d. He was able to get a firmware dump, dump the debug log and flash the LED. This is a very good starting point for development on VxWorks cameras. Link here.

Other Information[]

These are links to other wiki pages that are good to read. Many thanks to those devs who have taken the time to take notes for us :)

  • fir_tool2.py on the 7d. Indy explains fir_tool with samples from the 7d updater: here
  • Explanation of FIR file header and what is at each offset (more links to other resources): here
  • 40d development - early stages working with .fir files: here

Closing[]

So that's pretty much all you'll need to start. That is ofcourse if you are working on something older :P for these newer cameras, I will leave it to Indy to edit if he wishes as this is his area of expertise ;)

Advertisement