Package: pytla
pytlapytlathe Python (Integrable) Tunable Laser Assembly library!This is meant to be an open source and relatively user friendly way to interact
with Integrable Tubable Laser Assembly lasers.
The pytla package provides a base classITLAthat can be extended for specific
manufacturer requirements with another yaml register file to specify the new registers.Current Specs FollowedOIF-ITLA-MSA-01.3.This communication scheme supports microITLA 1.1 devices as well.OIF-ITLA-MSA-01.2.Some older devices still adhere to the 1.2 standard. These can be accessed
by settingversion='1.2parameter on ITLA object initialization. Example below.If you are receiving unexpected execution errors on register functions like_fcf3it is likely you need to useversion='1.2'.StatusThis is very much a work in progress. Use at your own risk. I would call this
pre-alpha but most functionality exists and we use it at SpectrumLab.Hidden functions for each register (names the same as each register but in lowercase)
are available. Some registers still don't have user friendly functions defined
for them.It would be nice if we could include documentation for the
hidden register functions for each class in the pytla docs.Examplesdefault use (with MSA-01.3 lasers)# import, initialize, and connect to laserimportitlaimporttimefromitla.itla_errorsimportCPExcpetionlaser=itla.ITLA('/dev/ttyUSB0',9600)laser.connect()# Set the frequency to 193.560 THzlaser.set_frequency(193.560)# Set the power to 10 dBmlaser.set_power(10)# enable the laser# enabling takes some time so a CPExcpetion will be thrown# It is necessary to catch this explicitly so the user# doesnt continue on without explicitly handling this time delay# (at least until we implement checking the pending bit in nop)try:laser.enable()exceptCPException:time.sleep(30)More info about features available currently can be found inpytla docs.version selectionYou can also select the 1.2 spec if your laser does not yet support 1.3.
This is as simple as settingversionin initialization of yourITLAobject.# import, initialize, and connect to laserimportitlaimporttimefromitla.itla_errorsimportCPExcpetionlaser=itla.ITLA('/dev/ttyUSB0',9600,version='1.2')laser.connect()# Set the frequency to 193.560 THzlaser.set_frequency(193.560)# Set the power to 10 dBmlaser.set_power(10)# enable the laser# enable the laser# enabling takes some time so a CPExcpetion will be thrown# It is necessary to catch this explicitly so the user# doesnt continue on without explicitly handling this time delay# (at least until we implement checking the pending bit in nop)try:laser.enable()exceptCPException:time.sleep(30)Currently supported options under versionversion='1.3'(OIF-ITLA-MSA-01.3)version='1.2'(OIF-ITLA-MSA-01.2)Pure PhotonicsWe have also implemented a class for PurePhotonics lasers as an example of how
easy it can be for manufacturers to extend this library to control their own
ITLA based lasers.# import, initialize, and connect to laserimportitlaimporttimefromitla.itla_errorsimportCPExcpetionpplaser=itla.PPLaser('/dev/ttyUSB0')pplaser.connect()# Set the frequency to 193.560 THzlaser.set_frequency(193.560)# Set the power to 10 dBmlaser.set_power(10)# enable the laser# enable the laser# enabling takes some time so a CPExcpetion will be thrown# It is necessary to catch this explicitly so the user# doesnt continue on without explicitly handling this time delay# (at least until we implement checking the pending bit in nop)try:laser.enable()exceptCPException:time.sleep(30)laser.whispermode()ParadigmThe basic paradigm we have used for implementing this library is one in which
functions are created for all registers based on a yaml file specifying and
describing each register. These are all implemented as hidden functions with a
single underscore.For simplicity all ITLA register functions are named as follows: assuming
we have some register namedREGISTERin the ITLA documentation the
corresponding function would be_register().For ManufacturersIf you would like to have a specific class available for your particular type of
laser please create a yaml file as specified below and submit it for inclusion.
Please also provide any details for the order of operations required to enable
or activate your features.This library was designed to be simple to extend for implementing manufacturer
specific registers and functions. The first step is to create a yaml file
containing all of the additional registers your laser will utilize. Each entry
should have the following format.RegisterName:register:0x00fnname:registernamedescription:>Here we provide a description of this particular register for documentationpurposes. It is best to format this the same way you would a docstring as itwill be read as a docstring.readonly:[true/false]AEA:[true/false]signed:[true/false]MYREGISTER:register:0xFEfnname:myregisterdescription:>This is my very own register. I can write a signed integer to it or read it back.readonly:trueAEA:falsesigned:trueYou can name your register whatever you'd like and name the function for
accessing it to whatever you'd like as long as it is acceptable for python.
Generally a best practice is to make the register function name all lowercase
and change dashes to underscores. The register value must be numeric. It can be
base 10 but best practice is hex values.Assuming you have installed the pytla package and your yaml register
file is in the same folder as the file with theMyLaserclass you can create a
class with hidden functions for your registers implemented in addition to
the basic ITLA1.3 registers and wrapper functions.Realistically, unless you are OIF and you are defining a 1.4 or 2.0 spec,
you should not need to write a class that depends directly onITLABase.
Instead, you are likely adding functionality to the 1.3 (or older) standard.fromitla.itla13importITLA13classMyLaser(ITLA13):def__init__(self,port,baudrate=9600):register_files=['myregisters.yaml']super().__init__(port,baudrate=baudrate,register_files=register_files)defmyfunction(self,data=None):'''This function either writes an integer to register 0xFE or reads aninteger from 0xFE'''ifdataisnotNone:response=self._myregister()eliftype(data)isint:response=self._myregister(data)elseraiseTypeError("Must be an int!")returnint.from_bytes(response,'big',signed=True)AcknowlegementsThis work was done as a part of projects forMontana State UniversitySpectrum Lab