Apikacija OpenCL C++ Paralelizacija - 3n matrica obavlja jednostavnu funkciju množenja dviju matrica dimenzija 3 x 3. Množenje matrica izvodi se paralelno preko tri kernela od kojih svaki kernel izvršava računanje jednog reda u matrici rezultata. Ovim jednostavnim primjerom i uvodnom teorijom cilj je bio objasniti princip rada OpenCL aplikacija te osnovne strukture od kojih se ona sastoji.
Razvoju OpenCL projekta započinje kodiranjem „host“ aplikacije (C, C++), odnosno aplikacije koja se izvodi na korisnikovom računalu i koja otprema jezgre prema spojenim uređajima. Svaka host aplikacija koristi pet osnovnih strukture podataka u OpenCL-u:
Funkcija dohvaća listu dostupnih platformi. Ulazni parametri su: (1) broj platformi koje mogu biti dodane u listu, (2) referenca liste u koju se pohranjuju pronađene platforme, (3) referenca varijable u koju se sprema broj pronađenih platformi.
Povratna vrijednost funkcije su zastavice (engl. bit flags): CL_SUCCESS za uspješno izvršenje funkcije te CL_INVALID_VALUE ako je prvi parametar 0, a u listi platformi već postoji neka vrijednost ili su prvi i treći parametri NULL.
Funkcija dohvaća listu procesnih jedinica za određenu platformu. Ulazni parametri funkcije su: (1) ID platforme dohvaćene funkcijom clGetPlatformIDs, (2) tip procesne jedinice koji želimo pronaći, predstavljen je nekom od zastavica – CL_DEVICE_TYPE_CPU, CL_DEVICE_TYPE_GPU, CL_DEVICE_TYPE_ACCELERATOR, CL_DEVICE_TYPE_DEFAULT, CL_DEVICE_TYPE_ALL, (3) broj procesnih jedinica koje mogu biti dodane u listu, (4) referenca liste u koju se pohranjuju pronađene procesne jedinice, (5) referenca varijable u koju se sprema broj pronađenih procesnih jedinica.
Funkcija vraća zastavice: CL_SUCCESS ako je uspješno izvršena, CL_INVALID_PLATFORM ako prvi parametar nije dobro zadan, CL_INVALID_DEVICE_TYPE ako drugi parametar nije dobro zadan, CL_INVALID_VALUE ako je treći parametar 0, a u listi platformi već postoji neka vrijednost ili su drugi i treći parametri NULL, CL_DEVICE_NOT_FOUND ako je procesne jedinice nisu nađene.
Funkcija dohvaća određene informacije o platformi. Ulazni parametri su: (1) ID platforme za koju se podaci dohvaćaju, (2) zastavica koja definira koju informaciju želimo dohvatiti (proslijediti se mogu slijedeće zastavice: CL_PLATFORM_PROFILE, CL_PLATFORM_VERSION, CL_PLATFORM_NAME, CL_PLATFORM_VENDOR, CL_PLATFORM_EXTENSIONS), (3) veličina varijable u koju se pohranjuje dohvaćena vrijednost, (4) referenca na varijablu u koju će se pohraniti dohvaćena vrijednost, (5) referenca varijable u koju se pohranjuje veličina dohvaćene vrijednosti.
Ako je funkcija uspješno izvršena vratit će vrijednost zastavice CL_SUCCESS, CL_INVALID_PLATFORM ako nije valjan ulazni parametar ID platforme, odnosno CL_INVALID_VALUE ako je deklarirana veličina varijable za pohranu vrijednosti manja od veličine dohvaćene vrijednosti.
Funkcija dohvaća određene informacije o procesnoj jedinici. Ulazni parametri su: (1) ID procesne jedinice za koju se podaci dohvaćaju, (2) zastavica koja definira koju informaciju želimo dohvatiti, (3) veličina varijable u koju se pohranjuje dohvaćena vrijednost, (4) referenca na varijablu u koju će se pohraniti dohvaćena vrijednost, (5) referenca varijable u koju se pohranjuje veličina dohvaćene vrijednosti.
Ako je funkcija uspješno izvršena vratit će vrijednost zastavice CL_SUCCESS, CL_INVALID_DEVICE ako nije valjan ulazni parametar ID procesne jedinice, odnosno CL_INVALID_VALUE ako je deklarirana veličina varijable za pohranu vrijednosti manja od veličine dohvaćene vrijednosti.
Funkcija stvara objekt konteksta (engl. Context), okruženje u kojem se upravlja osnovnim OpenCL objektima – memorijom, kernelom, redom naredbi, programom - i izvršavanjem kernela na procesnim jedinicama. Ulazni parametri funkcije su: (1) referenca na listu predefiniranih svojstava konteksta, (2) broj procesnih jedinica pronađenih funkcijom clGetDeviceIDs, (3) referenca liste u koju su pohranjene procesne jedinice, (4) funkcija za upravljanje pogreškama, (5) parametri funkcije za upravljanje pogreškama, (6) varijabla povratne vrijednosti (NULL ako je uspješno kreiran kontekst, odnosno broj ako je došlo do pogreške).
Ako je funkcija uspješno završila, vraća objekt cl_context.
Funkcija stvara objekt reda naredbi (engl. Command Queue). Ulazni parametri funkcije su: (1) kontekst stvoren naredbom clCreateContext, (2) lista procesnih jedinica koje se nalaze u okviru konteksta, (3) predefinirana svojstva reda naredbi u obliku zastavica CL_QUEUE_OUT_OF_ORDER_EXEC_MODE_ENABLE (naredbe se ne izvršavaju redom dolazaka u red) i CL_QUEUE_PROFILING_ENABLE, (4) varijabla povratne vrijednosti (NULL ako je uspješno kreiran red naredbi, odnosno broj ako je došlo do pogreške).
Ukoliko je funkcija uspješno izvršena vratit će objekt reda naredbi tipa cl_command_queue.
Funkcija stvara objekt međuspremnika kojima program (host) razmjenjuje parametre i rezultate sa kernelom. Ulazni parametri funkcije su: (1) objekt konteksta, (2) zastavica kojom se definira korištenje i alokacija međuspremnika, (3) veličina međuspremnika u byte-ovima, (4) referenca na prethodno alociran međuspremnik, (5) varijabla povratne vrijednosti (NULL ako je uspješno kreiran međuspremnik, odnosno broj ako je došlo do pogreške).
Uspješno izvršena funkcija vraća objekt memorije (međuspremnika) tipa cl_mem.
Funkcija koja prosljeđuje parametre iz memorije programa (host-a) u međuspremnik. Parametri funkcije su: (1) objekt reda naredbi, (2) objekt međuspremnika, (3) bool vrijednosti CL_TRUE (nakon što se kopija vrijednosti memorije host-a proslijedi naredbenom redu, memorija se oslobađa za daljnje korištenje) ili CL_FALSE (memorija host-a se oslobađa tek nakon što parametar event (9) vrati vrijednost da je vrijednost memorije prosljeđena), (4) pomak byte-ova u međuspremniku, (5) veličina vrijednosti koje se upisuju u međuspremnik, (6) referenca na varijablu (memoriju) u kojoj je zapisana vrijednost koja se prosljeđuje međuspremniku, (7) broj događaja koji moraju biti izvršeni kako bi se vrijednost koja se prosljeđuje redu mogla procesirati, (8) lista događaja koji moraju biti izvršeni kako bi se vrijednost koja se prosljeđuje redu mogla procesirati, (9) varijabla u koju se pohranjuje povratna vrijednost o prosljeđivanju red.
Ako je funkcija uspješno izvršena vratit će CL_SUCCESS ili neku od zastavica o neuspjelom izvršenju.
Funkcija stvara objekt programa iz string polja. Parametri funkcije su: (1) objekt konteksta, (2) broj pokazivača na početak koda, (3) polje pokazivača na početak koda, (4) veličina koda, (5) varijabla povratne vrijednosti (NULL ako je uspješno kreiran program, odnosno broj ako je došlo do pogreške).
Uspješno izvršena funkcija vraća objekt programa tipa cl_program.
Funkcija kompajlira kod i izrađuje izvršnu datoteku. Ulazni parametri funkcije su: (1) objekt programa stvoren funkcijom clCreateProgramWithSource, (2) broj procesnih jedinica, (3) lista procesnih jedinica, (4) referenca na string sa opcijama izrade (engl. Build) izvršne datoteke, (5) referenca na funkciju koja sadrži rutine obavijesti o izradi izvršne datoteke, (6) referenca parametara funkcije obavijesti.
Ako je funkcija uspješno izvršena vratit će CL_SUCCESS ili neku od zastavica o neuspjelom izvršenju.
Funkcija stvara kernel objekt tipa cl_kernel. Ulazni parametri su: (1) objekt programa stvoren funkcijom clCreateProgramWithSource te kompajliran i izrađen funkcijom clBuildProgram, (2) Naziv funkcije programa koja će se izvršavati na kernelu, (3) varijabla povratne vrijednosti (NULL ako je uspješno kreiran kernel, odnosno broj ako je došlo do pogreške).
Funkcija prosljeđuje skup argumenata kernelu. Parametri funkcije su: (1) kernel objekt stvoren funkcijom clCreateKernel, (2) indeks argumenta u funkciji programa kojem se vrijednost prosljeđuje, (3) veličina argumenta u byte-ovima (veličina međuspremnika gdje su pohranjene vrijednosti argumenata), (4) referenca na pohranjene vrijednosti (međuspremnik).
Uspješno izvršena funkcija vratiti će vrijednost zastavice CL_SUCCESS, dok će neuspješno izvršena funkcija vratiti vrijednost greške koja se dogodila.
Funkcija prosljeđuje naredbe za izvršavanje kernela na procesnim jedinicama. Parametri funkcije su: (1) objekt reda naredbi, (2) objekt kernela, (3) broj događaja koji prethodno moraju biti izvršeni kako bi se naredba mogla izvršiti, (4) lista događaja koji prethodno moraju biti izvršeni kako bi se naredba koja se prosljeđuje mogla izvršiti, (5) varijabla u koju se pohranjuje povratna vrijednost o izvršenju kernela.
Uspješno izvršena funkcija vratiti će vrijednost zastavice CL_SUCCESS, dok će neuspješno izvršena funkcija vratiti vrijednost greške koja se dogodila.
Funkcija koja prosljeđuje naredbu za dohvaćanje (čitanje) podataka iz međuspremnika u memoriju host-a. Ulazni parametri funkcije su: Funkcija koja prosljeđuje parametre iz memorije programa (host-a) u međuspremnik. Parametri funkcije su: (1) objekt reda naredbi, (2) objekt međuspremnika, (3) bool vrijednosti CL_TRUE (čitanje se blokira sve dok se vrijednost ne pročita i kopira u lokalnu memoriju host-a) ili CL_FALSE (novo čitanje ne može početi sve dok argument event (9) ne vrati povratnu vrijednost), (4) pomak byte-ova u međuspremniku, (5) veličina vrijednosti koja se dohvaća, (6) referenca na međuspremnik iz kojeg se čita, (7) broj događaja koji moraju biti izvršeni kako bi se vrijednost iz međuspremnika mogla dohvatiti, (8) lista događaja koji moraju biti izvršeni kako bi se vrijednost iz spremnika mogla dohvatiti, (9) varijabla u koju se pohranjuje povratna vrijednost.
Povratna vrijednost funkcije je zastavica CL_SUCCESS za uspješno izvršenje funkcije ili određena zastavica pogreške ako funkcija nije uspješno izvršena.
Funkcija osigurava da su sve naredbe iz naredbenog reda predane procesnim jedinicama. Naredbeni redak se čisti od mogućih blokiranih naredbi koje mogu ostati blokirani funkcijama clEnqueueReadBuffer, clEnqueueWriteBuffer i dr. Funkcija kao parametar prima objekt naredbenog reda. Povratna vrijednost uspješno izvršene funkcije je zastavica CL_SUCCESS, odnosno određena zastavica greške ako je do nje došlo.
Funkcija koja „čeka“ da sve naredbe iz naredbenog reda budu izvršene. Ona predstavlja sinkronizacijsku točku programa. Ulazni parametar je objekt naredbenog reda, a povratna vrijednost je zastavica CL_SUCCESS za uspješno izvršenje, odnosno određena zastavica greške ako je do nje došlo.
Funkcija otpušta (briše) stvorene objekte kernela nakon što su izvršili sve naredbe. Ulazni parametar funkcije je objekt kernela, dok je izlazna vrijednost zastavica CL_SUCCESS za uspješno izvršenje funkcije, odnosno CL_INVALID_KERNEL ako ulazni parametar nije valjan.
Funkcija otpušta (briše) stvorene objekte programa nakon što su ih kernel objekti izvršili. Ulazni parametar funkcije je objekt programa, dok je izlazna vrijednost zastavica CL_SUCCESS za uspješno izvršenu funkciju ili neka od zastavica pogreške ako je došlo do pogreške.
Funkcija oslobađa objekte memorije (međuspremnika) nakon što su sve vrijednosti međuspremnika izvršene. Ulazni parametar funkcije je objekt memorije, dok su izlazne vrijednosti CL_SUCCESS za uspješno izvršenje funkcije, odnosno CL_INVALID_MEM_OBJECT ako ulazni parametar nije valjan.
Funkcija briše naredbeni redak nakon što su sve naredbe vezane za redak izvršene. Ulazni parametar funkcije je objekt naredbenog reda. Izlazna vrijednost funkcije je zastavica CL_SUCCESS ako je funkcija uspješno završila, odnosno zastavica određene greške ako je do nje došlo.
Funkcija briše objekt konteksta. Ulazni parametar funkcije je objekt konteksta. Povratna vrijednost funkcije može biti zastavica CL_SUCCESS za uspješno izvršenje funkcije ili CL_INVALID_CONTEXT ako je proslijeđen krivi ulazni parametar.
Made by Juranek Bojan & Goran Mlinarić