RP6 - Programmierung: Unterschied zwischen den Versionen

Version vom 17. Juni 2012, 18:00 Uhr

Allgemein

In diesem Artikel geht es um die Programmierung des RP6, des RP6v2 und ihrer Erweiterungsplatinen RP6 CONTROL M32 und RP6 CCPRO M128.

Zu den Grundlagen des RP6 und des RP6v2 gibt es jeweils eigene Seiten.

RP6Loader

Der RP6Loader ist hier zu finden. Der RP6Loader ist ein JAVA-Programm, das den RP6 oder die M32 über deren serielle Schnittstelle mit einem PC verbindet.

Das Programm verfügt über folgende Funktionen:

• Statusfenster mit RP6-Akku Spannungsanzeige
• Flash Loader (Programme hochladen und starten, Programmspeicher löschen)
• HexViewer (Inhalt der HEX-Datei ansehen)
• Terminal (Zeichen über die serielle Schnittstelle senden/empfangen)
• Displays (Grafische Hilfen zur Encoder-Einstellung)
• Log (Protokoll-Datei zur Fehlereingrenzung)

Der RP6Loader kann alle seine Funktionen nur mit dem Bootloader-Programm in der RP6 Base und M32 ausspielen. Entscheidet man sich für die ISP-Programmierung mit Löschen des Bootloaders, bleibt vom Funktionsumfang eigentlich nur das Terminal übrig.

Loader Versionen

Hier eine Tabelle der (mir) bekannten RP6Loader Versionen für die RP6 Base und M32:

Geeignete Terminals

Der RP6Loader enthält u.a. eine Terminal-Funktion. Stattdessen kann man auch andere Terminals mit besserem Funktionsumfang einsetzen.

HTerm

Dieses Terminal-Programm HTerm wurde von SlyD empfohlen. Die Konfiguration zeigt dieses Bild.

ZOC

radbruch hat hier darauf hingewiesen, dass es ein schönes, sogar farbiges Terminal-Programm ZOC gibt, das man gut anstelle des Terminals im RP6Loader einsetzen kann.

Projekte

• RP6FlashWriter: Der Opensource RP6 Loader
• RP6Loader für .Net oder CLR Schreiben
• rpyutils 0.1 Loader und Term in Python für Linux
• ...

RP6 Base und CONTROL M32

Der RP6 (191524) und die M32 (191550) können frei in C programmiert werden. Dies wird durch die umfangreiche Funktionsbibliothek und die detailliert beschriebene Anleitung auch Anfängern sehr leicht gemacht. Die Software, die zur Programmierung verwendet wird (WinAVR), ist ausschließlich Freeware und kann entweder der CD entnommen oder aus dem Internet (hier) heruntergeladen werden.

Demo-Programme

Die RP6 Base und M32 Demo Programme sind hier zu finden.

RP6 Base

Ein Programm für die RP6 Base kann zum Beispiel so aussehen:

#include "RP6RobotBaseLib.h"	

int main(void)
{
	initRobotBase(); // Mikrocontroller initialisieren

	powerON(); // Encoder und Motorstromsensoren anschalten (WICHTIG!!!)

	setLEDs(0b111111); // Alle LEDs anschalten

	moveAtSpeed(100,100); // Beide Motoren fahren mit Geschwindigkeit 100

	while(true)
	{
		task_motionControl(); // Geschwindigkeit einstellen
		task_ADC(); // Wird wegen der Motorstromsensoren aufgerufen
	}
	return 0; 

}

In dem Programm würde der RP6 als erstes alle LEDs anschalten und dann endlos mit Geschwindigkeit 100 geradeaus fahren, ohne Hindernisse zu berücksichtigen.

CONTROL M32

Noch ein Beispiel für die M32:

// Includes:

#include "RP6ControlLib.h" 		// IMMER einbinden!!!


int main(void)
{
	initRP6Control(); // IMMER als ERSTES aufrufen!!!
	initLCD(); // Das LCD starten. Muss IMMER aufgerufen werden, BEVOR das LCD verwendet wird!
	setLEDs(0b1111); // Alle LEDs ein
	mSleep(500); // Eine halbe Sekunde warten
	setLEDs(0b0000); // Alle LEDs aus
	sound(180,80,25); // 2 mal Piepsen
	sound(220,80,0);
	showScreenLCD("################", "################"); // Etwas auf dem Display zeigen
	mSleep(1500); // Warten
	showScreenLCD("<<RP6  Control>>", "<<LC - DISPLAY>>"); //
	mSleep(2500); // Warten
	showScreenLCD("Hello World", "Example Program");
	mSleep(2500); //Warten
	clearLCD(); // Das LCD löschen
		
	while(true) 
	{
	     mSleep(1500); // Ewig warten...
	}
	return 0;
}

Library

Die Library für die RP6 Base und CONTROL M32 besteht aus folgenden 13 Dateien:

Versionen

Hier eine Tabelle der (mir) bekannten Library Versionen der RP6 Base und M32:

In der 1. Spalte findet ihr das Datum der RP6Examples.zip Datei, in der die Library enthalten ist. Die 2. Spalte nennt die Version, die im Dateinamen der VERSION_x.x.txt Datei als x.x vorkommt. In der 3. und 4. Spalte steht die Versionsangabe der RP6Library und RP6ControlLibrary laut Angabe in der VERSION_x.x.txt Datei.

In der 5. Spalte gebe ich den Wert der Konstante RP6LIB_VERSION an. Es gibt sie erst ab den Examples vom 16.10.2007. In den Spalten 6 bis 11 führe ich nacheinander die Versionsnummern und ggf. das in der Datei genannte Datum der Header-Datei/Library an: RP6Config.h, BaseLib, ControlLib, UartLib, MasterTWI, SlaveTWI.

Die jeweils aktuelle Library ist in den Demo-Programmen auf der AREXX Homepage enthalten. Link siehe oben! Die RP6Control Library in der Version 1.31beta vom 03.02.2012 könnt ihr hier finden.

RP6RobotBase

Die RP6 Base Library existiert inzwischen in der Version 1.4 vom 29.04.2008. Gegenüber der Version 1.0 vom 10.04.2007 wurden neben Bugfixes auch einige Verbesserungen vorgenommen:

• Power On LED Funktion
• ACS Einstellungen in die RP6Config.h verlagert (um sie ändern zu können)
• Universelle Timer Variable mit 100 us Auflösung
• Anpassung an neuere WinAVR Versionen

Bug-Report

Derich2 hat hier darauf hingewiesen, dass die Stopwatches nicht genau arbeiten. Durch eine kleine Änderung in der Timer 0 Compare ISR (ISR (TIMER0_COMP_vect)) kann man Abhilfe schaffen.

Konfiguration

Die wesentlichen Hardware-Konfigurationen des RP6 sind in der "RP6Config.h" zu finden. Sie enthält Festlegungen zu:

• Encoder-Auflösung
• Rotations-Faktor
• Geschwindigkeits-Messintervall
• Power On Warnung
• ACS

Diese Header-Datei wird standardmäßig auch in die RP6RobotBase Library eingebunden.

Port-Verwendung

Die Verwendung der Ports des RP6 Microcontrollers wird festgelegt in der Header-Datei "RP6RobotBase.h". In dieser Datei wird auch noch Folgendes aufgeführt:

• Quarzfrequenz (F_CPU)
• True/false Definition
• Verschiedene Macros
• Baudrate der seriellen Schnittstelle

Hier eine Tabelle mit den Port-Definitionen für die RP6 Base:

Erklärung der Spalten:
Port        -> Atmel Portpin Bezeichnung
Name        -> Atmel Funktionsbezeichnung
In/Out      -> Eingang (In) oder Ausgang (Out)
Pullup      -> Falls Eingang: Pullup ein- (1) oder ausgeschaltet (0)
Wert        -> Falls Ausgang: Logikpegel high (1) oder low (0)
Funktion    -> Schnittstellenfunktion
Bezeichnung -> Portpin Bezeichnung der Library
Stecker     -> Portpin verfügbar an STECKER: Pin
Anmerkungen -> Kommentare (ADC_xxxxx: ADC-Kanal Bezeichnung)

Zeichen:
*   Standard-Belegung! Über Jumper/Lötbrücke änderbar.
**  Power On für Radencoder, IR-Empfänger *, Stromsensoren *, PWRON-LED *
*** Zusätzlicher Anschluß von Bumpern oder Tastern möglich!
²   I2C-Master: Out, Slave: In

Timer-Nutzung

Die Nutzung der Timer wird in der RP6Base Library in der Funktion initRobotBase() am Ende der Datei RP6RobotBaseLib.c festgelegt.

Timer 0

Timer 0 arbeitet in der RP6Base Library im CTC-Modus (Mode 2) mit einem Vorteiler von 8 und nutzt als TOP-Wert OCR0. Bei einem Wert von 99 für OCR0 errechnet sich ein Zyklus von 100 us bei einer Quarzfrequenz von 8 MHz.

Der Zyklus von 100 us wird genutzt für:

• Verzögerungen (sleep, mSleep)
• Stopwatches
• RC5 Empfang
• Timer Variable
• Geschwindigkeits-Messung
• Weiche PWM-Anpassung und automatische PWM-Abschaltung
• ACS Timing
• Blinken der Power On LED
• Überstrom Zeitmessung
• Bumper Check Intervall Zeitmessung
• Selbsttest: Duty cycle Messung

Timer 1

Timer 1 arbeitet im phasenrichtigen (phase correct) PWM-Modus (Mode 10) mit einem Vorteiler von 1 (kein Vorteiler!) und nutzt als TOP-Wert ICR1. Bei einem Maximalwert von 210 für ICR1 errechnet sich eine PWM-Frequenz von ca. 19048 Hz.

Die PWM wird genutzt für:

• Geschwindigkeitsregelung der Motoren

Timer 2

Der Timer 2 arbeitet im CTC-Modus (Mode 2) mit einem Vorteiler von 1 (kein Vorteiler!) und nutzt als TOP-Wert OCR2. Bei einem Wert von 110 (= 0x6E) für OCR2 errechnet sich eine Frequenz von ca. 72072 Hz.

Die 72 kHz Frequenz wird genutzt für:

• ACS

RP6Control

Die RP6Control Library gibt es inzwischen in der Version 1.1 vom 28.09.2007 (evtl. existiert auch eine Version 1.2 vom 12.09.2008 ??). Von Dirk wurde hier eine Version 1.31beta veröffentlicht mit folgenden Verbesserungen:

• Neue Task ADC
• Funktionen für die freien I/O-Portpins
• Tonfrequenz-Konstanten für den Beeper

Bug-Report

Derich2 hat hier darauf hingewiesen, dass die Stopwatches nicht genau arbeiten. Durch eine kleine Änderung in der Timer 0 Compare ISR (ISR (TIMER0_COMP_vect)) kann man Abhilfe schaffen. Diese Änderung ist ab Version 1.31beta der Library schon berücksichtigt.

Konfiguration

Die wesentlichen Hardware-Konfigurationen des RP6 sind in der "RP6Config.h" zu finden. Sie enthält Festlegungen zu:

• Encoder-Auflösung
• Rotations-Faktor
• Geschwindigkeits-Messintervall
• Power On Warnung
• ACS

Diese Header-Datei wird standardmäßig auch in die RP6Control Library eingebunden.

Port-Verwendung

Die Verwendung der Ports des RP6 CONTROL M32 Microcontrollers wird festgelegt in der Header-Datei "RP6Control.h". In dieser Datei wird auch noch Folgendes aufgeführt:

• Quarzfrequenz (F_CPU)
• True/false Definition
• Baudrate der seriellen Schnittstelle

Hier eine Tabelle mit den Port-Definitionen der M32:

Erklärung der Spalten:
Port        -> Atmel Portpin Bezeichnung
Name        -> Atmel Funktionsbezeichnung
In/Out      -> Eingang (In) oder Ausgang (Out)
Pullup      -> Falls Eingang: Pullup ein- (1) oder ausgeschaltet (0)
Wert        -> Falls Ausgang: Logikpegel high (1) oder low (0)
Funktion    -> Schnittstellenfunktion
Bezeichnung -> Portpin Bezeichnung der Library
Stecker     -> Portpin verfügbar an STECKER: Pin
Anmerkungen -> Kommentare (ADC_xxxxx: ADC-Kanal Bezeichnung)

Zeichen:
*   Standard-Belegung! Über Jumper/Lötbrücke änderbar.
**  Frei nutzbar. wenn kein 2. EEPROM (IC5) eingesetzt ist!
²   I2C-Master: Out, Slave: In

Timer-Nutzung

Die Nutzung der Timer wird in der CONTROL M32 Library in der Funktion initRP6Control() am Ende der Datei RP6ControlLib.c festgelegt.

Timer 0

Timer 0 arbeitet in der M32 Library im CTC-Modus (Mode 2) mit einem Vorteiler von 8 und nutzt als TOP-Wert OCR0. Bei einem Wert von 199 für OCR0 errechnet sich ein Zyklus von 100 us bei einer Quarzfrequenz von 16 MHz.

Der Zyklus von 100 us wird genutzt für:

• Verzögerungen (sleep, mSleep)
• Stopwatches
• Timer Variable
• Sound timing

Timer 1

Timer 1 ist in der M32 Library nicht genutzt und kann beliebig in eigenen Programmen eingesetzt werden.

Timer 2

Der Timer 2 arbeitet im Normal-Modus (Mode 0). Der Wert von OCR2 bestimmt die Frequenz.

Die von Timer 2 erzeugte Frequenz wird genutzt für:

• Beeper

RP6uart

Diese Library stellt Funktionen für die serielle Kommunikation zur Verfügung. Sie kann auf der RP6 Base und M32 eingesetzt werden. Die aktuelle Version ist seit dem 10.09.2007 die Version 1.1. Gegenüber der Version 1.0 vom 10.04.2007 sind die Empfangsfunktionen jetzt Interrupt-basiert und verfügen über einen Ringpuffer.

Die RP6uart Library ist standardmäßig in die RP6Base und CONTROL M32 Library eingebunden.

RP6I2Cmaster/slaveTWI

Diese Library (bestehend aus einer Master- und einer Slave-Library) stellt Funktionen für die I2C-Kommunikation zur Verfügung. Die Library, die es in der Version 1.0 unverändert bereits seit dem 16.05.2007 gibt, läßt sich sowohl auf der RP6Base, als auch auf der M32 nutzen. Beide Plattformen können I2C-Master oder -Slave sein.

Bug-Report

Dieser interessante Thread von RolfD dreht sich um Fehler in dieser Lib und deren Fix.

Ergänzung

Hier findet sich eine (evtl. noch nicht fehlerfreie) Veränderung der RP6I2Cmaster Library, um mit ihr den berührungslosen Temperatursensor MLX90614 anzusteuern. Die Änderungen ermöglichen einen Repeated Start zwischen dem Senden der I2C- und RAM-Adresse und dem Lesen der Sensor-Werte. Die Original-Library sendet an dieser Stelle ein Stop.

WinAVR

Die neueste Version von WinAVR kann man hier herunterladen. WinAVR ist eine fertige Windows-Einrichtung eines Editors (Programmer's Notepad 2) und eines C-Compilers für Atmel AVR-Microcontroller (AVR-GCC).

Zu empfehlen ist ein Blick in folgende Anleitungen, die in der WinAVR-Installation enthalten sind:

• WinAVR-user-manual.html (Benutzer-Handbuch im Stammverzeichnis)
• pn2.chm (PN2 Hilfe-Datei im Unterverzeichnis \pn\help)

Programmer's Notepad 2

Programmer's Notepad 2 (PN2) ist der Editor von WinAVR, mit dem man Programme schreibt.

GCC

GCC ist eine Sammlung von Compilern, die auch eine C-Variante enthält (AVR-GCC), die für die Programmierung von AVR-Microcontrollern eingesetzt wird. In AVR-GCC wird auch der RP6 programmiert. In seiner Anleitung gibt es einen "C - Crashkurs" (Kapitel 4.4.).

Zusätzlich ist u.a. in der WinAVR-Installation folgende Referenz zu allen Definitionen und Funktionen der AVR-GCC-Libraries enthalten:

• avr-libc-user-manual.pdf (Handbuch im Unterverzeichnis \doc\avr-libc)

Es gibt gute Tutorials, um die Sprache zu lernen:

• Avr-gcc
• C-Tutorial
• Das C Tutorial (deutsch)
• Einiges zu ANSI-C

Darüber hinaus gibt es natürlich auch Bücher:

• Suche C-Buch für Einstieg

Projekte

Ohne Anspruch auf Vollständigkeit habe ich hier Links zu wichtigen Software-Projekten für die RP6Base und die M32 aufgelistet. Wichtig war mir dabei, dass es sich um direkt nutzbare und vollständige Programme oder Libraries handelt.

... kann gern ergänzt werden ...

RP6 Base

• Library:
  • Minimale Lib für den RP6
  • RP6uart_2 Lib
• LCD Ansteuerung (Demo, Library):
  • LCD an RP6 Base
• Servoansteuerung (Grundlagen, Demos, Library):
  • RP6 Servo Ansteuerung
  • Domino Day für den RP6
  • Minimallösung Servo-Sensor
  • Libverträgliche Servo-ISR
  • RP6Base Library für 8 Servos
• Ansteuerung externer I2C-Hardware (Demo):
  • RP6 Beispiel RTC PCF8583
  • RP6 Beispiel Devantech CMPS03
• Kamera Minimallösung (Demo):
  • Minimallösung Kamera für den RP6
• Kamera-Projekt (Demo):
  • RP6Base Video Grabber 1
• Clock (Library):
  • RP6 Einfache Clock Library
• DCF77-Decoder/Clock (Library):
  • RP6 DCF77 Library
• Linienfolger (Demo):
  • RP6 Linienfolger
• PC-Verbindung über Bluetooth (Grundlagen):
  • RP6 Uart Adapter für BTM222
• PC-Fernsteuerung (Demo):
  • RP6 und Funk
  • RP6 Remotrol 1.3
  • Gemeinschaftsprojekt RP6 Remotrol 2.0
• RC-Fernsteuerung (Demo):
  • RP6 und RC
  • Fernsteuerung für den RP6
• IR-Fernsteuerung (Demo):
  • RP6_TV_ Remote
  • Servos mittels TV-Remote steuern
• IR-Kommunikation (Demo):
  • Einfache IR Kommunikation für den RP6
• RP6 und BASCOM (Demo):
  • RP6 mit BASCOM (kleiner Anfang)
  • RP6 mit BASCOM und Fernbedienung RC5
• RP6 und LabView (Demo):
  • Der Robby und LabView
• Morse-Code senden/empfangen (Demo, Library):
  • RP6 - Morse-Code
• Verschiedenes:
  • Maussensor an RP6
  • Feuerwehrbot Roboterwettbewerb
  • Projekt RP6 mit Snake Vision
  • RP6 und M32 Simulator
  • ...

CONTROL M32

• Library:
  • RP6Control M32 Library Version 1.31beta
  • RP6uart_2 Lib
• Servoansteuerung (Library):
  • RP6Control M32 Library für 8 Servos
• Ansteuerung des zweiten SPI-EEPROMs (Library):
  • RP6Control Library für 2. SPI-EEPROM (IC5)
• Messgeräte (Demo):
  • RP6Control M32 Rechteck Generator
  • RP6Control M32 Impulslängen Messgerät
• Kamera-Projekt (Demo):
  • RP6Control M32 Video Zeilenzähler 1
  • RP6Control M32 Video Grabber 1
  • RP6Control M32 Helligkeits Sensor
• TRX433 (CS-8 C, 190045, Library):
  • RP6Control Lib für den 433 MHz Transceiver CS-8 C
• Clock (Library):
  • RP6 Einfache Clock Library
• DCF77-Decoder/Clock (Library):
  • RP6 DCF77 Library
• Spiele (Demo):
  • RP6 Sammlung von Spielen und anderen Mini-Programmen
• PC-Fernsteuerung (Demo):
  • RP6 Remotrol 1.3
  • Gemeinschaftsprojekt RP6 Remotrol 2.0
• Morse-Code senden/empfangen (Demo, Library):
  • RP6 - Morse-Code
• Verschiedenes:
  • RP6 und M32 Simulator
  • ...

RP6 CCPRO M128

Die RP6 CCPRO M128 Erweiterungsplatine (191563) hat zunächst keinen Microcontroller an Bord. Man muß daher das C-Control PRO MEGA128 Modul (198219) mit bestellen. Es gehört zum C-Control PRO System von CONRAD und enthält einen ATmega128 Microcontroller. Das CCPRO MEGA128 Modul wird in CompactC oder BASIC programmiert. Die Programme werden als Byte-Code von der IDE in das Modul geladen und dort von einem Byte-Code-Interpreter ausgeführt.

Demo-Programme

Die RP6 CCPRO M128 Demo Programme sind hier zu finden.

CompactC

Hier ein Beispiel in CompactC:

// WICHTIG: Immer die RP6CCLib mit einbinden:
#include "../../RP6CCLib/RP6CCLib.cc"

void main(void)
{
    // WICHTIG! Immer als erstes aufrufen:
	RP6_CCPRO_Init(); // Auf Startsignal warten, LCD und andere Dinge initialisieren !

    // ------------------------------------------------------

    // Zwei Zeilen Text mit dem LCD anzeigen:
    showScreenLCD("RP6 CCPRO M128", "Hello World!");

    // Zweimal piepsen:
    beep(200,300,100);   // Format: beep (<tonhöhe>, <dauer>, <pause>)
    beep(100,100,100);

    // 2 Sekunden Pause:
    AbsDelay(2000);

    // Untere Zeile im LCD löschen:
    clearPosLCD(1,0,16);


    // ------------------------------------------------------
    // Lauflicht:
    byte runLight, dir;   // Variablen deklarieren
    runLight = 1;  // Lauflicht Variable
    dir = 0;       // Laufrichtung des Lauflichtes
    while(true)
    {
		// LEDs setzen:
		setLEDs(runLight);

        // Laufrichtung wechseln wenn die äusseren LEDs erreicht wurden:
		if(runLight >= 16) {
            dir = 1;
            // Laufrichtung im LCD anzeigen:
            setCursorPosLCD(1,4);
            printLCD("<<<<----");
        }
		else if (runLight <= 1) {
			dir = 0;
            // Laufrichtung im LCD anzeigen:
            setCursorPosLCD(1,4);
            printLCD("---->>>>");
        }

		// LED Bit weiter "shiften" - nach links oder rechts, je nach Richtung:
		if(dir == 0)
			runLight = runLight << 1;
		else
			runLight = runLight >> 1;

        // 150ms Pause:
        AbsDelay(150);
    }
}

BASIC

Hier das selbe Beispiel in BASIC:

' WICHTIG: Immer die RP6CCLib mit einbinden:
#include "../../RP6CCLib/RP6CCLib.cbas"

Sub main()
    Dim runLight, dir As Byte  ' Variablen deklarieren

    ' WICHTIG! Immer als erstes aufrufen:
	RP6_CCPRO_Init()  ' Auf Startsignal warten, LCD und andere Dinge initialisieren!

    ' ------------------------------------------------------

    ' Zwei Zeilen Text mit dem LCD anzeigen:
    showScreenLCD("RP6 CCPRO M128", "Hello World!")

    ' Zweimal piepsen:
    beep(200,300,100)   ' Format: beep (<tonhöhe>, <dauer>, <pause>)
    beep(100,100,100)

    ' 2 Sekunde Pause:
    AbsDelay(2000)

    ' Untere Zeile im LCD löschen:
    clearPosLCD(1,0,16)


    ' ------------------------------------------------------
    ' Lauflicht:

    runLight = 1  ' Lauflicht Variable
    dir = 0       ' Laufrichtung des Lauflichtes
    Do While True
        setLEDs(runLight)  ' LEDs setzen

        ' Laufrichtung wechseln wenn die äusseren LEDs erreicht wurden:
		If runLight >= 16 Then
            dir = 1
            ' Laufrichtung im LCD anzeigen:
            setCursorPosLCD(1,4)
            printLCD("<<<<----")
		Else
            If runLight <= 1 Then
              dir = 0
              ' Laufrichtung im LCD anzeigen:
              setCursorPosLCD(1,4)
              printLCD("---->>>>")
            End If
        End If

		' LED Bit weiter "shiften" - nach links oder rechts, je nach Richtung:
		If dir = 0 Then
			runLight = runLight << 1
		Else
			runLight = runLight >> 1
        End If

        AbsDelay(150)  ' 150ms Pause
    End While
End Sub

Library

Die RP6 CCPRO M128 Library besteht aus den beiden Dateien RP6CClib.cc (CompactC) und RP6CClib.cbas (BASIC). Ihr Inhalt ist identisch.

Versionen

Hier eine Tabelle der (mir) bekannten Library Versionen der CCPRO M128:

Bug-Report

Die Funktion void RP6_readRegisters(byte adr, byte start_reg, byte readBuffer[], byte reg_count) der RP6CClib liest "reg_count" Register des Controllers auf dem RP6 Mainboard.

In diesem Teil:

    I2C_Start();
    I2C_Write(adr+1);
    byte i;
    for(i=0;i<reg_count;i++)
        readBuffer[i] = (I2C_Read_ACK());
    readBuffer[i+1] = (I2C_Read_NACK());
    I2C_Stop();

... werden die Register eingelesen.

Ist reg_count z.B. 10 (10 Register sollen gelesen werden), werden mit I2C_Read_ACK() die Register in readBuffer[0] bis readBuffer[9] abgelegt. Danach wird mit I2C_Read_NACK() noch das 11. Register in readBuffer[11] abgelegt. readBuffer[10] bleibt unberührt. Damit funktioniert diese Funktion zwar (d.h. in readBuffer[0..9] sind die gewünschten 10 Register vorhanden), aber es findet ein unnötiger Lesezyklus zusätzlich statt.

Man kann die RP6CClib.cc so anpassen:

    I2C_Start();
    I2C_Write(adr+1);
    byte i;
    for(i=0;i<(reg_count-1);i++)
        readBuffer[i] = (I2C_Read_ACK());
    readBuffer[i] = (I2C_Read_NACK());
    I2C_Stop();

In der RP6CClib.cbas sieht das so aus:

    For i=0 To reg_count-2
        readBuffer(i) = I2C_Read_ACK()
    Next
    readBuffer(i) = I2C_Read_NACK()

Konfiguration

Die wesentlichen Hardware-Konfigurationen des RP6 finden sich am Anfang der M128 Library (RP6CClib). Dort steht eine Festlegung zur:

• Encoder-Auflösung

Port-Verwendung

Am Anfang der M128 Library (RP6CClib) werden Bezeichnungen für einige Portpins der RP6 CCPRO M128 definiert, siehe Abschnitt "C-Control Standard Port Konfiguration auf dem RP6 CCPRO M128 Modul". Diese Bezeichnungen kann man anstelle der Port-Bit Nummern verwenden, um das Programm selbsterklärender zu machen. Weitere Definitionen am Anfang der M128 Library:

• Port On/Port Off
• LF, CR, SPACE
• LED1..LED6

Die Festlegungen zur Verwendung der Ports des RP6 CCPRO M128 Microcontrollers finden sich am Ende der M128 Library in der Funktion RP6_CCPRO_Init(). Dort wird auch noch Folgendes gemacht:

• SPI initialisieren
• Schieberegister zurücksetzen
• Serielle Schnittstelle initialisieren
• I2C Modul initialisieren
• LCD initialisieren

Hier eine Tabelle mit den Port-Definitionen der M128:

Erklärung der Spalten:
Port        -> Atmel Portpin Bezeichnung
Name        -> Atmel Funktionsbezeichnung
In/Out      -> Eingang (In) oder Ausgang (Out)
Pullup      -> Falls Eingang: Pullup ein- (1) oder ausgeschaltet (0)
Wert        -> Falls Ausgang: Logikpegel high (1) oder low (0)
Port-Bit    -> CCPRO Port-Bit Nummer (0..52) 
Bezeichnung -> Portpin Bezeichnung der Library
Stecker     -> Portpin verfügbar an STECKER: Pin
Anmerkungen -> Kommentare

Zeichen:
*    Standard-Belegung! Über Jumper/Lötbrücke änderbar.
**   Pullup-Widerstand 100 kOhm!
²    Über Serienwiderstand 470 Ohm

Timer-Nutzung

Die Nutzung der Timer wird in der M128 Library in der Funktion RP6_CCPRO_Init() am Ende der Datei RP6CClib.cc oder RP6CClib.cbas festgelegt. Dort steht jedoch nur der Hinweis auf die Nutzung von Timer 3 für den Piezo Tongeber.

Timer 0

Frei für die eigene Nutzung.

Timer 1

Frei für die eigene Nutzung.

Timer 2

Interne CCPRO Zeitbasis (10ms Tick), z.B. für die Clock Funktion und die Thread-Ablaufsteuerung. Timer 2 kann vom eigenen Programm nicht anders konfiguriert werden, man kann aber den 10ms Tick im eigenen Programm nutzen.

Timer 3

Timer 3 wird in der Library für den Piezo Tongeber verwendet. Nutzt man die Funktionen beep(), beep_t() und die Macros sound(), sound_off() und tone() NICHT, kann man Timer 3 auch anders konfigurieren und nutzen.

C-Control PRO

C-Control PRO (CCPRO) ist eine Hardware- und Programmierumgebung von CONRAD. Sie ist angepaßt an die CCPRO Module MEGA32 und MEGA128. Das CCPRO MEGA128 Modul arbeitet auch auf der RP6 CCPRO M128 Erweiterungsplatine.

IDE

Die neueste Version der CCPRO-IDE und das CCPRO-Handbuch sind hier zu finden.

Um die Programmierung des C-Control PRO MEGA128 Moduls kennenzulernen, kann man sich auch die Demo-Programme ansehen. Achtung: Sie laufen nicht ohne Änderungen auf der RP6 CCPRO M128 Erweiterungsplatine!

Projekte

Derzeit gibt es nur ein interessantes Projekt als "Alternative" für die CCPRO IDE.

... kann gern ergänzt werden ...

CCPro-Loader

Hier gibt es den CCPro-Loader. Mit diesem Programm von messier kann man HEX-Dateien, die man mit anderen Programmiersprachen erstellt hat, in das C-Control PRO MEGA128 Modul laden, ohne den Bootloader zu zerstören. Das eröffnet die Möglichkeit, das Modul nicht nur in CompactC oder BASIC (d.h. in Bytecode-Interpreter Sprachen) zu programmieren, sondern auch z.B. mit GCC oder BASCOM.

Projekte

Ohne Anspruch auf Vollständigkeit habe ich hier Links zu wichtigen Software-Projekten für die RP6 CCPRO M128 aufgelistet. Wichtig war mir dabei, dass es sich um direkt nutzbare und vollständige Programme oder Libraries handelt.

... kann gern ergänzt werden ...

CompactC

• Stopwatches (Library):
  • CCPRO M128 Stopwatches
• DCF77-Decoder/Clock (Library):
  • CCPRO M128 DCF77 Decoder Teil 1 und Teil 2
  • CCPRO M128 DCF Clock Teil 1 und Teil 2
• Servo-Ansteuerung (Demo):
  • CCPRO M128 Demo Servo Ansteuerung
• PC-Fernsteuerung (Demo):
  • RP6 Remotrol 1.3
  • Gemeinschaftsprojekt RP6 Remotrol 2.0
• Morse-Code senden/empfangen (Demo, Library):
  • RP6 - Morse-Code

BASIC

• DCF77-Decoder/Clock (Library):
  • CCPRO M128 DCF77 Decoder Teil 1 und Teil 2
  • CCPRO M128 DCF Clock Teil 1 und Teil 2
• Servo-Ansteuerung (Demo):
  • CCPRO M128 Demo Servo Ansteuerung

Erfahrungsberichte

... kann gerne ergänzt werden ...

Siehe auch

• RP6
• RP6v2
• RP6 - Morse-Code
• CCRP5
• Yeti
• Asuro
• C't-Bot

Weblinks

• AREXX Support Forum
• C-Control PRO Forum
• Roboternetz RP6 Forum
• RP6 FlashWriter
• RP6 Remotrol

• JaWiki: RP6
• Eclipse mit WinAVR

• HTW Berlin: Robotik-Projekt
• FH-Wiesbaden: Anwendung der Prozessdatenverarbeitung - Home
• FH-Wiesbaden: Anwendung der Prozessdatenverarbeitung - Doku
• FEEIT, Skopje Macedonia: H&S 2011
• Uni Regensburg: Bacholorarbeit "LabView-Fernsteuerungs-Tool mit diversen Routinen"

Autoren

--Sloti 22:23, 29. Dez 2007 (CET)

--Tobias1 18:30, 06. Apr 2010 (CET)

--Dirk 17:03, 13. Jun 2012 (CET)