User Tools

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
code:code [2024/04/01 04:07] – [Preface] Igor Yefmovcode:code [2024/04/02 09:00] (current) – Igor Yefmov
Line 2: Line 2:
  
 Controlling the camera is done via writing "registers" - think of them as address locations. There are generally 4 ways to interface with the camera from a host: Controlling the camera is done via writing "registers" - think of them as address locations. There are generally 4 ways to interface with the camera from a host:
-  - standard UVC - this one is automagically supported by any UVC 1.1 compliant OS, which in the year 2017 would be "any modern OS". This interface covers the universally standardized controls for [[https://docs.microsoft.com/en-us/windows-hardware/drivers/stream/uvc-driver-implementation-checklist|USB Video Class]] +  - [[https://docs.microsoft.com/en-us/windows-hardware/drivers/stream/uvc-driver-implementation-checklist|standard UVC]] - this one is automagically supported by any UVC 1.1 compliant OS, which in the year 2017 would be "any modern OS". This interface covers the universally standardized controls for USB Video Class
-  - (Gen 3 and Gen 4) direct I²C access via Cypress's FX3 interface, using control port ''0x20''. This allows access to all sensor's registers (at your own risk!). For more information search the web for documentation on the sensor in your camera (as of October 2017 that would be [[http://lmgtfy.com/?q=OmniVision+10823+sensor+documentation|OmniVision 10823 sensor]]). Gen5 is using a sensor via an SLVS-EC interface which doesn't provide direct I²C access so one should use [[fx3_api|FX3 API]] (or, better yet - rely on [[code:SUB2r-lib]] for all your camera control needs)+
   - [[fx3_api|FX3 Host Vendor Command Interface]] - this interfaces with the Cypress's FX3 and is the primary [[fx3_api|FX3 API]]   - [[fx3_api|FX3 Host Vendor Command Interface]] - this interfaces with the Cypress's FX3 and is the primary [[fx3_api|FX3 API]]
   - [[fpga_registers_map|FPGA I²C Access]] - a "window" into a host of additional commands that are performed on FPGA, this is highly dependent on the FPGA model used and camera's generation and is not exactly intended for direct use outside of developing FX3 APIs and during development cycle of GUI implementation. The FPGA register maps are defined [[fpga_registers_map|on this page]]   - [[fpga_registers_map|FPGA I²C Access]] - a "window" into a host of additional commands that are performed on FPGA, this is highly dependent on the FPGA model used and camera's generation and is not exactly intended for direct use outside of developing FX3 APIs and during development cycle of GUI implementation. The FPGA register maps are defined [[fpga_registers_map|on this page]]
 +  - (Gen 3 and Gen 4) direct I²C access via Cypress's FX3 interface, using control port ''0x20''. This allows access to all sensor's registers (at your own risk!). For more information search the web for documentation on the sensor in your camera (as of October 2017 that would be [[http://lmgtfy.com/?q=OmniVision+10823+sensor+documentation|OmniVision 10823 sensor]]). Gen5 is using a sensor via an SLVS-EC interface which doesn't provide direct I²C access so one should use [[fx3_api|FX3 API]] (or, better yet - rely on [[code:SUB2r-lib]] for all your camera control needs)
  
 If you are set on writing your own UI and don't want to be bothered too much with figuring out how to communicate with the camera you have an option of using the [[code:SUB2r-lib]] library (which should be your preference anyways). If you are set on writing your own UI and don't want to be bothered too much with figuring out how to communicate with the camera you have an option of using the [[code:SUB2r-lib]] library (which should be your preference anyways).
Line 72: Line 72:
 static_assert(sizeof(FwVersion) == 4); static_assert(sizeof(FwVersion) == 4);
 </code> </code>
- 
  
 ===== FX3 Version Info ===== ===== FX3 Version Info =====
Line 90: Line 89:
 |5|Gen 4 camera, a.k.a. "Vitreledonella"| |5|Gen 4 camera, a.k.a. "Vitreledonella"|
 |6|Gen 5 camera, either "Square One" or "Studio"| |6|Gen 5 camera, either "Square One" or "Studio"|
-^  Release type  ^^ 
-|0|Private build: Private build for debugging and similar purposes | 
-|1|Alpha: feature-incomplete early development cycle "somewhat stable" build | 
-|2|Beta: feature-complete, but not very stable build (lots of bugs) | 
-|3|Evaluation: Tech preview | 
-|4|Release candidate: feature complete and stable | 
-|5|Release: general availability | 
-|6|Backport: backport of a feature from next gen camera | 
-|7|Emergency bug fix: a critical post-release bugfix | 
-^  Build number  ^^ 
-|#|Increments on each build| 
- 
  
 ===== FPGA Version Info ===== ===== FPGA Version Info =====
Line 109: Line 96:
 ====  Vendor ID that represents a vendor of the main computation unit  ==== ====  Vendor ID that represents a vendor of the main computation unit  ====
 |Code |Value | |Code |Value |
 +^  Vendor ID((represents a vendor of the main computation unit))  ^^
 |1|Xilinx (AMD)| |1|Xilinx (AMD)|
 |2|Altera (Intel)| |2|Altera (Intel)|
- +^  Hardware ID for %%VendorId%% ''1'' (Xylinx)  ^^
-====  Hardware ID for VendorId 1 (Xylinx)  ==== +
-|Code |Value |+
 |1|Artix-7 100T| |1|Artix-7 100T|
 |2|Artix-7 200T| |2|Artix-7 200T|
 |3|Artix %%UltraScale+%% XCAU25P| |3|Artix %%UltraScale+%% XCAU25P|
- +^  Hardware ID for %%VendorId%% ''2'' (Altera)  ^^
-====  Hardware ID for VendorId 2 (Altera)  ==== +
-|Code |Value |+
 |1|Cyclone 10 GX| |1|Cyclone 10 GX|
- +^  Product ID  ^^
-====  Product ID  ==== +
-|Code |Value |+
 |1|reserved| |1|reserved|
 |2|reserved| |2|reserved|
Line 132: Line 114:
 |7|Gen 5 camera, professional grade "Studio"| |7|Gen 5 camera, professional grade "Studio"|
  
-====  Release type  ====+===== Shared parts of the Version Info ===== 
 +Both types of Version Infor (FX3 and FPGA) share the same codes for defining build type and build number:
 |Code |Value | |Code |Value |
-|0|Private build| +^  Release type  ^^ 
-|1|Alpha| +|0|Private build: Private build for debugging and similar purposes | 
-|2|Beta| +|1|Alpha: feature-incomplete early development cycle "somewhat stable" build | 
-|3|Eval/Tech preview| +|2|Beta: feature-complete, but not very stable build (lots of bugs) | 
-|4|Release candidate| +|3|Evaluation: Tech preview | 
-|5|Release| +|4|Release candidate: feature complete and stable | 
-|6|Backport| +|5|Release: general availability | 
-|7|Emergency bug fix| +|6|Backport: backport of a feature from next gen camera | 
- +|7|Emergency bug fix: a critical post-release bugfix | 
-====  Build number  ==== +^  Build number  ^^ 
-|Code |Value | +|#|''13'' bits of a build number (the range is ''1..8191''). Increments on each build|
-|#|''11'' bits of a build number (the range is ''1..2047''). Increments on each build|+
  
  
 ---- ----
-====== Firmware Versioning evolution ====== +Previous iterations had different bit layout for the Version Info, see details here: [[Firmware Versioning Evolution]] 
- +----
-====== FX3 Version Info ====== +
-The version id is also encoded into the firmware image file name as: +
-<code><VendorID>_<HardwareID>_<ProductID>_<ReleaseType>_<BuildNumber></code> +
- +
-===== FX3 version info C/C++-struct ===== +
-The FX3 version structure is as follows (little-endian memory layout): +
- +
-<code cpp firmware-version.h> +
-struct FwVersion{ +
-    unsigned vendorId    : 3; +
-    unsigned hwCfgId     : 5; +
-    unsigned productId   : 8; +
-#ifdef OLD_VER_FMT +
-    unsigned releaseType : 5; +
-    unsigned buildNo     : 11; +
-#else +
-    unsigned releaseType : 3; +
-    unsigned buildNo     : 13; +
-#endif +
-}; +
-static_assert(sizeof(FwVersion) == 4); +
-</code> +
- +
-Prior to FPGA v. 89 there was no standard-compliant way of representing the version info in a C struct though (which is exactly what prompted the rework in the first place). +
-==== Bit layout ==== +
-The bits are laid out in 4 sequential bytes as follows (depending on the version): +
-^  version  ^  3  ^^^^^^^^  2  ^^^^^^^^  1  ^^^^^^^^  0  ^^^^^^^^ +
-^  :::  ^  7  ^  6  ^  5  ^  4  ^  3  ^  2  ^  1  ^  0  ^  7  ^  6  ^  5  ^  4  ^  3  ^  2  ^  1  ^  0  ^  7  ^  6  ^  5  ^  4  ^  3  ^  2  ^  1  ^  0  ^  7  ^  6  ^  5  ^  4  ^  3  ^  2  ^  1  ^  0  ^ +
-|  fx3<102\\ fpga<77  |  buildNo[7:0]  ||||||||  releaseType  |||||  buildNo[10:8]  |||  productId  ||||||||  vendorId  |||  hwCfgId  ||||| +
-|  fx3<103  |  buildNo[10:3]  ||||||||  buildNo[2:0]  |||  releaseType  |||||  productId  ||||||||  hwCfgId  |||||  vendorId  ||| +
-|  fx3>=103\\ fpga>=77  |  buildNo[12:5]  ||||||||  buildNo[4:0]  |||||  releaseType  |||  productId  ||||||||  hwCfgId  |||||  vendorId  ||| +
- +
-Because of the change in bit layout different byte sequences shown below are needed to produce the same result (exact same component values for the sake of simplicity and only as an illustration): +
-^  version  ^  byte sequence (API return buffer)  |  <code cpp> +
-.vendorId = 1 +
-.hwCfgId = 1 +
-.productId = 5 +
-.releaseType = 3 +
-.buildNo = 0x67</code>  | +
-|  fx3>=102\\ fpga<77  |''0x21 0x05 0x18 0x67''|:::| +
-|  fx3<103  |''0x09 0x05 0xE3 0x0C''|:::| +
-|  fx3>=103\\ fpga>=77  |''0x09 0x05 0x3B 0x03''|:::| +
- +
-===== Vendor ID ===== +
-^Code ^Value ^ +
-|1|Cypress| +
- +
-===== Hardware ID ===== +
-^Code ^Value ^ +
-|1|FX3| +
- +
-===== Product ID ===== +
-^Code ^Value ^ +
-|1|reserved for Gen 1 camera, a.k.a. "Moon landing"| +
-|2|reserved for Gen 2 camera, a.k.a. "Piggy"| +
-|3|Gen 3 camera (Alpha), a.k.a. "Frankie" (from Frankenstein's Monster)| +
-|4|Gen 3 camera, Production| +
-|5|Gen 4 camera, a.k.a. "Vitreledonella"| +
-|6|Gen 5 camera, either "Square One" or "Studio"| +
- +
-===== Release type ===== +
-^ Code ^ Name ^ Meaning ^ +
-|0|Private build| Private build for debugging and similar purposes | +
-|1|Alpha| feature-incomplete early development cycle "somewhat stable" build | +
-|2|Beta| feature-complete, but not very stable build (lots of bugs) | +
-|3|Evaluation| Tech preview | +
-|4|Release candidate| feature complete and stable | +
-|5|Release| general availability | +
-|6|Backport| backport of a feature from next gen camera | +
-|7|Emergency bug fix| a critical post-release bugfix | +
- +
-===== Build number ===== +
-^Code ^Value ^ +
-|#|Increments on each build| +
- +
- +
-====== FPGA Version Info ====== +
-The version id is also encoded into the firmware image file name as: +
-<code><VendorID>_<HardwareID>_<ProductID>_<ReleaseType>_<BuildNumber></code> +
- +
- +
-===== Vendor ID ===== +
-A ''3''-bit number that represents a vendor of the main computation unit +
-^Code ^Value ^ +
-|1|Xilinx (AMD)| +
-|2|Altera (Intel)| +
- +
-===== Hardware ID ===== +
-A ''5''-bit number that represents a model from the list in the following table: +
-^%%VendorId%%^Code ^Value ^ +
-|1|1|Artix-7 100T| +
-|1|2|Artix-7 200T| +
-|1|3|Artix %%UltraScale+%% XCAU25P| +
-|2|1|Cyclone 10 GX| +
-===== Product ID ===== +
-An ''8''-bit number, unique to each product type from the table below: +
-^Code ^Value ^ +
-|1|reserved| +
-|2|reserved| +
-|3|Gen 3 camera (Alpha), a.k.a. "Frankie"| +
-|4|Gen 3 camera, Production| +
-|5|Gen 4 camera, a.k.a. “Vitreledonella”| +
-|6|Gen 5 camera, prosumer grade "Square One"| +
-|7|Gen 5 camera, professional grade "Studio"| +
-===== Release type ===== +
-Lower ''3'' bits of this ''5''-bit value map to a type of build below, the upper ''2'' bits are reserved for future use and must be ''b00'' +
-^Code ^Value ^ +
-|0|Private build| +
-|1|Alpha| +
-|2|Beta| +
-|3|Eval/Tech preview| +
-|4|Release candidate| +
-|5|Release| +
-|6|Backport| +
-|7|Emergency bug fix| +
- +
-===== Build number ===== +
-''11'' bits of a build number (the range is ''1..2047'') +
-^Code ^Value ^ +
-|#|Increments on each build|+
  
 ====== FPGA config status - SPI codes ====== ====== FPGA config status - SPI codes ======

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also, you acknowledge that you have read and understand our Privacy Policy. If you do not agree, please leave the website.

More information