arduino / arduino/ArduinoCore-API

SPI API add void transfer(const void *tx_buffer, void *rx_buffer, size_t count);

Offen
#243 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement
Vorherrschende Sprache
C++
Sterne
306
Forks
150
PR-Merge-Kennzahlen
Keine gemergten PRs in 30 T.

Beschreibung

### API component

SPI API

### Description

SPI API add
```
virtual void transfer(const void *tx_buffer, void *rx_buffer, size_t count);
```
[Expand SPI API and Functionality for High Speed Devices](https://github.com/arduino/ArduinoCore-API/discussions/189)

### Is this a breaking change?

Unlikely

### Additional information

This is really a missing API method, it doesn't make sense to have only a single buffer for both transmit and receive, as DMA hardware normally works in 2 buffers.
The plain old
https://github.com/arduino/ArduinoCore-API/blob/master/api/HardwareSPI.h#L112
```
virtual void transfer(void *buf, size_t count) = 0;
```
forces hacks such as:
- allocate a temporary buffer
- do the DMA transfers receiving into the temporary buffer
- copy that temporary buffer data back into the address pointed by *buf*
wasting both memory and cpu cycles

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Rechercherichtung

Beginne bei api/HardwareSPI.h mit der bestehenden Deklaration für die Übertragung in einem einzelnen Puffer und lies dann die verknüpfte Diskussion, um den vorgesehenen Umfang der SPI API zu verstehen. Verfolge die betroffenen API-Implementierungen und Verifizierungspfade, bevor du die Schnittstelle änderst. Erledigt ist die Aufgabe, wenn die virtuelle Transfer-Signatur mit zwei Puffern durchgängig unterstützt wird, ohne den Workaround mit dem temporären Puffer.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
cpp
Bereich
api, embedded-iot
Issue-Typ
Feature
Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.