Difference between revisions of "Xbox Port Roadmap"

From ReactOS Wiki
Jump to: navigation, search
(→‎Revive ReactOS Xbox port)
(→‎Implement missing drivers)
 
(56 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
This page describes the plan of reviving ReactOS port for original Xbox, including components outside the source tree.
+
This page describes the plan of reviving the ReactOS port for the original Xbox, including components outside the source tree.
  
 
Once something is done in this list, it should be simply removed.
 
Once something is done in this list, it should be simply removed.
Line 9: Line 9:
 
* Fix USB OHCI - {{JIRA|16352}}
 
* Fix USB OHCI - {{JIRA|16352}}
 
** Blocks actual OS testing in XQEMU
 
** Blocks actual OS testing in XQEMU
−
** '''Important:''' check whether the problem is reproduced on real Xbox
+
** Reproduced on RealHW as well
−
* Fix PCI-to-PCI bridge PnP problem - {{JIRA|16319}}
+
* Fix USBH_ProcessHubStateChange: OverCurrent problem - {{JIRA|16726}}
−
** RealHW only, applied workaround in master - {{GitRev|b99272702c94f5c6707dc095d3d11bb5a0147c43}}
+
** RealHW only
−
* Fix <code>FindResourceExW</code> debug print problem ''(low priority)''
+
* <code>Assertion failed: (pti->pcti->fsChangeBits & QS_SENDMESSAGE) == 0</code> happens in <code>win32ss/user/ntuser/misc.c, line 729</code> after some idle hours, and it can be safely cont'ed from kernel debugger
−
** Too hard to reproduce
+
** Does not happen with <code>usbohci.sys</code> from Windows 2003 for some reason
 +
* Xbox HAL: Shutdown does not happen, shows "It is now safe to turn off your computer" picture
 +
* Serial COM1 is not accessible for user-mode, the port can be opened, but both RX and TX are ignored - '''FIXME: needs ticket'''
 +
** RealHW only, the debug port lacks SERIRQ, so it cannot utilize interrupt
 +
* VBE driver causes KiTrap06Handler unrecoverable error when trying to attach to XGPU PCI device - {{JIRA|17643}}
 +
** RealHW only
 +
* <code>Memory at 0xFFFFFFFF could not be accessed</code> on 1st stage setup (Boot CD), reproduced only in GCC builds with 64 MB RAM - {{JIRA|18370}}
 +
** This is either related to the memory manager or to the video drivers (e.g. blue.sys or miniports), real cause is unknown yet
 +
* When booting from FATX volume, SYSTEM hive gets corrupted on next boot - '''FIXME: needs ticket'''
 +
** Likely a bug in our old fastfat driver, which is being used for FATX support now
  
 
=== Improve ReactOS ===
 
=== Improve ReactOS ===
−
* Obtain memory map via multiboot on Xbox - {{JIRA|16300}}, [https://github.com/reactos/reactos/pull/1971 PR #1971]
+
* Add Xbox machine detection into setuplib - '''FIXME: needs ticket'''
−
** Will allow <code>bootvid</code> and <code>xboxvmp</code> to work properly
+
** See [https://git.reactos.org/?p=reactos.git;a=blob;f=base/setup/lib/settings.c;hb=9fc87dacdb653b647538180a32002117389b36dc#l276 this code]
−
** Will allow firmware to prepare SMBIOS/PCI BIOS tables in memory
 
 
* Add bootvid selection into <code>txtsetup.sif</code> and <code>setuplib</code> - '''FIXME: needs ticket'''
 
* Add bootvid selection into <code>txtsetup.sif</code> and <code>setuplib</code> - '''FIXME: needs ticket'''
 
** See [https://chat.reactos.org/reactos/pl/ourrbyihibbf5p8whcb879uwzy chat message] from Hermes Belusca
 
** See [https://chat.reactos.org/reactos/pl/ourrbyihibbf5p8whcb879uwzy chat message] from Hermes Belusca
−
* Fix Xbox HAL to report reserved video memory range for NVIDIA NV2A - '''FIXME: needs ticket'''
+
* Add missing devices into Xbox HAL device tree:
 +
** PIC (<code>*PNP0000</code>)
 +
** Timer (<code>*PNP0100</code>)
 +
** DMA Controller (<code>*PNP0200</code>)
 +
** Speaker (<code>*PNP0800</code>)
 +
** CMOS/RTC (<code>*PNP0B00</code>)
 +
* Xbox HAL: Report Flash ROM memory range as <code>*PNP0C02</code> aka "Motherboard resources" (0xFF000000 - 0xFFFFFFFF)
 +
* Xbox HAL: Report LPC SuperIO controller (I/O ports 0x2E-0x2F) as <code>*PNP0A05</code> (aka Generic ACPI Bus) if it's detected
 +
* Xbox HAL: Flash, SuperIO, and other LPC devices should be children of ISA to PCI bridge
 +
* Xbox HAL: Serial COM ports should be children of SuperIO device
 +
* Xbox HAL: Report reserved video memory range for NVIDIA NV2A (use "NV2A Framebuffer" resource added earlier, maybe as <code>*PNP0C02</code> aka "Motherboard resources") - '''FIXME: needs ticket'''
 
** See [https://chat.reactos.org/reactos/pl/83uwqwtb63yefm5ca8qy3qgmtr chat message] from Thomas Faber
 
** See [https://chat.reactos.org/reactos/pl/83uwqwtb63yefm5ca8qy3qgmtr chat message] from Thomas Faber
−
* Add ATAPI support into FreeLdr - {{JIRA|16220}}
 
−
** Will allow to test bootcd and livecd
 
−
** Could be useful for [[PC-98]] port as well
 
 
* Add automatic HAL selection in FreeLdr - '''FIXME: needs ticket'''
 
* Add automatic HAL selection in FreeLdr - '''FIXME: needs ticket'''
 
** Will allow to test bootcd and livecd
 
** Will allow to test bootcd and livecd
−
* Add support for Xbox BRFR partitions - {{JIRA|16329}}
 
−
** Requires <code>disk_new</code> driver - {{JIRA|6264}}
 
−
** Blocks testing on real hardware
 
−
* Fix or implement FATX filesystem driver - {{JIRA|16373}}
 
−
** FATX support should be removed from <code>fastfat</code>, or not, if we switch to <code>fastfat_new</code> ''(but when?)'' - {{JIRA|11819}}
 
−
** Blocks testing on real hardware
 
 
* Add input support in FreeLdr on Xbox - {{JIRA|16218}} ''(low priority)''
 
* Add input support in FreeLdr on Xbox - {{JIRA|16218}} ''(low priority)''
 
** <code>freeldr.ini</code> can be modified manually
 
** <code>freeldr.ini</code> can be modified manually
 
* Add HAL/video/bootvid sections into <code>unattend.inf</code> - '''FIXME: needs ticket'''
 
* Add HAL/video/bootvid sections into <code>unattend.inf</code> - '''FIXME: needs ticket'''
−
 
−
=== Documentation ===
 
−
* Fix constants and variables naming in <code>freeldr</code> and <code>xboxvmp</code> from Xbox-Linux to MS ''(low priority)''
 
  
 
=== Implement missing drivers ===
 
=== Implement missing drivers ===
−
* Add <code>bootvid</code> driver for Xbox - {{JIRA|16219}}
+
* nForce network driver for KDNET - {{JIRA|18223}}
−
** Nice for public demonstration and user experience
+
** Will allow debugging without serial LPC adapter
−
* Add <code>vgasave</code> driver for NVIDIA NV2A - '''FIXME: needs ticket'''
+
* Console text mode driver for NVIDIA NV2A - '''FIXME: needs ticket'''
 +
** Will allow installing from bootcd
 +
* <code>vgasave</code> driver for NVIDIA NV2A - '''FIXME: needs ticket'''
 
** See [https://chat.reactos.org/reactos/pl/kptqdu1uppbc3qogujqjioz83e chat message] from r3mendozal
 
** See [https://chat.reactos.org/reactos/pl/kptqdu1uppbc3qogujqjioz83e chat message] from r3mendozal
−
* Add NVIDIA nForce <code>nvnet</code> driver - {{JIRA|15872}} ''(low priority)''
 
−
** First test with existing closed-source driver
 
−
** Potentially will help improving XQEMU nForce net emulation
 
 
* Improve <code>xboxvmp</code> driver to support NVIDIA hardware acceleration ''(low priority)''
 
* Improve <code>xboxvmp</code> driver to support NVIDIA hardware acceleration ''(low priority)''
 
** Add support for 2D acceleration
 
** Add support for 2D acceleration
Line 55: Line 60:
 
** Add support for OpenGL
 
** Add support for OpenGL
 
** Potentially will help here - [https://jira.reactos.org/browse/CORE-16465?focusedCommentId=118579&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-118579 CORE-16465]
 
** Potentially will help here - [https://jira.reactos.org/browse/CORE-16465?focusedCommentId=118579&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-118579 CORE-16465]
−
 
+
* UDFX filesystem driver (used with XISO/XDVDFS disks)
−
=== Backport fixes into XboxDev Cromwell ===
+
* USB Gamepad XID driver - '''FIXME: needs ticket'''
−
* Boot refactoring and improvements
+
** See https://web.archive.org/web/20191214213754/http://euc.jp/periphs/xbox-controller.en.html
−
** Refactor Linux CD boot and allow to cancel it
+
** There are possible options to import existing drivers:
−
** Improve Linux loading text prints
+
*** https://github.com/thundercatsNZ/xbcd - XBox Controller Driver (kernel mode driver, compatible with XP)
−
** General refactoring of boot code
+
*** https://github.com/emoose/Xb2XInput - User-mode Windows driver for Xbox OG controllers
−
* Add multisystem support
+
* Xbox Memory Unit (XMU) driver - '''FIXME: needs ticket'''
−
** Prepare for multisystem support and more refactoring
+
** See https://xboxdevwiki.net/Xbox_Memory_Unit - <code>USB\VID_045E&PID_0280</code>
−
** Refactor config entries finalization
+
* Xbox Wireless Adapter (MN-740) driver - '''FIXME: needs ticket'''
−
** Better function naming for multisystem
+
** See https://xboxdevwiki.net/Network#Wireless_adapter
−
** Add nested multisystem boot menu
+
* Xbox Live Communicator driver - '''FIXME: needs ticket'''
−
* Fix displaying some hardware information
+
** See https://xboxdevwiki.net/Xbox_Live_Communicator - <code>USB\VID_045E&PID_0283</code>
−
* Fix infinite boot loop and refactor timeout a bit
+
* Xbox Video Camera driver - '''FIXME: needs ticket'''
−
* Fix array write out-of-bounds bug in <code>rawread</code>
+
** See https://www.gsp.com/cgi-bin/man.cgi?section=4&topic=ov519 - <code>USB\VID_045E&PID_028C</code>
−
* Add ReactOS boot support
 
−
** Add some debug prints for ReactOS boot
 
−
** Fix booting ReactOS, specify boot device properly
 
−
** Fix interpreting multiboot header according to the spec
 
−
** Add ReactOS native partition boot support
 
  
 
=== Fix bugs and improve Cromwell ===
 
=== Fix bugs and improve Cromwell ===
 
* Fix glitchy text characters: '''. _ ( f'''
 
* Fix glitchy text characters: '''. _ ( f'''
 
* Fix boot device label positioning (in 720x480 and 1024x576 screen mode)
 
* Fix boot device label positioning (in 720x480 and 1024x576 screen mode)
−
* Fix static framebuffer address (64 vs 128 MB RAM)
 
−
* Fix memory map
 
−
* Fix Xromwell XBE problems on some Xbox'es ''(at least the one JayFoxRox have)''
 
 
* Add SMBIOS table generation
 
* Add SMBIOS table generation
 
** Check corresponding data on NVIDIA nForce 420 board
 
** Check corresponding data on NVIDIA nForce 420 board
Line 89: Line 86:
 
* Other published issues: https://github.com/XboxDev/cromwell/issues
 
* Other published issues: https://github.com/XboxDev/cromwell/issues
  
−
== Create open source Xbox firmware ==
+
== Create open source Xbox OS ==
 
See page [[Run Xbox Games on ReactOS‎]].
 
See page [[Run Xbox Games on ReactOS‎]].
  
 
[[Category: Documentation]]
 
[[Category: Documentation]]
 
[[Category: Development]]
 
[[Category: Development]]

Latest revision as of 16:30, 9 November 2022

This page describes the plan of reviving the ReactOS port for the original Xbox, including components outside the source tree.

Once something is done in this list, it should be simply removed.

Revive ReactOS Xbox port

Progress is tracked in CORE-16216.

Fix ReactOS bugs

  • Fix USB OHCI - CORE-16352
    • Blocks actual OS testing in XQEMU
    • Reproduced on RealHW as well
  • Fix USBH_ProcessHubStateChange: OverCurrent problem - CORE-16726
    • RealHW only
  • Assertion failed: (pti->pcti->fsChangeBits & QS_SENDMESSAGE) == 0 happens in win32ss/user/ntuser/misc.c, line 729 after some idle hours, and it can be safely cont'ed from kernel debugger
    • Does not happen with usbohci.sys from Windows 2003 for some reason
  • Xbox HAL: Shutdown does not happen, shows "It is now safe to turn off your computer" picture
  • Serial COM1 is not accessible for user-mode, the port can be opened, but both RX and TX are ignored - FIXME: needs ticket
    • RealHW only, the debug port lacks SERIRQ, so it cannot utilize interrupt
  • VBE driver causes KiTrap06Handler unrecoverable error when trying to attach to XGPU PCI device - CORE-17643
    • RealHW only
  • Memory at 0xFFFFFFFF could not be accessed on 1st stage setup (Boot CD), reproduced only in GCC builds with 64 MB RAM - CORE-18370
    • This is either related to the memory manager or to the video drivers (e.g. blue.sys or miniports), real cause is unknown yet
  • When booting from FATX volume, SYSTEM hive gets corrupted on next boot - FIXME: needs ticket
    • Likely a bug in our old fastfat driver, which is being used for FATX support now

Improve ReactOS

  • Add Xbox machine detection into setuplib - FIXME: needs ticket
  • Add bootvid selection into txtsetup.sif and setuplib - FIXME: needs ticket
  • Add missing devices into Xbox HAL device tree:
    • PIC (*PNP0000)
    • Timer (*PNP0100)
    • DMA Controller (*PNP0200)
    • Speaker (*PNP0800)
    • CMOS/RTC (*PNP0B00)
  • Xbox HAL: Report Flash ROM memory range as *PNP0C02 aka "Motherboard resources" (0xFF000000 - 0xFFFFFFFF)
  • Xbox HAL: Report LPC SuperIO controller (I/O ports 0x2E-0x2F) as *PNP0A05 (aka Generic ACPI Bus) if it's detected
  • Xbox HAL: Flash, SuperIO, and other LPC devices should be children of ISA to PCI bridge
  • Xbox HAL: Serial COM ports should be children of SuperIO device
  • Xbox HAL: Report reserved video memory range for NVIDIA NV2A (use "NV2A Framebuffer" resource added earlier, maybe as *PNP0C02 aka "Motherboard resources") - FIXME: needs ticket
  • Add automatic HAL selection in FreeLdr - FIXME: needs ticket
    • Will allow to test bootcd and livecd
  • Add input support in FreeLdr on Xbox - CORE-16218 (low priority)
    • freeldr.ini can be modified manually
  • Add HAL/video/bootvid sections into unattend.inf - FIXME: needs ticket

Implement missing drivers

Fix bugs and improve Cromwell

  • Fix glitchy text characters: . _ ( f
  • Fix boot device label positioning (in 720x480 and 1024x576 screen mode)
  • Add SMBIOS table generation
    • Check corresponding data on NVIDIA nForce 420 board
  • Add PCI BIOS table generation
    • Check corresponding data on NVIDIA nForce 420 board
  • Import features from XBOverclock project
  • Add full device information page for Peripherals menu (low priority)
  • Other published issues: https://github.com/XboxDev/cromwell/issues

Create open source Xbox OS

See page Run Xbox Games on ReactOS‎.

Retrieved from "https://reactos.org/wiki/index.php?title=Xbox_Port_Roadmap&oldid=54350"