Sources
This Document has been moved over to Google Drive
If you are here to learn about one of our specific sources, the below links describe them in detail.
How to Create a Source
If you look at the core library section, the Sender
class that is provided by omnibus. It is the back bone of any source. The core library section describes it well enough, so I shall just point you there.
Specific Sources
Ni
Omnibus was originally created to work with the Data Acquisition (DAQ) system. The Ni source is the one that is designed to work with it. The heart of the DAQ briefcase is the National Instruments (Ni) box. This is what converts the values received from the electronic sensors to digital values. The python library used to interface with this box can be found here.
https://nidaqmx-python.readthedocs.io/en/latest/
In order to run this source, you will need to download this software onto your computer.
https://www.ni.com/en-ca/support/downloads/drivers/download.ni-daqmx.html#460239
It is worth noting that for windows this is straight forward, however, we do not know how to install this on either Mac or Linux, but we will soon.
Specific instructions on using DAQ with omnibus can be found in the electrical documentation.
Fake Ni
This library is meant to mimic Ni, for the sake of testing
Parsley
Most of our electronics make use of a communication protocol known as CAN. This protocol is based around sending messages, known as “CAN Messages”. In order to test our boards, we created one called USB Debug, which receives can messages and relays them to a computer to be read out. This source is designed to receive those messages and parse them into python data objects, which may be sent over the omnibus.
[Note to self, write a better description of how parsley works]
[Note to self, write a full parsley guide]
[Note to self, remove parsley from omnibus]