Selfbus ARM Entwicklung - Getting Started

Entwicklungsumgebung

Die Entwicklungsumgebung für den im Selfbus Umfeld genannten „ARM“ Mikrocontroller heisst aktuell MCUXpresso IDE. Diese ist von der NXP Homepage hier herunterzuladen.

Diese wird installiert, am besten mit allen Treibern die dabei mit angegeben werden.

Programmiergerät und Debug Schnittstelle

Die beste Art den ARM Controller zu programmieren ist ein JTAG Programmiergerät. Dieses hat zusätzlich die Möglichkeit des On-Chip-Debuggings. Damit lassen sich eventuelle Fehler recht gut und schnell identifizieren und beheben. Zusätzlich hat man die Möglichkeit Variablen auf dem Chip zur Laufzeit zu beobachten. Damit lassen sich oft logische Programmierfehler ausfindig machen.

Es gib mehrere JTAG Programmiergeräte, die von der IDE MCUXpresso unterstützt werden. Diese werden im User Guide unter der Überschrift „Debug Probes“ aufgeführt. Die bekannstesten unter Ihnen sind der J-Link von Segger und der LPC-Link von NXP. Ebenso kann man auch unseren eigenen SelfBus DAP Debugger verwenden. Dieser stellt zusätzlich die serielle Schnittstelle vom ARM zur Verfügung.

Programmieren über UART

Der LPC1115 hat einen mitgelieferten UART Bootloader, der es ermöglicht den Controller über diese UART Schnittstelle zu programmieren.

Am PC eignet sich hierzu das Programm Flashmagic, welches die Daten über eine UART Schnittstelle seriell zum Controller überträgt.

Diese serielle Schnittstelle kann mit verschiedenen Tools hergestellt werden:

Selfbus USB Programmer: Es wurde der Selfbus USB Programmer um eine Schnittstelle für den ARM Prozessor erweitert. Die neuen Modelle (ab Version 3.7) haben einen 5x2-poligen ARM JTAG Stecker. Die RM2,00mm Stecker gibt es bei Reichelt. Das Flachbandkabel 30cm im Selfbus Shop.

Die Schnittstelle ist so vorbereitet, dass die Controllerplatinen 1:1 angeschlossen werden können.

Beliebiger USB UART Adapter: Am besten und problemlosesten funktioniert ein Adapter an dem die DTR und RTS Leitung herausgeführt ist, dann ist ein problemloses Programmieren möglich.

Es müssen dann folgende Verbindungen hergestellt werden:

Applikationen, Beispiele und sblib laden

Es müssen 2 Repositories von Github geladen werden, um starten zu können.

Die Applikationssoftware liegt zurzeit noch komplett unter software-arm-incubation.

Die sblib ist im Github unter software-arm-lib zu finden. Die sblib ist die grundsätzliche Software, auf der alle Projekte aufbauen. Sie kommuniziert mit dem KNX Bussystem und bietet dem Entwickler viele Möglichkeiten.

Diese beiden Repositories können über einen Git Client wie z.B. dem von Github auf den PC geladen werden, oder für den Einsteig und die ersten Schritte ausreichend, per Klick auf den „Clone or Download“ Button im jeweiligen Github Repository.

Diese Daten werden aus der ZIP entpackt sie werden jeweils in einem Ordner an einem beliebigen Speicherort abgelegt.

Einrichtung von MCUXpresso

Die Ersteinrichtung von MCUXpresso sollte sorgfältig durchgeführt werden. Ansonsten hat man die Daten alle nachher in den falschen Ordnern und man muss sie mühselig wieder sortieren.

Beim Start der IDE (Integrated Development Environment, in diesem Fall MCUXpresso) wird nach dem Workspace gefragt. Hier bietet es sich an, einen neuen Ordner zu erstellen und dort den Workspace anzulegen.

In diesen Workspace verlinken wir jetzt die beiden heruntergeladenen Selfbus Repositories.

Dieses wird über die Schaltfläche „Import project(s) from file system…“ gemacht. Diese Schaltfläche findet man im linken, unteren Bereich „Quickstart“.

In dem sich öffnenden Fenster wird der Button „Browse…“ in dem Bereich „Project directory (unpacked)“ angeklickt.

Hier wählt man zunächst den Pfad des Speicherorts der software-arm-lib Dateien an. Nach dem Betätigen der Schaltfläche „Next“ erscheint eine Übersicht über alle in dem Ordner befindlichen Projekte. Im Falle der software-arm-lib umfasst dieses einige examples und eben auch die sblib. Wichtig ist, dass mindestens die sblib angewählt ist, der Rest kann aber auch sehr hilfreich sein.

Nun ist es noch sehr wichtig, dass der Haken bei „Copy projects into workspace“ entfernt wird!

Dieses führt dazu, dass nur eine Verlinkung hergestellt wird, die Daten aber da bleiben wo sie sind.

Die Prozedur wird mit einem Klick auf die Schaltfläche „Finish“ abgeschlossen.

Nach einem erneuten Klick auf „Import project(s) from file system…“ wird der Ordner der „software-arm-incubation“ Daten ausgewählt. Nach dem Klick auf „Next“ können die Applikationen ausgewählt werden. Für einen ersten Überblick würde ich alle Projekte auswählen. Den Haken bei „Copy projects into workspace“ wieder entfernen und die Prozedur mit einem Klick auf „Finish“ abschließen.

Abschließend benötigen wir noch die „CMSIS_CORE“ library, die wir auf einem ähnlichen Weg importieren. Nach dem Klick auf  „Import project(s) from file system…“ wird dieses Mal die Schaltfläche „Browse“ im Bereich „Project archive (zip)“ betätigt.  Hier sollte die Ordnerauswahl in einem Unterordner der DIE starten. Dieser Unterordner heißt „Examples“ und beinhaltet unter anderem den Ordner „Legacy“, welcher wiederum den Ordner „CMSIS_CORE“ enthält. In diesem Ordner ist die ZIP „CMSIS_CORE_Lastest.zip“ enthalten. Diese wird ausgewählt und mit einem Klick auf „Next“ bestätigt. Im Auswahlfenster wird nur die CMSIS_CORE_LPC11xx (CMSIS_CORE_LPC11xx/)“ angehakt, alle anderen benötigen wir nicht. In diesem Fall ist auch die Option nicht gegeben, die Daten nicht in den Workspace zu kopieren, da es sich bei der Quelle um eine ZIP handelt. Damit wird die CMSIS_CORE in den Workspace kopiert.

Damit ist die IDE MCUXpresso eingerichtet.

Erste Kompilierung einer Applikation

Die erste Kompilierung einer Applikation benötigt eine kompilierte sblib. Daher muss diese zuerst ausgewählt werden und für die jeweilige BCU Version kompiliert werden. Dazu wählt man im Baum links im Reiter „Project Explorer“ den Eintrag „sblib“ an. In der Menüleiste neben dem Hammer-Symbol wird der kleine Pfeil angeklickt und z.B. der Eintrag „Debug_BCU1 (Debug build for BCU1)“ ausgewählt. Dieses startet die Kompilierung des sblib für die ausgewählte BCU.

Anschließend kann eine Applikation mit BCU1 kompiliert werden. Beispielhaft nehmen wir hier das Projekt „out8-bcu1“. Dieses wird durch Anklicken im Baum unter dem „Project Explorer“ ausgewählt und durch einen Klick auf den Pfeil neben dem Hammer-Symbol und der Auswahl des Eintrags „Debug (Debug build)“ kompiliert.

Sollte dieses fehlerfrei durchlaufen, kann das Projekt per Programmiergerät/Debugger auf den Controller übertragen werden.

Debuggen auf dem Controller

Der große Vorteil der JTAG Schnittstelle und der IDE MCUXpresso gegenüber „herkömmlichen“ Mikrocontrollern, wie die bekannten AVRs (z.B. Arduino) ist die Möglichkeit der des On-Chip-Debuggings.

Dieses bedeutet, man kann das Programm auf dem Mikrocontroller ausführen, pausieren und stoppen. Zusätzlich hat man die Möglichkeit Breakpoints zu setzten. Damit kann man also die Ausführung des Programms auf dem Controller an einer Stelle unterbrechen, an der man sich gerne die Variablen oder an der Hardware die Pin-Pegel ansehen möchte.

Somit benötigt man nicht an jeder eventuell interessanten Stelle im Code eine serielle Konsolenausgabe. Diese seriellen Ausgaben haben außerdem den Nachteil, dass sie die Programmausführung erheblich verlangsamen.

Um das Debuggen im MCUXpresso zu starten, wird der BLAUE! Käfer im Quickstart Panel unten links im Bildschirm angewählt.

Nun wird der Debugger initialisiert und das Programm auf den Controller übertragen. Anschließend wird das Programm an der ersten auszuführenden Codezeile gestoppt:

Da die sblib die main Funktion beinhaltet, ist dort der Einstiegspunkt in das Programm.

Nun kann man mit den Funktionstasten F5, F6 und F7 durch das Programm durchgehen.

F5: Step Into = jede Zeile Code wird ausgeführt und anschließend gestoppt. Zusätzlich wird in jede Unterfunktion hineingesprungen.

F6: Step Over = Jede Zeile Code wird ausgeführt und scnhließend gestoppt, allerdings wird nicht in die Funktionsaufrufe hineingesprungen

F7: Step Return  = Aus der aktuellen Funktion wird eine Aufrufstufe herausgesprungen. Die aktuelle Funktion wird bis zum Ende ausgeführt und die Programmausführung wird erst in der aufrufenden Funktion gestoppt.

Alternativ zu den Funktionstasten können die Symbole in der Toolbar verwendet werden:

Wenn man nicht die gesamten Schritte durchgehen möchte, bis ein bestimmtes Ereignis auftritt oder eine bestimmte Funktion aufgerufen wird, können Breakpoints gesetzt werden. Diese werden in den Controller übertragen und lassen die Programmausführung stoppen, wenn die Codezeile ausgeführt werden soll.

Dazu wird in der gewünschten Zeile der Codeanzeige links neben den Zeilennummern doppelt geklickt.

Anschließend wird die Codeausführung mit einem Klick auf den grünen Pfeil in der Toolbar gestartet.

Die Codeausführung wird dann gestoppt und mit einem Pfeil neben der Zeilennummer angezeigt.

WICHTIG: Bevor die Debug Funktion erneut ausgeführt wird, unbedingt den roten Stop Button in der Toolbar betätigen. Wenn ohne dieses Vorgehen der blaue Käfer erneut betätigt wird, kommt es zu Fehlermeldungen, da nur ein Debug Kanal zur Verfügung steht und kein erneutes Debugging gestartet werden kann.