Select Git revision
installation.html
Marcus Greiff authored
installation.html 5.74 KiB
<!DOCTYPE html>
<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><title>Installation Instructions · LabConnections</title><link href="https://cdnjs.cloudflare.com/ajax/libs/normalize/4.2.0/normalize.min.css" rel="stylesheet" type="text/css"/><link href="https://fonts.googleapis.com/css?family=Lato|Roboto+Mono" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.6.3/css/font-awesome.min.css" rel="stylesheet" type="text/css"/><link href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css" rel="stylesheet" type="text/css"/><script>documenterBaseURL="."</script><script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.2.0/require.min.js" data-main="assets/documenter.js"></script><script src="siteinfo.js"></script><script src="../versions.js"></script><link href="assets/documenter.css" rel="stylesheet" type="text/css"/></head><body><nav class="toc"><h1>LabConnections</h1><select id="version-selector" onChange="window.location.href=this.value" style="visibility: hidden"></select><form class="search" action="search.html"><input id="search-query" name="q" type="text" placeholder="Search docs"/></form><ul><li><a class="toctext" href="index.html">LabConnections</a></li><li class="current"><a class="toctext" href="installation.html">Installation Instructions</a><ul class="internal"></ul></li><li><a class="toctext" href="systemConfiguration.html">System Configuration</a></li></ul></nav><article id="docs"><header><nav><ul><li><a href="installation.html">Installation Instructions</a></li></ul><a class="edit-page" href="https://github.com//tree/2f394b7fb331bde8055286d7ff760868bc3c8d27/docs/src/installation.md"><span class="fa"></span> Edit on GitHub</a></nav><hr/><div id="topbar"><span>Installation Instructions</span><a class="fa fa-bars" href="#"></a></div></header><h1><a class="nav-anchor" id="Installation-Instructions-1" href="#Installation-Instructions-1">Installation Instructions</a></h1><h3><a class="nav-anchor" id="On-the-HOST-1" href="#On-the-HOST-1">On the HOST</a></h3><p>To get started, first install julia v0.6.X on the PC running a Linux distribution by following the instructions specified <a href="https://github.com/JuliaLang/julia/blob/master/README.md">here</a>. So far, the system has only been testen on Ubuntu 14.* and 16.*.</p><p>Once julia is installed julia, run</p><pre><code class="language-none">`Pkg.clone(https://gitlab.control.lth.se/labdev/LabConnections.jl)'
`Pkg.add("YAML")'</code></pre><p>in the julia prompt to install all dependencies on the HOST.</p><h3><a class="nav-anchor" id="On-the-BeagleBone-1" href="#On-the-BeagleBone-1">On the BeagleBone</a></h3><p>On the BeagleBone, first install Debian for 32 bit ARM processors using a micro-SD by following <a href="http://derekmolloy.ie/write-a-new-image-to-the-beaglebone-black/">this guide</a>. You may also include a julia v0.6 tarball, alternatively transferring it using after an installation.</p><p>If chosing the latter, connect the BB and download the julia tarball for ARM (ARMv7 32-bit hard float) from <a href="https://julialang.org/downloads/">here</a> and scp it to /home/debian/ on the BB. Run</p><pre><code class="language-none">`cd ~/Downloads'
`scp -r julia-0.6.0-linux-arm.tar.gz debian@192.168.7.2:/home/debian'</code></pre><p>next, log on to the BB running</p><pre><code class="language-none">`ssh debian@192.168.7.2'</code></pre><p>an unpack the tarball. Julia should now be operational by running</p><pre><code class="language-none">`/home/debian/julia-<distro specific tag>/bin/julia'</code></pre><p>Next, open a new terminal on the HOST and cd to the /util directory of the LabConnection package by running in the julia package folder</p><pre><code class="language-none">`cd && cd .julia/v0.6/LabConnection/util'</code></pre><p>This directory contains some nice utility files to operate the BB from the host. To flash it with the current revision of the software, including all dependencies, simply type</p><p>`./flash_BB.sh'</p><h3><a class="nav-anchor" id="Setting-up-automatic-communication-between-the-BB-and-the-HOST-via-TCP-1" href="#Setting-up-automatic-communication-between-the-BB-and-the-HOST-via-TCP-1">Setting up automatic communication between the BB and the HOST via TCP</a></h3><p>To setup automatic start of julia server on the beagle bone</p><ol><li><p>Make sure that julia is installed in <code>/home/debian/julia-903644385b/bin/julia</code> on the BeagleBone or edit <code>juliaserver.service</code> accordingly</p></li><li><p>Create the folder <code>/home/debian/juliapackages/</code> on the BeagleBone</p></li><li><p>On the computer, go to <code>LabConnections/util</code> and run <code>./copyfoldertobb.sh</code></p><ul><li><p>If this failes, make sure that there is not already a folder <code>/home/debian/juliapackages/LabConnections</code></p></li></ul></li><li><p>Copy <code>LabConnections/src/BeagleBone/startup/juliaserver.service</code> to <code>/lib/systemd/system/juliaserver.service</code> on the BeagleBone.</p></li><li><p>Run: <code>sudo systemctl enable juliaserver</code> on BeagleBone</p></li><li><p>Run: <code>sudo systemctl start juliaserver</code> on BeagleBone</p></li></ol><p>After a while, the BeagleBone should start blinking on SysLED 2: on-off-on-sleep-repeat</p><p>The server should now start automatically on restart of the BeagleBone.</p><pre><code class="language-"></code></pre><footer><hr/><a class="previous" href="index.html"><span class="direction">Previous</span><span class="title">LabConnections</span></a><a class="next" href="systemConfiguration.html"><span class="direction">Next</span><span class="title">System Configuration</span></a></footer></article></body></html>