Difference between revisions of "USB"

From ReactOS Wiki
Jump to: navigation, search
(→‎Vgal USB state: USBCCGP SelectConfiguration is fixed)
(19 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
{{Warning|With current versions of ReactOS, USB support is '''NOT''' advanced enough to successfully work with USB flash-drives, web-cameras and etc. Please  mind that system may crash due problem caused by USB-device. Please, if possible, avoid using USB devices together with ReactOS,  unless you know what you are doing.}}
 
{{Stub}}
 
{{Stub}}
 +
== Vgal USB state ==
 +
Here is the current state of Vadim Galyant's [https://github.com/reactos/reactos/pull/245/#issuecomment-367211489 USB patches], which all together represent the new version of the ReactOS USB stack.
 +
 +
Additional notes are listed below the table.
 +
 +
{| class="sortable wikitable"
 +
|-
 +
! style="width: 3%;" | # apply seq
 +
! style="" | Patch name
 +
! style="" | # PR
 +
! style="" | Status
 +
! style="width: 6%;" | LiveUSB Required
 +
|-
 +
| 1
 +
| [USBPORT] Transaction Translator
 +
| [https://github.com/reactos/reactos/pull/283 #283]
 +
| {{StatusCell|Stable}} | Merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 2
 +
| [USBPORT] Correct size adressing for PA (01)
 +
| {{GitRev|c89a190ea655b030f4cc91de8b47ead424e9d339}}
 +
| {{StatusCell|Stable}} | Merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 3
 +
| [USBOHCI_NEW] Correct size adressing for PA
 +
| {{GitRev|c89a190ea655b030f4cc91de8b47ead424e9d339}}
 +
| {{StatusCell|Stable}} | Merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 4
 +
| [USBUHCI_NEW][USBOHCI_NEW][USBEHCI_NEW][USBHUB_NEW] Enable drivers
 +
| {{GitRev|88cf5b0a3c429437d8dddb2f2759812b99683087}}
 +
| {{StatusCell|Stable}} | Merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 5
 +
| [USBUHCI_NEW] Bring-in new USB UHCI driver '''(requires patch 2, 3)'''
 +
| [https://github.com/reactos/reactos/pull/245 #245]
 +
| {{StatusCell|Stable}} | Merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 6
 +
| [USBEHCI_NEW] Bring-in new USB EHCI driver '''(requires patch 2, 3)'''
 +
| [https://github.com/reactos/reactos/pull/301 #301]
 +
| {{StatusCell|Stable}} | Merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 7
 +
| [USBSTOR_NEW] Bring-in new USB Storage driver
 +
| [https://github.com/reactos/reactos/pull/1450 #1450]
 +
| {{StatusCell|Stable}} | Merged
 +
|
 +
|-
 +
| 8
 +
| [USBHUB] Black list for unsupported devices
 +
| N/A
 +
| {{StatusCell|Failed}} | Will not be merged
 +
| {{StatusCell|Unknown}} | H/W depend
 +
|-
 +
| 9
 +
| [USBHUB] Make ReactOS bootable from USB
 +
| N/A
 +
| {{StatusCell|Unknown}} | Not merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 10
 +
| [USBCCGP] Fix SelectConfiguration NULL handling
 +
| {{GitRev|46b0f6d9deec116523bf8748a05abecc0ac22672}}
 +
| {{StatusCell|Failed}} | Superseded
 +
|
 +
|-
 +
| 11
 +
| [HID] Bring-in new USB HID support
 +
| N/A
 +
| {{StatusCell|Unknown}} | Not merged
 +
|
 +
|-
 +
| 12
 +
| [NTOSKRNL][HAL] Allow USB boot in PnP Enumeration Worker
 +
| [https://github.com/reactos/reactos/pull/1569 #1569]
 +
| {{StatusCell|Unknown}} | Not merged
 +
| {{StatusCell|Stable}} | Yes
 +
|-
 +
| 13
 +
| [USBHUB] Move DPRINT after check Status
 +
| [https://github.com/reactos/reactos/pull/282 #282]
 +
| {{StatusCell|Stable}} | Merged
 +
|
 +
|-
 +
| 14
 +
| [NTOSKRNL][BOOT] Hack for ImportHwIDs
 +
| N/A
 +
| {{StatusCell|Unknown}} | Not merged
 +
|
 +
|-
 +
| 15
 +
| [NTOSKRNL][USETUP] Hack for USB keyboard in 1st Stage Setup
 +
| {{GitRev|63286c6bbc300c55a3b0120d37a637ec25a8fe44}}
 +
| {{StatusCell|Failed}} | Superseded
 +
|
 +
|-
 +
| 16
 +
| [NTOSKRNL] Fix and improve IopValidateID()
 +
| [https://github.com/reactos/reactos/pull/341 #341]
 +
| {{StatusCell|Stable}} | Merged
 +
|
 +
|-
 +
| 17
 +
| [USBPORT][USBHUB_NEW] Fix QueryIDs
 +
| {{GitRev|3baf43c5def76d2b30bc32f5792c110c3e90e686}}
 +
| {{StatusCell|Stable}} | Merged
 +
|
 +
|}
 +
 +
=== Additional notes ===
 +
* To achieve successfull Live USB boot, it is enough to merge all patches that are marked as '''Required'''.
 +
* Before merging new UHCI and EHCI drivers, "'''Correct size adressing for PA'''" patches should be merged.
 +
* Patch #8 with black list of devices is required to boot successfully on some machines, until the support for Isochronous Transfers would be implemented.
 +
 +
== See also ==
 
* [[USB Stack]]
 
* [[USB Stack]]
 
* [[USB Todo]]
 
* [[USB Todo]]
 
* [[Supported USB Devices]]
 
* [[Supported USB Devices]]
−
* [[LiveUSB|Booting from a USB disk]]
+
* [[LiveUSB|LiveUSB - Booting from a USB disk]]
−
* [http://www.reactos.org/forum/viewtopic.php?f=2&t=10835 USB Working January 26, 2012]
+
* [[User:Illen/RAM_Boot|USB RAM Boot]]
−
* [http://www.reactos.org/forum/viewtopic.php?f=15&t=10909 USB branch merged at r55555]
+
* [[USB Testing]]
−
* [http://old.reactos.org/en/newsletter_56.html#sec0 History of USB in ReactOS] April 9th, 2009
+
 
−
* [http://old.reactos.org/en/newsletter_71.html#sec0 More news about USB] April 22nd, 2010
+
== Links ==
−
* [http://old.reactos.org/en/newsletter_83.html#sec1 New USB Drivers] April 28th, 2011
+
* [https://web.archive.org/web/20141127220403/http://old.reactos.org/en/newsletter_56.html#sec0 History of USB in ReactOS] April 9th, 2009
−
* [http://old.reactos.org/en/newsletter_90.html#sec1 Two of Four host controller interface drivers completed]  January 23rd, 2012
+
* [https://web.archive.org/web/20141127220416/http://old.reactos.org/en/newsletter_71.html#sec0 More news about USB] April 22nd, 2010
−
* [http://old.reactos.org/en/newsletter_91.html#sec3 USB branch merged with trunk] February 28th, 2012
+
* [https://web.archive.org/web/20141127220422/http://old.reactos.org/en/newsletter_83.html#sec1 New USB Drivers] April 28th, 2011
 +
* [https://web.archive.org/web/20130524183039/http://old.reactos.org/en/newsletter_90.html#sec1 Two of Four host controller interface drivers completed]  January 23rd, 2012
 +
* [http://www.reactos.org/forum/viewtopic.php?f=2&t=10835 USB Working] January 26, 2012
 +
* [http://www.reactos.org/forum/viewtopic.php?f=15&t=10909 USB branch merged at r55555] February 12th, 2012
 +
* [https://web.archive.org/web/20141127220416/http://old.reactos.org/en/newsletter_91.html#sec3 USB branch merged with trunk] February 28th, 2012
  
 
[[Category:Hardware]]
 
[[Category:Hardware]]
 
[[Category:Development]]
 
[[Category:Development]]

Revision as of 07:57, 1 October 2019

Icon speedy deletion.png Warning: With current versions of ReactOS, USB support is NOT advanced enough to successfully work with USB flash-drives, web-cameras and etc. Please mind that system may crash due problem caused by USB-device. Please, if possible, avoid using USB devices together with ReactOS, unless you know what you are doing.


The page USB is a short article on something that should have a lot more information written on it.
If you know anything else about it, you are STRONGLY encouraged to add the information in. If you are unsure of proper formatting or style, add it to the talk page or this page itself as you think best and others will help.


Vgal USB state

Here is the current state of Vadim Galyant's USB patches, which all together represent the new version of the ReactOS USB stack.

Additional notes are listed below the table.

# apply seq Patch name # PR Status LiveUSB Required
1 [USBPORT] Transaction Translator #283 Merged Yes
2 [USBPORT] Correct size adressing for PA (01) c89a190 Merged Yes
3 [USBOHCI_NEW] Correct size adressing for PA c89a190 Merged Yes
4 [USBUHCI_NEW][USBOHCI_NEW][USBEHCI_NEW][USBHUB_NEW] Enable drivers 88cf5b0 Merged Yes
5 [USBUHCI_NEW] Bring-in new USB UHCI driver (requires patch 2, 3) #245 Merged Yes
6 [USBEHCI_NEW] Bring-in new USB EHCI driver (requires patch 2, 3) #301 Merged Yes
7 [USBSTOR_NEW] Bring-in new USB Storage driver #1450 Merged
8 [USBHUB] Black list for unsupported devices N/A Will not be merged H/W depend
9 [USBHUB] Make ReactOS bootable from USB N/A Not merged Yes
10 [USBCCGP] Fix SelectConfiguration NULL handling 46b0f6d Superseded
11 [HID] Bring-in new USB HID support N/A Not merged
12 [NTOSKRNL][HAL] Allow USB boot in PnP Enumeration Worker #1569 Not merged Yes
13 [USBHUB] Move DPRINT after check Status #282 Merged
14 [NTOSKRNL][BOOT] Hack for ImportHwIDs N/A Not merged
15 [NTOSKRNL][USETUP] Hack for USB keyboard in 1st Stage Setup 63286c6 Superseded
16 [NTOSKRNL] Fix and improve IopValidateID() #341 Merged
17 [USBPORT][USBHUB_NEW] Fix QueryIDs 3baf43c Merged

Additional notes

  • To achieve successfull Live USB boot, it is enough to merge all patches that are marked as Required.
  • Before merging new UHCI and EHCI drivers, "Correct size adressing for PA" patches should be merged.
  • Patch #8 with black list of devices is required to boot successfully on some machines, until the support for Isochronous Transfers would be implemented.

See also

Links

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