This project is part of QOSST.
qosst-hal is the Hardware Abstract Layer. Its goal is to provide a unified interface for the hardware and for the higher classes in order for QOSST to be hardware-agnostic. In particular it includes abstraction layer for
- Analog-to-Digital Converters (ADC);
- Amperemeters;
- Digital-to-Analog Converters (DAC);
- DAC and ADC simultaneous;
- Lasers;
- Modulation Bias Controllers;
- Polarisation Controllers;
- Powermeters;
- Power supplies;
- Switches (optical switches);
- Variable Optical Attenuators (VOA);
- Voltmeters.
The module can be installed with the following command:
pip install qosst-halIt is also possible to install it directly from the github repository:
pip install git+https://github.com/qosst/qosst-halIt also possible to clone the repository before and install it with pip or poetry
git clone https://github.com/qosst/qosst-hal
cd qosst-alice
poetry install
pip install .The whole documentation can be found at https://qosst-hal.readthedocs.io/en/latest/
qosst-hal is not supposed to be used as a standalone package, but should be used to code your own hardware classes. There is a tutorial in the documentation on how to code your own hardware, but the basic idea is to subclass the basic hardware class and implement the abstract method of the abstract class. Here is an example on how to do with a VOA class for instance:
from qosst_hal.voa import GenericVOA
class MyVOA(GenericVOA):
# According to the documentation, the VOA class should implement
# open, set_value and close
location: str
inst: Whatever
def __init__(self, location:str):
self.location = location
def open(self) -> None:
self.inst = Whatever(self.location)
def set_value(self, value:float) -> None:
self.write(value)
def close(self) -> None:
self.inst.close()The list of methods that should be implemented for each abstract class can be found in the code, or in the documentation.
Important: no actual implementations are released with QOSST.
As for all submodules of QOSST, qosst-hal is shipped under the Gnu General Public License v3.
Contribution are more than welcomed, either by reporting issues or proposing merge requests. Please check the contributing section of the QOSST project fore more information.