Mirror of EspoTek/Labrador@github.com - Drivers and firmware for the Labrador board
Go to file
chrises 5f7c56d222 old travis.yml??? 2021-10-28 15:24:27 +11:00
AVR_Code FIrmware version 0006: Fixes issue with logic analyzer channels being 2.6us out of sync 2018-11-06 09:14:13 +11:00
Desktop_Interface Fixed on mac??? 2021-10-28 14:08:56 +11:00
Librador_API Librador demo builds and runs on mac - untested (no hardware ATM) 2019-01-30 18:58:02 +11:00
PCB Update PCB readme to give credit to Ele4nor 2018-11-25 11:10:21 +11:00
SlidingDFT@13e0121253 Vincenzo's FFT patch 2021-10-18 16:00:24 +11:00
.appveyor.yml Update .appveyor.yml 2021-10-18 19:23:38 +11:00
.clang-format Add .clang-format file (#83) 2019-05-29 10:12:22 +10:00
.gitignore Librador no longer links against Qt5. Octave is happy about that. 2018-05-01 14:59:43 +10:00
.gitmodules Vincenzo's FFT patch 2021-10-18 16:00:24 +11:00
.travis.yml old travis.yml??? 2021-10-28 15:24:27 +11:00
README.md Update README.md 2021-08-18 15:17:38 +10:00
labrador_bootstrap_pi Update labrador_bootstrap_pi 2019-09-08 15:43:28 +10:00
pinout.svg Added demo skeleton for librador 2018-03-28 14:23:34 +11:00
test.txt Vincenzo's FFT patch 2021-10-18 16:00:24 +11:00

README.md

What is it?

The EspoTek Labrador is an open-source board that turns your PC, Raspberry Pi or Android Smartphone and into a full-featured electronics lab bench, complete with oscilloscope, signal generator and more.

This repo hosts all of the software and hardware that makes Labrador possible.

Tutorial

If you're new to Labrador or oscilloscopes in general, I strongly recommend checking out the fantastic tutorial series produced by Lief Koepsel:
https://www.wellys.com/posts/courses_electronics/
It features well-written, rich articles as well as video content that explains everything more clearly than I ever could!

Getting Started

To download binary (executable) versions of the software, go to:
https://github.com/espotek/labrador/releases

For the documentation, please visit:
https://github.com/espotek/labrador/wiki

Raspberry Pi Build

Please note that the Raspbian version 9 (Stretch) or later is required to install this software.

To install Labrador on the Raspberry Pi, open a terminal and paste the following command:
wget -O /tmp/labrador_bootstrap_pi https://raw.githubusercontent.com/EspoTek/Labrador/master/labrador_bootstrap_pi && sudo chmod +x /tmp/labrador_bootstrap_pi && sudo /tmp/labrador_bootstrap_pi

This will automatically download, compile and install the latest version of the Labrador software from source. The whole process will take around 20-30 minutes, so don't forget to pack a snack!
After running it, a desktop entry will appear for the Labrador software (under Education), and running the labrador command from the terminal will launch the software interface.

Additional Extras

There are community contributed 3D printable cases available at Thingiverse, courtesy of SpaceBex and Bostwickenator:

Building from Source

If you're looking to build from source but don't know where to start, Qt Creator is the easiest way to get your toes wet!
https://www.qt.io/download-open-source/
When installing, make sure you tick the box to install Qt 5.15 or later.

Once it's installed, open Desktop_Interface/Labrador.pro, then Clean All -> Run qmake -> Build All.

If you're on Linux (including Raspberry Pi), then you can also build the software from source by cloning the repo, cd'ing to the Desktop_Interface directory then running:

qmake
make
sudo make install

Then, to launch, just type labrador into the terminal.

To build the AVR software, I use Atmel Studio 7. Just load up the .atsln and push F7. You can use avr-gcc if you don't want to install a full IDE.

The PCB files can be edited in KiCAD 5.0 or later.

Licence

All Dekstop software files are licenced under GNU GPL v3. https://www.gnu.org/licenses/gpl.html

All Microcontroller software files, with the exception of those provided by Atmel, are licenced under the 3-Clause BSD License. https://opensource.org/licenses/BSD-3-Clause

All hardware files (schematics, PCB) are licenced under Creative Commons 4.0 (CC BY-NC-SA). https://creativecommons.org/licenses/by-nc-sa/4.0/

Collaboration

If you want to submit a Pull Request, bug report or feature request please feel free to do so here at GitHub.
If you just want to say hello and remind me that people are actually using my product (or if you just don't want to make a GitHub account), please email admin@espotek.com

Thanks to all.
~Chris