Implementierung der erweiterten Hardwarefunktionen für den WGR-V-Prozessor. Mehr ...

#include "wgrhal.h"
#include "wgrhal_ext.h"

Datenstrukturen
union	header

Makrodefinitionen
#define	ENOMEM 12

#define	NALLOC 1024

Typdefinitionen
typedef int	ptrdiff_t

typedef long	Align

typedef union header	Header

Funktionen
uint64_t	mult_calc_64 (uint32_t multiplicand, uint32_t multiplier)
	Berechnet das 64-Bit-Ergebnis einer Multiplikation.

uint32_t	mult_calc (uint32_t multiplicand, uint32_t multiplier)
	Berechnet das 32-Bit-Ergebnis einer Multiplikation.

int32_t	div_calc (uint32_t dividend, uint32_t divisor, div_result_t *result)
	Führt eine Division durch und liefert Quotient und Rest.

uint32_t	div_calc_quotient (uint32_t dividend, uint32_t divisor)
	Berechnet den Quotienten einer Division.

uint32_t	div_calc_remainder (uint32_t dividend, uint32_t divisor)
	Berechnet den Rest einer Division.

void	spi_enable (void)
	Aktiviert die SPI-Schnittstelle.

void	spi_disable (void)
	Deaktiviert die SPI-Schnittstelle.

void	spi_automatic_cs (bool active)
	Aktiviert oder deaktiviert den automatischen Chipselect (CS) der SPI-Schnittstelle.

void	spi_cs (uint32_t active)
	Setzt den SPI-Chipselect-Zustand.

void	spi_set_clock_offset (uint32_t offset)

void	spi_set_clock_divider (uint32_t divider)
	Konfiguriert den Taktteiler der SPI-Schnittstelle.

uint32_t	spi_get_status (void)
	Liest den aktuellen Status der SPI-Schnittstelle.

uint32_t	spi_fifo_full (void)
	Prüft, ob das SPI-FIFO voll ist.

uint32_t	spi_is_ready (void)
	Prüft, ob die SPI-Schnittstelle bereit ist.

uint32_t	spi_is_busy (void)
	Prüft, ob die SPI-Schnittstelle beschäftigt ist.

uint32_t	spi_rx_full (void)
	Prüft, ob der SPI-Empfangspuffer voll ist.

uint32_t	spi_rx_empty (void)
	Prüft, ob der SPI-Empfangspuffer leer ist.

uint32_t	spi_tx_full (void)
	Prüft, ob der SPI-Sende-Puffer voll ist.

uint32_t	spi_tx_empty (void)
	Prüft, ob der SPI-Sende-Puffer leer ist.

int32_t	spi_wait_rx_data (uint32_t timeout_ms)
	Wartet darauf, dass Daten im SPI-Empfangspuffer verfügbar sind.

int32_t	spi_write_byte (uint8_t data, uint32_t timeout_ms)
	Sendet ein Byte über die SPI-Schnittstelle.

int32_t	spi_read_byte (uint8_t *data, uint32_t timeout_ms)
	Liest ein Byte von der SPI-Schnittstelle.

int32_t	spi_write_buffer (const uint8_t *buf, uint32_t length, uint32_t timeout_ms)
	Sendet einen Datenpuffer über SPI.

int32_t	spi_write_uint32 (uint32_t value, uint32_t timeout_ms)
	Sendet einen 32-Bit-Wert über SPI.

int32_t	spi_read_buffer (uint8_t *buf, uint32_t length, uint32_t timeout_ms)
	Liest einen Datenpuffer von der SPI-Schnittstelle.

int32_t	ws2812_set_color (uint8_t led, rgb_color_t color)
	Setzt die Farbe einer WS2812B LED.

rgb_color_t	ws2812_get_color (uint8_t led)
	Liest die aktuell gesetzte Farbe einer WS2812B LED.

int32_t	ws2812_write_all (const rgb_color_t colors[8])
	Schreibt die Farben aller 8 WS2812B LEDs.

int32_t	ws2812_fill (rgb_color_t color)
	Füllt alle WS2812B LEDs mit einer einheitlichen Farbe.

void	ws2812_clear (void)
	Schaltet alle WS2812B LEDs aus.

int	pwm_precompute_notes (void)
	Berechnet Notenparameter für den PWM-Modus.

void	pwm_play_note (note_t note, uint32_t octave)
	Spielt eine bestimmte Note in einer festgelegten Oktave über den PWM aus.

void	pwm_free_note_buffer (void)
	Gibt den für PWM-Noten reservierten Speicher frei.

void	free (void *ap)
	Gibt einen zuvor allokierten Speicherblock frei.

uint32_t	heap_free_space (void)
	Ermittelt den aktuell freien Heap-Speicher.

void *	malloc (uint32_t nbytes)
	Allokiert einen Speicherblock.

void *	realloc (void *ptr, uint32_t size)
	Ändert die Größe eines allokierten Speicherblocks.

void *	calloc (uint32_t nmemb, uint32_t size)
	Allokiert einen Speicherblock für ein Array und initialisiert diesen mit 0.

void	ssd1351_inv (void)
	Schaltet den Invertierungsmodus des Displays um.

void	ssd1351_send_data (const uint8_t *data, size_t len)
	Sendet einen Datenpuffer an das SSD1351 Display.

void	ssd1351_send_command (uint8_t cmd)
	Sendet einen einzelnen Befehl an das SSD1351 Display.

void	ssd1351_send_command_with_data (uint8_t cmd, const uint8_t *data, size_t len)
	Sendet einen Befehl mit zugehörigen Daten an das SSD1351 Display.

void	ssd1351_send_commands (const uint8_t *buf, size_t len)
	Sendet eine Folge von Befehlen an das SSD1351 Display.

void	ssd1351_init (void)
	Initialisiert das SSD1351 Display.

void	ssd1351_set_position (uint8_t x, uint8_t y, uint8_t w, uint8_t h)
	Setzt die Schreibposition und den Bereich im SSD1351 Display.

void	draw_char_cell_custom (uint8_t row, uint8_t col, char c, uint16_t fg, uint16_t bg)
	Zeichnet ein einzelnes Zeichen in einer Terminalzelle mit individuellen Farben.

void	draw_char_cell (uint8_t row, uint8_t col, char c)
	Zeichnet ein einzelnes Zeichen in einer Terminalzelle.

void	clear_terminal_row (uint8_t row)
	Löscht eine bestimmte Terminalzeile.

void	clear_terminal (void)
	Löscht das gesamte Terminal.

void	draw_status_bar (const char *text, uint16_t bg_color, uint16_t fg_color)
	Zeichnet eine Statusleiste am oberen Displayrand.

void	terminal_native_scroll (void)
	Scrollt das Terminal um eine Zeile.

void	terminal_put_char (char c)
	Gibt ein einzelnes Zeichen im Terminal aus und aktualisiert den Cursor.

void	terminal_print (const char *str)
	Gibt einen String im Terminal aus.

void	terminal_print_col (const char *text, uint16_t color)
	Gibt einen String im Terminal mit einer bestimmten Textfarbe aus.

void	print_ok_res (const char *label, int32_t value)
	Gibt ein Label und einen numerischen Wert (als String) aus, farblich als OK markiert.

void	print_ok (const char *label)
	Gibt ein Label als OK-Nachricht aus.

void	print_error (const char *label)
	Gibt ein Label als Fehlernachricht aus.

void	terminal_set_text_color (uint16_t color)
	Setzt die Textfarbe des Terminals.

void	terminal_set_bg_color (uint16_t color)
	Setzt die Hintergrundfarbe des Terminals.

void	terminal_draw_text (uint8_t row, uint8_t col, const char *str, uint16_t fg, uint16_t bg)
	Zeichnet einen Text an einer bestimmten Terminalposition mit definierten Vorder- und Hintergrundfarben.

void	terminal_draw_text_default (uint8_t row, uint8_t col, const char *str)
	Zeichnet einen Text an einer bestimmten Terminalposition mit Standardfarben.

void	ssd1351_fill_screen (uint16_t color)
	Füllt das gesamte Display mit einer Farbe.

void	ssd1351_draw_pixel (uint8_t x, uint8_t y, uint16_t color)
	Zeichnet einen einzelnen Pixel an einer bestimmten Position.

void	terminal_init (void)
	Initialisiert das Terminal (Display) des SSD1351.

uint32_t	ssd1351_cursor_x (void)
	Gibt die aktuelle X-Position des Cursors im SSD1351 Terminal zurück.

Variablen
const uint8_t	note_freq_halfbase [12]
	Frequenztabelle für Noten (Halbton-Basis).

int	errno

char	_heap_start

char	_heap_end

Ausführliche Beschreibung

Implementierung der erweiterten Hardwarefunktionen für den WGR-V-Prozessor.

Diese Datei enthält die Implementierung der in wgrhal_ext.h deklarierten Funktionen. Sie erweitert die Basisfunktionen um Hardwareunterstützung für:

Multiplikation und Division
SPI-Kommunikation
WS2812B LED-Steuerung
PWM-basierte Tonerzeugung
Dynamischen Speicher (malloc)
SSD1351 Display mit Terminal-Funktionen

Einige interne (statische) Funktionen werden zusätzlich für die Speicherverwaltung und spezifische Hardwaresteuerungen verwendet.

Definiert in Datei wgrhal_ext.c.

Makro-Dokumentation

◆ ENOMEM

#define ENOMEM 12

Definiert in Zeile 487 der Datei wgrhal_ext.c.

◆ NALLOC

#define NALLOC 1024

Definiert in Zeile 531 der Datei wgrhal_ext.c.

Dokumentation der benutzerdefinierten Typen

◆ Align

typedef long Align

Definiert in Zeile 514 der Datei wgrhal_ext.c.

◆ Header

typedef union header Header

Definiert in Zeile 526 der Datei wgrhal_ext.c.

◆ ptrdiff_t

typedef int ptrdiff_t

Definiert in Zeile 482 der Datei wgrhal_ext.c.

Dokumentation der Funktionen

◆ calloc()

void * calloc	(	uint32_t	nmemb,
		uint32_t	size
	)

Allokiert einen Speicherblock für ein Array und initialisiert diesen mit 0.

Parameter

nmemb	Anzahl der Elemente.
size	Größe eines Elements in Byte.

Rückgabe: Zeiger auf den allokierten Speicher oder NULL bei Fehler.

Definiert in Zeile 662 der Datei wgrhal_ext.c.

◆ clear_terminal()

void clear_terminal ( void )

Löscht das gesamte Terminal.

Definiert in Zeile 878 der Datei wgrhal_ext.c.

◆ clear_terminal_row()

void clear_terminal_row ( uint8_t row )

Löscht eine bestimmte Terminalzeile.

Parameter

row	Zu löschende Zeile.

Definiert in Zeile 870 der Datei wgrhal_ext.c.

◆ div_calc()

int32_t div_calc	(	uint32_t	dividend,
		uint32_t	divisor,
		div_result_t *	result
	)

Führt eine Division durch und liefert Quotient und Rest.

Parameter

dividend	Dividend.
divisor	Divisor.
result	Zeiger auf eine div_result_t-Struktur, in der Quotient und Rest gespeichert werden.

Rückgabe: 0 bei Erfolg, -1 bei Fehler (z.B. Division durch 0 oder ungültiger Pointer).

Definiert in Zeile 52 der Datei wgrhal_ext.c.

◆ div_calc_quotient()

uint32_t div_calc_quotient	(	uint32_t	dividend,
		uint32_t	divisor
	)

Berechnet den Quotienten einer Division.

Parameter

dividend	Dividend.
divisor	Divisor.

Rückgabe: Quotient oder -1 bei Division durch 0.

Definiert in Zeile 71 der Datei wgrhal_ext.c.

◆ div_calc_remainder()

uint32_t div_calc_remainder	(	uint32_t	dividend,
		uint32_t	divisor
	)

Berechnet den Rest einer Division.

Parameter

dividend	Dividend.
divisor	Divisor.

Rückgabe: Rest oder -1 bei Division durch 0.

Definiert in Zeile 87 der Datei wgrhal_ext.c.

◆ draw_char_cell()

void draw_char_cell	(	uint8_t	row,
		uint8_t	col,
		char	c
	)

Zeichnet ein einzelnes Zeichen in einer Terminalzelle.

Parameter

row	Zeile.
col	Spalte.
c	Zu zeichnendes Zeichen.

Definiert in Zeile 865 der Datei wgrhal_ext.c.

◆ draw_char_cell_custom()

void draw_char_cell_custom	(	uint8_t	row,
		uint8_t	col,
		char	c,
		uint16_t	fg,
		uint16_t	bg
	)

Zeichnet ein einzelnes Zeichen in einer Terminalzelle mit individuellen Farben.

Parameter

row	Zeile.
col	Spalte.
c	Zu zeichnendes Zeichen.
fg	Vordergrundfarbe.
bg	Hintergrundfarbe.

Definiert in Zeile 833 der Datei wgrhal_ext.c.

◆ draw_status_bar()

void draw_status_bar	(	const char *	text,
		uint16_t	bg_color,
		uint16_t	fg_color
	)

Zeichnet eine Statusleiste am oberen Displayrand.

Parameter

text	Anzuzeigender Text.
bg_color	Hintergrundfarbe.
fg_color	Textfarbe.

Definiert in Zeile 888 der Datei wgrhal_ext.c.

◆ free()

void free ( void * ptr )

Gibt einen zuvor allokierten Speicherblock frei.

Parameter

ptr	Zeiger auf den Speicherblock.

Definiert in Zeile 598 der Datei wgrhal_ext.c.

◆ heap_free_space()

uint32_t heap_free_space ( void )

Ermittelt den aktuell freien Heap-Speicher.

Rückgabe: Freier Speicher in Byte.

Definiert in Zeile 533 der Datei wgrhal_ext.c.

◆ malloc()

void * malloc ( uint32_t size )

Allokiert einen Speicherblock.

Parameter

size	Größe des benötigten Speichers in Byte.

Rückgabe: Zeiger auf den allokierten Speicher oder NULL bei Fehler.

Definiert in Zeile 563 der Datei wgrhal_ext.c.

◆ mult_calc()

uint32_t mult_calc	(	uint32_t	multiplicand,
		uint32_t	multiplier
	)

Berechnet das 32-Bit-Ergebnis einer Multiplikation.

Parameter

multiplicand	Erster Faktor.
multiplier	Zweiter Faktor.

Rückgabe: Niederwertiger 32-Bit-Teil des Multiplikationsergebnisses.

Definiert in Zeile 41 der Datei wgrhal_ext.c.

◆ mult_calc_64()

uint64_t mult_calc_64	(	uint32_t	multiplicand,
		uint32_t	multiplier
	)

Berechnet das 64-Bit-Ergebnis einer Multiplikation.

Parameter

multiplicand	Erster Faktor.
multiplier	Zweiter Faktor.

Rückgabe: 64-Bit-Ergebnis der Multiplikation.

Definiert in Zeile 27 der Datei wgrhal_ext.c.

◆ print_error()

void print_error ( const char * label )

Gibt ein Label als Fehlernachricht aus.

Parameter

label Beschriftung.

Definiert in Zeile 997 der Datei wgrhal_ext.c.

◆ print_ok()

void print_ok ( const char * label )

Gibt ein Label als OK-Nachricht aus.

Parameter

label Beschriftung.

Definiert in Zeile 992 der Datei wgrhal_ext.c.

◆ print_ok_res()

void print_ok_res	(	const char *	label,
		int32_t	value
	)

Gibt ein Label und einen numerischen Wert (als String) aus, farblich als OK markiert.

Parameter

label	Beschriftung.
value	Numerischer Wert.

Definiert in Zeile 984 der Datei wgrhal_ext.c.

◆ pwm_free_note_buffer()

void pwm_free_note_buffer ( void )

Gibt den für PWM-Noten reservierten Speicher frei.

Definiert in Zeile 463 der Datei wgrhal_ext.c.

◆ pwm_play_note()

void pwm_play_note	(	note_t	note,
		uint32_t	octave
	)

Spielt eine bestimmte Note in einer festgelegten Oktave über den PWM aus.

Parameter

note	Gewünschte Note (note_t).
octave	Oktave (z.B. 4).

Definiert in Zeile 424 der Datei wgrhal_ext.c.

◆ pwm_precompute_notes()

int pwm_precompute_notes ( void )

Berechnet Notenparameter für den PWM-Modus.

Rückgabe: 0 bei Erfolg, -1 bei Fehler.

Definiert in Zeile 401 der Datei wgrhal_ext.c.

◆ realloc()

void * realloc	(	void *	ptr,
		uint32_t	size
	)

Ändert die Größe eines allokierten Speicherblocks.

Parameter

ptr	Zeiger auf den Speicherblock.
size	Neue Größe in Byte.

Rückgabe: Zeiger auf den neuen Speicherblock oder NULL bei Fehler.

Definiert in Zeile 635 der Datei wgrhal_ext.c.

◆ spi_automatic_cs()

void spi_automatic_cs ( bool active )

Aktiviert oder deaktiviert den automatischen Chipselect (CS) der SPI-Schnittstelle.

Parameter

active true zum Aktivieren, false zum Deaktivieren.

Definiert in Zeile 123 der Datei wgrhal_ext.c.

◆ spi_cs()

void spi_cs ( uint32_t active )

Setzt den SPI-Chipselect-Zustand.

Parameter

active Aktiver Zustand (z. B. 0 oder 1).

Definiert in Zeile 137 der Datei wgrhal_ext.c.

◆ spi_disable()

void spi_disable ( void )

Deaktiviert die SPI-Schnittstelle.

Definiert in Zeile 116 der Datei wgrhal_ext.c.

◆ spi_enable()

void spi_enable ( void )

Aktiviert die SPI-Schnittstelle.

Definiert in Zeile 109 der Datei wgrhal_ext.c.

◆ spi_fifo_full()

uint32_t spi_fifo_full ( void )

Prüft, ob das SPI-FIFO voll ist.

Rückgabe: 1 wenn voll, sonst 0.

Definiert in Zeile 168 der Datei wgrhal_ext.c.

◆ spi_get_status()

uint32_t spi_get_status ( void )

Liest den aktuellen Status der SPI-Schnittstelle.

Rückgabe: Statuswert.

Definiert in Zeile 163 der Datei wgrhal_ext.c.

◆ spi_is_busy()

uint32_t spi_is_busy ( void )

Prüft, ob die SPI-Schnittstelle beschäftigt ist.

Rückgabe: 1 wenn beschäftigt, sonst 0.

Definiert in Zeile 178 der Datei wgrhal_ext.c.

◆ spi_is_ready()

uint32_t spi_is_ready ( void )

Prüft, ob die SPI-Schnittstelle bereit ist.

Rückgabe: 1 wenn bereit, sonst 0.

Definiert in Zeile 173 der Datei wgrhal_ext.c.

◆ spi_read_buffer()

int32_t spi_read_buffer	(	uint8_t *	buf,
		uint32_t	length,
		uint32_t	timeout_ms
	)

Liest einen Datenpuffer von der SPI-Schnittstelle.

Parameter

buf	Zeiger auf den Zielpuffer.
length	Länge des Puffers.
timeout_ms	Zeitlimit in Millisekunden.

Rückgabe: 0 bei Erfolg, -1 bei Fehler.

Definiert in Zeile 284 der Datei wgrhal_ext.c.

◆ spi_read_byte()

int32_t spi_read_byte	(	uint8_t *	data,
		uint32_t	timeout_ms
	)

Liest ein Byte von der SPI-Schnittstelle.

Parameter

data	Zeiger, in den das gelesene Byte gespeichert wird.
timeout_ms	Zeitlimit in Millisekunden.

Rückgabe: 0 bei Erfolg, -1 bei Timeout.

Definiert in Zeile 235 der Datei wgrhal_ext.c.

◆ spi_rx_empty()

uint32_t spi_rx_empty ( void )

Prüft, ob der SPI-Empfangspuffer leer ist.

Rückgabe: 1 wenn leer, sonst 0.

Definiert in Zeile 188 der Datei wgrhal_ext.c.

◆ spi_rx_full()

uint32_t spi_rx_full ( void )

Prüft, ob der SPI-Empfangspuffer voll ist.

Rückgabe: 1 wenn voll, sonst 0.

Definiert in Zeile 183 der Datei wgrhal_ext.c.

◆ spi_set_clock_divider()

void spi_set_clock_divider ( uint32_t divider )

Konfiguriert den Taktteiler der SPI-Schnittstelle.

Parameter

divider Wert des Taktteilers.

Definiert in Zeile 147 der Datei wgrhal_ext.c.

◆ spi_set_clock_offset()

void spi_set_clock_offset ( uint32_t offset )

Definiert in Zeile 142 der Datei wgrhal_ext.c.

◆ spi_tx_empty()

uint32_t spi_tx_empty ( void )

Prüft, ob der SPI-Sende-Puffer leer ist.

Rückgabe: 1 wenn leer, sonst 0.

Definiert in Zeile 198 der Datei wgrhal_ext.c.

◆ spi_tx_full()

uint32_t spi_tx_full ( void )

Prüft, ob der SPI-Sende-Puffer voll ist.

Rückgabe: 1 wenn voll, sonst 0.

Definiert in Zeile 193 der Datei wgrhal_ext.c.

◆ spi_wait_rx_data()

int32_t spi_wait_rx_data ( uint32_t timeout_ms )

Wartet darauf, dass Daten im SPI-Empfangspuffer verfügbar sind.

Parameter

timeout_ms Zeitlimit in Millisekunden.

Rückgabe: 0 bei Erfolg, -1 bei Timeout.

Definiert in Zeile 203 der Datei wgrhal_ext.c.

◆ spi_write_buffer()

int32_t spi_write_buffer	(	const uint8_t *	buf,
		uint32_t	length,
		uint32_t	timeout_ms
	)

Sendet einen Datenpuffer über SPI.

Parameter

buf	Zeiger auf den zu sendenden Puffer.
length	Länge des Puffers.
timeout_ms	Zeitlimit in Millisekunden.

Rückgabe: 0 bei Erfolg, -1 bei Fehler.

Definiert in Zeile 257 der Datei wgrhal_ext.c.

◆ spi_write_byte()

int32_t spi_write_byte	(	uint8_t	data,
		uint32_t	timeout_ms
	)

Sendet ein Byte über die SPI-Schnittstelle.

Parameter

data	Zu sendendes Byte.
timeout_ms	Zeitlimit in Millisekunden.

Rückgabe: 0 bei Erfolg, -1 bei Timeout.

Definiert in Zeile 218 der Datei wgrhal_ext.c.

◆ spi_write_uint32()

int32_t spi_write_uint32	(	uint32_t	value,
		uint32_t	timeout_ms
	)

Sendet einen 32-Bit-Wert über SPI.

Parameter

value	Zu sendender Wert.
timeout_ms	Zeitlimit in Millisekunden.

Rückgabe: 0 bei Erfolg, -1 bei Fehler.

Definiert in Zeile 274 der Datei wgrhal_ext.c.

◆ ssd1351_cursor_x()

uint32_t ssd1351_cursor_x ( void )

Gibt die aktuelle X-Position des Cursors im SSD1351 Terminal zurück.

Rückgabe: X-Koordinate des Cursors.

Definiert in Zeile 1057 der Datei wgrhal_ext.c.

◆ ssd1351_draw_pixel()

void ssd1351_draw_pixel	(	uint8_t	x,
		uint8_t	y,
		uint16_t	color
	)

Zeichnet einen einzelnen Pixel an einer bestimmten Position.

Parameter

x	X-Koordinate.
y	Y-Koordinate.
color	Farbe des Pixels.

Definiert in Zeile 1040 der Datei wgrhal_ext.c.

◆ ssd1351_fill_screen()

void ssd1351_fill_screen ( uint16_t color )

Füllt das gesamte Display mit einer Farbe.

Parameter

color Zu füllende Farbe.

Definiert in Zeile 1026 der Datei wgrhal_ext.c.

◆ ssd1351_init()

void ssd1351_init ( void )

Initialisiert das SSD1351 Display.

Definiert in Zeile 796 der Datei wgrhal_ext.c.

◆ ssd1351_inv()

void ssd1351_inv ( void )

Schaltet den Invertierungsmodus des Displays um.

Definiert in Zeile 741 der Datei wgrhal_ext.c.

◆ ssd1351_send_command()

void ssd1351_send_command ( uint8_t cmd )

Sendet einen einzelnen Befehl an das SSD1351 Display.

Parameter

cmd	Befehlscode.

Definiert in Zeile 763 der Datei wgrhal_ext.c.

◆ ssd1351_send_command_with_data()

void ssd1351_send_command_with_data	(	uint8_t	cmd,
		const uint8_t *	data,
		size_t	len
	)

Sendet einen Befehl mit zugehörigen Daten an das SSD1351 Display.

Parameter

cmd	Befehlscode.
data	Zeiger auf den Datenpuffer.
len	Länge der Daten in Byte.

Definiert in Zeile 771 der Datei wgrhal_ext.c.

◆ ssd1351_send_commands()

void ssd1351_send_commands	(	const uint8_t *	buf,
		size_t	len
	)

Sendet eine Folge von Befehlen an das SSD1351 Display.

Parameter

buf	Zeiger auf den Befehlsbuffer.
len	Länge des Buffers in Byte.

Definiert in Zeile 784 der Datei wgrhal_ext.c.

◆ ssd1351_send_data()

void ssd1351_send_data	(	const uint8_t *	data,
		size_t	len
	)

Sendet einen Datenpuffer an das SSD1351 Display.

Parameter

data	Zeiger auf den Datenpuffer.
len	Länge des Puffers in Byte.

Definiert in Zeile 755 der Datei wgrhal_ext.c.

◆ ssd1351_set_position()

void ssd1351_set_position	(	uint8_t	x,
		uint8_t	y,
		uint8_t	w,
		uint8_t	h
	)

Setzt die Schreibposition und den Bereich im SSD1351 Display.

Parameter

x	Startspalte.
y	Startzeile.
w	Breite des Bereichs.
h	Höhe des Bereichs.

Definiert in Zeile 819 der Datei wgrhal_ext.c.

◆ terminal_draw_text()

void terminal_draw_text	(	uint8_t	row,
		uint8_t	col,
		const char *	str,
		uint16_t	fg_color,
		uint16_t	bg_color
	)

Zeichnet einen Text an einer bestimmten Terminalposition mit definierten Vorder- und Hintergrundfarben.

Parameter

row	Zeile.
col	Spalte.
str	Zu zeichnender Text.
fg_color	Vordergrundfarbe.
bg_color	Hintergrundfarbe.

Definiert in Zeile 1012 der Datei wgrhal_ext.c.

◆ terminal_draw_text_default()

void terminal_draw_text_default	(	uint8_t	row,
		uint8_t	col,
		const char *	str
	)

Zeichnet einen Text an einer bestimmten Terminalposition mit Standardfarben.

Parameter

row	Zeile.
col	Spalte.
str	Zu zeichnender Text.

Definiert in Zeile 1021 der Datei wgrhal_ext.c.

◆ terminal_init()

void terminal_init ( void )

Initialisiert das Terminal (Display) des SSD1351.

Definiert in Zeile 1046 der Datei wgrhal_ext.c.

◆ terminal_native_scroll()

void terminal_native_scroll ( void )

Scrollt das Terminal um eine Zeile.

Definiert in Zeile 907 der Datei wgrhal_ext.c.

◆ terminal_print()

void terminal_print ( const char * str )

Gibt einen String im Terminal aus.

Parameter

str	Zu druckender String.

Definiert in Zeile 968 der Datei wgrhal_ext.c.

◆ terminal_print_col()

void terminal_print_col	(	const char *	text,
		uint16_t	color
	)

Gibt einen String im Terminal mit einer bestimmten Textfarbe aus.

Parameter

text	Zu druckender String.
color	Textfarbe.

Definiert in Zeile 976 der Datei wgrhal_ext.c.

◆ terminal_put_char()

void terminal_put_char ( char c )

Gibt ein einzelnes Zeichen im Terminal aus und aktualisiert den Cursor.

Parameter

c	Zu druckendes Zeichen.

Definiert in Zeile 934 der Datei wgrhal_ext.c.

◆ terminal_set_bg_color()

void terminal_set_bg_color ( uint16_t color )

Setzt die Hintergrundfarbe des Terminals.

Parameter

color Neue Hintergrundfarbe.

Definiert in Zeile 1007 der Datei wgrhal_ext.c.

◆ terminal_set_text_color()

void terminal_set_text_color ( uint16_t color )

Setzt die Textfarbe des Terminals.

Parameter

color Neue Textfarbe.

Definiert in Zeile 1002 der Datei wgrhal_ext.c.

◆ ws2812_clear()

void ws2812_clear ( void )

Schaltet alle WS2812B LEDs aus.

Definiert in Zeile 362 der Datei wgrhal_ext.c.

◆ ws2812_fill()

int32_t ws2812_fill ( rgb_color_t color )

Füllt alle WS2812B LEDs mit einer einheitlichen Farbe.

Parameter

color Farbe, mit der alle LEDs gefüllt werden.

Rückgabe: 0 bei Erfolg, -1 bei Fehler.

Definiert in Zeile 349 der Datei wgrhal_ext.c.

◆ ws2812_get_color()

rgb_color_t ws2812_get_color ( uint8_t led )

Liest die aktuell gesetzte Farbe einer WS2812B LED.

Parameter

led	LED-Index (0-7).

Rückgabe: Aktuelle Farbe als rgb_color_t.

Definiert in Zeile 318 der Datei wgrhal_ext.c.

◆ ws2812_set_color()

int32_t ws2812_set_color	(	uint8_t	led,
		rgb_color_t	color
	)

Setzt die Farbe einer WS2812B LED.

Parameter

led	LED-Index (0-7).
color	Neue Farbe als rgb_color_t.

Rückgabe: 0 bei Erfolg, -1 bei ungültigem LED-Index.

Definiert in Zeile 307 der Datei wgrhal_ext.c.

◆ ws2812_write_all()

int32_t ws2812_write_all ( const rgb_color_t colors[8] )

Schreibt die Farben aller 8 WS2812B LEDs.

Parameter

colors Array von 8 rgb_color_t-Werten.

Rückgabe: 0 bei Erfolg, -1 bei Fehler.

Definiert in Zeile 332 der Datei wgrhal_ext.c.

Variablen-Dokumentation

◆ errno

int errno

Definiert in Zeile 486 der Datei wgrhal_ext.c.

◆ note_freq_halfbase

const uint8_t note_freq_halfbase[12]

Initialisierung:

Frequenztabelle für Noten (Halbton-Basis).

Definiert in Zeile 387 der Datei wgrhal_ext.c.

Datenstrukturen

Makrodefinitionen

Typdefinitionen

Funktionen

Variablen

Ausführliche Beschreibung

Makro-Dokumentation

◆ ENOMEM

◆ NALLOC

Dokumentation der benutzerdefinierten Typen

◆ Align

◆ Header

◆ ptrdiff_t

Dokumentation der Funktionen

◆ calloc()

◆ clear_terminal()

◆ clear_terminal_row()

◆ div_calc()

◆ div_calc_quotient()

◆ div_calc_remainder()

◆ draw_char_cell()

◆ draw_char_cell_custom()

◆ draw_status_bar()

◆ free()

◆ heap_free_space()

◆ malloc()

◆ mult_calc()

◆ mult_calc_64()

◆ print_error()

◆ print_ok()

◆ print_ok_res()

◆ pwm_free_note_buffer()

◆ pwm_play_note()

◆ pwm_precompute_notes()

◆ realloc()

◆ spi_automatic_cs()

◆ spi_cs()

◆ spi_disable()

◆ spi_enable()

◆ spi_fifo_full()

◆ spi_get_status()

◆ spi_is_busy()

◆ spi_is_ready()

◆ spi_read_buffer()

◆ spi_read_byte()

◆ spi_rx_empty()

◆ spi_rx_full()

◆ spi_set_clock_divider()

◆ spi_set_clock_offset()

◆ spi_tx_empty()

◆ spi_tx_full()

◆ spi_wait_rx_data()

◆ spi_write_buffer()

◆ spi_write_byte()

◆ spi_write_uint32()

◆ ssd1351_cursor_x()

◆ ssd1351_draw_pixel()

◆ ssd1351_fill_screen()

◆ ssd1351_init()

◆ ssd1351_inv()

◆ ssd1351_send_command()

◆ ssd1351_send_command_with_data()

◆ ssd1351_send_commands()

◆ ssd1351_send_data()

◆ ssd1351_set_position()

◆ terminal_draw_text()

◆ terminal_draw_text_default()

◆ terminal_init()

◆ terminal_native_scroll()

◆ terminal_print()

◆ terminal_print_col()

◆ terminal_put_char()

◆ terminal_set_bg_color()

◆ terminal_set_text_color()

◆ ws2812_clear()

◆ ws2812_fill()

◆ ws2812_get_color()

◆ ws2812_set_color()

◆ ws2812_write_all()

Variablen-Dokumentation