# OSP libraries

The Arduino OSP libraries from ams-OSRAM, _aolibs_ for short,
implement support for chips that use the Open System Protocol,
like the AS1163 ("SAID") or the OSIRE E3731i ("RGBi"). 

There are two ways to obtain the _aolibs_, either using GitHub
or using the Arduino IDE. The latter is the easier way.


## GitHub

The _aolibs_ are published on the GitHub page of 
[ams OSRAM](https://github.com/ams-OSRAM).
They consist of _several_ Arduino libraries, each with 
their own repository on GitHub; here is the complete
[list](https://github.com/orgs/ams-OSRAM/repositories?q=OSP_ao).

There is one overarching repository 
[aotop](https://github.com/ams-OSRAM/OSP_aotop).
It is the landing page of _aolibs_, containing global 
documentation (like a "getting started") and it has links 
to all other repositories.

On each repository page, click the green button `<> Code ▼` 
and select `Download ZIP` (or clone).


## Arduino

An easier way to download all _aolibs_ is to use the Arduino IDE. 
In the side-bar on the left select the LIBRARY MANAGER (or use menu
Tools > Manage Libraries ...) and enter `OSP_ao` as search string.

All _aolibs_ will be listed. By pressing `INSTALL` for
`OSP ToplevelSketches aotop` all _aolibs_ will downloaded and 
installed because they are in the dependency list of `aotop`.
They will be downloaded in `C:\Users\john\Documents\Arduino\libraries\OSP_aoxxx`
(assuming user `john` did the install).

(end)
