Editing DS4-USB

Jump to navigation Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
'''Source:''' http://eleccelerator.com/wiki/index.php?title=DualShock_4 (full paste 17:50 UTC, 18 January 2014 )
'''Source:''' http://eleccelerator.com/wiki/index.php?title=DualShock_4 (full paste 17:50 UTC, 18 January 2014 )


'''Source:''' https://gist.github.com/johndrinkwater/7708901
=USB=


[[File:DUALSHOCK4 03.jpg|thumbnail|right]]
Audio definitely does not carry through USB.


== USB ==
The reports arrive once every 4ms.
[[SKU_Models_Nonretail|Nonretail]] consoles can use the [[%E2%98%85_Debug_Settings#Controller_Setting|★ Debug Settings : Controller Setting]] to use [[USB|USB]] instead of wireless.


Audio does not carry through {{G|USB}} in the case of a [[DualShock 4|Dual Shock 4]].
===Device Descriptor===
 
The reports arrive ~250 times per second (every ~4ms).
 
=== Device Descriptor ===


{| class="wikitable"
{| class="wikitable"
Line 79: Line 74:
|}
|}


=== Configuration Descriptor ===
===Configuration Descriptor===


{| class="wikitable"
{| class="wikitable"
Line 175: Line 170:
| 1 || bDescriptorType || 1 || 0x05 || (= 5)
| 1 || bDescriptorType || 1 || 0x05 || (= 5)
|-
|-
| 2 || bEndpointAddress || 1 || 0x84 || IN<--(1 000 0100)-->4 (PS3 Controller: 0x81)
| 2 || bEndpointAddress || 1 || 0x84 || IN<--(10 00 0100)-->4 (PS3 Controller: 0x81)
<small>
<small>
The address of this endpoint within the device:
The address of this endpoint within the device:
Line 223: Line 218:
| 1 || bDescriptorType || 1 || 0x05 || (= 5)
| 1 || bDescriptorType || 1 || 0x05 || (= 5)
|-
|-
| 2 || bEndpointAddress || 1 || 0x03 || OUT<--(0 000 0011)-->3 (PS3 Controller: 0x02)
| 2 || bEndpointAddress || 1 || 0x03 || OUT<--(00 00 0011)-->3 (PS3 Controller: 0x02)
|-
|-
| 3 || bmAttributes || 1 || 0x03 || Interrupt
| 3 || bmAttributes || 1 || 0x03 || Interrupt
Line 234: Line 229:


=== HID Report Descriptor ===
=== HID Report Descriptor ===
[https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf#page=26 HID Usage Tables 1.12 (p.26)]
 
[http://www.usb.org/developers/devclass_docs/Hut1_12v2.pdf HID Usage Tables 1.12 (p.26)]
 
<div style="height:650px; width:700px; overflow:auto">


{| class="wikitable sortable"
{| class="wikitable sortable"
Line 312: Line 310:
|0x15||0x00|| - ||Logical Minimum (0)||
|0x15||0x00|| - ||Logical Minimum (0)||
|-
|-
|0x25||0x7F|| - ||Logical Maximum (127)||Note: REPORT_SIZE (6) is too small for LOGICAL_MAXIMUM (127) which needs 7 bits
|0x25||0x7F|| - ||Logical Maximum (127)||
|-
|-
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)|| send (byte 07: msb 6 bits)
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)|| send (byte 07: msb 6 bits)
Line 701: Line 699:
|-
|-
|}
|}
</div><br />


<small>Total size of the Report descriptor is 0x01D3 (467)</small>
<small>Total size of the Report descriptor is 0x01D3 (467)</small>


=== Report Structure ===
===Report Structure===
==== Samples Report ====
====Samples Report====
<small>
<small>
{| cellpadding="4" style="border-collapse: collapse; text-align: center;"
{| cellpadding="4" style="border-collapse: collapse; text-align: center;"
Line 756: Line 756:
}}
}}


==== Data Format ====
====Data Format====
{| class="wikitable"
{| class="wikitable"
|+Data Format
|+Data Format
Line 774: Line 774:
|-
|-
|[1]
|[1]
|colspan="8"|{{padl}} Left stick axis X (0: {{padll}} left)
|colspan="8"|{{padl}} X axis (0 = {{padll}} left)
|-
|-
|[2]
|[2]
|colspan="8"|{{padl}} Left Stick axis Y (0: {{padlu}} up)
|colspan="8"|{{padl}} Y axis (0 = {{padlu}} up)
|-
|-
|[3]
|[3]
|colspan="8"|{{padr}} Right Stick axis X (0: {{padrl}} left)
|colspan="8"|{{padr}} Right Stick axis X
|-
|-
|[4]
|[4]
|colspan="8"|{{padr}} Right Stick axis Y (0: {{padru}} up)
|colspan="8"|{{padr}} Right Stick axis Y
|-
|-
|[5]
|[5]
Line 799: Line 799:
| 7=NW || 6=W || 5=SW || 4=S || 3=SE || 2=E || 1=NE || 0=N
| 7=NW || 6=W || 5=SW || 4=S || 3=SE || 2=E || 1=NE || 0=N
|-
|-
| '''↑←''' || '''←''' || '''↓←''' || '''↓''' || '''↓→''' || ''→ '' || '''↑→''' || '''↑'''
| '''↑←''' || '''←''' || '''↓←''' || '''↓''' || '''↓→''' || '''→''' || '''↑←''' || '''↑'''
|-
|-
|}
|}
Line 824: Line 824:
|colspan="8"|{{padr2}} Trigger
|colspan="8"|{{padr2}} Trigger
|-
|-
|[10 - 11]
|[10]
|colspan="8"|Seems to be a timestamp. A common increment value between two reports is 188 (at full rate the report period is 1.25ms). This timestamp is used by the PS4 to process acceleration and gyroscope data.
|colspan="8"|Unknown, seems to count downwards, non-random pattern
|-
|[11]
|colspan="8"|Unknown, seems to count upwards by 3, but by 2 when [10] underflows
|-
|-
|[12]
|[12]
Line 831: Line 834:
|-
|-
|[13 - 14]
|[13 - 14]
|colspan="8"|Gyro X: angular velocity measures (follows right-hand-rule)
|colspan="8"|Possibly Gyro X (seems to be signed): orientation measures
|-
|-
|[15 - 16]
|[15 - 16]
|colspan="8"|Gyro Y
|colspan="8"|Possibly Gyro Y
|-
|-
|[17 - 18]
|[17 - 18]
|colspan="8"|Gyro Z
|colspan="8"|Possibly Gyro Z
|-
|-
|[19 - 20]
|[19 - 20]
|colspan="8"|Accel X (signed): acceleration (positive: right)
|colspan="8"|Possibly Accel X: acceleration measures
|-
|-
|[21 - 22]
|[21 - 22]
|colspan="8"|Accel Y (signed): acceleration (positive: up)
|colspan="8"|Possibly Accel Y
|-
|-
|[23 - 24]
|[23 - 24]
|colspan="8"|Accel Z (signed): acceleration (positive: towards player)
|colspan="8"|Possibly Accel Z
|-
|-
|[25 - 29]
|[25 - 29]
Line 876: Line 879:
|-
|-
|[35]
|[35]
|0 if finger №1 is down.
|colspan="8"|T-PAD: tracking numbers, unique to each finger (№1) down, so for each lift and repress, it gets a newly incremented figure.
|colspan="7"|T-PAD: tracking numbers, unique to each finger (№1) down, so for each lift and repress, it gets a newly incremented figure.
|-
|-
|[36 - 38]
|[36 - 38]
Line 890: Line 892:
|-
|-
|[39]
|[39]
|0 if finger №2 is down.
|colspan="8"|T-PAD: tracking numbers, unique to each finger (№2) down.
|colspan="7"|T-PAD: tracking numbers, unique to each finger (№2) down.
|-
|-
|[40 - 42]
|[40 - 42]
Line 915: Line 916:
Speculation: sound, rumble (active: 1-255 / Left-Right small or large?) and LED (Color changing 8 bits for each of the R, G, and B primaries : 13-255?) are only carry through (always enable) blue-tooth.
Speculation: sound, rumble (active: 1-255 / Left-Right small or large?) and LED (Color changing 8 bits for each of the R, G, and B primaries : 13-255?) are only carry through (always enable) blue-tooth.


=== Class Requests ===
===Class Requests===


This is what happened with a controller that was not previously synced to the PS4
This is what happened with a controller that was not previously synced to the PS4
Please note that all contributions to PS4 Developer wiki are considered to be released under the GNU Free Documentation License 1.2 (see PS4 Developer wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following hCaptcha:

Cancel Editing help (opens in new window)