Editing Talk:DualShock 4

== Eleccelerator ==

Hi, this is Frank, Eleccelerator is my website. I noticed the little message you've sent me (please use email next time, I don't check my own wiki edits, but I can't find your email either lol so I'm a hypocrite right now). Feel free to copy whatever information you want, I want the information to be public. Including a link to my website would be nice though.

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

: I’ve been decoding the USB reports independently and appear to have got further along, when I’m happy that most of the packet is described, I’ll integrate my findings, still a few nibbles unaccounted for though… https://gist.github.com/johndrinkwater/7708901 -- [[User:Johndrinkwater|Johndrinkwater]] ([[User talk:Johndrinkwater|talk]]) 05:22, 3 December 2013 (EST)

----

Review:

It feels really good to hold.

=Hardware=

Teardown photo album: http://imgur.com/a/ytRW5

The USB port and LED are on one separate board, connected using a [http://en.wikipedia.org/wiki/Flexible_flat_cable flat flexible cable], this cable is connected to a vertical FFC connector that does not have a locking mechanism.

The touchpad sensor is also detachable, connected using a flat flexible cable, this cable is connected to the main PCB using a connector that has a flip-up locking mechanism.

The speaker is not removable and it connects to the main PCB using some raised contacts.

The battery is 3.65V 1000mAH Li-ion.

Main microcontroller is a Spansion MB9BF002, a ARM Cortex M3 core, BGA package. The reset and SWD signals might be exposed to test points, I am not sure.

The Bluetooth module shows "8LA18366" and "GS-WCM-01" (or maybe it's "GS-WCN-01") and "VR2.0". There is also a QR code that I can't decipher yet. There are a lot of test points near it. Underneath, it is confirmed to be a Qualcomm Atheros AR3002.

There's a chip marked with "BD9200" (in QFN 32 pin footprint) that might be a PMIC because it has some thick traces around it, plus a big inductor. One of the pins near it read 6V, might be for the motor.

There's a shiny small square chip left of the left analog stick, it is marked with "7710" "325A1", I have no idea what this is, but there's some differential signals coming out of it, it might be USB, the activity stops when I disconnect the USB cable. I think this is connected to the USB port. I suspect this is a OTG chip.

There's a rectangular (maybe LGA) chip on the bottom side on the left, marked with "134" "A1322" "333", possibly a sensor. It's got some sort of latch signal around it, or maybe it's a weird clock. It's slow and doesn't seem like a bus. Or it could be a shift register and it's reading blank because I'm not pressing buttons.

There's a QFN 32 pin chip marked with "WM18016" (the M could be a N, the 6 could be a G) "36A0LM6" dead center on the bottom side of the PCB. It has a sine wave logo on it (possibly Wolfson Microelectronics). It is near the audio stuff but it is also near where all the buttons connect. There are 5 test points near it. It appears to be communicating with SPI with constant activity. There's also two resistors that look like I2C pull-up resistors, and there appears to be constant I2C traffic.

Some buttons are active low, some are active high (maybe only the thumbstick push buttons). The sheet of flexible circuit for the buttons are active low.

I'll keep adding to this section

==Flexible Film Pin Mapping==

The buttons are all on a single sheet of flexible film. The contacts for the flexible film are numbered from 1 to 18, and the numbers are written on the PCB.

The triggers have a resistor printed directly on the film, this appears to form a [http://en.wikipedia.org/wiki/Voltage_divider Voltage divider] voltage divider, so that the trigger can have an analog value. The ground side of the voltage divider appears to be oscillating, the frequency and duty cycle are not fixed or predictable. 

{| class="wikitable"
| Pin # || Purpose   || Notes
|-
| 1     || L2 Common || oscillating between 0 and 3.3V
|-
| 2     || L1 Sig    || active High
|-
| 3     || L1 Common || fixed at 3.3V
|-
| 4     || L2 Sig    || voltage divider output, active low
|-
| 5     || DPAD Right || active low
|-
| 6     || DPAD Up    || active low
|-
| 7     || DPAD Left  || active low
|-
| 8     || DPAD Down  || active low
|-
| 9     || Common    || ground
|-
| 10    || PS Button || active low
|-
| 11    || X || active low
|-
| 12    || Circle    || active low
|-
| 13    || Triangle  || active low
|-
| 14    || Square    || active low
|-
| 15    || R2 Common || oscillating between 0 and 3.3V
|-
| 16    || R1 Sig    || active high
|-
| 17    || R1 Common || fixed at 3.3V
|-
| 18    || R2 Sig    || voltage divider output, active low
|}

=USB=

Audio definitely does not carry through USB.

The reports arrive once every 4ms.

===Device Descriptor===

{| class="wikitable"
|-
! colspan="5" style="background-color:#C0C0C0; color:#000000;" |[http://linuxcommand.org/man_pages/lsusb8.html Device Descriptor]
|-
! Offset 
! Field 
! Size 
! Value
! Description
|-
| 0 || bLength || 1 || 0x12 || Size of this descriptor in bytes (18)
|-
| 1 || bDescriptorType || 1 || 0x01 || DEVICE descriptor type (Constant = 1)
|-
| 2 || bcdUSB || 2 || 0x0200 || USB Spec release number ([http://en.wikipedia.org/wiki/USB#USB_2.0 2.00]):
<small>with which the device and is descriptors are compliant (e.g.: 0x0200 (USB2.0), 0x0300, 
([[USB_3.0|USB3.0]]))</small>
|-
| 4 || bDeviceClass || 1 || 0x00 || [http://www.usb.org/developers/defined_class Class code] assigned by [http://en.wikipedia.org/wiki/USB_Implementers_Forum USB-IF:]
<small>(used by the operating system to find a class driver for your device)</small>
<small>
*00h means each interface defines its own class (identify itself at the interface level: bInterfaceClass)
*FFh means vendor-defined class
*Any other value must be a class code
</small>
|-
| 5 || bDeviceSubClass || 1 || 0x00 || SubClass Code assigned by USB-IF
<small>(used by the operating system to find a class driver for your device)</small>
|-
| 6 || bDeviceProtocol || 1 || 0x00 || Protocol Code assigned by USB-IF
<small>(used by the operating system to find a class driver for your device)</small>
|-
| 7 || bMaxPacketSize0 || 1 || 0x40  || Max packet size for endpoint 0. (64)
<small>
*Must be 8, 16, 32 or 64
*Must be 9 according to [http://www.usb.org/developers/tools/USB30CVSpec_1_4.pdf Compliance Test Specification for the USB 3.0 Architecture p29 9.1]
</small>
|-
| 8 || idVendor || 2 ||	0x054C || [http://www.linux-usb.org/usb.ids Vendor ID (VID)] (Sony Corp.) 
<small>
must be obtained from USB-IF

(used by the operating system to find a driver for your device)</small>
|-
| 10 || idProduct || 2 || 0x05C4 || Product ID (PID) - (Sony Computer Entertainment Wireless Controller) 
<small>
assigned by the manufacturer

(used by the operating system to find a driver for your device)</small>
|-
| 12 || bcdDevice || 2 || 0x0100 || Device release number (Version: 1.00)
<small>in binary coded decimal</small>
|-
| 14 || iManufacturer || 1 || 0x01 || Index of string descriptor describing manufacturer
<small>set to 0 if no string</small>
|-
| 15 || iProduct || 1 || 0x02  || Index of string descriptor describing product 
<small>set to 0 if no string</small>
|-
| 16 || iSerialNumber || 1 || 0x00 || Index of string descriptor describing device serial number<BR /> <small>set to 0 if no string</small>
|-
| 17 || bNumConfigurations || 1	|| 0x01 || Number of possible configurations
|-
|}

===Configuration Descriptor===

{| class="wikitable"
|-
! colspan="5" style="background-color:#C0C0C0; color:#000000;" |Configuration Descriptor
|-
! Offset 
! Field 
! Size 
! Value
! Description
|-
| 0 || bLength || 1 || 0x09 || Size
|-
| 1 || bDescriptorType || 1 || 0x02 || (= 2)
|-
| 2 || wTotalLength || 2 || 0x0029 || Total number of bytes (41) in this descriptor and all the following descriptors (9+9+9+7+7)
|-
| 4 || bNumInterfaces || 1 || 0x01 || Number of interfaces supported by this configuration
|-
| 5 || bConfigurationValue || 1	|| 0x01 || Value used by Set Configuration to select this configuration
|-
| 6 || iConfiguration || 1 || 0x00 || Index of string descriptor describing configuration - set to 0 if no string
|-
| 7 || bmAttributes || 1 || 0xC0 || Self Powered & powered by the bus (11000000) (PS3 controller: 0x80)
<small>
specify power parameters for the configuration :
<small>
{| cellpadding="4" style="border-collapse: collapse; text-align: center;"
|-
| colspan="6" |<code>''8-digit bit binary''</code>
|-
|style="border: 1px solid; border-left: hidden;"  | …
|style="border: 1px solid;"                       | 7|6|5|4|3|2|1|0
|style="border: 1px solid; border-right: hidden;" | …
|}
</small>
*D0 - D4: Reserved.
*D5: The configuration supports remote wakeup.
*D6: The configuration is self-powered and does not use power from the bus.
*D7: The configuration is powered by the bus.
</small>
|-
| 8 || bMaxPower || 1 || 0xFA || Maximum current: 500mA drawn by device in this configuration.<BR /><small>In units of 2mA. So 0x32 (50) means 100 mA</small>
|-
! colspan="5" style="background-color:#C0C0C0; color:#000000;" |Interface Descriptor
|-
| 0 || bLength || 1 || 0x09 || Size
|-
| 1 || bDescriptorType || 1 || 0x04 || (= 4)
|-
| 2 || bInterfaceNumber || 1 ||	0x00 || Number identifying this interface. 
<small>Zero-based value</small>
|-
| 3 || bAlternateSetting || 1 || 0x00 || The first (and default) value used to select alternative setting is always 0
<small>
(An interface can have more than one variant, and these variants can be switched between, while other interfaces are still in operation)
</small>
|-
| 4 || bNumEndpoints || 1 || 0x02  || Number of Endpoints used for this interface
|-
| 5 || bInterfaceClass || 1 || 0x03 || Class code assigned by USB-IF]
<small>
*00h is a reserved value
*FFh means vendor-defined class
*Any other value must be a class code
</small>
|-
| 6 || bInterfaceSubClass || 1 || 0x00 || SubClass Code assigned by USB-IF
|-
| 7 || bInterfaceProtocol || 1 || 0x00 || Protocol Code assigned by USB-IF
|-
| 8 || iInterface || 1 || 0x00 || Index of string descriptor describing interface - set to 0 if no string
|-
! colspan="5" style="background-color:#C0C0C0; color:#000000;" |Human Interface Device (HID) Descriptor
|-
| 0 || bLength || 1 || 0x09 || Size
|-
| 1 || bDescriptorType || 1 || 0x21 || Constant name specifying type of HID descriptor
|-
| 2 || bcdHID 1.17 || 2 || 0x0111 || [http://en.wikipedia.org/wiki/USB_human_interface_device_class HID class spec version] (1.11)
|-
| 4 || bCountryCode || 1 || 0x00 || Not supported ([http://www.usb.org/developers/devclass_docs/HID1_11.pdf Device Class Definition for HID 1.11 6.2.1 p33])
|-
| 5 || bNumDescriptors || 1 || 0x01 || Number of Descriptors 
|-
| 6 || bDescriptorType || 1 || 0x22 || DescriptorType (34): REPORT
|-
| 7 || DescriptorLength || 2 || 0x01D3 || total size of the Report descriptor (467)
|-
! colspan="5" style="background-color:#C0C0C0; color:#000000;" |Endpoint (IN) Descriptor
|-
| 0 || bLength || 1 || 0x07 || Size
|-
| 1 || bDescriptorType || 1 || 0x05 || (= 5)
|-
| 2 || bEndpointAddress || 1 || 0x84 || IN/D2H (10000100)-->4 (PS3 Controller: 0x81)
<small>
The address of this endpoint within the device:
*D3-D0: Endpoint number
*D6-D4: Reserved. set to Zero
*D7: Direction: 0 = OUT, 1 = IN (Ignored for Control Endpoints)
</small>
|-
| 3 || bmAttributes || 1 || 0x03 || Interrupt (00000011)
<small>
(D1:0) [http://www.inno-logic.com/resources/21.php#4 Transfer Type:]
*00 = Control
*01 = Isochronous
*10 = Bulk
*11 = Interrupt

The following only apply to isochronous endpoints. Else set to 0.

(D3:2) Synchronisation Type (ISO mode):
*00 = No Synchronisation
*01 = Asynchronous
*10 = Adaptive
*11 = Synchronous

(D5:4) Usage Type (ISO mode):
*00 = Data endpoint
*01 = Feedback endpoint
*10 = Implicit feedback Data endpoint
*11 = Reserved

(D7:6) Reserved
Set to 0 
</small>
|-
| 4 || wMaxPacketSize || 2 || 0x0040 || (64)
|-
| 6 || bInterval || 1|| 0x05 || 5 (unit depends on device speed) (PS3 Controller: 1)
<small>
Interval for polling endpoint for data transfers. Expressed in frames (ms) for low/full speed or microframes (125{{micro}}s) for high speed<BR />
(ignored for Bulk & Control Endpoints. Isochronous must equal 1 and field may range from 1 to 255 for interrupt endpoints)
</small>
|-
! colspan="5" style="background-color:#C0C0C0; color:#000000;" |Endpoint (OUT) Descriptor
|-
| 0 || bLength || 1 || 0x07 || Size
|-
| 1 || bDescriptorType || 1 || 0x05 || (= 5)
|-
| 2 || bEndpointAddress || 1 || 0x03 || OUT/H2D (00000011)-->3 (PS3 Controller: 0x02)
|-
| 3 || bmAttributes || 1 || 0x03 || Interrupt
|-
| 4 || wMaxPacketSize || 2 || 0x0040 || (64)
|-
| 6 || bInterval || 1 || 0x05 || 5
|-
|}

=== HID Report Descriptor ===

[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"
|-
! colspan="3"|Value !! Items !! Remarks
|-
|0x05||0x01|| - ||Usage Page (Generic Desktop Controls)|| 
|-
|0x09||0x05|| - ||Usage (Game Pad)|| CA – <small>A manual control or cursor device. A game pad minimally consists of a thumb-activated rocker switch that controls two axes (X and Y) and has four buttons. The rocker switch consists of four contact closures for up, down, right, and left.</small>
|-
|0xA1||0x01|| - ||Collection (Physical)||
|-
|0x85||0x01|| - ||Report ID (1)||
|-
|0x09||0x30|| - ||Usage (X)|| DV – <small>A linear translation in the X direction. Report values should increase as the control’s position is moved from left to right.</small>
|-
|0x09||0x31|| - ||Usage (Y)|| DV – <small>A linear translation in the Y direction. Report values should increase as the control’s position is moved from far to near.</small>
|-
|0x09||0x32|| - ||Usage (Z)|| DV – <small>A linear translation in the Z direction. Report values should increase as the control’s position is moved from high to low (Z).</small>
|-
|0x09||0x35|| - ||Usage (Rz)|| DV – <small>A rotation about the Z axis. Angular position report values follow the righthand rule.</small>
|-
|0x15||0x00|| - ||Logical Minimum (0)||
|-
|0x26||0xFF|| 0x00 ||Logical Maximum (255)||
|-
|0x75||0x08|| - ||Report Size (8)||
|-
|0x95||0x04|| - ||Report Count (4)||
|-
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)||
|-
|0x09||0x39|| - ||Usage (Hat switch)|| DV – <small>A specialized mechanical configuration of switches generating a variable value with a null state. The switches are arranged around a springloaded knob. When the knob is tilted in the direction of a switch, its contacts are closed. A typical example is four switches that are capable of generating information about four possible directions in which the knob can be tilted. Intermediate positions can also be decoded if the hardware allows two switches to be reported simultaneously.</small>
|-
|0x15||0x00|| - ||Logical Minimum (0)||
|-
|0x25||0x07|| - ||Logical Maximum (7)||
|-
|0x35||0x00|| - ||Physical Minimum (0)||
|-
|0x46||0x3B||0x01||Physical Maximum (315)||
|-
|0x65||0x14|| - ||Unit (System: English Rotation, Length: Centimeter)||
|-
|0x75||0x04|| - ||Report Size (4)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0x81||0x42|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,Null State)||
|-
|0x65||0x00|| - ||Unit (None)||
|-
|0x05||0x09|| - ||Usage Page (Button)||
|-
|0x19||0x01|| - ||Usage Minimum (0x01)||
|-
|0x29||0x0E|| - ||Usage Maximum (0x0E)||
|-
|0x15||0x00|| - ||Logical Minimum (0)||
|-
|0x25||0x01|| - ||Logical Maximum (1)||
|-
|0x75||0x01|| - ||Report Size (1)||
|-
|0x95||0x0E|| - ||Report Count (14)||
|-
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)||
|-
|0x06||0x00||0xFF||Usage Page (Vendor Defined 0xFF00)||
|-
|0x09||0x20|| - ||Usage (0x20)||
|-
|0x75||0x06|| - ||Report Size (6)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0x15||0x00|| - ||Logical Minimum (0)||
|-
|0x25||0x7F|| - ||Logical Maximum (127)||
|-
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)||
|-
|0x05||0x01|| - ||Usage Page (Generic Desktop Ctrls)||
|-
|0x09||0x33|| - ||Usage (Rx)|| DV – <small>A rotation about the X axis. Angular position report values follow the righthand rule.</small>
|-
|0x09||0x34|| - ||Usage (Ry)|| DV – <small>A rotation about the Z axis. Angular position report values follow the righthand rule.</small>
|-
|0x15||0x00|| - ||Logical Minimum (0)||
|-
|0x26||0xFF||0x00||Logical Maximum (255)||
|-
|0x75||0x08|| - ||Report Size (8)||
|-
|0x95||0x02|| - ||Report Count (2)||
|-
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)||
|-
|0x06||0x00||0xFF||Usage Page (Vendor Defined 0xFF00)||
|-
|0x09||0x21|| - ||Usage (0x21)||
|-
|0x95||0x36|| - ||Report Count (54)||
|-
|0x81||0x02|| - ||Input (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position)||
|-
|0x85||0x05|| - ||Report ID (5)||
|-
|0x09||0x22|| - ||Usage (0x22)||
|-
|0x95||0x1F|| - ||Report Count (31)||
|-
|0x91||0x02|| - ||Output (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x04|| - ||Report ID (4)||
|-
|0x09||0x23|| - ||Usage (0x23)||
|-
|0x95||0x24|| - ||Report Count (36)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x02|| - ||Report ID (2)||
|-
|0x09||0x24|| - ||Usage (0x24)||
|-
|0x95||0x24|| - ||Report Count (36)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x08|| - ||Report ID (8)||
|-
|0x09||0x25|| - ||Usage (0x25)||
|-
|0x95||0x03|| - ||Report Count (3)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x10|| - ||Report ID (16)||
|-
|0x09||0x26|| - ||Usage (0x26)||
|-
|0x95||0x04|| - ||Report Count (4)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x11|| - ||Report ID (17)||
|-
|0x09||0x27|| - ||Usage (0x27)||
|-
|0x95||0x02|| - ||Report Count (2)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x12|| - ||Report ID (18)||
|-
|0x06||0x02||0xFF||Usage Page (Vendor Defined 0xFF02)||
|-
|0x09||0x21|| - ||Usage (0x21)||
|-
|0x95||0x0F|| - ||Report Count (15)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x13|| - ||Report ID (19)||
|-
|0x09||0x22|| - ||Usage (0x22)||
|-
|0x95||0x16|| - ||Report Count (22)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x14|| - ||Report ID (20)||
|-
|0x06||0x05||0xFF||Usage Page (Vendor Defined 0xFF05)||
|-
|0x09||0x20|| - ||Usage (0x20)||
|-
|0x95||0x10|| - ||Report Count (16)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x15|| - ||Report ID (21)||
|-
|0x09||0x21|| - ||Usage (0x21)||
|-
|0x95||0x2C|| - ||Report Count (44)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x06||0x80||0xFF||Usage Page (Vendor Defined 0xFF80)||
|-
|0x85||0x80|| - ||Report ID (128)||
|-
|0x09||0x20|| - ||Usage (0x20)||
|-
|0x95||0x06|| - ||Report Count (6)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x81|| - ||Report ID (129)||
|-
|0x09||0x21|| - ||Usage (0x21)||
|-
|0x95||0x06|| - ||Report Count (6)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x82|| - ||Report ID (130)||
|-
|0x09||0x22|| - ||Usage (0x22)||
|-
|0x95||0x05|| - ||Report Count (5)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x83|| - ||Report ID (131)||
|-
|0x09||0x23|| - ||Usage (0x23)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x84|| - ||Report ID (132)||
|-
|0x09||0x24|| - ||Usage (0x24)||
|-
|0x95||0x04|| - ||Report Count (4)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x85|| - ||Report ID (133)||
|-
|0x09||0x25|| - ||Usage (0x25)||
|-
|0x95||0x06|| - ||Report Count (6)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x86|| - ||Report ID (134)||
|-
|0x09||0x26|| - ||Usage (0x26)||
|-
|0x95||0x06|| - ||Report Count (6)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x87|| - ||Report ID (135)||
|-
|0x09||0x27|| - ||Usage (0x27)||
|-
|0x95||0x23|| - ||Report Count (35)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x88|| - ||Report ID (136)||
|-
|0x09||0x28|| - ||Usage (0x28)||
|-
|0x95||0x22|| - ||Report Count (34)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x89|| - ||Report ID (137)||
|-
|0x09||0x29|| - ||Usage (0x29)||
|-
|0x95||0x02|| - ||Report Count (2)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x90|| - ||Report ID (144)||
|-
|0x09||0x30|| - ||Usage (X)|| DV – <small>A linear translation in the X direction. Report values should increase as the control’s position is moved from left to right.</small>
|-
|0x95||0x05|| - ||Report Count (5)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x91|| - ||Report ID (145)||
|-
|0x09||0x31|| - ||Usage (Y)|| DV – <small>A linear translation in the Y direction. Report values should increase as the control’s position is moved from far to near.</small>
|-
|0x95||0x03|| - ||Report Count (3)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x92|| - ||Report ID (146)||
|-
|0x09||0x32|| - ||Usage (Z)|| DV – <small>A linear translation in the Z direction. Report values should increase as the control’s position is moved from high to low (Z).</small>
|-
|0x95||0x03|| - ||Report Count (3)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0x93|| - ||Report ID (147)||
|-
|0x09||0x33|| - ||Usage (Rx)|| DV – <small>A rotation about the X axis. Angular position report values follow the righthand rule.</small>
|-
|0x95||0x0C|| - ||Report Count (12)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA0|| - ||Report ID (160)||
|-
|0x09||0x40|| - ||Usage (Vx)|| DV – <small>A vector in the X direction. Report values should increase as the vector increases in the positive X direction (from left to right). Negative values represent vectors in the negative X direction.</small>
|-
|0x95||0x06|| - ||Report Count (6)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA1|| - ||Report ID (161)||
|-
|0x09||0x41|| - ||Usage (Vy)|| DV – <small>A vector in the Y direction. Report values should increase as the vector increases in the positive Y direction (from far to near). Negative values represent vectors in the negative Y direction.</small>
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA2|| - ||Report ID (162)||
|-
|0x09||0x42|| - ||Usage (Vz)|| DV – <small>A vector in the Z direction. Report values should increase as the vector increases in the positive Z direction (from high to low). Negative values represent vectors in the negative Z direction.</small>
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA3|| - ||Report ID (163)||
|-
|0x09||0x43|| - ||Usage (Vbrx)|| DV – <small>A vector in the X direction relative to the body of an object. Report values should increase as the vector increases in the positive X direction (forward). Negative values represent vectors in the negative X direction. X is the “forward” axis for an object.</small>
|-
|0x95||0x30|| - ||Report Count (48)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA4|| - ||Report ID (164)||
|-
|0x09||0x44|| - ||Usage (Vbry)|| DV – <small>A vector in the Y direction relative to the body of an object. Report values should increase as the vector increases in the positive Y direction (to the right from an observer facing forward on the object). Negative values represent vectors in the negative Y direction.</small>
|-
|0x95||0x0D|| - ||Report Count (13)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA5|| - ||Report ID (165)||
|-
|0x09||0x45|| - ||Usage (Vbrz)|| DV – <small>A vector in the Z direction relative to the body of an object. Report values should increase as the vector increases in the positive Z direction (down from an observer facing forward on the object). Negative values represent vectors in the negative Z direction.</small>
|-
|0x95||0x15|| - ||Report Count (21)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA6|| - ||Report ID (166)||
|-
|0x09||0x46|| - ||Usage (Vno)|| DV– <small>A non oriented vector or value. The units define a physical measurement not related to a specific axis or orientation. An example would be pressure or temperature.</small>
|-
|0x95||0x15|| - ||Report Count (21)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xF0|| - ||Report ID (240)||
|-
|0x09||0x47|| - ||Usage (Feature Notification)||
|-
|0x95||0x3F|| - ||Report Count (63)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xF1|| - ||Report ID (241)||
|-
|0x09||0x48|| - ||Usage (Resolution Multiplier)||
|-
|0x95||0x3F|| - ||Report Count (63)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xF2|| - ||Report ID (242)||
|-
|0x09||0x49|| - ||Usage (0x49)||
|-
|0x95||0x0F|| - ||Report Count (15)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA7|| - ||Report ID (167)||
|-
|0x09||0x4A|| - ||Usage (0x4A)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA8|| - ||Report ID (168)||
|-
|0x09||0x4B|| - ||Usage (0x4B)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xA9|| - ||Report ID (169)||
|-
|0x09||0x4C|| - ||Usage (0x4C)||
|-
|0x95||0x08|| - ||Report Count (8)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xAA|| - ||Report ID (170)||
|-
|0x09||0x4E|| - ||Usage (0x4E)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xAB|| - ||Report ID (171)||
|-
|0x09||0x4F|| - ||Usage (0x4F)||
|-
|0x95||0x39|| - ||Report Count (57)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xAC|| - ||Report ID (172)||
|-
|0x09||0x50|| - ||Usage (0x50)||
|-
|0x95||0x39|| - ||Report Count (57)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xAD|| - ||Report ID (173)||
|-
|0x09||0x51|| - ||Usage (0x51)||
|-
|0x95||0x0B|| - ||Report Count (11)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xAE|| - ||Report ID (174)||
|-
|0x09||0x52|| - ||Usage (0x52)||
|-
|0x95||0x01|| - ||Report Count (1)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xAF|| - ||Report ID (175)||
|-
|0x09||0x53|| - ||Usage (0x53)||
|-
|0x95||0x02|| - ||Report Count (2)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0x85||0xB0|| - ||Report ID (176)||
|-
|0x09||0x54|| - ||Usage (0x54)||
|-
|0x95||0x3F|| - ||Report Count (63)||
|-
|0xB1||0x02|| - ||Feature (Data,Var,Abs,No Wrap,Linear,Preferred State,No Null Position,Non-volatile)||
|-
|0xC0|| - || - ||End Collection||
|-
|}

</div><br />

{{Spoiler|Total size of the Report descriptor |0x01D3 (467) bytes}}

===Sample Report===
<pre>
01 81 80 83 7A 08 00 00 00 00 93 5F FB D2 FF DA
FF D8 FF 4F EE 14 1B 99 FE 00 00 00 00 00 05 00
00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00
80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00
</pre>
===Report Structure===

{| class="wikitable"
|+Data Format
|-
|width="100"|byte index
|width="60"|bit 7
|width="60"|bit 6
|width="60"|bit 5
|width="60"|bit 4
|width="60"|bit 3
|width="60"|bit 2
|width="60"|bit 1
|width="60"|bit 0
|-
|[0]
|colspan="8"|Report ID (always 0x01)
|-
|[1]
|colspan="8"|Left Stick X (0 = left)
|-
|[2]
|colspan="8"|Left Stick Y (0 = up)
|-
|[3]
|colspan="8"|Right Stick X
|-
|[4]
|colspan="8"|Right Stick Y
|-
|[5]
|TRI
|CIR
|X
|SQR
|colspan="4"|D-PAD (hat format, 0x08 is released, 0=N, 1=NE, 2=E, 3=SE, 4=S, 5=SW, 6=W, 7=NW)
|-
|[6]
|R3
|L3
|OPT
|SHARE
|R2
|L2
|R1
|L1
|-
|[7]
|colspan="6"|Counter (counts up by 1 per report)
|T-PAD
|PS
|-
|[8]
|colspan="8"|Left Trigger (0 = released, 0xFF = fully pressed)
|-
|[9]
|colspan="8"|Right Trigger
|-
|[10]
|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]
|colspan="8"|Unknown yet, 0x03 or 0x04
|-
|[13 - 14]
|colspan="8"|Possibly Gyro X (seems to be signed)
|-
|[15 - 16]
|colspan="8"|Possibly Gyro Y
|-
|[17 - 18]
|colspan="8"|Possibly Gyro Z
|-
|[19 - 20]
|colspan="8"|Possibly Accel X
|-
|[21 - 22]
|colspan="8"|Possibly Accel Y
|-
|[23 - 24]
|colspan="8"|Possibly Accel Z
|-
|[25 - 63]
|colspan="8"|TODO, work in progress
|}

===Class Requests===

This is what happened with a controller that was not previously synced to the PS4
<pre>
Set Address
Get Device Descriptor:    (Short Device Descriptor)
Get Device Descriptor:    (Full Device Descriptor)
Get String Descriptor[idx=0, langID=0]:      04 03
Get String Descriptor[idx=0, langID=0]:      04 03 09 04
Get String Descriptor[idx=1, langID=0x0409]: 38 03
Get String Descriptor[idx=1, langID=0x0409]: "Sony Computer Entertainment"
Get String Descriptor[idx=2, langID=0x0409]: 
Get String Descriptor[idx=3, langID=0x0409]: "Wireless Controller"
Get Configuration Descriptor: (Short Configuration Descriptor)
Get Configuration Descriptor: (Full Configuration Descriptor)
Get Device Status: 00 00
Set Configuration to 0x01
Get Descriptor:  (HID Report Descriptor)
Set Idle to 0
Get Report 0xA3: A3 41 75 67 20 20 33 20 32 30 31 33 00 00 00 00 00 30 37 3A 30 31 3A 31 32 00 00 00 00 00 00 00 00 00 01 00 31 03 00 00 00 49 00 05 00 00 80 03 00
Get Report 0x02: 02 01 00 00 00 00 00 87 22 7B DD B2 22 47 DD BD 22 43 DD 1C 02 1C 02 7F 1E 2E DF 60 1F 4C E0 3A 1D C6 DE 08 00
Get Report 0xA3: A3 41 75 67 20 20 33 20 32 30 31 33 00 00 00 00 00 30 37 3A 30 31 3A 31 32 00 00 00 00 00 00 00 00 00 01 00 31 03 00 00 00 49 00 05 00 00 80 03 00
Get Report 0x12: 12 8B 09 07 6D 66 1C 08 25 00 00 00 00 00 00 00
Set Report 0x14: 13 AC 9E 17 94 05 B0 56 E8 81 38 08 06 51 41 C0 7F 12 AA D9 66 3C CE
Set Report 0x12: 14 02 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
</pre>

The same controller is then disconnected, and this is what happened when it reconnected
<pre>
... enumeration steps same as before
Get Report 0xA3: A3 41 75 67 20 20 33 20 32 30 31 33 00 00 00 00 00 30 37 3A 30 31 3A 31 32 00 00 00 00 00 00 00 00 00 01 00 31 03 00 00 00 49 00 05 00 00 80 03 00
Get Report 0x02: 02 01 00 00 00 00 00 87 22 7B DD B2 22 47 DD BD 22 43 DD 1C 02 1C 02 7F 1E 2E DF 60 1F 4C E0 3A 1D C6 DE 08 00
Get Report 0xA3: A3 41 75 67 20 20 33 20 32 30 31 33 00 00 00 00 00 30 37 3A 30 31 3A 31 32 00 00 00 00 00 00 00 00 00 01 00 31 03 00 00 00 49 00 05 00 00 80 03 00
Get Report 0x12: 12 8B 09 07 6D 66 1C 08 25 00 AC 9E 17 94 05 B0
</pre>

report ID 0xA3 seems to be some sort of time-of-manufacture identifier, it contains a date and time as a string in the beginning, ".Aug 3 2013.....07:01:12...........1....I....."

AC 9E 17 94 05 B0 is PS4 (Host) Bluetooth MAC Address (in proper MAC format, it is B0:05:94:17:9E:AC), AC 9E 17 is the LAP and 0x94 is the UAP, 05 B0 is the NAP, this was verified using a Bluetooth sniffer.

The 16 bytes that follow immediately after the BD_ADDR is the link key that is used to authenticate the DualShock 4. When a Bluetooth connection is established, this link key is used for authentication.

I am guessing that 8B 09 07 6D 66 1C means something, it's different on a different controller, it seems to be the Bluetooth MAC Address of the DualShock 4. in proper MAC format it is 1C:66:6D:07:09:8B in this example.

=Bluetooth=

The DS4 has two modes, one where you can pair it with a computer (hold PS and share at the same time until the light blinks twice in quick succession rapidly), and another mode when it is used with a PS4.

In the PS4 mode, it appears to advertise as two devices, one is a game controller and the other is an audio device. The game controller has a class 0x002508, and the audio device is class 0x200404. Neither has a name.

Only controllers that have previously paired with the PS4 can cause it to wake up. If you spoof a previously paired DS4's BDADDR and class, then using "sudo hcitool cc <ps4's bdaddr>" will wake up the PS4. If the same cc request comes from an unknown BDADDR, nothing happens.
==UART HCI==

On the DS4 circuit itself is a Qualcomm Atheros AR3002 module and the UART pins have test points. You can clearly see the UART HCI data when you analyze the traffic on the RX and TX pins. See [http://eleccelerator.com/wiki/index.php?title=File:Ds4_testpoints_hci_uart_1.jpg File:Ds4_testpoints_hci_uart_1.jpg]

The data seems to be at a baud rate of exactly 3Mbit/s , sticking with HCI standards, meaning it's 8N1.

The report rate seems to be once every 1.3 millisecond, but there are some occasional gaps in between that can reach 15 milliseconds.

[http://eleccelerator.com/wiki/index.php?title=File:Ds4_uart_hci_cap_with_unpaired_better.pcap File:Ds4 uart hci cap with unpaired better.pcap], this file is a capture of the traffic over the UART HCI, [http://www.wireshark.org/ Wireshark] is required to view this PCAP file.

[http://eleccelerator.com/files/ds4_uart_hci_cap_playroom_needs_sorting.pcap.gz ds4_uart_hci_cap_playroom_needs_sorting.pcap.gz], similar to the file before, but uses data while running "the Playroom" app on the PS4, so that it shows motors, speaker, and LED activity. This file needs to be decompressed using gzip first, then opened with Wireshark. Once opened, it needs to be sorted by timestamp.
==HID Report==
Here's a sample HCI transaction that represents a report from the DS4 to the PS4


 Offset(h) 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
 00000000  <span style="background:#ff6666;">02 15 20 53 00 4F 00 42 00</span> <span style="background:#66ff66;">A1 11 C0 00 83 81 7E</span>  .. S.O.B.¡.À.ƒ.~
 00000010  <span style="background:#66ff66;">7E 08 00 3C 00 00 83 A2 07 F1 FF F9 FF 04 00 21</span>  ~..<..ƒ¢.ñÿùÿ..!
 00000020  <span style="background:#66ff66;">03 17 1F 29 F9 00 00 00 00 00 08 00 00 00 00 80</span>  ...)ù..........€
 00000030  <span style="background:#66ff66;">00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00</span>  ...€....€...€...
 00000040  <span style="background:#66ff66;">00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00</span>  .€...€....€...€.
 00000050  <span style="background:#66ff66;">00 00 00 00</span> <span style="background:#66ff66;">7D 0A 5D 0B</span>                          ....}.].

{| class="wikitable"
|-
! !! Offset !! Value !! Size !! Description
|-
| rowspan="5" style="background-color:#ff6666;"|'''Header''' || 0x00 || 0x02 || 0x01 || (2) Packet Type:
<small>
*0x00: Acknowledgement Packets 
*0x01: HCI Command Packet 
*0x02: '''HCI ACL Data Packet''' 
*0x03: HCI SCO Data Packet 
*0x04: HCI Event Packet
</small>
|-
| 0x01 || 0x1520 ||0x02|| (0x2015) Control information (<sub>msb</sub>00 10 000000010101<sub>lsb</sub>):
<small>
*Broadcast (BC) flag (most significant 2 bits):
 00 = '''point-to-point packet''' (no broadcast)
 01 = Active Slave Broadcast
 10 = Parked Slave Broadcast
*Packet boundary (PB) flag (2 bits):
 01 = continuing packet of a higher level message
 10 = '''first packet of a higher level message'''
*Connection handle (least significant 12 bits):
0x15
</small>
|-
| 0x03 || 0x5300 ||0x02|| (83) Length of Packet
|-
| 0x05 || 0x4F00 ||0x02|| (79) Length of HID portion (Payload+Check)
|-
| 0x07 || 0x4200 ||0x02|| (0x0042) Channel ID (CID)
|-
| rowspan="2" style="background-color:#66ff66;"|'''HID portion''' || 0x09 || 0xA1 ... 00 || 0x4B || Packet Payload
|-
| 0x54 || 0x7D0A5D0B || 0x04 || (0x0B5D0A7D) HID portion: Data Integrity Check (CRC-32) field (to ensure that the packet is valid) is appended onto the end of the packet. Packet Payload is used to compute the Data Integrity Check.
|-
|}


02 15 20 53 00 4F 00 42 00 A1 11 C0 00 83 81 7E 7E 08 00 3C 00 00 83 A2 07 F1 FF F9 FF 04 00 21 03 17 1F 29 F9 00 00 00 00 00 08 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 00 7D 0A 5D 0B

The header is

02 15 20 53 00 4F 00 42 00

Which means this is a Bluetooth HCI ACL packet, connection handle is 0x15, CID is 0x0042, and the length of the HID portion is 79 long.

The 79 byte HID portion is

A1 11 C0 00 83 81 7E 7E 08 00 3C 00 00 83 A2 07 F1 FF F9 FF 04 00 21 03 17 1F 29 F9 00 00 00 00 00 08 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 00 7D 0A 5D 0B

If you look carefully, it is very similar to the reports sent over USB if you ignore A1 11 C0.
===CRC32===

Notice the last 4 bytes, 7D 0A 5D 0B, this value is different for every report packet, it appears to be random but it is actually a CRC32 over the first 75 bytes of the HID report. The CRC32's polynomial is 0x4C11DB7.

You can use http://www.lammertbies.nl/comm/info/crc-calculation.html to try this yourself, enter into the textbox (hex):

A1 11 C0 00 83 81 7E 7E 08 00 3C 00 00 83 A2 07 F1 FF F9 FF 04 00 21 03 17 1F 29 F9 00 00 00 00 00 08 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 80 00 00 00 80 00 00 00 00 00