Commits

Alex Hixon committed 611039b

Added a whole bunch of documentation.

  • Participants
  • Parent commits 9067b93

Comments (0)

Files changed (6)

File docs/firmware_loader_psuedocode.txt

+pointer = 0;
+index = 0;
+remaining = filesize;
+
+length = 0;
+remote_address = 0;
+
+while remaining more than 0:
+	if remaining less than 3:
+		print "Microcode file is incomplete - got to message %index%."
+	
+	// load in packet information (length, address)
+	length = pointer[0]
+	remote_address = pointer[1] | (pointer[2] << 8)
+	pointer += 3
+	reminaing -= 3
+
+	if (remaining less than length) or (length more than 64):
+		print "Microcode message %index% has bad length %length%."
+	
+	// load in packet payload
+	result = usb_control_msg (device, ..., 0xa0, addr, 0, pointer, length, timeout);
+	pointer += length
+	remaining -= length
+
+	if result less than 0:
+		print "Command failed. Message: %index%; result: %result%."
+	
+	if result not equal to length:
+		print "Command failed. Message: %index&; result: %result%; expected: %length%."
+	
+	index += 1

File docs/model_matrix.txt

+VID     PID     Chipset Type    Name                                        Notes
+
+0x05CA  0x1810  R5U870  UVC     HP Pavilion Webcam                          
+0x05CA  0x1812  Unknown UVC     HP Pavilion Webcam                          Used on HP Pavilion DV6502AU laptops. Apparently does not require ucode.
+0x05CA  0x1830  R5U870  WDM     Sony Visual Communication Camera VGP-VCC2   Used on Sony VAIO SZ laptops.
+0x05CA  0x1832  R5U870  WDM     Sony Visual Communication Camera VGP-VCC3   Used on Sony VAIO UX laptops.
+0x05CA  0x1833  R5U870  WDM     Sony Visual Communication Camera VGP-VCC2   Used on Sony VAIO AR1 laptops.
+0x05CA  0x1834  R5U870  WDM     Sony Visual Communication Camera VGP-VCC2   Used on Sony VAIO AR2 laptops.
+0x05CA  0x1835  R5U870  UVC     Sony Visual Communication Camera VGP-VCC5   Used on Sony VAIO SZ laptops.
+0x05CA  0x1836  R5U870  UVC     Sony Visual Communication Camera VGP-VCC4   Used on Sony VAIO FE laptops.
+0x05CA  0x1837  R5U870  UVC     Sony Visual Communication Camera VGP-VCC4   Used on Sony VAIO FZ laptops. The camera is installed upside down.
+0x05CA  0x1839  R5U870  UVC     Sony Visual Communication Camera VGP-VCC6   Used on Sony VAIO CR laptops.
+0x05CA  0x183a  R5U870  UVC     Sony Visual Communication Camera VGP-VCC7   Used on Sony VAIO SZ and TZ11 laptops.
+0x05CA  0x183b  R5U870  UVC     Sony Visual Communication Camera VGP-VCC8   Used on Sony VAIO FZ laptops.
+0x05CA  0x183e  R5U870  UVC     Sony Visual Communication Camera VGP-VCC9   Used on Sony VAIO FZ laptops.
+0x05CA  0x1841  R5U870  UVC     Fujitsu F01                                 
+0x05CA  0x1870  R5U870  WDM     HP Pavilion Webcam / HP Webcam 1000         VID/PID combination used by two distinct devices. dv1xxx appears to be
+                                                                            the less common of the two. The only way to check the difference is to
+                                                                            read the model number out via DMI. 

File docs/r5u870_specs.txt

+As reported from Ricoh's website.
+
+Image format:   YUV422
+Audio codec:    I2S
+
+Frame rates:    VGA: 30fps
+                SXGA: 7.5fps
+
+

File docs/uvc_controls.txt

+

File docs/wdm_resolutions.txt

+Resolutions for UVC cameras are reported by the camera itself. The table below
+only describes the resolutions for WDM cameras, since they don't do it.
+
+Type    Width   Height  Required bandwidth
+VGA     160     120     1152000
+VGA     176     144     1520640
+VGA     320     240     4608000
+VGA     352     288     6082560
+VGA     640     480     18432000
+	
+SXGA    160     120     1152000
+SXGA    176     144     1520640
+SXGA    320     240     4608000
+SXGA    352     288     6082560
+SXGA    640     480     18432000
+SXGA    1280    1024    19660800
 /*
- * Ricoh 5U87x series USB firmware loader.
+ * Ricoh R5U87x series USB firmware loader.
  * Copyright (c) 2008 Alexander Hixon <alex@alexhixon.com>
  * 
  * Loading routines based off those used in the original r5u870 kernel