Difference between revisions of "Install ReactOS on Xbox"

From ReactOS Wiki
Jump to: navigation, search
(First edition)
 
(Update link to official XboxDev Cromwell)
 
(21 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Installing is fairly simple, however there are some prerequsites:
+
'''ReactOS''' can be either installed to your '''Xbox''' or started via Live CD without installing.
  
1. You should be able to transfer files to XBox's HDD somehow (best is FTP server, Linux running on xbox (http://xbox-linux.org) but you can also attach the HDD to your PC - manuals for this are located on the same great http://xbox-linux.org site.
+
[[File:Cromwell BIOS - ReactOS Boot.png|200px|thumb|right|Cromwell BIOS starting ReactOS]]
2. Your knowledge how to run custom software on the xbox (you can gain it from the same site).
+
A modified '''Cromwell BIOS''' is required, which allows you to boot '''ReactOS''' or '''Linux'''. It's available in two forms: a flashable BIOS image and a standalone XBE file. The first one can be flashed into the BIOS (if you have a modchip, it works very well), and the second one can be started directly from the dashboard. It's fully free and can be downloaded below:
  
 +
* https://github.com/XboxDev/cromwell/releases
  
Steps to install:
+
If you are using '''XQEMU''', simply pass it via command-line parameter:
1. Copy freeldr.ini/freeldr.sys into root directory of E: drive
 
2. Copy ReactOS folder from where you have it working (virtual machine, real hdd) to  ReactOS folder on E: drive
 
3. Run modified cromwell (which allows to boot ReactOS or Linux) - you can either flash it to the bios (if you have a modchip, it works very well) or write to the C: drive as .xbe file and run it using a dashboard.
 
  
 +
-bios image.bin
  
Things to remember:
+
== Before boot ==
1. Don't forget to detach your xpad controller because currently reactos won't boot with it
+
# Don't forget to detach your Xbox Gamepad controller because currently, ReactOS won't boot with it.
2. Attach your keyboard and mouse before booting into reactos (well, hotplug should work too, but since whole usb stack is now in experimental mode it may not work).
+
# Attach your keyboard and mouse before booting into ReactOS (well, hotplug should work too, but since whole USB stack is now in experimental mode it may not work).
3. It's just fun for now, nothing else. You can browse your xbox's hdd in explorer, as if it's just a pc computer, you can even do some very simple things, but not very much really. But with time - when we finish nvidia network card driver, it's gonna become more interesting since possibilities are endless - there are so plenty of software for Win32 that there is definately something cool you may want to try to run on your XBox :-)
+
 
 +
In the case of XQEMU, find these parameters:
 +
 
 +
-usb -device usb-xbox-gamepad
 +
 
 +
And replace them with:
 +
 
 +
-usb -device usb-kbd -device usb-mouse
 +
 
 +
== Running Live CD ==
 +
Just insert your burned CD into the drive, and select CD-ROM (hdb) boot in Cromwell BIOS.
 +
 
 +
In the case of XQEMU, specify a file for cdrom:
 +
 
 +
-drive index=1,media=cdrom,file=livecd.iso
 +
 
 +
== Installing to Xbox HDD ==
 +
Installation from the Boot CD currently is not supported, however, there's an alternative install method which is fairly simple.
 +
 
 +
=== Some prerequisites ===
 +
# You should be able to transfer files to Xbox's HDD somehow (best is FTP server, running on Xbox Linux (http://xbox-linux.org) but you can also attach the HDD to your PC – manuals for this are located on the same great http://xbox-linux.org site).
 +
# Your knowledge how to run custom software on the Xbox (you can gain it from the same site).
 +
 
 +
In the case of XQEMU, you can just use XboxHDM to create a disk image with FATX partitions:
 +
 
 +
* https://github.com/xqemu/xqemu-hdd-image
 +
 
 +
=== Steps to install ===
 +
# Copy <code>freeldr.ini</code> and <code>freeldr.sys</code> into root directory of <code>E:</code> drive.
 +
# Copy <code>ReactOS</code> folder from where you have it working (virtual machine, real HDD) to <code>ReactOS</code> folder on <code>E:</code> drive.
 +
 
 +
[[File:XboxHDM - ReactOS Files on E.png|200px|thumb|right|All files in place]]
 +
In the case of XQEMU, just move these files into <code>/xboxhdm/linux/E/</code> directory. Optionally, if you are using stock BIOS for gaming, you should place <code>reactos.xbe</code> in <code>/xboxhdm/linux/C/</code> directory. Once all files are in place, generate <code>linux.iso</code> which will allow to run XboxHDM and create a virtual HDD for XQEMU with your files.
 +
 
 +
== Booting from PC HDD ==
 +
: '''Note:''' you should have ''Cromwell BIOS flashed'' to the chip to use this boot method. It won't work with Xromwell XBE loader, and it will break your Xbox dashboard! Also note that hard disk should be ''formatted as FAT32'', not BTRFS or any other file system.
 +
 
 +
Latest Cromwell BIOS firmware supports booting from native FAT32 partitions. You can use <code>dd</code> utility to write HDD image, or just replace Xbox hard disk with PC hard disk where you have ReactOS installed.
 +
 
 +
[[Category:Tutorial]]

Latest revision as of 20:16, 6 January 2020

ReactOS can be either installed to your Xbox or started via Live CD without installing.

Cromwell BIOS starting ReactOS

A modified Cromwell BIOS is required, which allows you to boot ReactOS or Linux. It's available in two forms: a flashable BIOS image and a standalone XBE file. The first one can be flashed into the BIOS (if you have a modchip, it works very well), and the second one can be started directly from the dashboard. It's fully free and can be downloaded below:

If you are using XQEMU, simply pass it via command-line parameter:

-bios image.bin

Before boot

  1. Don't forget to detach your Xbox Gamepad controller because currently, ReactOS won't boot with it.
  2. Attach your keyboard and mouse before booting into ReactOS (well, hotplug should work too, but since whole USB stack is now in experimental mode it may not work).

In the case of XQEMU, find these parameters:

-usb -device usb-xbox-gamepad

And replace them with:

-usb -device usb-kbd -device usb-mouse

Running Live CD

Just insert your burned CD into the drive, and select CD-ROM (hdb) boot in Cromwell BIOS.

In the case of XQEMU, specify a file for cdrom:

-drive index=1,media=cdrom,file=livecd.iso

Installing to Xbox HDD

Installation from the Boot CD currently is not supported, however, there's an alternative install method which is fairly simple.

Some prerequisites

  1. You should be able to transfer files to Xbox's HDD somehow (best is FTP server, running on Xbox Linux (http://xbox-linux.org) but you can also attach the HDD to your PC – manuals for this are located on the same great http://xbox-linux.org site).
  2. Your knowledge how to run custom software on the Xbox (you can gain it from the same site).

In the case of XQEMU, you can just use XboxHDM to create a disk image with FATX partitions:

Steps to install

  1. Copy freeldr.ini and freeldr.sys into root directory of E: drive.
  2. Copy ReactOS folder from where you have it working (virtual machine, real HDD) to ReactOS folder on E: drive.
All files in place

In the case of XQEMU, just move these files into /xboxhdm/linux/E/ directory. Optionally, if you are using stock BIOS for gaming, you should place reactos.xbe in /xboxhdm/linux/C/ directory. Once all files are in place, generate linux.iso which will allow to run XboxHDM and create a virtual HDD for XQEMU with your files.

Booting from PC HDD

Note: you should have Cromwell BIOS flashed to the chip to use this boot method. It won't work with Xromwell XBE loader, and it will break your Xbox dashboard! Also note that hard disk should be formatted as FAT32, not BTRFS or any other file system.

Latest Cromwell BIOS firmware supports booting from native FAT32 partitions. You can use dd utility to write HDD image, or just replace Xbox hard disk with PC hard disk where you have ReactOS installed.