Difference between revisions of "EmBIOS"
(discontinue emBIOS) |
|||
| (11 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| + | {{Template:Outdated|reason=emBIOS was discontinued on {{#dateformat:2011-03-25}} and superseded by [[emCORE]]}} | ||
[[File:Embios.jpg|115px|thumb|right|emBIOS on the 4G Nano]] | [[File:Embios.jpg|115px|thumb|right|emBIOS on the 4G Nano]] | ||
| − | emBIOS is best described as a hardware abstraction with threading and debugging capabilities built in. It | + | emBIOS ('''em'''bedded '''BIOS''') is best described as a hardware abstraction with threading and debugging capabilities built in. It was superseded by [[emCORE]]. It simplified development immensely by integrating drivers for all the iPods. Before drivers were scattered throughout multiple tools built for multiple iPods. If there was a bug fix for a driver, it would have to be applied in many different places. emBIOS attempted to solve this problem by providing a syscall interface that is standard throughout all iPod generations. This means that a build of a tool can work across generations as long as it is run on a native emBIOS. This allows for maximum code reuse. |
| + | |||
| + | emBIOS was designed with portability in mind. It should have also been able to be run on other devices like the BeagleBoard if someone would have ported the necessary drivers. | ||
| + | |||
| + | If you're curious about how emBIOS worked, you can browse its last SVN revision before its official death [http://websvn.freemyipod.org/listing.php?repname=freemyipod&path=/embios/&rev=672&peg=672 here]. | ||
| − | |||
==Building== | ==Building== | ||
| − | If you want to try it out on your own iPod, there are automatic builds but you might as well just check out the SVN and compile it yourself | + | If you want to try it out on your own iPod, there are automatic builds on [http://builds.freemyipod.org/ our buildserver], but you might as well just check out the [[SVN]] and compile it yourself. Here are the basic steps to compiling emBIOS for your iPod: |
* Check out the Freemyipod [[SVN]]. | * Check out the Freemyipod [[SVN]]. | ||
| − | * Build the UCL tool in the | + | * Build the UCL tool in the folder tools/ucl of the SVN using make and copy those tools to a place in your path. |
* Make sure you have the arm-eabi toolchain. You can easily build this using the rockboxdev.sh script in the tools directory of the Rockbox SVN. | * Make sure you have the arm-eabi toolchain. You can easily build this using the rockboxdev.sh script in the tools directory of the Rockbox SVN. | ||
| − | * If you | + | * You can compile emBIOS for all targets ('make') or for only some ('make target1 target2'). You can find out the target names on [http://builds.freemyipod.org/ the buildserver] |
| + | * If your toolchain prefix is not 'arm-none-eabi-' but something different (like 'arm-elf-eabi-' if you compile it with a toolchain created with the rockboxdev script) you can set the CROSS variable to your prefix. | ||
| + | |||
| + | So to compile for the iPod nano 2g with your toolchain prefixed with arm-elf-eabi- do: | ||
| + | |||
| + | <code>CROSS=arm-elf-eabi- make ipodnano2g</code> | ||
| + | |||
| + | ==Using== | ||
| + | To communicate with emBIOS use the embios.py python script in the [http://websvn.freemyipod.org/listing.php?repname=freemyipod&path=/embios/trunk/tools/&rev=672&peg=672 /embios/trunk/tools] folder of our SVN. You need to have libusb, python and pyusb 1.x for this to work. Simply run embios,py without any arguments to get a list of possible commands. You can upload and download from/to the memory, read the i2c bus, run emBIOS applications or complete firmware files and much more. Just try it out! | ||
Latest revision as of 18:59, 25 March 2011
|
The information and/or topic discussed here is not up to date. emBIOS was discontinued on 2011-03-25 and superseded by emCORE |
emBIOS (embedded BIOS) is best described as a hardware abstraction with threading and debugging capabilities built in. It was superseded by emCORE. It simplified development immensely by integrating drivers for all the iPods. Before drivers were scattered throughout multiple tools built for multiple iPods. If there was a bug fix for a driver, it would have to be applied in many different places. emBIOS attempted to solve this problem by providing a syscall interface that is standard throughout all iPod generations. This means that a build of a tool can work across generations as long as it is run on a native emBIOS. This allows for maximum code reuse.
emBIOS was designed with portability in mind. It should have also been able to be run on other devices like the BeagleBoard if someone would have ported the necessary drivers.
If you're curious about how emBIOS worked, you can browse its last SVN revision before its official death here.
Building
If you want to try it out on your own iPod, there are automatic builds on our buildserver, but you might as well just check out the SVN and compile it yourself. Here are the basic steps to compiling emBIOS for your iPod:
- Check out the Freemyipod SVN.
- Build the UCL tool in the folder tools/ucl of the SVN using make and copy those tools to a place in your path.
- Make sure you have the arm-eabi toolchain. You can easily build this using the rockboxdev.sh script in the tools directory of the Rockbox SVN.
- You can compile emBIOS for all targets ('make') or for only some ('make target1 target2'). You can find out the target names on the buildserver
- If your toolchain prefix is not 'arm-none-eabi-' but something different (like 'arm-elf-eabi-' if you compile it with a toolchain created with the rockboxdev script) you can set the CROSS variable to your prefix.
So to compile for the iPod nano 2g with your toolchain prefixed with arm-elf-eabi- do:
CROSS=arm-elf-eabi- make ipodnano2g
Using
To communicate with emBIOS use the embios.py python script in the /embios/trunk/tools folder of our SVN. You need to have libusb, python and pyusb 1.x for this to work. Simply run embios,py without any arguments to get a list of possible commands. You can upload and download from/to the memory, read the i2c bus, run emBIOS applications or complete firmware files and much more. Just try it out!
