Home

User's Guide & Technical Manual

1. 02 6 pf 6 30 The Viewer Software displays both the base firmware and software version numbers The base firmware defines the board type and is that part of the program code stored on the electronics board in the lens which is fully protected and cannot be erased or altered when a new program is uploaded New firmware is occasional offered by the manufacturer to update data processing facilities in the lens Uploading new firmware should only be conducted by authorized lens service providers using Cooke software Program Uploader This software ensures updates are correctly managed and verified Software allows earlier versions of the firmware to be uploaded if circumstances require a previous version Evolution of S4 amp Prime 10 bit ADC Upgrade SW Versions V0 05 to 0 19 Early versions most do not exist V0 20 See specification issues up to version 2 22 V0 21 Specification issue 2 23 Addition of Serial number to lens data string V0 22 addition of Ka command V0 22 to 25 skipped V0 26 Addition of board SW version to end of N command response string V0 27 Addition of more film formats Wnn command modify responses to P amp Kbn commands V0 28 Add CoC values W07 and W08 V0 29 Add dummy normalized zoom to data field amp change startup to standardized sequence Start up Baud increase from 9600 to 115k2 V4 01 New numbering to replace 0 29 Copyright 2012 Page 59 Cooke Note K3 amp K
2. 5 1 1 N Command Retrieve Fixed Data in ASCII Format Typical Response see exceptions by Lens type The first command a lens receives must be the N command When sending data in response to a command a lens typically echoes back the command as the first character in the response string Note Some older lenses and S4 8 lenses have N command responses that vary slightly Please see Appendix A 1 for details All 5 4 Panchro 8 and Zoom lenses provide the following N command response and will remain consistent for all lenses in the next development cycle Response Prime Lens NSs sssOu WuuLPNxxxMdddUbtTffyyyyBv vv L F C R Response Zoom Lens NSs ssssOu uuuLZNxxxMdddUbTffyyyyBv vv L F C R O uuw OwnerData 31charactes S XXX Focal length Primes or minimum focal length Zooms Tag f for S4 i M ddd Unspecified Primes or maximum focal length Zooms U Start up units l imperial M metric b metric or B imperial when both available as B Transmission factor not yet available in S4 8 Primes see Appendix SPACE characters Firmware version number Example Note Two space before B5 03 Issue N c r Response NS5 100 0090Cooke Optics Electronic Lenses LPFLOON100UBt92 B5 03 I f c r Copyright 2012 Page 24 C i f PN den F 2 O O a Q kJ amp amp Ly aw 5 1 2 D Command Retrieve Pre Defined Set of Calculated Data in ASCII Format Please see Appendix A 1 for variations in response to D com
3. Technology User s Guide amp Technical Manual Version 3 0 June 2012 cookeoptics com CookeOpticslimitec CookeOpticsLimited 2012 Cooke Optics Limited All rights reserved Cooke amp S4 S4 8 amp 5 amp CXX and Panchro are trademarks of Cooke Optics Limited The use of any of Cooke Optics intellectual property is strictly forbidden without its prior written consent Cooke Close Thurmaston Leicester LE4 8PT United Kingdom 44 0 116 264 0700derive the model from which we create our Kalman filter 44 0 116 264 0707 lenses cookeoptics com cookeoptics com m Copyright 2012 Page 1 Cooke Cooke amp Communication Protocol User s Guide amp Technical Manual Table of Contents 1 Introduction Intended Audience 1 4 References Contact Information 2 Cooke amp Intelligent Technology Overview amp Technology Open Protocol Technology Partners Lens Types with amp Technology 3 Hardware 3 1 3 1 Standard LEMO Connector 3 1 3 2 Maximum Cable Length versus Baud Rate 3 2 Lens System Components Lens System Overview Illumination Ring 4 System Communications 4t Basic Communications Format 42 Communicate with an Lens _ S External Remote Readout of amp Lens Data 4 4 4 Viewer Software for Cooke amp Lenses 4 4 4 1 2 4 3 Viewer Software for Cooke Lenses 0 44 Update Ownership Program for Cooke Lenses
4. Firmware and Lens Software Version Numbers Technology Partners Copyright 2012 Page 4 CookeOptics Appendix C Update Ownership Program for Cooke amp Lenses Instructions Viewer Java Program for Cooke amp Lenses Instructions Using HyperTerminal or PuTTY to Communicate with Cooke amp Lenses List of Figures amp Technology CORE Commands and EXTENDED Commands Camera Connector Viewed from Rear of Lens Rear View of LEMO socket EGBOO304CLL Figure 4 Rear View of LEMO PLUGS FGBO0304CLAD35 or FHBOO304CLAD35 5 amp Lighting Control Unit List of Tables Table 5 Basic Lens Response Types Table 6 Compare Calculation Time to Lens Type Table7 Compare Repeat Rate frames second to Lens Type Table 8 Valid Commands Allowed amp Blocked Recommendations with EDSU Copyright 2012 Page 5 CookeOptics Introduction Cooke Optics Limited developed the amp Technology system to enable film and digital cameras and equipment to automatically record and display key lens data for every frame shot Lens metadata includes information such as focal length focus distance T stop Zoom depth of field horizontal field of view entrance pupil position and frame rate Script supervisors no longer need to manually write down lens setting for every frame shot Power and data are transmitted through a camera interface an external interface or both 1 1 Purpose This document is both a User s Guide
5. EDSU establishes format of data and data rate to send to lens EDSU issues OC command and verifies response from lens An internal EDSU buffer for the EDSU data in the lens will be cleared 5 Data sent to the opposite camera interface will now append the contents of EDSU buffer to the normal data stream If buffer remains empty no data will be appended a Copyright 2012 Page 48 A lat caer Pr E C O O i e QW we bias 6 Each time EDSU generates new data it issues OD command to send data This data is stored in lens in EDSU buffer When new string is received by lens it replaces existing EDSU contents with new string 7 The lens generates data strings at whatever rate is required single or continuous and uses the latest EDSU data to append 8 To terminate the process the EDSU sends OH command EDSU can also request lens operate in Continuous data send mode ASCII or Binary so lens data is available to EDSU for use internally or passed through to secondary unit 9 Inthis mode data from lens is mixed with responses from OD commands issued by the EDSU response will be first string sent by lens after receipt of any OD command so will not be confused with next continuous data string 9 3 EDSU Dependencies Blocking Requirements for Pass Through Operation If EDSU has a secondary unit attached and it allows commands from the secondary unit to be passed to the lens and corresponding response passed bac
6. exceeds the valid range 5 1 18 H Command Unset Continuous Mode Response L F C R This command causes received channel to stop transmitting continuous data after a C or Kc command It also unsets the Checksum Mode and the Inhibit Error Response Mode Example Issue H c r Response I f c r 5 3 5 8 CORE Illumination Commands Additional details for operating the 5 8 Illumination feature are described in Section 8 5 2 1 Kjn Command 5 amp Lenses Only Set Scale Illumination Level for Both LED Sets il Response L F C R Copyright 2012 Page 36 CookeOptics The value of n is between 0 and 9 where O sets illumination to OFF and is at maximum brightness Example Issue Kj5 c r Response I f c r Note The Unknown response string will be issued by all non 5 amp lenses or if the value of n is any character that is not 0 to 9 5 2 2 Kkn Command 5 amp Lenses Only Set Scale Illumination Level for One LED Sets Response L F C R L FJ C R rs O n is O 5 nn pa Cc 5 N 3 O 5 The value of n is between 0 and 9 where O sets illumination to OFF and is at maximum brightness The second LED set is turned off Example Issue Kk5 c r Response l f c r Note The Unknown response string will be issued by all non 5 amp lenses or if the value of n is any character that is not 0 to 9 Copyright 2012 Page 37 CookeOptics
7. abcd Firmware Version Number format X XX Example Issue B c r Response B5 03 I f c r Note One space between B and 5 03 5 1 8 Kbn Command Set New Baud Rate Response Kbn L F C R L F C R n Baud Rate Maximum Cable Length o 9600 e 115200 2mees Example Issue Kb1 c r Response Kb1 I f c r Copyright 2012 Page 31 4 d A a i F E CookeOptics Note The Unknown response string will be issued if the value of n exceeds the valid range 5 1 9 C Command Set Continuous Send Mode of Data Packet in ASCII Format Response L F C R Once Continuous Send Mode is set the lens will continually measure calculate and send values in the D command format Example Issue C c r Response D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r D0001021T0195t1 4 8Z0000H0290024N0001018F0001024V006 8E 098z0000S5 100 009 I f c r 5 1 10 Kc Com
8. Arri Arri 435 Xtreme and Arricam cameras equipped with LDS have amp contacts in the lens mounts Avid Avid Media Composer editing system takes lens metadata captured with amp and passes it through to VFX Cinematography Electronics The Cinematography Electronics amp Lens Display Unit interfaces the Cooke amp lens system with their popular CineTape Measure System and adds lens data previously not available actual measured subject distance The focus puller will now know where the subject falls within the depth of field for the particular lens being used This data is continuously updated and displayed for real time information Pre adjustment or pre setting is never necessary In fact you can choose to display hyper focal distance subject distance focus marks the entrance pupil position and angle of view information that could save hours of prep time before a motion control shoot if dd Cinematography Electronics amp Lens Display Unit CMotion With amp equipped CMotion lens control systems your zoom controller can communicate directly with your amp equipped lens giving you iris zoom and focus positions resulting in faster set ups and more accurate control Codex The ability to record amp data Copyright 2012 Page 62 CookeOptics Element Technica Maker of Technica 3D stereographic 3D rigs The Foundry The Foundry s forthcoming Nuke 6 release will have an in built 3D cam
9. Operations Under normal operation a command is sent to a lens requesting information the lens generates a data string and sends this information to the camera interface the external interface or both This data can then be stored by the camera or external device for post processing 5 amp lenses have the additional facility to collect a data stream from an External Data Source Unit EDSU and then append this data to the lens normally generated data string During the append operation the EDSU generated data stream is stored within the lens and then appended to every data block that is sent to the Camera The EDSU can turn the append operation ON and OFF The lens has space to store a single EDSU STRING and this same string is used for every data block until it is updated by the EDSU or the append function terminated The data rate from the EDSU does not need to match the data rate between camera and lens If data strings from the EDSU which are to be appended arrive slower than the rate of data strings being generated by the lens for the camera then multiple strings to the camera will have the same EDSU append string added At the same time that the EDSU is sending data to the lens it can also request that the lens send the normal data stream back to it 9 2 Principals of Operation EDSU issues OS command to determine settings for current channel EDSU issues OT command to determine settings for opposite channel
10. By stringing together a list of tags users can request only the lens data elements they need in whatever order they want These commands will be included in the CORE Command Set expected release 2013 Data elements will include Focus Distance Aperture Value Aperture Ring T Stop Position Focal Length Hyperfocal Distance Near Focus Distance Far Focus Distance Horizontal Field of View Entrance Pupil Position Normalized Zoom Value Normalized Focus Position Copyright 2012 Page 51 Appendix A A 1 Command Response VARIATIONS earlier software versions Note You can retrieve the version number by issuing the B command A 1 1 D Command Variations Retrieve Pre Defined Set of Calculated Data in ASCII Format Note Data length for v0 30 is 62 characters while data length for v0 39 and v4 21 is 76 characters S4 amp Prime Lens versions 0 21 0 28 10 bit 0 34 0 38 12 bit Response DsssssssTaaaatbbbbbZffffHaaaaaaaNb bbbbbbFcccccccVvvv vESeeeSxxxxxxXXXX L FI C R D sssssss actual focus distance units T aaaa actualAperture settings Z Z o Z o t bbbbb calibration ring Aperturevalue C H aaaaaaa HYPERFOCAL setting units oN bbbbbbb NEAR FOCUS distance units Z F cecccce FAR FOCUS distance units Z o Z o V vwvv Horizontal Field of view degrees _ E seee _ Entrance Pupil Position units Tag sisa or sign S xox Lens Serial
11. R Response for S4 amp Zoom lens versions 1 26 and 1 36 and above current versions Response Zoom Lens NSs sssOu WuuLZNxxxMdddUbTff yy Bv vv L F C R Example Issue N l f c r Response NS8000123 OCooke Optics LZNOISMO40UIT92 B1 39 Response for S4 amp Zoom lens in earlier versions Response Zoom Lens NSs sssOu WuuLZNxxxMdddUbTff yyy L F C R Response for RED Zoom lens version 3 06 and above current versions Response Zoom Lens NSs sssOu WuuLZNxxxMdddUbTff yy Bv vv L F C R Response for RED Zoom lens version 3 03 Response Zoom Lens NSs sssOu WuuLZNxxxMdddUbTff yyy Bv vv L F C R Response for RED Zoom lens version 3 02 and earlier Response Zoom Lens NSs sssOu WuuLZNxxxMdddUbTff yyy L F C R Tag S SSS XXX Focal length Primes or minimum focal length Zooms XXX Focal length 4 4 Prime only Tag f instead of N ddd unspecified Primes or maximum focal length Zooms Copyright 2012 Page 54 Infinity Nodal distance N or n indicates sign plus 3 digits S4 4 Prime only Entrance Pupil Position or sign plus 3 characters 4 4 Prime only o oO Start up units l imperial M metric b metric start or B imperial start both available Transmission factor not yet available in S4 8 Primes SPACE characters Firmware version number A 1 3 Kd Command Variations Retrieve Pre Defined Set of Calculated Binar
12. and a Technical Manual It contains instructions on how to control and communicate with Cooke amp lenses along with additional information about current amp Technology protocol standards 1 2 Intended Audience e Sections 1 through 10 and Appendices A through C of this document are available on the Cooke Optics Website and can be downloaded at http www cookeoptics com cooke nsf itech downloads html It is an amp Technology Communications Protocol User Guide and Manual for Cooke lens users Technicians amp Technology partners and anyone interested in learning more about the amp Technology protocols e Appendix D is available by special request to amp Technology partners and Technicians who service amp Technology equipment e Appendix E is available only to Cooke Optics amp Technology developers 1 3 Contact Information Please email info cookeoptics com with questions or if you need additional information 1 4 References Cooke amp Communications Protocols Version 2 41 March 2011 Copyright 2012 Page 6 A lat caer Pr E C O O ce QW we bias 2 Cooke amp Intelligent Technology Overview amp Technology is a registered trademark of Cooke Optics Limited It is a metadata protocol that enables film and digital cameras to automatically record key lens data for every frame shot Equipment identification is by serial number lens type and manufacturer The amp Technology system reco
13. and provides access to a text based application console If there are no serial ports on the PC you can use a USB to Serial port converter and use device manager to determine which COM port is emulated by the USB converter If there is no HyperTerminal preinstalled on your PC it can be downloaded from the Internet or retrieved from a Windows XP computer Note Windows 7 and Vista no longer provide HyperTerminal Alternatively PUTTY can be downloaded from http www putty org and configured as a terminal emulator More detailed instructions can be found in Appendix C 3 4 6 External Data Source Unit EDSU for 5 amp Cooke 5 lenses have additional facilities and commands not available to the other lens types which enable an external device called an External Data Source Unit or EDSU connected to the lens external RS232 channel to perform special operations Under normal operation a command is sent to a lens to request information The lens generates a data string and sends this information to the camera interface the Copyright 2012 Page 16 CookeOptics external interface or both This data can then be stored by the camera or external device for post processing 5 amp lenses have the additional facility to collect a data stream from an External Data Source Unit EDSU and then append this data to the normally generated data string of the lens This combined data string is then sent to the camera At the same time tha
14. bits 8 stop bits 1 parity no flow control no so the connected lens can be accessed Enter a name Connection Description a New Connection Enter a name and choose an icon for the connection Select the port to which you are connected Copyright 2012 Page 73 CookeOpticsLimited Connect To Enter details for the phone number that you want to dial Country region United States 1 Area code EEE Phone number Select the serial port parameters as shown below COMI Properties Bits per second 600 Data bits 8 Party None Stop bits How control None Apply and press OK CookeOptics The HyperTerminal is now connected To activate communication with the lens type N and press lt enter gt Note This is an upper case letter N All other commands are now available File Edit View Call Transfer Help NS3200 0980 0 Cooke Optics Ltd LPN 7SMB7SUBT92 B4 90 Connected 0 00 58 Auto detect 9600 8 N 1 NUM If you do not have access to HyperTerminal PUTTY can be downloaded from http www putty org and used to access serial devices Running the program will bring up the PuTTY Configuration window shown below Configure Putty as a serial client by opening the serial node in the category view and specifying serial as the connection type Copyright 2012 Page 75 N CookeOpticsLimited Serial line to connect to Configure the seria
15. distances in metric units only If the value after Tag U is a B the calibration table stores focus distances in both imperial and metric units with Copyright 2012 Page 42 CookeOptics the default display units set as imperial If the value after Tag U is a b the calibration table stores focus distances in both imperial and metric units with the default display units set as metric 6 2 2 Cooke 5 amp Lens Units and Startup Units Commands 5 amp lenses have a dual marked focus ring that can be reversed to show either imperial or metric units 5 amp lenses have been factory calibrated in both imperial and metric units and the factory set Start Up Units should match the focus ring units The Start Up Units can be checked by issuing the N Command or the OS Command The value after Tag U in the command response will always be either a B or b where B indicates the default display focus distance values are in imperial units and b indicates the default display units are metric See also Commands X and Y and 5 8 specific commands OS OX and OY Commands OX and OY will change the display default units on both 5 8 channels by changing the B to a b or changing the b to a B while Commands X and Y will change only the current display units on the channel the command was sent The newest 5 8 lenses have an internal switch which can be used to automatically change the Start Up Units when the focus
16. inputs on the communication channels are monitored at startup and during operation to determine which channel has control Lenses that have a single communication channel will be controlled by the camera interface For 5 amp Prime lenses the two channels function independently and can both receive commands and send replies at different baud rates The two channels on S4 8 amp Prime and Zoom lenses however do not function independently For 4 amp lenses if power is present on the external interface then the external interface is granted control If power is not present on the external interface then the camera is granted control S4 amp lenses can receive commands on only one channel but responses will be sent out on both channels Copyright 2012 Page 14 CookeOptics Typically a lens will start up at a baud rate of 115k2 and send the powerup string lt I f c r less than symbol followed by a linefeed and carriage return when power is detected The lens will then wait for one second to receive an N command from a controlling channel If the N command is not received within one second the baud rate will drop to 9600 and the lens will wait until an N command is received The lens must receive an N command as the first command Once the lens has received and responded to the N command all other commands valid for that lens type are available to the controlling channel s For example the Kbn command can be sent to the lens to r
17. respect to 0 volts where the quiescent state of the data line is at a negative voltage The external connector is a standard LEMO mechanical connector with 4 pins Maximum cable length depends on baud rate Refer to Table 2 on page 11 3 1 3 1 Standard LEMO Connector Wiibbiio LIINC KEY WAYS RED DOT Figure 3 Rear View of LEMO socket EGBOO304CLL This is the view of the solder buckets and the red dot marker and key way positions indicated for clarity Copyright 2012 Page 11 CookeOptics PLASTIC INSERT KEY WAYS RED DOT WHITE LINE Figure 4 Rear View of LEMO PLUGS FGB00304CLAD35 or FHBOO304CLAD35 This is the view of the solder buckets and the red dot marker and key way positions are indicated for clarity Data from Lens Data to Lens 0 volts Data and Power V Power in og Ieee Table 2 Maximum Cable Length versus Baud Rate Copyright 2012 Page 12 CookeOptics 3 2 Lens System Components 3 2 1 Lens System Overview The Cooke amp Technology lens system contains resistance elements to sense ring positions an electronics board to process and calculate lens information and one or two serial communications interfaces to receive and send commands and data to a camera and or other external device Cooke 5 8 lenses also have two sets of LEDs used to illuminate the focus scale The LEDs are connected to a secondary electronics interface board The lens electronics board has a communication
18. ring is reversed Earlier 5 amp lenses should be issued the OX or OY commands to set the Start Up Units to either imperial OX or metric OY so the display units will correspond correctly to the selected focus ring Copyright 2012 Page 43 CookeOptics 7 Baud Rates and Response Times 7 1 Implementation PANCHRO amp RED amp S4 amp Zooms S4 amp Primes 5 Primes Message transmission time is affected by the length of the data stream and baud rate Earlier S4 Prime and Zoom lenses with 10 bit ADC have slower clock speeds than the later S4 Primes lenses with 12 bit ADC 7 2 Table 6 Compare Calculation Time to Lens Ea nome Yee 7 3 Table7 Compare Repeat Rate frames second to Lens Type Repeat Rate Frames sec Lens Type Command Baud Rate Baud Rate Baud Rate 9600 115200 230400 5 8 Prime 1channel 23 147 2857 o E za 27 2857 SBprme2channe r3 w 3 D a Y E o EE Bn a NMA _ SAI Prime 12 bit un 6 NA o E _ 2 5 MA _ o E NA Sal zoom BNA pe NA REDO tt BNA Copyright 2012 Page 44 CookeOptics 8 Illumination Scale 5 8 Lenses 8 1 Overview 5 amp lenses are equipped with two sets of LED s which can controlled to illuminate the scales in low light situations The brightness level of one set can be altered while the other is OFF or both sets can be altered in unison Manual Control of the brightness levels is ach
19. 4 commands not currently available for 10 bit boards Evolution of S4 amp Prime 12 bit ADC Upgrade SW Versions V0 33 V0 37 Addition of more film formats Wnn command modify responses to P amp Kbn commands standardized sequence Start up Baud increase from 9600 to 115k2 New numbering to replace 0 39 Evolution of 4 amp Zoom 10 bit ADC Upgrade SW Versions V1 21 See specification issues up to version 2 22 V1 22 Specification issue 2 23 Addition of Serial number to lens data string Increase Normalized zoom resolution V1 23 Addition of Ka command V1 23 to 25 skipped V1 26 Addition of board SW version to end of N command response string V1 27 Addition of more film formats Wnn command modify responses to P amp Kbn commands V1 28 Add CoC values W07 and W08 V1 29 Change startup to standardized sequence Start up Baud increase from 9600 to 115k2 V4 41 New numbering to replace 1 29 Note K3 amp K4 commands not currently available for 10 bit board versions Evolution of S4 amp Zoom 12 bit ADC Upgrade SW Versions Specification issue 2 23 Addition of Serial number to lens data string Increase Normalized zoom resolution Addition of Ka command V1 37 Addition of more film formats Wnn commands Modify responses to P and Kbn commands V1 38 Add CoC values W07 and W08 Copyright 2012 Page 60 CookeOntics V1 39 Change startup to standardized sequence Start up Baud increase from 9600 to 115k2
20. 5 3 CORE Commands for 5 amp Start Up Units 5 3 1 OX Command 5 amp Lenses Only Set Start Up Units to Imperial Response L F C R L FJ C R es O nn O 5 nn pL 3 O 3 This command will set the Start Up Units character to B changing the current Display Units selection for both channels to Imperial See Section 6 for additional details Example Issue OX c r Response l f c r Note The Unknown response string will be issued if by all non 5 8 lenses 5 3 2 OY Command 5 amp Lenses Only Set Start Up Units to Metric _ Response L F C R L F C R rs O nN OD O 5 nn pL N 3 O This command will set the Start Up Units character to b changing the current Display Units selection for both channels to Metric See Section 6 for additional details Example Issue OY c r Response l f c r Note The Unknown response string will be issued by all non 5 lenses 5 4 CORE Commands for 5 amp External Interface EDSU Cooke 5 8 lenses allow users to append additional external data up to 60 8 bit values onto the data stream normally generated inside the lens External data is retrieved through the 5 8 s external communication interface and then appended to the D C Kd or Kc response stream The appended string must consist of 8 bit characters which do not include the I f or c r character and preferable no other ASCII control ch
21. Gmer Alame Uodate Verior 3 00 Cooke i wher Name Update Version 3 00 Figure 1 Select Serial Port on MAC and on Windows Current Owner Cooke Optics Update Please Enter the New Owner up to 31 characters Next Quit Cooke si Owner Name Update Version 3 00 Figure 2 Enter the New Owner e Click the Connect button the second screen as shown in Figure2 appears The current owner is displayed e Input the name of the new owner and then click the Update button the newly input owner name is displayed at the top of the screen as shown in Figure3 e If updating more than one lens disconnect the updated lens connect the new lens and then click Next button The owner name of the new lens is displayed and the previously inputted name stays in the text field If the owner of the next lens is the same as the previous one just press Update button e There is Copy and Paste menu by right click the mouse shown in Figure4 e Click x or Quit button to finish the updating process Copyright 2012 Page 68 CookeOptics Current Owner I am the New Owner Please Enter the New Owner up to 31 characters I am the New Owner Cooke i Owner Name Update Version 3 00 Figure 3 Owner Updated Current Owner I am the New Owner Please Enter the New Owner up to 31 characters I am the New Owner opy Paste Cooke i Owner Name Update Version 3 00 Figure4 Copy and Paste Menu
22. Notes If any error messages turn up please check the followings e Accessibility to the Serial Port on MAC e Updated Driver of USB Serial Port Adaptor Update uit e Lens is correctly connected to the selected serial port and powered on e Any program running which is using the same serial port such as HyperTerminal e Close the program power off the lens and start it again if not able to find reasons Copyright 2012 Page 69 CookeOptics Appendix C C 2 Viewer Java Program for Cooke amp Lenses The Cooke Viewer Java program is to view the information of a lens through its external interface It is implemented in Java so it runs on Windows and Mac OS X and can be downloaded from Cooke Optics Limited website The lens and PC or MAC is connected through a serial port If the machine doesn t have a serial port use a USB Serial port adapter and install a correct driver To run the program Java Runtime Environment JRE is required It comes with MAC OS For Windows it can be downloaded here if not installed Installation of Software Windows XP VISTA 7 e Download JRE 6 here and install if it is not already installed e Double click the Viewer installer CookeViewer_Win_setup_V3 00 msi follow the instruction and complete installation Mac OS X 10 5 10 6 e Setup Serial Port Run SerialPort_Config first so that the application can access serial ports Only need to run Seria Port_Config ONCE if there are bo
23. Number O O oo O Note The Zoom EFL value 0000 for all Prime lenses S4 amp Zoom and RED Lens versions up to and including 1 22 1 30 3 02 Response DsssssssTaaaatbbbbbZffffHaaaaaaaNb bbbbbbFcccccccVvvv vESeeeSxxxxxxXxXxX L FI C R Tag D sssssss actual focus distance units Copyright 2012 Page 52 CookeOptics N bbbbbbb _NEARFOCUSdistance units mmm Note The normalized zoom setting value resolution was 0 00 to 1 00 for S4 8 Zoom and Red lens versions up to and including 1 22 1 30 3 02 and is displayed as 000 to 100 The resolution for all subsequent versions is 0 000 to 1 000 and is displayed as 0000 to 1000 A 1 2 N Command Variations Retrieve Fixed Data in ASCII Format The first command a lens receives must be the N command Response for 5 amp Prime lens Response Prime Lens NSs sssOu WuuLPNxxxMdddUbTffyyBv vv L F C R Response for Panchro amp Prime lens Response Prime Lens NSs sssOu WuuLPNxxxMdddUbTffyyBv vv L F C R Response for S4 amp Prime lens versions 0 25 or 0 35 and above current versions Response Prime Lens NSs sssOu wuuLPfxxxNdddUbEseeeBv vv L F C R Example Issue N l f c r Response NS4075 01230Cooke Optics LPf027N0O77UIE 088B4 22 Response for S4 amp Prime lens versions before 0 25 and 0 35 Copyright 2012 Page 53 CookeC Response Prime Lens NSs sssOu wuuLPfxxxNdddUbEseee y L F C
24. Rate External Panchro a N A Yes Camera 115k2 REDZoom N A Yes Camera 115k2 YES External 115k2 _ _ YES NO External 115k2 NO YES Camera 1152 S4 8 older version YES YES External 115k2 S4 8 older version YES NO External 115k2 S4 8 olderversion NO YES Camera 9600 5A ws NO External 115k 5A O no YES Camera 15k Yes Yes YES YES YES YES 4 9 2 Bluetooth Operation 4 amp Lenses Only S4 amp lenses are Bluetooth capable if the external interface has control although this feature has been dropped from the 5 amp and Panchro amp lens series and will likely be retired in future S4 amp lenses If an S4 amp lens is controlled by the external interface its start up baud rate will be 115k2 and the standard power on prompt lt I f c r is sent to both channels The lens will wait for one second to receive an N command from the external channel If no response is received within one second the data rate will drop to 9600 baud and a modified power on string is sent lt I f c r This string doubles as a Bluetooth initialization prompt and a standard start up prompt lt The lens at this stage will accept either the N command directly through the external interface or it will enter a series of exchanges to establish a Bluetooth connection If the N command is received on the external interface the lens will skip f
25. V4 61 New numbering to replace 1 39 V4 62 Addition of K3 amp K4 commands Evolution Red Zoom 12 bit ADC Upgrade SW Versions V3 02 See specification issues up to version 2 22 V3 03 Specification issue 2 23 Addition of Serial number to lens data string Increase Normalized zoom resolution Addition of Ka command SW version added to the end of N command response string V3 04 05 Skipped V3 06 Remove 1 packing character from N response field to make same length as all other board responses V3 07 Addition of more film formats Wnn commands Modify responses to P and Kbn commands V3 08 09 Version 3 08 3 09 Change start up to standardized sequence V6 01 New numbering to replace 3 09 V6 02 Addition of K3 amp K4 commands Evolution of 5 amp 12 bit ADC Upgrade SW Versions V5 01 Factory Test version with base firmware b V5 02 amp 5 03 Software start up units operation V5 04 Revised start up units with operational switch Addition of K3 amp K4 commands Evolution of Panchro amp 12 bit ADC Upgrade SW Versions V8 01 V8 02 Production Release version to spec 2 40 V8 03 Addition of K3 amp K4 commands B 2 amp Technology Partners Aaton Aaton has built amp support into their Penelope 35mm camera for direct metadata capture via amp contacts in the lens mount Angenieux Copyright 2012 Page 61 CookeOptics Angenieux will incorporate the amp Technology into its Optimo series of zoom lenses
26. Z OZ o 5 4 Prime Lenses T1 4 Red Zoom Lenses Ag Command Response Structure CORE Command Function Table Copyright 2012 Page 2 Cooke 49 Start Up Sequence Controlling Channel and Start Up Baud Rate Bluetooth Operation S4 amp Lenses Only Basic Lens Response Types 5 CORE Command Set CORE Commands for All Lens Types Command N Retrieve Fixed Data Required first Command Command D Retrieve one set of ASCII Calculated Data 5 1 3 Command Kd Retrieve one set of Packed Binary Calculated Data 5 1 4 Command K3 Retrieve name of Lens Manufacturer 5 1 5 Command K4 Retrieve name of Lens Type 5 1 6 Command P Retrieve board Temperature 5 1 7 Command B Retrieve board Firmware Version 5 1 8 Command Kbn Set Baud Rate 5 1 9 CommandC Set Continuous Send mode amp Transmit ASCII Calculated Data 5 1 10 Command Kc Set Continuous Send mode amp Transmit Packed Binary Data 5 1 11 CommandG Set Checksum mode 5 1 12 Command Ka Set Inhibit Error Response mode 5 1 13 Command X Set Display Units to Imperial 5 1 14 Command Y Set Display Units to Metric 5 1 15 Command V Set Film Size to 35mm default value 5 1 16 Command W Set Film Size to 16mm 5 1 17 Command Wnn Set Film Size Circle of Confusion Value 5 1 18 Command H Stop Continuous Send clear Checksum clear Inhibit Error 5 2 CORE Commands for 5 amp ILLUMINATION COMMANDS 5 2 1 Command Kjn Set Scale Illumination for bot
27. ale Illumination for both LED sets Kkn Set Scale Illumination for one LED set 5 amp START UP UNITS COMMANDS OX setstart Upunitstoimpeial d d OY setstar upunitstometic FT dao OS Retrieve Channel settings forthischannel S d OT Retrieve Baud Rate Data Type Display Unit for Opposite channel J OC commence AppendofDatasting S doo OD Append Data String upto 60 8 bit data value LK OH HaltAppendofdatastring S o 4 9 Start Up Sequence Most lens will start up at a baud rate of 115k2 and send the power on string lt I f c r less than symbol followed by a linefeed and carriage return to the power Copyright 2012 Page 21 CookeOptics on prompt The lens will then wait for one second to receive an N command from a controlling channel If the N command is not received within one second the baud rate will drop to 9600 and the lens power on string will be sent again The lens will then wait until an N command is received The lens must receive an N command as the first command Once the lens has received and responded to the N command all other commands valid for that lens type are available to the controlling channel s For example the Kon command can be sent to the lens to revise the baud rate Variations are shown in the table below 4 9 1 Table 4 Controlling Channel and Start up Baud Rate Lens Type Interface with Power Controlling Channel Start up Baud
28. aracter hex 00 to hex 1F Copyright 2012 Page 38 A lat caer Pe Coo ke QW we TA Additional details describing the 5 amp EDSU operation are provided in Section 9 5 4 1 OS Command 5 amp Lenses Only Retrieve Current 5 8 Channel Settings Response OrRdUCO OcccWnninlSssssssssBx xx L F C R L FJ C R O0 J S poor R FocusScale Ring Type currently fitted on lens I Imperial M Metric__ pod U Display Units currently selected Imperial M Metric _ Ww m Number Associated with Film Size CoC Value see Wnn Command _ i m __ Illumination Level n 1 for 1 LED n 2 for 2 LEDs I O min 9 max B xx FirmwareVersion Number o gt Z oZ o Example Issue OS c r Response OrldiC0O 0250W00Si105200 090 B4 90 I f c r Note The Unknown response string will be issued by all non 5 amp lenses 5 4 2 OT Command 5 amp Lenses Only Retrieve Baud Rate Data Type Display Units for Opposite Channel i Response OtBbFfUu L F C R L FJ C R Tag Tag B b Baud Rate of Opposite Channel b 0 7 see Kbn Command Example Copyright 2012 Page 39 CookeOptics Issue OT c r Response OtBOFAUI I f c r Note The Unknown response string will be issued by all non 5 amp lenses 5 4 3 OC Command 5 amp Lenses Only Commence Append of Data String ic Response L F C R Response Unknown OO MLENIC R a Example Issue OC
29. bed in Section 8 1 Copyright 2012 Page 13 CookeOptics 4 System Communications 4 1 Basic Communications Format Standard serial communication is 8 bit data without parity 1 stop bit in ACSII format The lens can also transmit a packed binary format response when requested using the 8 bit no parity format to reduce the time taken to transmit data from the lens The camera or external unit will initiate all data transfers from the lens except during Power Up At Power Up a single automatically generated string is transmitted by the lens to both channels indicating that a power up has occurred All commands sent to the lens must be in ASCII format and terminate with a carriage return character c r The carriage return character has hex value OxOD Reply responses from the lens will normally be in ASCII format and terminate with the character pair linefeed followed by carriage return I f c r The linefeed carriage return pair have hex values Ox0A and Ox0D The packed binary format also has termination character pair OxOA and Ox0D and neither of these characters will appear within the data string All data string characters have either bit 7 or bit 6 or both set to 1 4 2 Communicating with an amp Lens Cooke 5 8 Prime lenses Cooke S4 amp Prime and Zoom lenses have two communications channels and Cooke Panchro amp Prime lenses and RED Zoom lenses have one communication channel Power
30. c r Response I f c r Note The Unknown response string will be issued by all non 5 amp lenses 5 4 4 OD Command 5 amp Lenses Only Append this Data String dddd d to the D C Kd or Kc Response String Response L F C R Response Unknown L FIIC RI i ss i lt iststis Response Unknown ddd d a string of up to 60 data values which terminate with the C R character These can be any 8 bit values except a C R or L F Example Issue OD abc12378 amp S c r Response I f c r Note The Unknown response string will be issued by all non 5 8 lenses 5 4 5 OH Command 5 amp Lenses Only Halt Append of Data String Copyright 2012 Page 40 CookeOptics Response L F C R Response Unknown o RCR a Example Issue OH c r Response I f c r Note The Unknown response string will be issued by all non 5 amp lenses Copyright 2012 Page 41 CookeOptics 6 Measurement and Calculation Units 6 1 Measured Values and Calculated Values Cooke amp lenses measure the lens settings focus aperture zoom and use these values to calculate focal length hyperfocal distance near focus distance far focus distance horizontal field of view entrance pupil position normalized focus distance and normalized zoom setting Distance values are expressed in either millimeters or in multiples of 0 1 inch with the exception of the Zoom EFL value which is alway
31. e Sections 6 1 and 6 2 for additional information regarding operation of X and Y commands Example Issue X c r Response X I f c r 5 1 14 Y Command Set Display Units to Metric Response Y L F C R Note This command will change the display units on both channels for 4 amp lenses but will change only the display units for the channel which issued the command for 5 amp lenses See Sections 6 1 and 6 2 for additional information regarding operation of X and Y commands Example Issue Y c r Response Y I f c r Copyright 2012 Page 34 CookeOptics 5 1 15 V Command Set 35mm Mode V C R V 0 0 b b b L F C R V bbb Circle of Confusion value in mm fora 35mm Example Issue V c r Response V0 0250 I f c r 5 1 16W Command Set 16mm Mode Response W 0 0 b b b L F C R W bbb Circle of Confusion value in mm fora 16mm Example Issue W c r Response W0 0125 I f c r 5 1 17 Wnn Command Set Film Size Extended Mode Wnn C R Response W 0 0 b b b L F C R Response Unknown MAILV FNIC R W bbb Circle of Confusion value in mm Copyright 2012 Page 35 CookeOptics Example Issue WO8 c r Response W0 0191 I f c r m Filmsie Cirdeof Confusion Value 0 f 35mm RS 6 ATON2perf oo O 0022 8 2764x2304 4K Anamorphic 00191 SS 9 Sonyaps cot NS Note The Unknown response string will be issued if the value of nn
32. er r Pr E C O O i ce QW we bias While pressing connect the power cable All LEDs are highlighted Release The module starts normally with LEDs off on the unit 2 oS SPECIAL MODE Adjust The Maximum Brightness Of The Yellow LEDs During normal use press ZONE until the green LED brightness increases By keeping ZONE pressed the Green LED becomes very bright Press or to adjust the maximum brightness of the LEDs Release ZONE to exit the SPECIAL MODE SS Power Connector RS232 Serial Cable LED1 oneal LED2 Yellow Assistant Scale LED Red Green Figure 5 5 amp Lighting Control Unit 8 1 2 5 amp Manual Scale Illumination Instructions At Power up the LED s will be OFF and consume minimum power To alter the brightness of both sets of LEDs move the Aperture ring to the aperture setting T22 end stop and move it away towards 11 4 then repeat that process twice more within 0 5 second This will cause the LED s to be set to fully ON for 0 3 sec then fully OFF for 0 3 sec and then fully ON The operator can now adjust the desired level by moving the Aperture scale up towards T22 or down towards T 1 4 If there is a half second period Copyright 2012 Page 46 CookeOptics during which no change of Aperture setting is detected the set illumination level is retained During this illumination setting process amp lens operations continue to fu
33. era tracker to which the user can provide additional hints and constraints about the shoot to recreate the camera for example which lens was used More Shoot lens distortion grids with different focal lengths and the amp data gives you an accurate focal length Use a lens tool to un distort the plate then use the camera tracker within Nuke to reapply this to the footage Having the amp data makes the tracking process much simpler particularly since lens distortion changes with the zoom Fujinon Fujinon PL mounted zoom lenses as of 2010 include amp Technology Mark Roberts Motion Control The amp Technology is incorporated into some of the Mark Roberts Motion Control remote and repeatable pan tilt heads such as the Ulti head so that while the cameraman is controlling the head including pan tilt zoom and focus the system can also accurately record the calibrated lens data using the amp Technology This data can then be fed through to post production to more easily add any CG computer graphic elements Camera and lens motion data is often required for post production and the amp data saves the cameraman or operator time in getting correctly calibrated data for the lens motion The Ulti head can be used on its own or with the larger MRMC products such as the Modula and the Talos rigs See Mark Roberts Motion Control for more information about their products for film and broadcast applications including the Academy Awa
34. etadata capture Sony F65 S two Copyright 2012 Page 64 CookeOptics It s all about the workflow Transvideo Transvideo s Cine Monitor HD now has built in amp Technology that can display lens data on the monitor A graphic representation of the iris focus and depth of field is a great benefit to focus pullers X tu Transvideo Cine Monitor HD B 3 amp Accessories AC Power Supply for amp lenses with external connector from Cooke Optional D9 to USB Adapter y S 4 Copyright 2012 Page 65 CookeOptics XLR Power Connection for amp lenses with external connector from Cooke Cooke 5 8 Lighting Controller The Cine Tape Measure system is a small rugged lightweight and quiet ultrasonic range finder that is easy to set up and easy to use Copyright 2012 Page 66 CookeOptics Appendix C C 1 Update Ownership Program for Cooke amp Lenses The Cooke Owner Update program is to update the owner name of a lens through its external interface It is implemented in Java so it runs on Windows and Mac OS X and can be downloaded from Cooke Optics Limited website The lens and PC or MAC is connected through a serial port If the machine doesn t have a serial port use a USB Serial port adapter and install a correct driver To run the program Java Runtime Environment JRE is required It comes with MAC OS X For Windows it can be downloaded here if not installed I
35. evise the baud rate 4 2 1 Connecting an amp Lens to an Camera Film and digital cameras which are amp Technology compliant can automatically retrieve and record key lens data for each frame through the four contact pins built into the PL mounts The extent of camera data made available is the choice of the camera manufacturer via their software so check with the camera manufacturer for details Cameras use different film sizes or Circle of Confusion values The lens default film size is 35 mm with Circle of Confusion value equal to 0 0250 mm You can use the V W or Wnn command to set the appropriate film size to match any camera See Section 5 15 5 17 for details 4 2 2 External Remote Readout of amp Lens Data Continuous remote readout of the precise lens data can be obtained by connecting the lens to an external device such as the Cinematography Electronics amp Lens Display Unit Lens data can be displayed on an externally connected amp compatible monitor such as Transvideo s CineMonitorHD 4 3 Viewer Software for Cooke amp Lenses The Cooke Viewer program can be used to display lens data through its external interface The program runs on a Windows or MAC OS X platform and can be downloaded from the Cooke Optics website at http www cookeoptics com cooke nsf technical downloads html The lens is connected to the PC or MAC through a serial port If the computer does not have a serial port use a USB Serial
36. formation is stored in the electronics board along with other unique lens characteristics There is a set of EXTENDED commands unique to Cooke lenses used for this purpose only These hidden commands are considered confidential In addition to the set of EXTENDED commands associated with calibrating a lens there is also a set of EXTENDED commands associated with lens program updates These commands are confidential 4 7 1 PANCHRO 8 amp Prime Lenses T2 8 Panchro amp Prime lenses have a single channel interface for direct communication with a camera The start up baud rate will be 115k2 if an N command is received within one second If no N command is received within one second the speed will drop to Copyright 2012 Page 17 CookeOptics 9600 baud and the lens will wait without timeout for an N command Baud rate can be adjusted using the Kon command All CORE commands described in Sections 5 1 through 5 1 18 are available for Panchro amp lenses 4 7 2 4 amp 8 Prime and CXX 15 40mm Zoom T2 0 Lenses S4 amp lenses have two communications channels which send the same response to both channels and can receive commands only from a single controlling channel If power is present on the external interface the external interface takes precedence over the camera interface and will have control If only one interface supplies power it will be the controlling channel If the external interface has control start up will be at 115k2 ba
37. h LED sets 5 2 2 Command Kkn Set Scale Illumination for one LED set 5 3 5 amp START UP UNITS COMMANDS 5 3 1 Command OX Set Start Up Units to Imperial 5 3 2 Command OY Set Start Up Units to Metric 5 4 CORE Commands for 5 amp SETTINGS amp EXTERNAL INTERFACE EDSU 5 4 1 Command OS Retrieve Channel Settings for This Channel 5 4 2 Command OT Retrieve Baud Rate Data Type Display Unit Opposite Channel 5 4 3 Command OC Commence Append of Data String 5 4 4 Command OD Append Data String up to 60 8 bit data values 5 4 5 Command OH Halt Append of Data String 6 Measurement and Calculation Units 6 1 Measured Values and Calculated Values 6 2 Start Up Units Copyright 2012 Page 3 Cooke Cooke Panchro amp Cooke S4 amp Prime amp Zoom and RED Zoom Lens Units Cooke 5 amp Lens Units and Startup Units Utility 7 Baud Rates and Response Times Implementation PANCHRO RED amp S4 8 amp Zooms S4 amp Primes 5 4 Primes Calculation Time Repeat Rate Frames second Overview 5 amp Lighting Control Unit Instructions 5 amp Manual Scale Illumination Instructions Principals of Operation EDSU Dependencies Blocking Requirements Pass Through Operation 10 Troubleshooting Possible Errors and How to Fix Them Loss of Program 11 NEW Commands Planned for 2013 ial th Optional Commands to Retrieve User Defined Combinations of Binary Data Packets Appendix A Appendix B
38. ieved using the Aperture Ring The brightness levels can also be controlled remotely by using the 5 amp Lighting Control Unit or issuing the Kjn or Kkn Commands 8 1 1 5 amp Lighting Control Unit Instructions 1 2 3 4 5 STANDARD MODE Connect the unit to a DC source of 9 35V then connect the serial cable to the lens See fig 5 During startup the module performs an auto test and the LEDs blink Yellow 1 Yellow 2 Red Green See Fig 5 After the auto test the green LED will light up A red LED means a connection failure with the lens in this case check the connection and the cable See Fig 5 Press or to adjust the illumination of the scales on the lens The brightness of the unit s LEDs vary with the adjustment ZONE selects the illuminated scales on the lens Three positions are available a Operator scale ON and Assistant scale ON b Operator scale OFF and Assistant scale ON c Both scales OFF RESET Sets the unit to the factory preset values While pressing ZONE connect the power cable All LEDs are highlighted Release ZONE The unit starts normally with 50 brightness on the OPERATOR and ASSISTANT scales oe i SPECIAL MODE 5 8 Lighting Control Unit LEDs Off This mode allows user to switch off the LEDS on the control unit The control unit operates the brightness levels on the lens normally but both LEDs on the control unit are off Copyright 2012 Page 45 A lat ca
39. ime Lenses SFFF xxxx 8025 1234 Panchro amp 8 25mm S4 amp Prime Lenses AFFF xxxx 4025 1234 S4 amp 25mm 5025 1234 5 amp 25mm Fujinon PL Mount Lenses Copyright 2012 Page 9 CookeOptics 3 Hardware 3 1 Interface Requirements Some amp lenses have both a camera communication connector four contacts built in the PL mount as shown in figure 2 and an external communication connector figures 3 and 4 Some lenses have only the camera communication interface Each interface is described in detail in Sections 3 1 2 and 3 1 3 3 1 1 Power Power can be supplied to the lens through either the camera connector or an external connector if available or both The maximum voltage which can be supplied on either connector is 35V DC Cooke amp voltage range 9 35V Lens Type Typical Current Draw S4 amp Primes 30 milliamps 4 8 Zoom CXX 5 amp Primes 40ma when Illumination OFF 70ma when Illumination ON Panchro amp Primes 3 1 2 Camera Connector Signal voltages on the camera interface are at TTL levels where the quiescent state of the data line is a logical high greater than 2 4 volts Copyright 2012 Page 10 CookeOptics PL Mount Principle Key Connectors 43 2 4 Figure 2 Viewed from rear of lens Data from Lens Data to Lens 0 volts Data and Power V Power in 3 1 3 External Connector Signal voltages on external connector are at RS 232 levels and with
40. interface which connects directly to the camera and may also have a second communication interface that can be connected to an external device such as a monitor or External Data Source Unit The camera interface operates at TTL levels and the external interface operates at RS232 levels Each communication interface provides power supply and serial transmit and receive lines through separate 4 way connectors See Sections 3 1 2 and 3 1 3 for details 3 2 2 Potentiometer Connections Cooke Prime lenses house two sensor resistance elements with wipers to sense the ring positions for focus and aperture Cooke Zoom lenses house three sensor resistance elements with wipers to sense the ring positions of focus aperture and zoom The lens electronics board connects to the resistance elements using one connector for Prime lenses and two connectors for Zoom lenses They are supplied with power from the logic board and the wiper signals are fed back to the board for sensing These current settings are interpreted using analog inputs which have 12 bit resolution Some of the earlier S4 amp lenses had only 10 bit resolution 3 2 3 Illumination Ring The 5 amp Prime lens logic boards have an additional 4 way connector which connects to a secondary electronics board via a cable This connector carries 5 volts power plus 2 PWM current sinking signals to control the two sets of LED s and provide scale illumination Lighting control instructions are descri
41. k certain commands should be blocked to prevent corruption of the communication process Table 8 Valid Commands Allowed amp Blocked Recommendations with EDSU Function Retrieve firmware version Set Continuous send ASCII data Retrieve single ASCII data string a Retrieve single ASCII string Set checksum mode ON Unset optional modes Set Change baud rate Set continuous send Binary data Request single Binary data string Set both illumination levels Set single illumination level Retrieve Fixed data block EDSU only command OD EDSU only command OC OH EDSU only command OS T n EDSU only command EDSU only command Copyright 2012 Allowed Kc Kd or Kc Allowed unless EDSU extracts single block and passes through to secondary unit baud rate change Page 49 P Retrieve board temperature V Set Change film size Beware Interlock exists for Camera priority Wnn Change film size Beware Interlock exists for Camera priority Change units to Imperial Beware Change Units to Metric Beware To avoid potential conflicts that may arise if commands are issued by multiple sources the EDSU should monitor any commands allowed to pass through to the lens to verify commands meet lens specifications and do not cause conflict with current EDSU operation If the EDSU is not logging data but only generating OD data then Commands D C Kd Kc can be allowed without conflict In general control of fi
42. l line speed baud Data bits Stop bits Parity H SSH Serial Open the session node click on the serial radio button and then click Open EA PuTTY Configuration Specify the destination you want to connect to Seral line COM1 Connection type Raw Telnet Rogn SSH Serial Load save or delete a stored session Saved Sessions H SSH Serial Copyright 2012 Page 76 Cooke Check to make sure you have specified the COM port to which you are connected Device Manager can help you determine the correct COM port Copyright 2012 Page 77
43. lens will wait without timeout for an N command Baud rate can be adjusted using the Kon command All CORE commands described in Sections 5 1 through 5 1 18 are available for Red lenses 4 7 5 DigiOptical Angenieux Fujinon and Sony Lenses As amp Technology partners DigiOptical Angenieux Fujinon and Sony have agreed to support all CORE amp Technology commands Each manufacturer may also have unique EXTENDED command features which are considered hidden to the general user Depending on the manufacturer some EXTENDED commands may be available by request to technicians who service equipment and amp Technology developers 4 8 CORE Command Response Structure Communication with a lens is initiated by the Camera or External device and a lens replies with the requested information and or to acknowledge the command The only exception to this sequence is at Power Up A lens will automatically transmit a data string to each existing channel to indicate a power up has occurred The lens will then wait to receive an N command The lens must receive the N command as its first command after which all other commands are available to the controlling channel s Each command has a specific lens response A lens will respond with the error response string L F C R to any unrecognized command unless the Inhibit Errors command Ka has been issued Each of the two communication channels on 5 8 lenses function independently 4 8 le
44. lm size and data append functions should come from a single source to avoid conflicts Similarly changes to Baud rate or checksum mode have difficult to follow implication and it may be simpler to block all such commands To block a command the EDSU should respond to the command from the secondary device using the standard error response l f c r The EDSU data string can be made up of any 8 bit values up to 60 values total values which terminate with the c r character These can be any 8 bit values except c r I f Care should be taken if the string includes any other ASCII control characters Hyperterminal PUTTY or other data interpretation programs might recognize them as formatting commands and attempt to implement them 10 Troubleshooting Possible Errors and How to Fix Them 10 1 Loss of Program In the unlikely event that a lens experiences a loss of program the start up prompt will appear as a I f c r or x I f c r If this occurs the lens will need its program to be reloaded Please contact your service provider Copyright 2012 Page 50 CookeOptics 11 NEW Optional Commands Retrieve User Defined Combinations of Binary Data Packets 11 1 NEW Optional Commands Planned for 2013 The New optional commands will allow users to define and then retrieve optional binary data sets composed of user selected lens information combined in any order Each lens data element will have a unique tag
45. mand Response DsssssssTaaaatbbbbbZffffHaaaaaaaNbbbbbb bFcccccccVvvv vEseeezmmmmSxxxxxxxxx L FI C R Actual Aperture setting conventional notation Entrance Pupil Position units Tag s is a or sign 1 FAR FOCUS distance units oe eI Example Issue D c r Response D0000402T0195t1 4 8Z0000H0087250N0000400F0000404V006 8E 039z0000S5 100 009 I f c r The units depend on which Display Units have been selected See commands X and Y Metric units will be in multiplies of 1mm and Imperial units will be in multiples of 0 1 inch The Actual Aperture setting is a multiple of 0 01 typical values range from 1 xx to 22 xx The Actual Aperture setting conventional notation is intended for display purposes and follows the ring marks using FULL STOP n notation to indicate the nearest 1 10 STOP value 5 1 3 Kd Command Retrieve Pre Defined Set of Calculated Binary Data Packets Please see Appendix A 1 for variations in response to Kd command A Response dssssTTttzzhhhhnnnnffffvveeZZSxxxxxx xxx L F C R Copyright 2012 Page 25 CookeOptics da Focus Distance w ee Entrance Pupil Position S t ZZ Normalized Zoom Value This field not included in 4 8 Prime lenses prior to 0 29 4 01 or 0 39 4 21 S followed by Lens Serial Number ASCII format Example Issue Kd c r Response d FRCCZ USR FP FTADAC S5 100 009I I Ff c r Typically 41 characters includi
46. mand Set Continuous Send Mode of Data Packet in Packed Binary Format _ Response dssssTTttzzhhhhnnnnffffvveeZZSxxxxxxxx x L F C R Once Continuous Send Mode is set the lens will continually measure calculate and send values in the Kd command format Example Issue Kc c r Response d O CCZ AFsh 0z P ADAC S5 100 009 I F c r d O CCZ AFsh 0z P ADAC S5 100 009 I f c r d O CCZ AFsh 0z P ADAC S5 100 009 I f c r d O CCZ AFsh 0z P ADA C S5 100 009 I f c r d O CCZ AFsh 0z P ADAC S5 100 009 I f c r d O CCZ AFsh 0z P ADAC S5 100 009 I F c r d O CCZ AFsh 0z P ADA C S5 100 009 I f c r d O CCZ AFsh 0z P ADAC S5 100 009 I F c r Copyright 2012 Page 32 CookeOptics This command sets the retrieved data format to packed binary as described by the Kd command and sends data in continuous mode The data content and format is the same as the Kd command data content and format This mode is unset by using the H command Each data packet is defined under the Kd command above 5 1 11 G Command Set ChecKsum Mode Response L F C R The checksum consists of two characters which are added to the response string between the contents of the message and the termination character pair L F C R The checksum is formed by setting an 8 bit checksum value to all 1 s and then performing and exclusive or operati
47. nction normally To alter the brightness of one set of LEDs move the Aperture ring to the aperture setting T1 4 end stop and move it away towards T22 then repeat that process twice more within 0 5 second This will cause the LED s to be set to OFF for 0 3 sec then ON for 0 3 sec then OFF again The operator can now adjust the desired level by moving the Aperture scale up towards T22 or down towards T 1 4 If there is a half second period during which no change of Aperture setting is detected the set illumination level is retained During this illumination setting process amp lens operations continue to function normally To turn off LEDs move the Aperture ring to the aperture setting T1 4 end stop and move it away towards T22 then repeat that process twice more within 0 5 second This will cause the LED s to be set to OFF for 0 3 secs then ON for 0 3 secs then OFF again The operator can now wait a half second and the off set illumination level is retained During this illumination setting process amp lens operations continue to function normally Copyright 2012 Page 47 OOKeCUDTICS 9 External DATA Source Unit EDSU 5 4 9 1 Overview Cooke 5 amp lenses have additional capabilities and commands not available to the other lens types which enable an external device called an External Data Source Unit or EDSU connected to the external RS232 channel of the lens to perform special
48. ng termination Response Values Defined as Follows Note None of these 8 bit data patterns correspond to any Control character codes Focus Distance ssss Current Focus Distance units 1 mm or 0 1 inch depending on Display Units selected ssss represents packed binary response 24 bits in 4 bytes characters Range 0 to 24 1 16777215 mm or 0 0 to 24 1 1677721 5 inch Infinity bOO b23 1 a binary value of all 1 s represents infinity Aperture Value TT Actual Aperture Setting T Number x 100 Copyright 2012 Page 26 CookeOptics 12 bits in 2 bytes characters Range 144 to 2560 1 44 to 25 60 Aperture Ring T Stop Position tt Aperture Ring T Stop Integer x 10 amp the 1 10 fraction 12 bits in 2 bytes characters Range 1 14 to 220 for Integer x 10 Range 2 0 9 for 1 10 fraction Current Focal Length EFL zz Current Focal Length in mm for Zoom Lenses and O for Prime Lenses 10 bits in 2 bytes characters OO Odd Range 1 0 1023 mm for Zoom Lenses Range 2 bOO b09 O for Prime Lenses Hyperfocal Distance hhhh Hyperfocal Distance 1 mm or 0 1 inch depending on Display Units selected 24 bits in 4 bytes characters Copyright 2012 Page 27 CookeOptics ae Amama 3 a Oe 2 2 a a ei eee a a A Range 0 to 24 1 16777215 mm or 0 0 to 24 1 1677721 5 inch Infinity bOO b23 1 a binary value of all 1 s represent
49. nses send the same response to both channels and can receive commands only from the controlling channel For S4 amp lenses when power is present on the external Copyright 2012 Page 19 CookeOptics interface the external interface will have control Thus the camera interface will have control only when there is no power supplied to the external interface Some commands have been introduced with newer firmware versions and may not be available if their firmware has not yet been upgraded Note also that certain commands pertain only to 5 8 lenses Copyright 2012 Page 20 CookeOptics 4 8 1 Table 3 CORE Command Function Lens Type Table ee px fox xe x Retrieve one set of ASCII Calculated Data CX x SS eae et __K3_ Retrievename oftens Manufacturer X x KA Retrievename oftenstype i o XT H Rete borers ___ _x Jak X x x Retrieve board Firmware Version Set Baud Rate to n where n 1 7 See Chart default 115k2 or 9 6k Set Continuous Send mode amp begin transmission of ASCII Calculated Data x X X X Xx x Xx Set Continuous Send mode amp begin transmission of Packed Binary Calculated Data Set Film Size to 35mm default value Set Film Size to 16mm Set Film Size to nn where nn 00 09 refers to specified film size circle of confusion See chart Stop Continuous Send clear Checksum clear Inhibit Error Response mode 5 amp ILLUMINATION COMMANDS Set Sc
50. nstallation of Software Windows XP VISTA 7 e Download JRE 6 here and install if it is not already installed e Double click the Owner Update installer Cooke Ownerupdate_Win_setup_V3 00 msi follow the instruction and complete installation Mac OS X 10 5 10 6 e Setup Serial Port Run SerialPort_Config first so that the application can access the serial port Only need to run Seria Port_Config ONCE if you have both programs Cooke Viewer_J and Cooke Owner Update on the machine Your account needs to be Administrator to run it After successful configuration your user ID should be displayed after GroupMembership and Process completed appears on the Terminal e No Owner Update for MAC program installation needed Just download and place it at the Desktop or any directory Hardware Setup e Connect the lens to a PC or MAC through the serial port cable and power it on Run Cooke Owner Update e Make sure the lens is powered on before running the program e For Windows Run Cooke Owner Update from Desktop or from Start gt Programs gt e For MAC OS X Double click Cooke Owner Update the screen as shown in Figure1 appears It lists all of the available serial ports on the machine Select one which the lens is connected to Copyright 2012 Page 67 CookeOptics OO Cooke iConnection Cooke i Connection Select a Serial Port for Lens Select a Serial Port for Lens dev tty usbserial CON Cooke 4
51. on between the existing checksum value and each character of the response string in turn until all the characters are processed The resulting 8 bit checksum is then converted into two separate characters as follows Example Issue G c r Response MN I f c r Responses of N and B commands when Checksum mode is on Issue N c r Response NS5 100 0090Cooke Optics Electronic Lenses LPFIOON100UBt92 B5 03LJ I f c r Issue B c r Response B5 03HE I f c r 5 1 12 Ka Command Set Inhibit Error Response Mode Response L F C R L F C R es O nn ke O 5 n pe Cc 5 N 5 O 5 Once the Error Response Mode is set the lens will simply ignore any bad or invalid message it receives rather than send the L F C R response to a command it does not recognize Copyright 2012 Page 33 CookeOptics Note The response unknown L F C R will be issued by some early lens S4 amp and RED versions prior to 0 22 0 35 1 23 1 31 and 3 03 which did not implement this command Example Issue Kb9 c r before Ka sent Response L F C R Issue Ka l f Response I f c r Issue Kb9 c r after Ka sent Response no response sent 5 1 13 X Command Set Display Units to Imperial Response X L F C R Note This command will change the display units on both channels for S4 amp lenses but will change only the display units for the channel which issued the command for 5 8 lenses Se
52. or c rI f ERROR c r I f ATZ c r AT BTNAME string c r AT BTSCAN c r c r I f OK c r I f followed by c r f CONNECTED c r I f A 3 Checksum Mode G command Copyright 2012 Page 57 CookeOptics Use the G command to turn on the checksum mode In checksum mode two characters are added to the response string between the message string and the termination sequence I f c r The checksum is formed by setting an 8 bit checksum value to all 1 s and then performing an exclusive or operation XOR between the existing checksum value and each character of the response string in turn until all the characters are processed The resulting 8 bit checksum is then converted into two separate characters as shown below Checksum value c7 c6 c5 c4 c3 c2 c1 c0 First checksum character to be transmitted O10 O c7c6c5 c4 Second checksum character to be transmitted O 1 O O c3c2c1co These two characters are appended to the response string followed by the termination sequence Use the H command to turn the checksum mode off Copyright 2012 Page 58 Cooke Appendix B B 1 Firmware and Lens SoftwareVersion Numbers Lens Type Base Firmware Software Version Number Version Red 18 50mm Zoom 12 bit ADC S4 amp Zoom 12 bit ADC 7 Red 50 150mm Zoom 12 bit ADC 3 02 3 09 6 00 6 19 5 amp Prime 12 bit ADC DigiOptical 18 50mm Zoom 12 bit ADC 3 02 3 09 6 00 6 19 Panchro amp Prime 12 bit ADC
53. orted by all lenses cameras or Technology partners Users should rely on the CORE command set EXTENDED command sets may include unique brand specific commands used for tasks such as calibration software updates or communication between brand specific equipment EXTENDED commands should be considered hidden commands not used by a typical operator A list of some EXTENDED commands is available by request to technicians who service equipment and amp Technology developers Copyright 2012 Page 7 CookeOpticsLimited Technology CORE Commands and EXTENDED Commands Figure 1 2 2 amp Technology Partners Digital cameras that are amp equipped RED SI 2K Sony F35 F3 F65 and film cameras Aaton Penelope Arricams talk to amp lenses directly via contacts in their lens mounts Transvideo monitors have built in amp Technology that can display lens data in real time along with a graphic representation of the iris focus and depth of field Metadata is passed through to post production to improve VFX creation and DI calibration Post production artists can sync the lens data to the 3D camera data to produce a more natural looking 3D model of the shot significantly faster than using traditional manual processes and guesswork A list of current amp Technology partners can be found in Appendix B 2 Copyright 2012 Page 8 CookeOptics 2 3 Table 1 Lens Types with amp Technology Cooke Optics Lenses aj Panchro amp Pr
54. ot found on any other lenses The LED s are driven using Pulse Width Modulation to vary the intensity Intensity settings can be controlled either by using the Aperture ring or a separate Lighting Control Unit Section 8 1 describes different methods for controlling the scale illumination Section 5 2 defines commands specific to 5 amp s illumination feature Under normal operation a 5 8 lens will receive commands to generate and then send the requested data string to the camera interface the external interface or both Copyright 2012 Page 18 CookeOptics This data can be stored by the camera or external equipment for recording and subsequent post processing A set of additional functions are available to 5 amp lenses which allow them to receive an externally generated data string and then append this received data to the normally generated data stream of the lens before it is sent to the camera A unit which sends data to a 5 amp lens through its external interface is called an External Data Source Unit or EDSU Operation with an EDSU is described in Section 9 Section 5 4 defines the commands associated with the EDSU functionality 4 7 4 Red 18 50mm and 50 150mm Zoom Lenses Red lenses have a single channel interface for direct communication with a camera The start up baud rate will be 115k2 if an N command is received within one second If no N command is received within one second the speed will drop to 9600 baud and the
55. port adapter and install the correct driver A Java Runtime Environment JRE is required to run the program If it is not already installed on your computer it can be downloaded for free from www java com See Appendix C 2 for additional details on how to use the Viewer Software Copyright 2012 Page 15 CookeOptics 4 4 Update Ownership Program for Cooke amp Lenses The Cooke Owner Update program can be used to change the owner name stored in the lens through its external interface The program runs on Windows and MAC OS X platforms and can be downloaded from the Cooke Optics website at http www cookeoptics com cooke nsf technical downloads html The lens is connected to the PC or MAC through a serial port If the computer does not have a serial port use a USB Serial port adapter and install the correct driver A Java Runtime Environment JRE is required to run the program If it is not already installed on your computer it can be downloaded for free from www java com See Appendix C 1 for additional details on how to use the Ownership Update Software 4 5 Hyper Terminal PuTTY Serial Terminal Emulators for COM Ports HyperTerminal or PuTTY can be used to communicate with a lens by connecting the external connector of the lens to a serial port on a PC HyperTerminal is an application that allows terminal emulation in Windows for certain types of devices HyperTerminal communicates over serial connections like RS 232
56. rd winning Milo Cyclops Talos Modula and Ulti head The Pixel Farm The Pixel Farm s PF Track software fully supports the amp system syncing lens data with the picture to allow for better tracking Not only does the amp supply real lens data eliminating the software s need to have to solve for lens data but the final picture is obtained faster and more accurately which means better quality and less cost Preston Cinema Systems The Fl Z Three Channel Wireless System for lens and camera control uses amp Technology to show lens focus data on the display of the FI Z Hand Unit 3 HU3 The lens is Copyright 2012 Page 63 CookeOptics connected to the motor driver unit MDR2 through an adapter cable Preston Cinema accessory item The MDR2 sends lens data over its microwave link to the HU3 Having accurate focus information transmitted directly from the lens at all times is a great confidence builder for the focus puller Preston Cinema Systems FI Z Hand Unit 3 RED RED has built in amp support utilizing contacts in the RED camera lens mount for direct metadata capture Service Vision Scorpio 3 axis motion control heads incorporate amp technology Silicon Imaging The SI 2K camera will have built in amp support utilizing contacts in the camera lens mount for direct data capture Sony Sony has built in amp support utilizing contacts in their Sony F35 9OOOPL F3 and F65 camera lens mount for direct m
57. rds lens settings and performs a series of calculations to provide continuous remote readout of focal length focusing distance aperture zoom depth of field hyperfocal distance horizontal field of view entrance pupil position normalized zoom and frame rate in both metric and imperial units The information is digitally recorded for every frame and stored as metadata accessible via cable connector near the lens mount and or contacts in the PL mount that sync with amp compatible cameras and other equipment 2 1 amp Technology Open Protocol The goal behind amp Technology is to provide an open standard that will streamline and enhance the process of filmmaking by making equipment digitally compatible from production through post Any product that displays the amp logo from acquisition through post is compatible with all other amp Technology embedded products This means an amp lens from Cooke can be used with any other products that conform to the amp Technology standards Within the amp Technology Communication protocol standard there are two types of commands as shown in figure 1 CORE commands and EXTENDED commands CORE commands are used to communicate between different brands of equipment and are supported by ALL amp Technology partners The amp Technology protocol platform also allows for brand specific commands known as EXTENDED commands EXTENDED commands are considered brand specific and are not supp
58. right 2012 Page 71 CookeOptics If any error messages turn up please check the followings e Accessibility to the Serial Port on MAC e Updated Driver of USB Serial Port Adaptor e Lens correctly connected to the selected serial port and powered on e Any program running which is using the same serial port such as HyperTerminal e Close the program power off the lens and start it again if not able to find reasons Copyright 2012 Page 72 CookeOptics C 3 Using HyperTerminal or PuTTY to Communicate with Cooke amp Lenses The HyperTerminal or Putty programs can be used to view the information of a lens through its external interface Launch HyperTerminal by running the hypertrm exe file From Windows XP it can be found under Programs gt Accessories gt Communications gt HyperTerminal If there is no HyperTerminal preinstalled on your PC it can be downloaded from the Internet or retrieved from a Windows XP computer Note Windows 7 and Vista no longer provide HyperTerminal but it can easily be installed The two files you need are hypertrm dll and hypertrm exe They are typically found from the Windows XP installation c Program Files Windows NT Hypertrm exe c Windows System32 hypertrm dll Copy these files into the same directory on the target Windows PC and launch HyperTerminal by running the hypertrm exe file Select the serial port to which the lens is connected and specify the connection settings speed 9600 data
59. s Hyperfocal Distance Near Focus Distance Far Focus Distance Horizontal Field of View Entrance Pupil Position Normalized Zoom Value see 10 bit and 12 bit ADC versions below for format This field not included in these early versions of S4 amp Prime lenses Lens Serial Number ASCII format Response Values d sss TT tt zz hhhh nnnn ffff vv ee are the same as those described in Section 5 1 3 Copyright 2012 Page 56 CookeOptics Normalized Zoom Value ZZ Note Response depends on Lens Version ZZ Normalized Zoom Value 0 000 to 1 000 for S4 amp Zoom and RED versions after 1 21 1 30 and 3 02 10 bits in 2 bytes characters a a a a A Range 0 1000 for Zoom Lenses This field not included in these early versions of S4 amp Prime lenses Normalized Zoom Value Z Note Response depends on Lens Version Z Normalized Zoom Value 0 00 to 1 00 for S4 amp Zoom and RED versions up to and including 1 21 1 30 and 3 02 7 bits in 1 byte character ee A A a a A Range 0 100 for Zoom Lenses This field not included in these early versions of S4 amp Prime lenses A 2 Bluetooth Communication Exchange The series of command and responses to establish a Bluetooth communication exchange as described in Section 4 2 2 Note The string sent is the lens Serial Number BOARD SENDS BLUETOOTH SENDS lt C r I f OK c r I f or c r I f ERROR c r I f AT c r c r I f OK c r f
60. s expressed in millimeters Every Cooke amp lens stores a unique set of calibration tables individually determined by a special calibration process and preloaded into the lens before it leaves the Cooke factory The calibration tables provide reference values that correspond to the focus aperture and zoom if applicable ring Some lenses are calibrated in both imperial and metric units while others are calibrated only in metric or only in imperial units The N command response string provides information to indicate which calibration table s is stored in the lens and which units are defaults for display purposes See Section 5 1 Users can request metric units by issuing Command Y or imperial units by issuing Command X regardless of how the lens was calibrated Note that the two channels on 5 amp lenses function independently while the two channels on S4 8 lenses are not independent These commands will change the display units on both channels for 4 8 lenses but will change only the display units for the channel which issued the command for 5 amp lenses 6 2 Start Up Units How to Interpret the Value after Tag U in the N Command Response 6 2 1 Cooke Panchro amp Cooke 4 amp Prime and Zoom RED Zoom Lens Units If the value after Tag U in the N command response is an Il the calibration table stores focus distances in imperial units only If the value after Tab U is an M the calibration table stores focus
61. s infinity Near Focus Distance nnnn Near Focus Distance 1 mm or 0 1 inch depending on Display Units selected 24 bits in 4 bytes characters Range 0 to 24 1 16777215 mm or 0 0 to 24 1 1677721 5 inch Infinity bOO b23 1 a binary value of all 1 s represents infinity Far Focus Distance ffff Far Focus Distance 1 mm or 0 1 inch depending on Display Units selected 24 bits in 4 bytes characters Range 0 to 24 1 16777215 mm or 0 0 to 24 1 1677721 5 inch Infinity bOO b23 1 a binary value of all 1 s represents infinity Horizontal Field of View vv Horizontal Field of View in Degrees x 0 1 Copyright 2012 Page 28 CookeOptics 11 bits in 2 bytes characters Range Oto 1800 0 0 to 180 0 Entrance Pupil Position ee Entrance Pupil Position signed 10 bit value s 0 for positive s 1 for negative Range O to 1023 signed Normalized Zoom Value Note Response depends on Lens Version ZZ Normalized Zoom Value 0 000 to 1 000 for S4 8 amp Zoom and RED versions after 1 21 1 30 and 3 02 and all Panchro amp and 5 amp versions See Appendix A 1 for variations in response to Kd command 10 bits in 2 bytes characters a A A a A a A A Range 0 1000 for Zoom Lenses b00 b09 O for Prime Lenses 5 1 4 K3 Command NEW 12 bit ADC versions only Retrieve Name of Lens Manufacturer in ASCII Format Note Lens will respond with
62. t the EDSU is sending data to the lens it can also request that the lens send the normal data stream back to it The commands and instructions for using this facility are described in Section 9 4 7 amp Lens Types CORE Commands and EXTENDED Commands Within the amp Technology Communication protocol standards there are two types of commands CORE commands and EXTENDED commands CORE commands are used to communicate between different brands of equipment and are supported by all Technology partners Any equipment from a manufacturer who adopts the 8 Technology protocols and agrees to implement all amp CORE commands can communicate directly with any amp lens An amp lens accepts specific commands that control the data output including a continuous mode that can send a constantly updated data stream at up to 285 frames per second This data can be eembedded as metadata For cameras with amp capability the data can be stored as metadata with the picture The amp Technology open protocol platform also allows for brand specific commands known as EXTENDED commands EXTENDED commands are considered brand specific and are not supported by all lenses cameras or amp Technology partners Users should rely on the CORE command set When each lens is built a careful process is undertaken to ensure each individual sensor is calibrated so that the resistance elements map correctly to their respective optical ring markings This in
63. th programs Cooke_Viewer and Cooke OwnerUpdate on the machine Your account needs to be Administrator to run it After successful configuration your user ID should be displayed after GroupMembership and Process completed appears on the Terminal e No Cooke Viewer for MAC program installation needed Just download and place it at the Desktop or any directory Hardware Setup e Connect the lens to a PC or MAC through the serial port cable and power it on Run Cooke Viewer e Make sure the lens is powered on before running the program e For Windows Run Cooke Viewer from the Desktop or from Start gt Programs gt e For MAC OS Double click Cooke Viewer the screen as shown in Figure1 appears It lists all of the available serial ports on the machine Select one which the lens is connected to e Click the Connect button the second screen as shown in Figure2 appears Copyright 2012 Page 70 Cooke OO Cooke iConnection l LooKe 1 Connection Select a Serial Port for Lens Select a Serial Port for Lens dev tty usbserial Y COMS l Connect 4 Viewer Version 3 00 Connect fi Viewer Version 3 00 Figure 1 Select Serial Port on MAC and on Windows an View the connected lens Lens Information Owner Cooke Optics Serial Number Lens Type 5 i Focal Length 100mm Calibration B Firmware Version 5 03 Base Firmware b e Click x or Quit button to end the program Figure 2 View the lens information Copy
64. the Unknown Response string L F C R if this command has not been implemented in firmware version Copyright 2012 Page 29 CookeOptics Response K3 XXXXXXXXXXXXXXX L F C R Response Unknown PL FIIC RI aaa Name of Manufacturer 15 character response string Example Issue K3 c r Response K3Cooke Optics Ld I f c r 5 1 5 K4 Command NEW 12 bit ADC versions only Retrieve Name of Lens Type in ASCII Format Note Lens will respond with the Unknown Response string L F C R if this command has not been implemented in firmware version ia Response K4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX L F C R Response Unknown AICR aaa es O n OD O 5 nn m an N 3 O 5 Tag Value Definition XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Name of Lens Type 30 character response string Example Issue K4 c r Response K45iT1 4 Prime 100mm I f c r 5 1 6 P Command Retrieve Lens Temperature in ASCII Format Response P x x L F C R L F C R es O nn O O 5 nn pe 3 N 5 O 5 P abcd Current Temperature in degrees Celsius Copyright 2012 Page 30 CookeOptics Example Issue P c r Response P24 I f c r Note The temperature reading process takes approximately 0 5 seconds During this time period all other processes are suspended 5 1 7 B Command Retrieve Version Number in ASCII Format B C R Response B abcd L F C R B
65. ud and the standard power on prompt lt I f c r is sent If no N command is received within one second the data rate is dropped to 9600 baud and a modified power up string in sent lt This is a unique Bluetooth feature built into the S4 amp lens series only The modified power up string doubles as both a Bluetooth initialization prompt anda standard start up prompt Additional details on establishing a Bluetooth connection are described in Appendix A 2 Baud rate can be adjusted using the Kon command All CORE commands described in Sections 5 1 through 5 1 18 are available for S4 8 lenses 4 7 3 5 amp Prime Lenses T1 4 All 5 amp lenses have two communications channels which can receive commands and send responses independently These channels can operate at different baud rates up to 230 4K Start up baud rate is at 115k2 on both channels if an N command is received within one second from either channel If no N command is received within one second speed is dropped to 9600 baud on both channels and the lens will wait without timeout for an N command from either channel There are two unique commands OX OY associated with 5 8 s dual marked focus ring These allow the user to change the Start Up units to imperial or metric and are described in Section 5 3 See Section 6 2 2 for a more detailed description of the dual marked focus ring 5 amp lenses are equipped with a scale illumination feature n
66. urther Bluetooth operation and enter normal startup mode Copyright 2012 Page 22 CookeOptics If a valid Bluetooth connection is established the baud rate will remain at 9600 and the lens will wait for the N command The Baud rate must remain at 9600 once a Bluetooth link is established so any command to change baud rate at this point will receive the error response In the event a Bluetooth connection is not established correctly within one second the lens will issue a standard startup string lt and wait until an N command is received from the external interface The series of command and responses to establish a Bluetooth communication exchange is outlined in Appendix A 2 4 9 3 Table 5 Basic Lens Response Types Basic Lens Response WhatitMeans lt f c r Standard Power On lt f c r Look for Bluetooth Initialization f c r 5 amp only Channel temporarily locked out u W fcir or x fc r Inhibit Error Command has been issued Tag I f c r Echo command that was sent followed by the requested data 1 f c r Acknowledge the command was received and implemented Copyright 2012 Page 23 CookeOptics 5 CORE Command Set 5 1 CORE Commands for All Lens Types Commands to a lens are in ASCII format and terminate with a carriage return character Responses from a lens are in either ASCII format or packed binary format and terminate with the character pair linefeed carriage return I f c r
67. y Data Packets Response for lens versions BEFORE 0 21 0 34 22 and 1 31 Response dssssTTttzzhhhhnnnnffffvveeZZ L F C R Response Values Tag vv Horizontal Field of View o Horizontal Field of View Oo eo o Entrance Pupil Position ZorZZ Normalized Zoom Value see version s below for format This field not included in these early versions of S4 amp Prime lenses Response Values d sss TT tt zz hhhh nnnn ffff vv ee are the same as those described in Section 5 1 3 Normalized Zoom Value ZZ Note Response depends on Lens Version ZZ Normalized Zoom Value 0 000 to 1 000 for S4 amp Zoom and RED versions after 1 21 1 30 and 3 02 10 bits in 2 bytes characters b08 b07 Z pe tert ete a a a ee Copyright 2012 Page 55 Range O0 1000 for Zoom Lenses This field not included in these early versions of S4 amp Prime lenses Normalized Zoom Value Z Note Response depends on Lens Version Z Normalized Zoom Value 0 00 to 1 00 for S4 amp Zoom and RED versions up to and including 1 21 1 30 and 3 02 7 bits in 1 byte character ee a A 1 b04 b03 b02 b01 Bit5 ae eee Range 0 100 for Zoom Lenses This field not included in these early versions of S4 amp Prime lenses Response for lens versions AFTER 0 21 0 34 22 and 1 31 Kd C R Response dssssTTttzzhhhhnnnnffffvveeZ Zxxxxxxxxx L F C R TT ZZ Zoom EFL mm 0000 for Prime lense

User's Guide & Technical Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

User's Guide &amp; Technical Manual

Contents

Download Pdf Manuals

Related Search

Related Contents

User's Guide & Technical Manual