DLPU082C August   2021  – March 2024 DLPC7540

 

  1.   1
  2.   Abstract
  3.   Trademarks
  4. 1 Scope
  5. 2 References
  6. 3 Acronyms
  7. 4 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. 5 System Status
  9. 6 Version
  10. 7 Power Modes
  11. 8 Display Modes
  12. 9 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

21.14 Vision

Vision

Table 21-134 Auto Screen Fit Corners [Opcode: 81h | Destination: 4]
Get Auto Screen Fit Corners
Return Parameters
Byte Description
Bytes 0-3

Top Left X

Format = s16.16

Bytes 4-7

Top Left Y

Format = s16.16

Bytes 8-11

Top Right X

Format = s16.16

Bytes 12-15

Top Right Y

Format = s16.16

Bytes 16-19

Bottom Right X

Format = s16.16

Bytes 20-23

Bottom Right Y

Format = s16.16

Bytes 24-27

Bottom Left X

Format = s16.16

Bytes 28-31

Bottom Left Y

Format = s16.16

Get auto screen fit corners

Table 21-135 Cam Proj Calibration Params [Opcode: D6h | Destination: 4]
Get Cam Proj Calibration Params
Return Parameters
Byte Description
Byte 0

Camera distortion model, FALSE = Use Brown's distortion model, TRUE = Use the fisheye distortion model

Byte 1

RGB or monochrome camera

Bytes 2-3

Camera horizontal resolution

Bytes 4-5

Camera vertical resolution

Bytes 6-9

Camera focal length in x direction

Format = s16.16

Bytes 10-13

Camera focal length in y direction

Format = s16.16

Bytes 14-17

Camera principal point in x direction

Format = s16.16

Bytes 18-21

Camera principal point in y direction

Format = s16.16

Bytes 22-25

Camera distortion coefficient K1

Format = s16.16

Bytes 26-29

Camera distortion coefficient K2

Format = s16.16

Bytes 30-33

Camera distortion coefficient P1

Format = s16.16

Bytes 34-37

Camera distortion coefficient P2

Format = s16.16

Bytes 38-41

Camera distortion coefficient K3

Format = s16.16

Bytes 42-45

Camera distortion coefficient K4

Format = s16.16

Bytes 46-49

Camera distortion coefficient K5

Format = s16.16

Bytes 50-53

Camera distortion coefficient K6

Format = s16.16

Bytes 54-55

Projector horizontal resolution

Bytes 56-57

Projector vertical resolution

Bytes 58-61

Projector focal length in x direction

Format = s16.16

Bytes 62-65

Projector focal length in y direction

Format = s16.16

Bytes 66-69

Projector principal point in x direction

Format = s16.16

Bytes 70-73

Projector principal point in y direction

Format = s16.16

Bytes 74-77

Projector distortion coefficient K1

Format = s16.16

Bytes 78-81

Projector distortion coefficient K2

Format = s16.16

Bytes 82-85

Projector distortion coefficient K3

Format = s16.16

Bytes 86-89

Projector distortion coefficient K4

Format = s16.16

Bytes 90-93

Projector distortion coefficient K5

Format = s16.16

Bytes 94-97

Projector distortion coefficient K6

Format = s16.16

Bytes 98-101

Projector distortion coefficient P1

Format = s16.16

Bytes 102-105

Projector distortion coefficient P2

Format = s16.16

Bytes 106-109

Camera rotation matrix [0][0]

Format = s16.16

Bytes 110-113

Camera rotation matrix [0][1]

Format = s16.16

Bytes 114-117

Camera rotation matrix [0][2]

Format = s16.16

Bytes 118-121

Camera rotation matrix [1][0]

Format = s16.16

Bytes 122-125

Camera rotation matrix [1][1]

Format = s16.16

Bytes 126-129

Camera rotation matrix [1][2]

Format = s16.16

Bytes 130-133

Camera rotation matrix [2][0]

Format = s16.16

Bytes 134-137

Camera rotation matrix [2][1]

Format = s16.16

Bytes 138-141

Camera rotation matrix [2][2]

Format = s16.16

Bytes 142-145

Camera translation vector [0]

Format = s16.16

Bytes 146-149

Camera translation vector [1]

Format = s16.16

Bytes 150-153

Camera translation vector [2]

Format = s16.16

Gets calibration parameters for camera and projector

Table 21-136 Projector Variation Index [Opcode: D7h | Destination: 4]
Set Projector Variation Index
Write Parameters
Byte Description
Bytes 0-1

Cam Proj Variation Index

Set current variation index for projector

Get Projector Variation Index
Data returned is in the same format as the Write Parameters.

Get current variation index for projector.

Table 21-137 Cam Params [Opcode: D8h | Destination: 4]
Set Cam Params
Write Parameters
Byte Description
Bytes 0-1

Horizontal capture resolution

Bytes 2-3

Vertical capture resolution

Bytes 4-5

Bytes per pixel

Byte 6

camera Camera test, for debug purpose only

bit0: start or stop camera test, for debug purpose only

Set Camera Resolution and BPP

Get Cam Params
Return Parameters
Byte Description
Bytes 0-1

Horizontal capture resolution

Bytes 2-3

Vertical capture resolution

Bytes 4-5

Bytes per pixel

Get Camera resolution and BPP

Table 21-138 Enable Auto Warp [Opcode: D9h | Destination: 4]
Set Enable Auto Warp
Write Parameters
Byte Description
Bytes 0-1

Horizontal resolution

Range = 0 to 7680 with step size 10

Bytes 2-3

Vertical resolution

Range = 0 to 4320 with step size 10

Bytes 4-5

Num Samples X

Range = 2 to 62 with step size 1

Bytes 6-7

Num Samples Y

Range = 2 to 32 with step size 1

Byte 8

Filter Flags

Bytes 9-12

CCA Detect Thresh

Range = 0.0000 to 1.0000 with step size 0.0001

Format = u16.16

Bytes 13-14

Radius of the gaussian

Bytes 15-16

Gaussian centroid offset in pixels (from DMD edge)

Bytes 17-20

Pitch bias in degrees

Range = -10 to 10 with step size 0.00390625

Format = s16.16

Bytes 21-24

Yaw bias in degrees

Range = -10 to 10 with step size 0.00390625

Format = s16.16

Byte 25

Level of digital decimation for camera captures

Range = 0 to 2 with step size 1

Byte 26

Enable or disable ROI processing for camera captures

bit0: Pixel Sampling Enable

Set configuration and enable auto warp

Table 21-139 Enable Auto Screen Fit [Opcode: DAh | Destination: 4]
Set Enable Auto Screen Fit
Write Parameters
Byte Description
Bytes 0-1

Aspect Ratio Width

Bytes 2-3

Aspect Ratio Height

Bytes 4-7

CCA feature detection threshold

Range = 0.0000 to 1.0000 with step size 0.0001

Format = u16.16

Bytes 8-9

Vertical offset in pixels of the 2x2 gaussian pattern

Range = -300 to 300 with step size 1

Bytes 10-13

Percentage of detected screen frame to be filled

Range = 80.0 to 120.0 with step size 0.1

Format = u16.16

Bytes 14-17

Intensity of gray solid field, used for pattern generation *

Range = 0.0 to 100.0 with step size 0.1

Format = u16.16

Byte 18

Pixel sampling difference

Range = 1 to 2 with step size 1

Byte 19

Variable Pixel Sampling

bit0: Pixel Sampling Enable

Set configuration and enable auto screen fit

Table 21-140 Resize Auto Screen Fit [Opcode: DBh | Destination: 4]
Set Resize Auto Screen Fit
Write Parameters
Byte Description
Bytes 0-3

Percentage of detected screen frame to be filled

Range = 80.0 to 120.0 with step size 0.1

Format = u16.16

Resize auto screen fit

Table 21-141 Refine Auto Screen Fit [Opcode: DCh | Destination: 4]
Set Refine Auto Screen Fit
Write Parameters
Byte Description
Bytes 0-1

Horizontal offset in pixels

Range = -300 to 300 with step size 1

Bytes 2-3

Vertical offset in pixels

Range = -300 to 300 with step size 1

Bytes 4-5

Horizontal offset in pixels

Range = -300 to 300 with step size 1

Bytes 6-7

Vertical offset in pixels

Range = -300 to 300 with step size 1

Bytes 8-9

Horizontal offset in pixels

Range = -300 to 300 with step size 1

Bytes 10-11

Vertical offset in pixels

Range = -300 to 300 with step size 1

Bytes 12-13

Horizontal offset in pixels

Range = -300 to 300 with step size 1

Bytes 14-15

Vertical offset in pixels

Range = -300 to 300 with step size 1

Refine auto screen fit

Table 21-142 Asf Pattern [Opcode: DDh | Destination: 4]
Set Asf Pattern
Write Parameters
Byte Description
Byte 0

Pattern Num

Bytes 1-2

Vertical offset in pixels of the 2x2 gaussian pattern

Range = -300 to 300 with step size 1

Bytes 3-6

Intensity of gray solid field, used for pattern generation

Range = 0.0 to 100.0 with step size 0.1

Format = u16.16

Project gaussian pattern defined by Index

Table 21-143 Enable Auto Exposure [Opcode: DEh | Destination: 4]
Set Enable Auto Exposure
Write Parameters
Byte Description
Bytes 0-1

Horizontal resolution

Range = 0 to 7680 with step size 10

Bytes 2-3

Vertical resolution

Range = 0 to 4320 with step size 10

Byte 4

Number of bytes per pixel supported by camera

Byte 5

1 : Enable 0 : Disable

Byte 6

Dim Projection until Image Saturation less than threshold

Range = 0 to 100 with step size 1

Byte 7

Changes Exposure Time until Image Saturation less than threshold

Range = 0 to 100 with step size 1

Enable Auto Exposure

Table 21-144 Exposure Time [Opcode: DFh | Destination: 4]
Set Exposure Time
Write Parameters
Byte Description
Bytes 0-1

Time

Range = 0 to 10000 with step size 1

Set Camera's Absolute Exposure Time . UVC compliant Exposure Time Standard . Value 166 implies 16.6 ms

Get Exposure Time
Data returned is in the same format as the Write Parameters.

Get Camera's Absolute Exposure Time. This value is multiple of 0.1 ms . For example, 166 is 16.6 ms.

Table 21-145 Enable Auto 2D Keystone [Opcode: F7h | Destination: 4]
Set Enable Auto 2D Keystone
Write Parameters
Byte Description
Bytes 0-1

Horizontal resolution

Range = 0 to 7680 with step size 10

Bytes 2-3

Vertical resolution

Range = 0 to 4320 with step size 10

Bytes 4-7

CCA Detect Thresh

Range = 0.0000 to 1.0000 with step size 0.0001

Format = u16.16

Bytes 8-9

Radius of the gaussian

Bytes 10-11

Gaussian centroid offset in pixels (from DMD edge)

Byte 12

Level of digital decimation for camera captures

Range = 0 to 2 with step size 1

Byte 13

Enable or disable ROI processing for camera captures

bit0: Pixel Sampling Enable

Set configuration and enable auto 2d keystone

Table 21-146 Manual V Bus [Opcode: F8h | Destination: 4]
Set Manual V Bus
Write Parameters
Byte Description
Byte 0

V Bus

bit0: Manual V Bus Enable

Get Manual V Bus
Data returned is in the same format as the Write Parameters.
Table 21-147 Vision Status [Opcode: F9h | Destination: 4]
Set Vision Status
Write Parameters
Byte Description
Bytes 0-3

Vision Status Word 0

bit0: Frame Buffer for Image capture not set or Buffer size is not sufficient.

bit1: Attached camera does not support Uncompressed frame format.

bit2: Selected frame resolution not supported by camera.

bit3: Camera parameters set failed.

bit4: Camera Probe Commit negotiation failed.

bit5: Memory Pool failed for vision mode.

bit6: Image Parameters failed.

bit7: Memory request failed.

bit8: Camera not found.

bit9: Image captured failed.

bit10: Camera's FOV not at center of Image

bit11: Image Saturation Threshold Criteria not met

bit12: Memory Request Fail for Auto Warp

bit13: Memory Release Fail for Auto Warp

bit14: Plan Fit Error

bit15: Hole fit correction error

bit16: Hole fit uncorrected error

bit17: TODO

bit18: TODO

bit19: TODO

bit20: TODO

bit21: TODO

bit22: TODO

bit23: VIS AUTO SCREEN FIT ERR MEM REQUEST FAIL

bit24: VIS AUTO SCREEN FIT ERR MEM RELEASE FAIL

bit25: VIS AUTO SCREEN FIT ERR CAM2PROJ HOMOGRAPHY FAIL

bit26: VIS AUTO SCREEN FIT ERR GAUSSIAN PAT NOT DETECTED

bit27: VIS AUTO SCREEN FIT ERR GRAY SOLID PAT NOT DETECTED

bit28: VIS AUTO SCREEN FIT ERR NOT ENOUGH CENTROIDS FOUND

bit29: VIS AUTO SCREEN FIT ERR WARP MAP CREATION FAIL

bit30: VIS AUTO SCREEN FIT ERR REFINE HOMOGRAPHY FAIL

bit31: VIS AUTO SCREEN FIT ERR RESIZE HOMOGRAPHY FAIL

Bytes 4-7

Vision Status Word 1

bit0: VIS AUTO SCREEN FIT ERR FILL FACTOR PROC FAIL

bit1: VIS AUTO 2DK ERR MEM REQUEST FAIL

bit2: VIS AUTO 2DK ERR MEM RELEASE FAIL

bit3: VIS AUTO 2DK ERR INCORRECT PAT INDEX

bit4: VIS AUTO 2DK ERR GAUSSIAN PAT NOT DETECTED BLK

bit5: VIS AUTO 2DK ERR GAUSSIAN PAT NOT DETECTED FLT

bit6: VIS AUTO 2DK ERR NOT ENOUGH CENTROIDS FOUND

bit7: VIS AUTO 2DK ERR CORRESPONDENCES NOT FOUND

bit8: VIS AUTO 2DK ERR IVALID OPTICAL RAY

bit9: VIS AUTO 2DK ERR INVALID CLOUD ELEMENT

bit10: VIS AUTO 2DK ERR PLANE FIT FAIL

bit11: VIS AUTO 2DK ERR MAP HOMOGRAPHY CALC FAIL

bit12: VIS AUTO 2DK ERR SUBSAMPLING PTR NULL

bit13: VIS AUTO 2DK ERR WARP MAP CREATION FAIL

bit14: Unknown error in vision mode.

Command to read status information from Vision module.

Get Vision Status
Data returned is in the same format as the Write Parameters.

Command to read status information from Vision module.