DLPU082C August   2021  – March 2024 DLPC7540

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. Scope
  5. References
  6. Acronyms
  7. System Boot
    1. 4.1 Data In flash
    2. 4.2 Bootloader Application
    3. 4.3 Main Application
    4. 4.4 Commands Supported by Bootloader and Main Applications
    5. 4.5 Debug Terminal
    6. 4.6 HOST_IRQ/SYSTEM_BUSY
    7. 4.7 Heartbeat
    8. 4.8 Low-Level Fault
  8. System Status
  9. Version
  10. Power Modes
  11. Display Modes
  12. Source Detection and Configuration
  13. 10Internal Sources
    1. 10.1 Test Patterns (TPG)
    2. 10.2 Solid Field (SFG) Color
    3. 10.3 Curtain
  14. 11Display Formatting
  15. 12Image Processing
  16. 13Warping
    1. 13.1 Control Point Table
    2. 13.2 Manual Warp Table
    3. 13.3 Table Constraints
    4. 13.4 Example Warp Table
    5. 13.5 Manual Warping Commands
      1. 13.5.1 CMD_SetManualWarpControlPoints [Command ID: 0x35, Destination: 4]
      2. 13.5.2 CMD_GetManualWarpControlPoints [Command ID: 0x35, Destination: 4]
      3. 13.5.3 CMD_WriteManualWarpTable [Opcode: 0x34, Destination: 4]
      4. 13.5.4 CMD_ReadManualWarpTable [Opcode: 0x34, Destination: 4]
      5. 13.5.5 CMD_ConfigureSmoothWarp [Command ID: 0x38, Destination: 4]
      6. 13.5.6 CMD_ApplyManualWarping [Command ID: 0x36, Destination: 4]
    6. 13.6 Optical (Lens) Distortion Correction
  17. 14Introduction to Blending
    1. 14.1  Blend Map Control Points
    2. 14.2  Blend Map Gain Values
    3. 14.3  Blend Map Offset Value
    4. 14.4  Constraints
    5. 14.5  Manual Blending Commands
      1. 14.5.1 CMD_EnableEdgeBlending [Command ID: 0x2F]
      2. 14.5.2 CMD_SetBlendMapControlPoints [Opcode: 0x2E]
      3. 14.5.3 CMD_ GetBlendMapControlPoints [Command ID: 0x2E]
      4. 14.5.4 CMD_SetBlendMapGainValues [Command ID: 0x2B]
      5. 14.5.5 CMD_ GetBlendMapGainValues [Command ID: 0x2B]
      6. 14.5.6 CMD_ SetBlendMapOffsetValues [Command ID: 0x2D]
      7. 14.5.7 CMD_ GetBlendMapOffsetValues [Command ID: 0x2D]
      8. 14.5.8 CMD_ApplyBlendMap [Command ID: 0x2C]
    6. 14.6  Manual Blending Application Commands
      1. 14.6.1 CMD_SetEdgeBlendingSystemParams [Command ID: 0x3D]
      2. 14.6.2 CMD_GetEdgeBlendingSystemParams [Command ID: 0x3D]
      3. 14.6.3 CMD_SetEdgeBlendingConfiguration [Command ID: 0x3E]
      4. 14.6.4 CMD_GetEdgeBlendingConfiguration [Command ID: 0x3E]
    7. 14.7  Cropping of Input Image for Blending Setup
    8. 14.8  Storing Edge Blend Configuration in EEPROM
    9. 14.9  Storing in EEPROM or Secondary Flash
    10. 14.10 Manual Blending GUI in Control Program
  18. 15Illumination Control
  19. 16Peripherals
    1. 16.1 GPIO
    2. 16.2 PWM
  20. 17Interface Protocol
    1. 17.1 Supported Interfaces
    2. 17.2 I2C Target
    3. 17.3 USB
  21. 18Command Protocol
    1. 18.1 Command Packet
    2. 18.2 Response Packet
    3. 18.3 Destination Details
    4. 18.4 Error Handling and Recovery
    5. 18.5 System Busy - I2C scenarios
      1. 18.5.1 GPIO Implementation
      2. 18.5.2 Short Status Response
    6. 18.6 Support for Variable Data Size
  22. 19Auto-Initialization Batch File
  23. 20Command Descriptions
  24. 21System Commands
    1. 21.1  3D
    2. 21.2  Administrative
    3. 21.3  Autolock
    4. 21.4  Bootloader
    5. 21.5  Calibration
    6. 21.6  Blending
    7. 21.7  Debug Internal
    8. 21.8  Debug
    9. 21.9  General Operation
    10. 21.10 Illumination
    11. 21.11 Image Processing
    12. 21.12 Manual WPC
    13. 21.13 Peripherals
    14. 21.14 Vision
    15. 21.15 Warping
  25.   Revision History

Manual Blending GUI in Control Program

The first two steps in the GUI focuses on getting the prerequisite information from the user and the next two steps focuses on the Edge Blending.

The Manual Blending GUI page enables user to do both photometric corrections (brightness adjustments in the overlap region) as well as geometric corrections (angle adjustments of the keystone corners in the projected image).

Note: The GUI supports the edge blending for a maximum of 5×5 projectors layout as per the algorithm restriction.

Step 0 : Prerequisites

Before using the Manual Blending GUI page, please make sure that the following prerequisites are done.

  1. The required number of projectors need to be physically set up with the desired overlap region.
  2. Make the physical adjustments to the projectors as far as possible to make sure that the projected images are properly overlapped and geometrically aligned.
  3. Connect one of the projectors (to be blended) to the Control Program and establish the Command Interface Connection.

When the connection is ready, use the Manual Blending page starting from Step 1 and go in the order of steps.

Step 1 : Read Parameters

(A) Read Output Resolution

This is the first and foremost step in the process of Manual Blending to read the output resolution information from the projector system. The default value of Output Width is 0 and Output Height is 0. Clicking on the "Read Output Resolution" button populates the valid (>0) output resolution information if and only if the connection to the projector system has been established.

GUID-20230127-SS0I-TJ3Q-JDPT-K2BHZNH0DVZ2-low.png

When the output resolution information has been read from the projector system, all other GUI elements that are relevant for the next step of action are enabled.

Note: Unless the output resolution information is populated, none of the following functionalities in the GUI would work as expected.

(B) Read Blending Data (Optional)

The user is given two options to either to read the manual blending parameter values stored in the EEPROM and populate into the fields in the page using the button "Load Blending Parameters and Geometric Correction Values from EEPROM" or manually enter data in the GUI in Step 2. When the blending parameter values from the EEPROM are loaded in the GUI, then the user can apply the same on the screen by clicking on the "Initialize and Apply" button in Step 2.

GUID-20230127-SS0I-HR4X-X8TJ-PGX49NF2JSTZ-low.png

Step 2 : Initialization of Blending Parameters

This step focuses on getting multiple system information from the user to initialize the parameters that are required for edge blending in the following steps. The user is supposed to enter the following information:

Projectors Layout

Layout in which the projectors are arranged, that is, horizontally stacked (columns) or vertically stacked (rows) to combine the projected image.

Based on the values provided by the user, the table of rows and columns depicting the projector layout in the sections "Current Projector in the Layout", "Black Luminance Values (Nits)" and "White Luminance Values (Nits)" is changed to give a visual prepresentation of the projectors layout.

Note: A 1x1 layout, that is, one row and one column which means only one projector, is not supported.
GUID-20230615-SS0I-WJCB-LGZZ-1QVFKRBD0PRC-low.png

Current Projector in the Layout

In the table of rows and columns depicting the projectors layout, identify the projector system that is currently being blended, that is, the projector system to which the current instance of control program is connected to.

GUID-20230127-SS0I-RCL3-TQ2F-GG85H8NHWZTB-low.png

Input Source

Select the input source used to display the pattern or image that should be used for calibration. This calibration patternor image must match the output resolution of the system identified in Step 1.

By default, "Splash Pattern" is the input source that displays a built-in default calibration pattern used for the Manual Blending process.

If "External Source" is the input source selected, then the user is expected to display a custom calibration pattern through External Video Input. The option to "Keep the display as is" makes it so no updates are made to the display. This is the most useful option for quickly tuning the RGB values for Simple 1D RGB mode.

GUID-20230508-SS0I-SQC5-2VVW-DR8QVQ7LWBND-low.png

Overlap Information

The user is allowed to give the overlap and fusion zone information in either exact number of pixels or lines or as a percentage in both horizontal and vertical directions.

When the "Projectors Layout" has

  • More than one row, then the user must enter the "Vertical Overlap Height".
  • More than one column, then the user must enter the "Horizontal Overlap Width".

The GUI controls are disabled when those values are not needed or used.

  1. Note: The minimum overlap supported is 1%.
  2. "Corner" systems can support a maximum overlap of 60%.
  3. "Non-Corner" systems (edge or middle systems) can support a maximum overlap of 49%.
GUID-20230127-SS0I-8Q6G-5XVP-HD5VGWQ3D0Q9-low.png

Photometric Correction Mode

For 2D cases and cases that include warping, "Use Black / White Luminance Values" must be selected. For 1D cases without warping, "Use Simple 1D RGB Gain / Offset Values" can be chosen.

GUID-20230508-SS0I-NDHQ-J938-QPHH5LZ79WMJ-low.png

Black Luminance Values (Nits)

  • Required for 2D Luminance mode.
  • The black luminance values of all the projectors in the layout are entered in the table here.
  • The black luminance value for the current projector that is being calibrated is highlighted.
  • The minimum value and default value is 0.0000.
  • Floating point values are supported up to 4 decimal places.
  • The maximum value cannot be greater than or equal to the white luminance value of the corresponding projector, that is, 0 ≤ Black Luminance Value < White Luminance Value of the corresponding projector.
Note: Display the black curtain in the projector system and measure the brightness using a light meter to get the value in nits.
GUID-20230127-SS0I-ZZXQ-QCQK-HJ0DT3TQM9P6-low.png

White Luminance Values (Nits)

  • Required for 2D Luminance mode
  • The white luminance values of all the projectors in the layout are entered in the table here.
  • The white luminance value for the current projector that is being calibrated is highlighted.
  • The default value is 1000.0000.
  • Floating point values are supported up to 4 decimal places.
  • The minimum value cannot be less than or equal to the black luminance value of the corresponding projector, that is, 0 ≤ Black Luminance Value < White Luminance Value of the corresponding projector.
GUID-20230127-SS0I-S6W0-CLQ6-GCLXTDKMWDWH-low.png

Simple 1D RGB Values

The RGB gain and offset values for the projector are entered in the below fields. The acceptable range of values are between 0 and 1 for all fields. TI recommends starting with the gain fields as all 1, and the offset fields as all 0. The gain values should be lowered so that a white field appears to be the same brightness as the least bright projector in the system. Raise the offset values to where the black field brightness of all projectors is the same.

GUID-20230508-SS0I-VWXK-S4XB-9HF9KB5KRCFG-low.png

After all of the above values are entered, click the "Initialize and Apply" button to initialize all the blending parameters and apply the values on the screen.

Note: When the initialization is done, the default "Splash Pattern" input source looks something like this on the screen. The green lines depict where only 2 projectors overlap and the magenta lines depict where more than 2 projectors overlap.
GUID-20230127-SS0I-07NV-HHKS-KJT2QXRK4FS2-low.png

Step 3 : Geometric Correction

After the blending parameters are initialized, the user is allowed to perform the geometric correction only for the keystone corners.

  • When the user changes any of the keystone corner values, then the updated values are sent through the ESW commands to the projector system and the immediate visual change can be seen on the projected pattern/image on the screen.
  • Clicking on the "Reset to Default Values" button would revert all the value changes done so far to their corresponding default values.
  • Clicking on the "Enable Edge Blending" button enables the user to enable the edge blending in the overlap region of the pattern displayed, that is, the lines in the pattern on the overlap region will not look sharper.
    • By default, Edge Blending will be disabled to ensure that the user first makes the geometric correction with the sharper looking lines in the pattern on the overlap region.
    • When the geometric correction is done, then the user can click on this button to enable the edge blending in the overlap region.
    • When the edge blending is enabled, this button will be toggled to "Disable Edge Blending".
GUID-20230127-SS0I-FTNX-7VPN-TC2NLGCKF157-low.png

Step 4: Enter Adjacent projector Geometric Parameters

For the 2D Luminance mode algorithm to correctly calculate the shapes of the overlapping regions, the keystone values of the adjacent projectors must be entered. The values can remain at default (unwarped) until all projectors in the system have completed the warping phase

GUID-20230508-SS0I-36TF-TQR6-XSG8VGX0DCQV-low.png

Step 5:Apply Manual Blending Corrections to EEPROM

  1. When satisfied with the manual blending corrections done so far and ready to store it in the EEPROM, choose if the blending data to be stored in EEPROM needs to be applied at startup or not. This can be done by using the "Enable Blending At Startup" checkbox. By default, this check box is unchecked.
    • If the checkbox is checked, then the blending data stored in EEPROM is applied at system startup.
    • If the checkbox is unchecked, then the blending data stored in EEPROM are hot applied at system startup.
  2. Click the "Save to EEPROM" button to write the manual blending parameter values in the page to the EEPROM and apply it at startup or not based on the "Enable Blending at Startup" check box state.
GUID-20230127-SS0I-CBPQ-WTBH-1XVGWCSLMBWL-low.png