Skip to content

Lens FIZ source

The Lens FIZ5 source reads the focus, iris and zoom of the lens plugged into the lens panel: a servo lens, a follow-focus system, an /i1 lens (Cooke, Zeiss, Fujinon), or RigFX's own external encoders. It publishes them as a FIZ5 channel for the Lens page.

What it publishes

Channel type Source channel Where to use it
FIZ source/lensfiz/fiz FIZ source of the Lens page

Modes and connectors

Pick the Mode that matches what is plugged in. Every mode but Encoder reads the Lens connector (Hirose 12-pin); Encoder reads the two external encoders on the Zoom connector (encoder 1) and the Focus connector (encoder 2), both Lemo 6-pin. See Hardware overview.

Mode For Connector
Canon Canon servo broadcast lenses Lens (Hirose 12-pin)
Fujinon Fujinon servo broadcast lenses Lens (Hirose 12-pin)
Angenieux Angénieux servo lenses Lens (Hirose 12-pin)
/i1 Cooke Smart lenses with the /i1 protocol: Cooke, Zeiss, Fujinon Lens (Hirose 12-pin)
Preston Preston follow-focus systems Lens (Hirose 12-pin)
Cmotion cmotion follow-focus systems Lens (Hirose 12-pin)
Encoder RigFX external encoders on the lens rings: zoom and focus by default, any ring with Encoders Zoom and Focus (Lemo 6-pin)

Source card

In Settings → Source → Lens FIZ Source:

Lens FIZ Source card

Field What it does
Status LED + label, see Status states.
Enable Turns the source on and off.
Mode What is plugged in, see Modes and connectors.
Encoders Encoder mode only: which encoder turns with each ring, see Encoders.
Focus, Iris, Zoom The live encoder values. In Encoder mode, a ring with no encoder shows —.
Buffer (frames delay) How many frames to delay the lens values (0–10), to line them up with a slower tracking source on the same camera.

The Mode list of the Lens FIZ Source card

Once enabled with the right mode, the status reads Connected and the values follow the lens rings:

Lens FIZ Source card, connected, with live FIZ values

Encoders

In Encoder mode, the Encoders row says which external encoder turns with each ring: for Focus, Iris and Zoom, pick Encoder 1 (the encoder on the Zoom connector), Encoder 2 (the one on the Focus connector) or None. The change applies at once and is kept after a restart.

By default, Encoder 1 is the zoom and Encoder 2 the focus, as the connectors are labelled. Put the encoders on any rings the lens needs. On a prime lens, for example, use one encoder for focus and the other for iris:

Ring Encoder
Focus Encoder 1
Iris Encoder 2
Zoom None

A prime needs no zoom: its lens file depends on focus only, so the Lens page works with focus alone. A zoom lens needs both focus and zoom; without zoom, the Lens page shows a warning.

Status states

LED Label Meaning
Off Disabled The Enable toggle is off.
Amber No Data Enabled, but no lens data. Check the mode, the cable and that the lens or follow-focus is powered.
Green Connected Lens data is arriving.

Calibration

Focus, iris and zoom are each reported on a 0–65535 scale, from one end of the ring's travel to the other.

Servo lenses, /i1 lenses and follow-focus systems (Canon, Fujinon, Angénieux, Cooke, Zeiss, Preston, cmotion) report their whole ring travel over 0–65535 themselves: nothing to calibrate.

External encoders are incremental: they count the ring's movement and learn its travel as it turns. Each time the ring goes past the highest or lowest position seen so far, that position becomes the new end of the 0–65535 range. To report the right values, they need to see the whole travel once:

  1. Turn each ring to one physical end stop of the lens.
  2. Turn it to the other end stop.

The encoders then report 0–65535 over the ring's travel. If a ring turns while its encoder is not in contact with it (the encoder slipped, or was taken off and put back), the count no longer matches the ring: reset the encoders by turning the source off and on again with Enable on the Lens FIZ Source card, then turn each ring from end stop to end stop again. Rings that turn endlessly have no end stops and can't be calibrated this way.

Troubleshooting

Status stays at No Data
  • Check that the Mode matches what is plugged in, and that the cable is in the right connector (Lens for every mode but Encoder).
  • Check that the lens, servo or follow-focus is powered and switched on.
The values don't reach 0 or 1 at the ends of the ring
  • With external encoders, turn each ring from end stop to end stop (Calibration).
With external encoders, the values drift or no longer match the ring
  • The ring turned while its encoder was not in contact with it. Turn the source off and on with Enable, then turn each ring from end stop to end stop again (Calibration).