|
FireSync API
|
| kStatus kLdCalLookup_PowerToInput | ( | kLdCalLookup | lookup, |
| k64f | power, | ||
| k64f | temperature, | ||
| kSize * | input, | ||
| k64f * | expectedPower | ||
| ) |
Calculates the set point input expected to produce specified optical power at the specified temperature.
Resulting output selects the nearest input, even if it results in optical power that is higher than requested.
All specified powers must already account for margins due to uncertainty in digital pot resolution, accuracy of the calibration methodology or efficiency of the optical path.
For example, with resolution of the pot at 10% of the input, the returned power may fall within +/- 10% of the specified before accounting for calibration error, temperature compensation uncertainty, optical path efficiency uncertainty
While granularity of the digital pot is only one component of the uncertainty, the optional 'expectedPower' output parameter may be passed in to determine the exact calibrated optical power corresponding to the specified input
| lookup | Lookup object. |
| power | Requested optical power. |
| temperature | Driver temperature at which the power is queried. Specify k64F_NULL to default to the calibration temperature. |
| input | Driver input, in device units, closest to the requested power at specified temperature. |
| expectedPower | Optional output parameter receiving the exact calibrated optical power corresponding to the specified input. |