Application helpers¶

microspec.helpers.to_cycles(ms: float) → int¶

Convert exposure time from milliseconds to cycles.

Parameters:	ms – Exposure time in milliseconds.
Returns:	Exposure time in cycles.
Return type:	int

Example

>>> import microspec as usp
>>> usp.to_cycles(ms=0.8)
40

See also

to_ms()

microspec.helpers.to_ms(cycles: int) → float¶

Convert from cycles to milliseconds.

Parameters:	cycles – Time in cycles. One cycle is 20µs.
Returns:	Time in milliseconds.
Return type:	float

Example

>>> import microspec as usp
>>> usp.to_ms(cycles=usp.MAX_CYCLES)
1310.0

Notes

Dev-kit firmware measures exposure time in units of cycles and stores exposure time as a 16-bit unsigned integer. The smallest exposure time is 1 cycle. The largest exposure time is 65500 (1310.0ms).