Exempelsamling

Introduktion

Laborationsuppgifter och uppgifter i exempelsamlingen utförs till stor del med hjälp av de programverktyg vi använder i kursen. Här får du hjälp med att installera dessa och dessutom göra ett inledande funktionstest.
Observera, det är i allmänhet bäst att ladda hem programvaror via vår resurssida, snarare än ev. nyare versioner från andra hemsidor, eftersom vissa distributioner är modifierade för att bättre passa kursen.
I laborations- och övningssalar på Chalmers används nästan uteslutande Windows-versioner av programvarorna, men det finns också versioner för Mac OSX och Linux.

Installation:Windows

Börja med att ladda hem följande programdistributioner från resurssidan:

 eterm8-0.96-setup.exe
 codelite-amd64-11.0.0.8-cse.exe

Installera på vanligt sätt genom att starta programmen. Alla programdelar följer med distributionerna och normalt ska detta räcka. Om du vid installation av CodeLite får frågan om du vill ta bort gamla inställningar ska du svara "JA".

Kontrollera installationerna

Starta eterm8, om du nu får problem med "saknad DLL", dvs. programmet startar inte direkt, beror detta förmodligen på att du inte har "run-time"-bibliotek för VC2015 installerat. Detta distribueras av Microsoft och du hittar en länk till distributionssidan i kolumnen "Anm" på resurssidan. Det finns två varianter, vet du inte vilken du ska ha så kan du prova med att installera båda. Efter detta ska du nu kunna starta och använda eterm8.

Om du sitter i en datasal på Chalmers

Oftast fungerar den installerade CodeLite-miljön direkt efter installationen. Om du får problem med att GCC eller CrossGCC inte finns som alternativ när du skapar projekt, eller att inget händer när du kompilerar, kan detta bero på att du tidigare använt CodeLite i Chalmers nätverk och att dessa inställningar nu felaktigt används. Du ågärdar detta genom att ta bort biblioteket "codelite" i ditt "AppData/Roaming", bibliotek. Vanligtvis i sökvägen Z:\.win\AppData\Roaming. Starta därefter om CodeLite.

Installation:OSX

Kräver minst version 10.10.
Om du inte tidigare gjort det, börja med att installera XCode. Ladda därefter hem följande distributioner från resurssidan:

 eterm8.app-0.95.zip
 codelite.app.zip
 gcc-arm-none-eabi-6-2017-q1-update-mac.tar.bz2

Vi förutsätter att dessa då på vanligt sätt hamnat i ditt hembibliotek under /Downloads. Det är praktiskt att placera de nya programmen i /Applications. Öppna en Terminal och utför följande eller, om applikationerna packats upp automatiskt, flytta hela mappar (eterm8.app, simserver.app och codelite.app) till /Applications.

Observera, om man låter Safari ladda hem OCH packa upp filerna ska man INTE försöka starta programmen omedelbart. Först måste man undanta dom från "Gatekeeper"s behandling... (se nedan).

cd /Applications
cp ~/Downloads/eterm8.app-0.95.zip .
unzip eterm8.app-0.95.zip
cp ~/Downloads/codelite.app.zip .
gunzip codelite.app.zip

cp ~/Downloads/gcc-arm-none-eabi-6-2017-q1-update-mac.tar.bz2 .
bunzip2 gcc-arm-none-eabi-6-2017-q1-update-mac.tar.bz2
tar xvf gcc-arm-none-eabi-6-2017-q1-update-mac.tar
mv gcc-arm-none-eabi-6-2017-q1-update-mac.tar gcc-arm
rm gcc-arm-none-eabi-6-2017-q1-update-mac.tar

Nu (2017-03-23) måste vi hindra "gatekeeper" från att placera våra program i "karantän" (se även här)

sudo spctl --add /Applications/eterm8.app
sudo spctl --add /Applications/simserver.app
sudo spctl --add /Applications/CodeLite.app

Kontrollera installationerna

Programmen kan nu startas på vanligt sätt. ETERM8 och Simserver är klara att användas.
OBS: Om du inte följt anvisningarna precis enligt ovan och får ett felmeddelande om felaktig sökväg från ETERM kan detta bero på att programmet placerats i "karantän" då det packades upp exempelvis av "Safari". Avinstallera då Eterm (se nedan) och gör om proceduren enligt anvisningarna.

Det finns ingen direktlänk till GDB som du använder inför laboration 1, men du kan enkelt skapa en sådan. Den körbara filen finns i eterm8.app/Contents/MacOS (arm-none-eabi-gdb). Skapa en länk till denna (Make Alias) och dra denna exempelvis till Desktop.

I Codelite men du måste göra "kompilatorsökning" innan du sätter i gång med ditt första programmeringsprojekt.
Starta nu CodeLite, gör kompilatorsökning:
Settings | Build Settings (Add Compilers). Add existing compiler (det lilla gröna +-tecknet uppe till vänster). I dialogen Select the compiler folder väljer du biblioteket /Applications/gcc-arm. Med detta ska installationen vara klar.

Avinstallation

Vill du avinstallera CodeLite och arm-gcc tar du helt enkelt bort biblioteken codelite.app och arm-gcc från /Applications.
Vill du avinstallera Eterm8 och SimServer tar du bort "eterm.app" och "simserver.app"-biblioteken. Du måste också ta bort de filer där programmens inställningar sparas:
(Ditt hembibliotek)/Library/Preferences/GMV/Eterm8.config
(Ditt hembibliotek)/Library/Preferences/GMV/SimServer.config

Installation:Linux

Installation av ETERM8 och SIMSERVER

Distributioner är testade för Debian 9. För Linuxsystem som inte hanterar .deb kan man i stället välja en "tarball" med Linux-binärer (se nedan). Paketen innehåller såväl ETERM8 som SIMSERVER, installera .deb-paket med.:

sudo dpkg -i eterm8_0.96_amd64.deb

Att ta bort installationen:

sudo dpkg -r eterm8

För övriga LINUX-varianter kommer ETERM8/SIMSERVER som "tarball". Enklast är att packa upp under /usr/local/bin. Då finns dom vanligtvis i sökvägen om du vill starta programmet från kommandoraden i en terminal. Skapa en länk till "desktop" om du föredrar det. Distributionen laddas hem från resurssidan:

 eterm8-simserver-0.96.tar.gz

Vi utgår från att denna, på vanligt sätt då hamnat i ditt hembibliotek under /Downloads. Du måste nu ha "rot"-behörighet för att nu utföra installationen:

 cd /usr/local/bin
 cp ~/Downloads/eterm8-simserver-0.96.tar.gz .
 gunzip  eterm8-simserver-0.96.tar.gz
 tar xvf  eterm8-simserver-0.96.tar
 rm eterm8-simserver-0.96.tar

ETERM8 och SIMSERVER är klara att användas. Kontrollera nu att ETERM6 och SIMSERVER kan startas.

Installation av CodeLite, C-kompilatorer och mallar.

Du måste ha "rot"-behörighet för att nu utföra installationen: Börja med att installera CodeLite enligt anvisningarna på CodeLites hemsida. Ladda därefter hem följande direkt från resurssidan:

 gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2
 md407-templates-linux.zip

Vi utgår från att dessa, på vanligt sätt då hamnat i ditt hembibliotek under /Downloads. Korskompilatorn GCC-ARM är ett stort programpaket och det kan det vara praktiskt att installera i ett eget hembibliotek: /usr/local/gcc-arm.

 cd /usr/local/
 cp ~/Downloads/gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2 .
 bunzip2 gcc-arm-none-eabi-7-2017-q4-major-linux.tar.bz2
 tar xvf gcc-arm-none-eabi-7-2017-q4-major-linux.tar
 mv gcc-arm-none-eabi-7-2017-q4-major  gcc-arm
 rm gcc-arm-none-eabi-7-2017-q4-major-linux.tar

Tidigare har Codelite installerats i /usr/share/codelite.
Projektfil för MD407 md407-startup.zip packas nu upp i ett nytt bibliotek under: /usr/share/codelite/templates/projects.

 cd /usr/share/codelite/templates/projects
 cp ~/Downloads/md407-templates-linux.zip .
 unzip md407-templates-linux.zip
 rm md407-templates-linux.zip

GCC ("native") är normalt installerad med varje Linux-installation så vi behandlar inte det här.

Kontrollera installationerna

Programmen kan nu startas på vanligt sätt, men du måste göra "kompilatorsökning" i Codelite innan du sätter i gång med ditt första programmeringsprojekt.
Starta nu CodeLite, gör kompilatorsökning på följande sätt: Settings | Build Settings (Add Compilers). – Add existing compiler I dialogen Select the compiler folder väljer du biblioteket /usr/local/gcc-arm. Upprepa för de kompilatorer du vill använda tillsammans med CodeLite. Med detta ska installationen vara klar.

FAQ

(Tack till Niklas Gustafsson)

Det går inte att köra programmet

Många misstolkar informationen som Codelite ger när projektet byggs. De flesta studenterna tror att allting fungerar så länge det inte kommer upp någon röd text. Därför missar många att projektet inte byggs över huvudtaget. Det vanligaste felet är att sökvägen till projektet innehåller mellanslag.
OBS! Om du skapar ett nytt workspace så var noga med att lägga detta på din personliga filyta på nätverket (oftast Z:). Gör du inte detta så sparas dina projekt lokalt på datorn och skulle du logga in på en annan dator på Chalmers kommer dom inte finnas där. Det gör dom ifall du sparar ditt workspace på Z:.
Säkerställ att projektet kompileras med rätt kompilator (Cross GCC (arm-none-eabi)).

Programmet körs, men det händer inget

Om delay används, kolla så att simulator är definierat (#define SIMULATOR) annars kommer längre delays köras väldigt länge (tar mycket längre tid på simulatorn än på hårdvaran).
I/O enheten är kopplad till fel port.
IDR skrivs, ODR läses, se nedan.

Det funkar inte att läsa/skriva data

Kolla så att IDR registret läses och inte ODR registret. Det är vanligt att studenter blandar ihop dessa. Skrivning av utdata ska ske mot ODR registret medans indata läses i IDR registret.
Kolla MODER inställningarna.

Vad är en avbrottsvektor?

Avbrottsvektorn är en del av avbrottstabellen. Denna tabell finns i minnet och pekar på diverse funktioner som ska köras när avbrott av olika slag händer. Varje rad i tabellen representerar ett slags avbrott. Tabellen används för att specificera vad som ska göras då ett avbrott genereras.

Några vanliga tabbar:

Det finns flera funktioner som gör samma sak. Det kan till exempel finnas två funktioner för att sätta bitarna i LCD displayens konfigurationsregister. Det är vanligt att studenter ändrar i den ena funktionen men anropar den andra. En bra grundregel är att ha en funktion per uppgift och bara använda den. Att ha fler funktioner för samma sak ställer mest till problem och är förvirrande.
Ibland fungerar inte funktioner som tagits från tidigare projekt där dom fungerat. Detta är oftast för att konstanter som definierats i det andra projektet har ett annat värde i det nya projektet. Om man vill bygga vidare på ett befintligt projekt men behålla originalet (vilket ofta är fallet) så är det bästa att kopiera hela projektet och fortsätta med att arbeta på kopian. Om man skapar ett nytt projekt och kopierar över all kod etc är det lätt att missa något.