View source

From Wiimote Wiki

The action you have requested is limited to users in the group user.

You can view and copy the source of this page:

The Wii Remote is known to send or receive the following HID reports. "Input" and "Output" are from the perspective of user interaction - input is received from the Wii Remote and output is sent to it. The bellow reports are from the perspective of a Bluetooth HID client. Software using raw L2CAP packets will need to emulate some degree of the bluetooth HID protocol. = General Operations = These reports relate to general operation and control of the Wii Remote. == 0x15 Status Request == {{ReportInfo|Output|15|1|Status Request}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|?|?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> RUMBLE: enable rumble motor '''Discussion:''' Sending this report will cause the Wii Remote to respond with report 0x20. == 0x20 Status == {{ReportInfo|Input|20|1|Status Request}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|?|?|?}} {{BitfieldRow|1|?|?|?|?|?|?|?|?}} {{BitfieldRow|2|P4|P3|P2|P1|ALWAYS|SPKEN|EXTCON|?}} {{BitfieldRow|3|?|?|?|?|?|?|?|?}} {{BitfieldRow|4|?|?|?|?|?|?|?|?}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|VBAT}} {{BitfieldEnd}} '''Values:'''<br> P''n'': Player ''n'' LED is lit. Set via [[#0x11 Player LEDs|report 0x11]].<br> ALWAYS: Continuous output mode enabled. Set via [[#0x12 Input Mode|report 0x12]].<br> SPKEN: Audio output system enabled. Set via [[#0x14 Audio Enable|report 0x14]].<br> EXTCON: Extension controller is connected.<br> VBAT: Output of battery voltage A/D. '''Discussion:''' This report is sent in response to report 0x15. == 0x11 Player LEDs == {{ReportInfo|Output|11|1|Update Player LEDs}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|P4|P3|P2|P1|?|?|1?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> P''n'': enable player ''n'' LED<br> RUMBLE: enable rumble motor<br> 1?: the Wii sets this bit when sending this report. '''Discussion:''' This report is used to update the four player-indicator LEDs at the base of the Wii Remote. This report must be issued after connecting to the Wii Remote to disable the automatic blinking. Wii Remote will respond with report 0x22. == 0x22 Command Status == {{ReportInfo|Input|22|4|Command Status}} {{BitfieldStart|BYTE}} {{BitfieldRangeRow|1}} {{BitfieldRange|8|0}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|0}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|REPORT}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|0}} {{BitfieldEnd}} '''Values:'''<br> REPORT: Report number of the report being acknowledged. '''Discussion:''' Sent in response to most output reports. If the bytes besides REPORT are non-zero, may indicate an error. = Memory & Register Access= == 0x17 Read == {{ReportInfo|Output|17|6|Read memory/registers}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|REG|?|RUMBLE}} {{BitfieldRangeRow|1}} {{BitfieldRange|8|ADDR[23:16]}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|ADDR[15:8]}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|ADDR[7:0]}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|LENGTH[15:8]}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|LENGTH[7:0]}} {{BitfieldEnd}} '''Values:'''<br> REG: Read from registers. If 0 read from EEPROM<br> RUMBLE: enable rumble motor<br> ADDR: Address to read from<br> LENGTH: Number of bytes to read<br> '''Discussion:''' Reads data from Wii Remote EEPROM (if REG=0) or configuration registers (if REG=1). The Wii Remote will respond via one or more input report 0x21. == 0x21 Read Data == {{ReportInfo|Input|21|21|Read memory status & data, also has button state}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|?|?|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|4|SIZE}} {{BitfieldRange|4|ERROR}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|ADDR[15:8]}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|ADDR[7:0]}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|DATA}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|DATA}} {{BitfieldEnd}} '''Values:'''<br> SIZE: Number of bytes in DATA minus 1. For example for 16 bytes, SIZE is 15.<br> ERROR: 0: success; 7: write-only memory; 8: invalid address<br> ADDR: Low 16 bits of the address of the first byte in DATA<br> DATA: data read from memory. NULL padded to 16 bytes.<br> '''Discussion:''' Sent by the Wii Remote in response to an Output Report 0x17. == 0x16 Write == {{ReportInfo|Output|16|21|Write memory/registers}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|REG|?|RUMBLE}} {{BitfieldRangeRow|1}} {{BitfieldRange|8|ADDR[23:16]}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|ADDR[15:8]}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|ADDR[7:0]}} {{BitfieldRangeRow|4}} {{BitfieldRange|1|0}} {{BitfieldRange|1|0}} {{BitfieldRange|6|LENGTH}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|DATA}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|DATA}} {{BitfieldEnd}} '''Values:'''<br> REG: Write to registers. If 0 write to EEPROM<br> RUMBLE: enable rumble motor<br> ADDR: Address to write to<br> LENGTH: Length of data to write. 1 ≤ LENGTH ≤ 16<br> '''Discussion:''' Writes data to either the Wii Remote EEPROM (if REG=0) or configuration registers (if REG=1). The Wii Remote will respond via input report 0x22. = IR Sensor Control = == 0x13 IR Enable 1 == {{ReportInfo|Output|13|1|IR Pixel Clock Enable}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|IRPCK|1?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> IRPCK: enable 24MHz IR pixel clock<br> 1?: Wii sets this bit when sending this report<br> RUMBLE: enable rumble motor '''Discussion:''' This and output report 0x1A are used to powering up the IR camera. This report enables a 24MHz clock signal supplied to the camera. To extend battery life, the pixel clock should be disabled when the IR camera is not being used. Wii Remote will respond with report 0x22. == 0x1A IR Enable 2 == {{ReportInfo|Output|1A|1|IR Sensor Enable}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|IREN|1?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> IREN: enable IR camera<br> 1?: Wii sets this bit when sending this report<br> RUMBLE: enable rumble motor '''Discussion:''' This and output report 0x13 are used to power up the IR camera. This report controls the enable line to the camera. To extend battery life, the camera should be disabled when not in use. Wii Remote will respond with report 0x22. = Speaker Reports = {{Unknown}} == 0x14 Audio Enable == {{ReportInfo|Output|14|1|Audio output enable}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|SPKEN|?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> LENGTH: number of bytes of audio data to send<br> RUMBLE: enable rumble motor '''Discussion:''' When SPKEN is set, the audio output subsystem will be powered up. See [[Speaker]] for details on playing audio. When SPKEN is cleared, power consumption may be reduced slightly. Wii Remote will respond with report 0x22. == 0x19 Audio Mute == {{ReportInfo|Output|19|1|Audio output mute}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|MUTE|?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> MUTE: Silence audio output.<br> RUMBLE: enable rumble motor '''Discussion:''' When MUTE is set, audio output is disabled. This is likely used when changing speaker configuration to prevent popping. Wii Remote will respond with report 0x22. == 0x18 Audio Data == {{ReportInfo|Output|18|21|Audio data}} {{BitfieldStart|BYTE}} {{BitfieldRangeRow|0}} {{BitfieldRange|7|LENGTH[7:1]}} {{BitfieldRange|1|RUMBLE}} {{BitfieldRangeRow|1}} {{BitfieldRange|8|DATA}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|DATA}} {{BitfieldEnd}} '''Values:'''<br> LENGTH: Number of bytes to send, low bit is not used<br> RUMBLE: enable rumble motor<br> DATA: Audio data. If fewer than 20 bytes, append NULL bytes to reach that size. '''Discussion:''' Sends audio data to the Wii Remote. For details see [[Speaker]]. Length value may not be required - this information was copied from WiiBrew and seems inconsistent with all other report formats. = User Input = == 0x12 Select Input Report== {{ReportInfo|Output|12|2|Select User Input Report}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|ALWAYS|1?|RUMBLE}} {{BitfieldRangeRow|1}} {{BitfieldRange|8|REPORT}} {{BitfieldEnd}} '''Values:'''<br> ALWAYS: always send input report, otherwise only on change<br> RUMBLE: enable rumble motor<br> 1?: Wii sets this bit when sending this report.<br> REPORT: input report that should be sent. '''Discussion:''' This report is used to select what type of input data should be returned. If ALWAYS is 1, then input reports will be sent continuously at 100Hz. Otherwise, input reports will only be sent when the reported value changes. REPORT determines which input report will be sent. Known values are listed bellow. To select reports 3E and 3F, specify report 3E. == 0x30 BTN == {{ReportInfo|Input|30|2|User Input: Buttons}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|?|?|MINUS|A|B|ONE|TWO}} {{BitfieldEnd}} '''Values:'''<br> A/B/PLUS/MINUS/HOME/ONE/TWO: 1 if face button/trigger with this label is pressed.<br> UP/DOWN/LEFT/RIGHT: 1 if this D-Pad direction is pressed. UP is towards the IR sensor. '''Discussion:''' The labeled bits here are common between all user input reports besides 0x3D. Bits 6 and 5 in both bytes see other uses in the other user input reports. == 0x31 BTN + XLR== {{ReportInfo|Input|31|5|User Input: Buttons and Accelerometer}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|XLRLSB|XLRLSB|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|XLRLSB|XLRLSB|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|XLR.X}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|XLR.Y}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|XLR.Z}} {{BitfieldEnd}} '''Values:'''<br> XLRLSB: least significant bits of the accelerometer data. Which bits are what has not been determined.<br> XLR: Acceleration detected along each axis.<br> '''Discussion:''' See [[Accelerometer]]. == 0x32 BTN + 8 EXT == {{ReportInfo|Input|32|10|User Input: Buttons and 8 Extension bytes}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|?|?|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|EXT0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|9}} {{BitfieldRange|8|EXT7}} {{BitfieldEnd}} '''Values:'''<br> EXT''n'': Byte of data from extension controller. '''Discussion:''' See [[Extensions]]. == 0x33 BTN + XLR + IR == {{ReportInfo|Input|33|17|User Input: Buttons, Accelerometer, IR Sensor}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|XLRLSB|XLRLSB|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|XLRLSB|XLRLSB|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|XLR.X}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|XLR.Y}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|XLR.Z}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|IR0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|16}} {{BitfieldRange|8|IR11}} {{BitfieldEnd}} '''Values:'''<br> XLRLSB: least significant bits of the accelerometer data. Which bits are what has not been determined.<br> XLR: Acceleration detected along each axis. See [[Accelerometer]]<br> IR: Data from IR sensor in [[IR Sensor#Medium|medium form]]. '''Discussion:''' See [[Accelerometer]] and [[IR Sensor]]. == 0x34 BTN + 19 EXT == {{ReportInfo|Input|34|21|User Input: Buttons and 19 Extension bytes}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|?|?|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|EXT0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|EXT18}} {{BitfieldEnd}} '''Values:'''<br> EXT''n'': Byte of data from extension controller. '''Discussion:''' See [[Extensions]]. == 0x35 BTN + XLR + 16 EXT== {{ReportInfo|Input|35|21|User Input: Buttons, Accelerometer, 16 Extension Bytes}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|XLRLSB|XLRLSB|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|XLRLSB|XLRLSB|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|XLR.X}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|XLR.Y}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|XLR.Z}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|EXT0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|16}} {{BitfieldRange|20|EXT16}} {{BitfieldEnd}} '''Values:'''<br> XLRLSB: least significant bits of the accelerometer data. Which bits are what has not been determined.<br> XLR: Acceleration detected along each axis. See [[Accelerometer]].<br> EXT: Data from extension. '''Discussion:''' See [[Accelerometer]] and [[Extensions]]. == 0x36 BTN + IR + 9 EXT == {{ReportInfo|Input|37|21|User Input: Buttons, IR Sensor, Extension}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|?|?|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|IR0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|11}} {{BitfieldRange|8|IR9}} {{BitfieldRangeRow|12}} {{BitfieldRange|8|EXT0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|EXT9}} {{BitfieldEnd}} '''Values:'''<br> IR: Data from IR sensor in [[IR Sensor#Short|short form]].<br> EXT: Data from extension. '''Discussion:''' See [[IR Sensor]] and [[Extensions]]. == 0x37 BTN + XLR + IR + 6 EXT == {{ReportInfo|Input|37|21|User Input: Buttons, Accelerometer, IR Sensor, Extension}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|XLRLSB|XLRLSB|PLUS|UP|DOWN|RIGHT|LEFT}} {{BitfieldRow|1|HOME|XLRLSB|XLRLSB|MINUS|A|B|ONE|TWO}} {{BitfieldRangeRow|2}} {{BitfieldRange|8|XLR.X}} {{BitfieldRangeRow|3}} {{BitfieldRange|8|XLR.Y}} {{BitfieldRangeRow|4}} {{BitfieldRange|8|XLR.Z}} {{BitfieldRangeRow|5}} {{BitfieldRange|8|IR0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|14}} {{BitfieldRange|8|IR9}} {{BitfieldRangeRow|15}} {{BitfieldRange|8|EXT0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|EXT5}} {{BitfieldEnd}} '''Values:'''<br> XLRLSB: least significant bits of the accelerometer data. Which bits are what has not been determined.<br> XLR: Acceleration detected along each axis. See [[Accelerometer]]<br> IR: Data from IR sensor in [[IR Sensor#Short|short form]].<br> EXT: Data from extension. '''Discussion:''' See [[Accelerometer]], [[IR Sensor]] and [[Extensions]]. == 0x3D EXT == {{ReportInfo|Input|3D|21|User Input: Extension}} {{BitfieldStart|BYTE}} {{BitfieldRangeRow|0}} {{BitfieldRange|8|EXT0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|20}} {{BitfieldRange|8|EXT20}} {{BitfieldEnd}} '''Values:'''<br> EXT: Data from extension. '''Discussion:''' Allows the extension to send data to the Wii at over 2kB/sec. Probable use would be for a Mic. See [[Extensions]]. == 0x3E & 0x3F BTN + XLR + IR == {{ReportInfo|Input|3E & 3F|21 & 21|User Input: Buttons, Accelerometer and Long IR}} {{BitfieldStart|BYTE}} {{BitfieldRangeRow|3E 0}} {{BitfieldRange|1|?}} {{BitfieldRange|2|XLR.Z[5:4]}} {{BitfieldRange|1|PLUS}} {{BitfieldRange|1|UP}} {{BitfieldRange|1|DOWN}} {{BitfieldRange|1|RIGHT}} {{BitfieldRange|1|LEFT}} {{BitfieldRangeRow|3E 1}} {{BitfieldRange|1|HOME}} {{BitfieldRange|2|XLR.Z[7:6]}} {{BitfieldRange|1|MINUS}} {{BitfieldRange|1|A}} {{BitfieldRange|1|B}} {{BitfieldRange|1|ONE}} {{BitfieldRange|1|TWO}} {{BitfieldRangeRow|3E 2}} {{BitfieldRange|8|XLR.X}} {{BitfieldRangeRow|3E 3}} {{BitfieldRange|8|IR0.0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|3E 11}} {{BitfieldRange|8|IR0.8}} {{BitfieldRangeRow|3E 12}} {{BitfieldRange|8|IR1.0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|3E 20}} {{BitfieldRange|8|IR1.8}} {{BitfieldRangeRow| }} {{BitfieldRange|8| }} {{BitfieldRangeRow|3F 0}} {{BitfieldRange|1|?}} {{BitfieldRange|2|XLR.Z[1:0]}} {{BitfieldRange|1|PLUS}} {{BitfieldRange|1|UP}} {{BitfieldRange|1|DOWN}} {{BitfieldRange|1|RIGHT}} {{BitfieldRange|1|LEFT}} {{BitfieldRangeRow|3F 1}} {{BitfieldRange|1|HOME}} {{BitfieldRange|2|XLR.Z[3:2]}} {{BitfieldRange|1|MINUS}} {{BitfieldRange|1|A}} {{BitfieldRange|1|B}} {{BitfieldRange|1|ONE}} {{BitfieldRange|1|TWO}} {{BitfieldRangeRow|3F 2}} {{BitfieldRange|8|XLR.Y}} {{BitfieldRangeRow|3F 3}} {{BitfieldRange|8|IR2.0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|3F 11}} {{BitfieldRange|8|IR2.8}} {{BitfieldRangeRow|3F 12}} {{BitfieldRange|8|IR3.0}} {{BitfieldRangeRow| }} {{BitfieldRange|8|· · ·}} {{BitfieldRangeRow|3F 20}} {{BitfieldRange|8|IR3.8}} {{BitfieldEnd}} '''Values:'''<br> XLR: Acceleration detected along each axis. See [[Accelerometer]]<br> IR''n'': Data from IR sensor for point ''n'' in [[IR Sensor#Long|long form]]. '''Discussion:''' See [[Accelerometer]] and [[IR Sensor]]. Note that a single Accelerometer sample is split between the two reports. = Unknown Reports = == 0x10 Unknown == {{Unknown}} {{ReportInfo|Output|10|1|Unknown}} {{BitfieldStart|BYTE}} {{BitfieldRow|0|?|?|?|?|?|?|?|RUMBLE}} {{BitfieldEnd}} '''Values:'''<br> RUMBLE: enable rumble motor '''Discussion:''' This report is mentioned by the HID descriptor. Purpose and effects are unknown. May be used to just set rumble.

• Template:BitfieldEnd
• Template:BitfieldRange
• Template:BitfieldRangeRow
• Template:BitfieldRow
• Template:BitfieldStart
• Template:ReportInfo
• Template:Unknown

Return to Main Page.