Donated space for related uLab project
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Timothy Pearson c40a208abb Explicitly call out the "C" and higher variants of the TDS7x4 scopes, as an updated programming manual was issued for them (distinct from the "A" variants) 8 months ago
attic/servers Update API to TDE R14 6 years ago
clients/tde Add preliminary data export support to oscilloscope part 9 months ago
database/mysql Properly handle recoverable MySQL connection interruptions 5 years ago
documentation/developers Add initial README file and initial dependency charts 7 years ago
fpga Add a several cycle "dead zone" to 7-segment decoder segment select lines to more accurately emulate real hardware 11 months ago
lib Build debug symbols for libtdekrb and libtqtrla on Debian systems 11 months ago
servers Explicitly call out the "C" and higher variants of the TDS7x4 scopes, as an updated programming manual was issued for them (distinct from the "A" variants) 8 months ago
.gitmodules Split BeagleBone Black GPMC support files into new libbbbgpmc library 5 years ago
README Update copyright dates 1 year ago

README

(c) 2013-2019 Timothy Pearson, Raptor Engineering
Licensed under the GPL v2

==================================================================================

GENERAL INFORMATION

==================================================================================

This is the source repository for the hardware access portion of the uLab remote laboratory system.

The terminal services components are hosted in a separate GIT repository, available from the uLab project's home page at http://ulab.trinitydesktop.org

This repository is a hierarchical tree, separating the main components into several related groups. The main groups are:
attic: Old files of any type, provided for historical reasons. These files are not required to build or use the uLab system, but may be of interest to academics who wish to know more about the origins of the uLab system.
clients: uLab clients and client parts for any supported operating systems. Each client part is matched with a server daemon in the "servers" top level directory.
database: Database structure descriptors, which can be used to create the database(s) utilized by the uLab servers.
documentation: Various files providing developer-facing documentation for the uLab system internals. User-facing documentation also included in a subdirectory of this directory.
fpga: FPGA-specific files, utilities, and programming software. This includes the hardware debug module required for FPGA viewer operation, and the various software components utilized by the FPGA Programmer daemon.
lib: Libraries providing core uLab functionality. These libraries are utilized by most uLab software, including both servers and clients.
servers: uLab server daemons for any supported operating systems. Each server daemon is matched with a client part in the "clients" top level directory.

==================================================================================

OBTAINING THE SOURCE CODE

==================================================================================

The uLab repository makes extensive use of GIT submodules, therefore obtaining a complete copy of the uLab source tree is slightly more complicated than a traditional 'git clone'. At minimum, you will need to execute:

git clone http://scm.trinitydesktop.org/scm/git/remotelaboratory
cd remotelaboratory
git submodule init
git submodule update

==================================================================================

BUILDING

==================================================================================

The uLab system shares much of its build infrastructure with the Trinity Desktop project; therefore, if you are familiar with building TDE packages with Autotools you may skip this section and proceed as you would with a TDE module.

At minimum, you will need to execute the following commands within each uLab component source tree:

cp -Rp <path to your system's libtool.m4 file> admin/libtool.m4.in
cp -Rp <path to your system's ltmain.sh file> admin/ltmain.sh
make -f admin/Makefile.common
./configure
make
make install

==================================================================================

REPORTING BUGS AND SUBMITTING PATCHES

==================================================================================

Bugs should be entered into the Trinity Desktop Environment's bugtracker at http://bugs.trinitydesktop.org, filed against the uLab software product.

Patches should be entered into the bugtracker as well; if the patch is an enhancement, open an enhancement request bug report detailing why the new feature(s) should be included in the master source and attach the patch to the new bug report.