openamp — zapewnia standardową obsługę przetwarzania asymetrycznego (AMP)

Moduł openamp zapewnia standardową infrastrukturę komunikacji międzyprocesorowej dla MicroPython. Moduł obsługuje wszystkie szczegóły OpenAMP, takie jak konfiguracja współdzielonej tablicy zasobów, inicjalizacja vringów itp. Udostępnia API do korzystania z infrastruktury magistrali RPMsg za pomocą klasy Endpoint oraz zapewnia obsługę zarządzania cyklem życia procesora (LCM), taką jak ładowanie oprogramowania układowego oraz uruchamianie i zatrzymywanie zdalnego rdzenia, za pomocą klasy RemoteProc.

Przykład użycia:

import openamp

def ept_recv_callback(src, data):
    print("Received message on endpoint", data)

# Create a new RPMsg endpoint to communicate with the remote core.
ept = openamp.Endpoint("vuart-channel", callback=ept_recv_callback)

# Create a RemoteProc object, load its firmware and start it.
rproc = openamp.RemoteProc("virtual_uart.elf") # Or entry point address (ex 0x081E0000)
rproc.start()

while True:
    if ept.is_ready():
        ept.send("data")

Funkcje

openamp.new_service_callback(ns_callback: Callable[[str, int], Any]) → None

Ustawia nowe wywołanie zwrotne usługi.

Argument ns_callback to funkcja, która zostanie wywołana, gdy zdalny procesor ogłosi nowe usługi. W tym momencie procesor hosta może zdecydować o utworzeniu ogłoszonego punktu końcowego, jeśli dana usługa jest obsługiwana, lub zignorować ją, jeśli nie jest. Jeśli ta funkcja nie zostanie ustawiona, procesor hosta powinien najpierw zarejestrować punkt końcowy lokalnie, a zostanie on automatycznie powiązany, gdy zdalny procesor ogłosi usługę.

Klasa Endpoint

class openamp.Endpoint(name: str, callback: Callable[[int, bytes], Any], src: int = ENDPOINT_ADDR_ANY, dest: int = ENDPOINT_ADDR_ANY)

Tworzy nowy punkt końcowy RPMsg. Punkt końcowy to dwukierunkowy kanał komunikacyjny pomiędzy dwoma rdzeniami.

Argumenty:

  • name to nazwa punktu końcowego.

  • callback to funkcja wywoływana, gdy punkt końcowy odbierze dane, której przekazywany jest adres źródłowy zdalnego punktu oraz dane jako bajty przekazane przez referencję.

  • src to adres źródłowy punktu końcowego. Jeśli nie zostanie podany, biblioteka przydzieli punktowi końcowemu jeden adres.

  • dest to adres docelowy punktu końcowego. Jeśli punkt końcowy jest tworzony z new_service_callback, należy go podać i musi on odpowiadać adresowi źródłowemu zdalnego punktu końcowego. Jeśli punkt końcowy jest rejestrowany lokalnie, przed ogłoszeniem, adres docelowy zostanie przydzielony przez bibliotekę w momencie powiązania punktu końcowego.

deinit() → None

Niszczy punkt końcowy i zwalnia wszystkie jego zasoby.

is_ready() → bool

Zwraca True, jeśli punkt końcowy jest gotowy do wysyłania (tzn. ma zarówno adres źródłowy, jak i docelowy).

send(buffer: bytes, *, src: int = -1, dest: int = -1, timeout: int = -1) → int

Wysyła wiadomość do zdalnego procesora przez ten punkt końcowy.

Argumenty:

  • buffer to ładunek wiadomości (dowolny obiekt obsługujący protokół bufora, np. bytes, bytearray lub str).

  • src to adres źródłowego punktu końcowego wiadomości. Jeśli nie zostanie podany, używany jest adres źródłowy, z którym powiązany jest punkt końcowy.

  • dest to adres docelowego punktu końcowego wiadomości. Jeśli nie zostanie podany, używany jest adres docelowy, z którym powiązany jest punkt końcowy.

  • timeout określa czas w milisekundach oczekiwania na wolny bufor. Domyślnie funkcja jest blokująca.

Klasa RemoteProc

Ostrzeżenie

W STM32H7 drugim rdzeniem AMP jest Cortex-M4, którego nie można zatrzymać, a następnie ponownie uruchomić w tym samym miejscu. Wywołanie RemoteProc.stop() lub RemoteProc.shutdown() na tej platformie powoduje zatem pełny reset systemu, a nie zatrzymanie pojedynczego rdzenia.

class openamp.RemoteProc(entry: str | int)

Obiekt RemoteProc zapewnia obsługę zarządzania cyklem życia procesora (LCM), taką jak ładowanie oprogramowania układowego oraz uruchamianie i zatrzymywanie zdalnego rdzenia.

Argument entry może być ścieżką do obrazu oprogramowania układowego, w którym to przypadku oprogramowanie jest ładowane z pliku do docelowej pamięci, lub adresem punktu wejścia, w którym to przypadku oprogramowanie układowe musi być już załadowane pod podanym adresem.

start() → None

Uruchamia zdalny procesor.

stop() → None

Zatrzymuje zdalny procesor. Dokładne zachowanie zależy od platformy.

shutdown() → None

Shutdown zatrzymuje zdalny procesor i zwalnia wszystkie jego zasoby. Dokładne zachowanie zależy od platformy, jednak zazwyczaj wyłącza zasilanie i zegary zdalnego rdzenia. Funkcja ta jest również używana jako finalizator (tzn. wywoływana, gdy obiekt RemoteProc jest usuwany przez garbage collector).