my_printf ist ein in der Funktionalität reduzierter Ersatz für den jedem C-Compiler beiliegenden
printf und ist speziell für die Benutzung in Verbindung mit Mikrocontrollern gedacht.
my_printf macht immer dann Sinn, wenn es darum geht Flashspeicher zu sparen und ermöglicht den Einsatz auf Mikrocontrollersystemen
ab ca. 2 kByte Flashspeicher.
Die Syntax von my_printf : void my_printf(const char *s,...);
Prototypdeklaration in : ../include/my_printf.h
In der speichersparsamsten Version verfügt my_printf über keine Ausgabemöglichkeit von
float oder double, ein jedoch vom
Standard abweichendes Umwandlungszeichen %k ermöglicht es, Pseudo-Kommazahlen auszugeben.
my_printf ist gespeichert im Verzeichnis ../src in den Quelltextvarianten:
- my_printf.c (für 8 Bit-, 32-Bit- und PC-Systeme)
- my_printf32.c (nur für 8-Bit Systeme
- my_printf_float.c
Um my_printf innerhalb eines Programms zur Verfügung zu haben, muss entsprechend der gewünschten Funktionalität die benötigte Datei mit dem
"Hauptprogramm" compiliert und hinzugelinkt werden. Bei Verwendung der hier benutzten Makefile Vorlagen wird dies erreicht durch eine Angabe
im Makefile von:
SRCS += ../src/my_printf.c
Die zu den verschiedenen my_printf gehörenden Header-Dateien ist für alle Varianten unabhängig der Funktionalität gleich:
#include "my_printf.h"
my_printf benötigt zur Ausgabe in einer der zu einem Programmprojekt gehörenden Dateien eine Funktion namens:
void my_putchar(char ch);
my_printf bedient sich dieser Funktion zur Zeichenausgabe. Soll bspw. ein Programm die Ausgaben auf der seriellen Schnittstelle vornehmen
gibt es in einer der Dateien wahrscheinlich eine Funktion ähnlich dieser:
void uart_putchar(char ch);
Um nun Ausgabefunktion nutzen zu können, könnte ein einfaches Programm folgendermassen aussehen:
#include <avr/io.h>
#include "uart_all.h"
#include "my_printf.h"
#define printf my_printf
/* --------------------------------------------------------
my_putchar
wird von my-printf aufgerufen und hier muss
eine Zeichenausgabefunktion angegeben sein, auf das
printf dann schreibt !
-------------------------------------------------------- */
void my_putchar(char ch)
{
uart_putchar(ch);
}
int main(void)
{
uart_init();
printf("\n\r Hallo Welt\n\r");
while(1);
}
Im gezeigten Beispiel wird die Zeile
#define printf my_printf
dazu genutzt, um im gesamten Programm printf anstelle von my_printf schreiben zu können und somit bereits bestehende Programme
mit my_printf (anstelle von printf aus stdio.h) verwenden zu können. Die originale printf Funktion ist nach diesem define nicht mehr verfügbar.
 Umwandlungszeichen my_printf
|
Zeichen
|
Datentyp
und Darstellung
|
|
%d
|
Integer als dezimale Zahl ausgeben (int ist 16-Bit Wert auf einem 8-Bit System, ein 32-Bit Wert auf einem 32-Bit Systemen
|
%l
|
nur bei printf32.c : 32-Bit Integerwert ausgeben (verfügbar für AVR, STM8 und MCS-51)
|
%c
|
Ausgabe eines char als (Ascii)-Zeichen
|
%k
|
(Pseudo-Kommazahl) Integerwert mit eingesetztem Dezimalpunt ausgeben, auf 32-Bit Systemen oder bei my_printf32
als 32-Bit Wert, ansonsten als 16-Bit Wert. Mit dem Wert in der globaler Variable printfkomma wird
angegeben, an welcher Position bei der Ausgabe ein Dezimalpunkt eingefügt wird.
|
%f
|
nur bei my_printf_float.c, Ausgabe eines (float) Gleitkommawertes. Ein Punkt zur Angabe der Nachkommastellen wird
interpretiert
|
%s
|
Zeichenkette (String) ausgeben
|
%x
|
Integer als hexadezimale Zahl ausgeben
|
%%
|
Ausgabe des Prozentzeichens
|
Beispiel:
#define printf my_printf
int a,a2,b,c;
printf("\n\r ASCII-Zeichen '%c' = dezimal %d = hexadezimal 0x%x\n\r", 'M', 'M', 'M');
a= 42; b= 13;
// Variable a um eine Zehnerstelle nach links,
// um spaeter eine Nachkommastelle anzeigen zu koennen
a2= a*100;
c= a2 / b;
printfkomma= 2;
printf(" %d / %d = %k", a, b, c);
Ausgabe:
ASCII-Zeichen 'M' = dezimal 77 = hexadezimal 0x4D
42 / 13 = 3.23
|