X-CUBE-IOTA1 STM32Cube erabiltzailearen eskulibururako hedapen software paketea

The X-CUBE-IOTA1 hedapenerako software paketea STM32 Kuboa STM32-n exekutatzen da eta middleware-a barne hartzen du IOTA Distributed Ledger Technology (DLT) funtzioak gaitzeko.
IOTA DLT gauzen Interneterako (IoT) transakzio-likidazio eta datuak transferitzeko geruza bat da. IOTAk pertsonei eta makinei dirua edo/eta datuak transferitzeko aukera ematen die transakzio kuotarik gabe ingurune fidagarri, baimenik gabeko eta deszentralizatu batean. Teknologia honek mikro-ordainketak ere ahalbidetzen ditu, inolako bitartekari fidagarri baten beharrik gabe. Hedapena STM32Cube softwarearen teknologian eraikita dago STM32 mikrokontrolagailu desberdinetan eramangarritasuna errazteko. Softwarearen egungo bertsioa exekutatzen da B-L4S5I-IOT01A IoT nodorako aurkikuntza kita eta erantsitako Wi-Fi interfazearen bidez Internetera konektatzen da.

LOTUKO LOTURAK

Bisitatu STM32Cube ekosistema web www.st.com webgunean informazio gehiago lortzeko
https://www.iota.org/get-started/what-is-iota
https://docs.iota.org/docs/getting-started/1.1/introduction/overview
https://iota-beginners-guide.com
https://chrysalis.docs.iota.org
https://iota-beginners-guide.com/future-of-iota/iota-1-5-chrysalis
https://www.boazbarak.org/cs127/Projects/iota.pdf

Siglak eta laburdurak

1. taula. Siglen zerrenda

Akronimoa	Deskribapena
DLT	Banatutako liburuen teknologia
IDE	Garapen-ingurune integratua
IoT	Gauzen Interneta
PoW	Lan-froga

X-CUBE-IOTA1 STM32Cuberako softwarearen hedapena

Amaituview

The X-CUBE-IOTA1 software paketea zabaltzen da STM32 Kuboa funtzionaltasuna funtsezko ezaugarri hauekin:

Firmware osoa STM32-n oinarritutako plaketarako IOTA DLT aplikazioak eraikitzeko

Middleware liburutegiak hauek dira:
– FreeRTOS
– Wi-Fi kudeaketa
- enkriptatzea, hashinga, mezuen autentifikazioa eta sinadura digitala (Cryptolib)
- Garraio-mailako segurtasuna (MbedTLS)
- Tangle-rekin elkarreragiteko IOTA Bezeroaren APIa
Gidari osoa mugimendu eta ingurumen sentsoreetara sarbidea duten aplikazioak eraikitzeko

ExampIOTA DLT Bezeroaren aplikazioa nola garatu ulertzen laguntzeko
Eramangarri erraza MCU familia ezberdinetan, STM32Cube-ri esker

Doako lizentzia-baldintzak eta erabilerrazak

Softwarearen hedapenak middlewarea eskaintzen du IOTA DLT STM32 mikrokontrolagailu batean gaitzeko. IOTA DLT gauzen Interneterako (IoT) transakzio-likidazio eta datuak transferitzeko geruza bat da. IOTAk pertsonei eta makinei dirua edo/eta datuak transferitzeko aukera ematen die transakzio kuotarik gabe ingurune fidagarri, baimenik gabeko eta deszentralizatu batean. Teknologia honek mikro-ordainketak ere ahalbidetzen ditu, inolako bitartekari fidagarri baten beharrik gabe.

IOTA 1.0

Distributed Ledger Technologies (DLT) nodo-sare batean eraikita daude, eta horrek liburu-liburu banatua mantentzen du, hau da, transakzioak erregistratzeko kriptografikoki babestuta dagoen datu-base banatua. Nodoek adostasun protokolo baten bidez egiten dituzte transakzioak.
IOTA IoT-rako berariaz diseinatutako erregistro banatuko teknologia bat da.
IOTA banatutako liburuari korapilatsua deitzen zaio eta IOTA sareko nodoek igorritako transakzioek sortzen dute.
Nahasian transakzio bat argitaratzeko, nodo batek honako hau egin behar du:

onetsi gabeko bi transakzio balioztatu aholkuak izenekoak

sortu eta sinatu transakzio berria
Lanaren froga nahikoa egitea

transakzio berria IOTA sarera igorri

Transakzioa korapiloari lotzen zaio baliozko transakzioei seinalatzen duten bi erreferentziarekin batera.
Egitura hau grafiko azikliko zuzendu gisa modelatu daiteke, non erpinek transakzio bakarrak adierazten dituzten eta ertzak transakzio bikoteen arteko erreferentziak adierazten dituzten.
Genesis transakzio bat nahasketa erroan dago eta eskuragarri dauden IOTA token guztiak biltzen ditu, iotas izenekoak.
IOTA 1.0-k ezohiko inplementazio-ikuspegia erabiltzen du irudikapen trinarioan oinarrituta: IOTAko elementu bakoitza deskribatzen da trits = -1, 0, 1 biten ordez, eta 3 trits-eko trytes byteen ordez. Trito bat -13tik 13ra arteko zenbaki oso gisa adierazten da, letrak (AZ) eta 9 zenbakia erabiliz kodetuta.
IOTA 1.5 (Chrysalis) transakzio trinarioaren diseinua egitura bitar batekin ordezkatzen du.
IOTA sareak nodoak eta bezeroak ditu. Nodo bat sareko kideekin konektatzen da eta korapiloaren kopia bat gordetzen du. Bezeroa helbideak eta sinadurak sortzeko hazia duen gailu bat da.
Bezeroak transakzioak sortu eta sinatzen ditu eta nodora bidaltzen ditu sareak baliozkotu eta gorde ditzan. Erretiratzeko transakzioek baliozko sinadura bat izan behar dute. Transakzio bat baliozkotzat jotzen denean, nodoak bere liburuko liburuan gehitzen du, kaltetutako helbideen saldoak eguneratzen ditu eta transakzioa bere bizilagunei igortzen die.

IOTA 1.5 - Krisalida

IOTA Fundazioaren helburua Coordicide baino lehen IOTA sare nagusia optimizatzea eta IOTA ekosistemarako enpresetarako prest dagoen irtenbide bat eskaintzea da. Hau Chrysalis izeneko bitarteko eguneratze baten bidez lortzen da. Chrysalis-ek aurkeztutako hobekuntza nagusiak hauek dira:

Helbide berrerabilgarriak: Ed25519 sinadura eskema hartzeak, Winternitz sinadura bakarraren eskema (W-OTS) ordezkatuz, erabiltzaileek hainbat aldiz segurtasunez bidal ditzakete tokenak helbide beretik;

Ez dago sorta gehiago: IOTA 1.0-k sorta kontzeptua erabiltzen du transferentziak sortzeko. Sortak beren erro-erreferentziarekin (enborra) elkarrekin lotuta dauden transakzio multzo bat dira. IOTA 1.5 eguneraketarekin, sorta-eraikuntza zaharra kendu eta Atomic transakzio sinpleagoekin ordezkatzen da. Tangle erpina Mezuaren bidez adierazten da, karga arbitrarioak izan ditzakeen edukiontzi moduko bat da (hau da, Token karga edo Indexazio karga);
UTXO eredua: hasiera batean, IOTA 1.0-k kontuetan oinarritutako eredua erabili zuen IOTA token indibidualak jarraitzeko: IOTA helbide bakoitzak token kopuru bat zeukan eta IOTA helbide guztietako token kopuru agregatua hornikuntza osoaren berdina zen. Horren ordez, IOTA 1.5-ek gastatu gabeko transakzioen irteera eredua edo UTXO erabiltzen du, gastatu gabeko token kopuruaren jarraipena egiteko ideian oinarrituta, irteera izeneko datu-egitura baten bidez;

Gehienez 8 guraso: IOTA 1.0-rekin, 2 guraso transakzio erreferentzia egin behar izan dituzu beti. Chrysalis-ekin, erreferentziazko nodo nagusien kopuru handiagoa (8 arte) sartzen da. Emaitza onenak lortzeko, gutxienez 2 guraso bakar aldi berean gomendatzen dira.

LOTUKO LOTURAK
Chrysalis-i buruzko informazio gehiago lortzeko, kontsultatu dokumentazio orri honetara

Lan-froga

IOTA protokoloak Proof-of-Work erabiltzen du sarea tasa mugatzeko bitarteko gisa.
IOTA 1.0-k Curl-P-81 trinary hash funtzioa eta hash bat behar zuen Tangle-ri transakzio bat igortzeko atzetik datozen zero trit-kopuruarekin.
Chrysalis-ekin, posible da tamaina arbitrarioko mezu bitarrak igortzea. RFC honek lehendik dagoen PoW mekanismoa eskakizun berrietara nola egokitu deskribatzen du. Gaur egungo PoW mekanismoari ahalik eta eten txikiena izatea du helburu.

Arkitektura

STM32Cube hedapen honek IOTA DLT middlewarera sartzeko eta erabiltzeko aplikazioak garatzeko aukera ematen du.
STM32CubeHAL hardwarearen abstrakzio-geruzan oinarrituta dago STM32 mikrokontrolagailurako eta STM32Cube plaka euskarri espezifiko batekin (BSP) hedatzen du mikrofonoaren hedapen-plakarako eta audioa prozesatzeko eta USB komunikaziorako PC batekin bitarteko software osagaiekin.
Aplikazio softwareak mikrofonoaren hedapen-plaka sartzeko eta erabiltzeko erabiltzen dituen software-geruzak hauek dira:

STM32Cube HAL geruza: goiko geruzekin (aplikazioa, liburutegiak eta pilak) elkarreragiteko API multzo generiko bat eskaintzen du. Arkitektura komun batean oinarritutako API generiko eta hedagarriez osatuta dago, eta horri esker, middleware geruza bezalako beste geruza batzuek Mikrokontrolagailuen unitate (MCU) hardware konfigurazio zehatzik gabe funtzionatzen dute. Egitura honek liburutegiko kodea berrerabilgarritasuna hobetzen du eta gailuaren eramangarritasun erraza bermatzen du.
Board Support Package (BSP) geruza: API multzo bat da, plaka periferiko jakin batzuetarako programazio-interfaze bat eskaintzen duena (LEDa, erabiltzailearen botoia etab.). Interfaze honek plaka-bertsio zehatza identifikatzen ere laguntzen du eta beharrezko MCU periferikoak hasieratzeko eta datuak irakurtzeko laguntza eskaintzen du.

1. irudia. X-CUBE-IOTA1 software-arkitektura

Karpeta egitura

2. irudia. X-CUBE-IOTA1 karpeta-egitura

Karpeta hauek software paketean sartzen dira:

Dokumentazioa: HTML konpilatua dauka file iturburu-kodetik eta software-osagaien eta APIen dokumentazio zehatzetik sortua
Gidariak: Onartutako plaka eta hardware plataformetarako HAL kontrolatzaileak eta plakaren berariazko kontrolatzaileak ditu, barneko osagaietarako eta ARM® Cortex®-M prozesadore serierako CMSIS hornitzailetik independenteko hardwarearen abstrakzio geruza barne.
Erdikoak: FreeRTOS duten liburutegiak ditu; Wi-Fi kudeaketa; enkriptatzea, hashinga, mezuen autentifikazioa eta sinadura digitala (Cryptolib); garraio-mailako segurtasuna (MbedTLS); IOTA Bezeroaren APIa Tangle-rekin elkarreragiteko
Proiektuak: dauka adibampSTM32 oinarritutako plataforma onartzen duen IOTA DLT Bezeroaren aplikazio bat garatzen laguntzeko (B-L4S5I-IOT01A), hiru garapen-ingurunerekin, IAR Embedded Workbench for ARM (EWARM), RealView Mikrokontrolagailuak garatzeko kit (MDK-ARM) eta STM32CubeIDE

APIa

Informazio tekniko zehatza erabiltzailearen API funtzio osoa eta parametroen deskribapena HTML konpilatu batean daude file “Dokumentazioa” karpetan.

IOTA-Client aplikazioaren deskribapena

Proiektua fileIOTA-Client aplikaziorako s: $BASE_DIR\Projects\B-L4S5IIOT01A\Applications\IOTA-Client.
Eraikitzeko prest dauden proiektuak eskuragarri daude IDE anitzetarako.
Erabiltzaile-interfazea serie atakaren bidez ematen da eta ezarpen hauekin konfiguratu behar da:

3. Irudia Tera Term - Terminalaren konfigurazioa

4. Irudia Tera Term - Serial atakaren konfigurazioa

Aplikazioa exekutatzeko, jarraitu beheko prozedura.
1. urratsa. Ireki serieko terminal bat mezuen erregistroa ikusteko.
2. urratsa. Sartu zure Wi-Fi sarearen konfigurazioa (SSID, segurtasun modua eta pasahitza).
3. urratsa. Ezarri TLS root CA ziurtagiriak.
4. urratsa. Kopiatu eta itsatsi Projects\B-L4S5I-IOT01A\Applications\IOTAClient\usertrust_thetangle.pem ataleko edukia. Gailuak TLS bidez urruneko ostalariak autentifikatzeko erabiltzen ditu.

Oharra: Parametroak konfiguratu ondoren, alda ditzakezu taula berrabiarazi eta Erabiltzaile botoia (botoi urdina) sakatuz 5 segundotan. Datu hauek Flash memorian gordeko dira.

5. Irudia. Wi-Fi parametroen ezarpenak

5. urratsa. Itxaron "Sakatu edozein tekla jarraitzeko" mezua agertu arte. Ondoren, pantaila freskatu egiten da funtzio nagusien zerrendarekin:

Bidali indexazio-mezu generiko bat

Bidali indexazio-sentsorearen mezu bat (timest barneamp, Tenperatura eta Hezetasuna)
Lortu oreka
Bidali transakzioa

Beste funtzio batzuk

6. Irudia Menu nagusia

6. urratsa. Aukeratu 3. aukera funtzio hauetako bat probatzeko:

Lortu nodoen informazioa	Lortu aholkuak
Lortu irteera	Helbidetik irteerak
Lortu oreka	Erantzun errorea
Jaso mezua	Bidali mezua
Bilatu mezua	Proba-zorroa
Mezu-sortzailea	Probatu kriptografia

7. irudia. Beste funtzio batzuk

LOTUKO LOTURAK
IOTA 1.5 funtzioei buruzko xehetasun gehiago lortzeko, ikusi IOTA C Bezeroaren dokumentazioa

Sistema konfiguratzeko gida

Hardware deskribapena

STM32L4+ Discovery kit IoT nodoa

IoT nodorako B-L4S5I-IOT01A Discovery kit-ak hodeiko zerbitzarietara zuzenean konektatzeko aplikazioak garatzeko aukera ematen du.
Discovery kit-ak askotariko aplikazioak ahalbidetzen ditu potentzia baxuko komunikazioa, bide anitzeko sentsazioa eta ARM®Cortex® -M4+ core-n oinarritutako STM32L4+ serieko funtzioak baliatuz.
Arduino Uno R3 eta PMOD konektibitatea onartzen du hedapen-gaitasun mugagabeak eskaintzen dituen osagarri-plaka dedikatu aukera handi batekin.

8. Irudia B-L4S5I-IOT01A Aurkikuntza kit

Hardwarearen konfigurazioa

Ondorengo hardware osagaiak behar dira:

Wi-Fi interfazearekin hornitutako IoT nodorako STM32L4+ aurkikuntza-kit bat (eskaera kodea: B-L4S5I-IOT01A)

USB A motako Mini-B USB B motako kable bat STM32 aurkikuntza-plaka ordenagailura konektatzeko

Softwarearen konfigurazioa

Software osagai hauek behar dira B-L4S5I-IOT01A-rako IOTA DLT aplikazioak sortzeko garapen-ingurunea konfiguratzeko:

X-CUBE-IOTA1: firmwarea eta erlazionatutako dokumentazioa st.com-en dago eskuragarri

garapen tresna-katea eta konpilatzailea: STM32Cube hedapen softwareak ingurune hauek onartzen ditu:
– IAR Embedded Workbench for ARM ® (EWARM) toolchain + ST-LINK/V2
– ErrealaView Mikrokontrolagailuen Garapen Kit (MDK-ARM) tresna-katea + ST-LINK/V2
– STM32CubeIDE + ST-LINK/V2

Sistemaren konfigurazioa

B-L4S5I-IOT01A Discovery plakak IOTA DLT funtzioak ustiatzeko aukera ematen du. Plakak ST-LINK/V2-1 arazketa/programatzailea integratzen du. ST-LINK/V2-1 USB kontrolatzailearen bertsio egokia deskarga dezakezu STSW-LINK009 helbidean.

Berrikuspen historia

2. taula. Dokumentuen berrikuspenaren historia

Data	Berrikuspena	Aldaketak
13-eka-19	1	Hasierako kaleratzea
18-eka-19	2	3.4.8.1 Atala eguneratua TX_IN eta TX_OUT, 3.4.8.3 Atala Datuak zero balio bidez bidaltzea transakzioak eta 3.4.8.4 Atala Funtsak bidaltzea transferentzia-eragiketen bidez.
6-maiatzak-21	3	Sarrera eguneratua, 1. atala Siglak eta laburdurak, 2.1 atala baino gehiagoview, Atala 2.1.1 IOTA 1.0, Atala 2.1.3 Lanaren Froga, Atala 2.2 Arkitektura, Atala 2.3 Karpeta egitura, Atala 3.2 Hardwarearen konfigurazioa, Atala 3.3 Softwarearen konfigurazioa eta Atala 3.4 Sistemaren konfigurazioa. 2. atala kendu eta Sarrerako esteka batekin ordezkatu da. Kendu 3.1.2 Atala Transakzioak eta sortak, 3.1.3 Atala Kontua eta sinadurak, Atala 3.1.5 Hashing. 3.4 Atala Aplikazioak eta erlazionatutako azpiatalak nola idatzi, 3.5 Atala IOTALightNode aplikazioaren deskribapena eta erlazionatutako azpiatalak eta 4.1.1 STM32 Atala Nukleo plataforma Gehitu da 2.1.2IOTA 1.5 atala - Chrysalis, 2.5 atala IOTA-Client aplikazioaren deskribapena, 2.4 atala APIa eta 3.1.1 atala STM32L4+ Discovery kit IoT nodoa.

OHAR GARRANTZITSUA - IRAKURRI KONTUZ

STMicroelectronics NV-k eta bere filialek ("ST") eskubidea dute ST produktuetan eta / edo dokumentu honetan aldaketak, zuzenketak, hobekuntzak, aldaketak eta hobekuntzak egiteko, edozein unetan abisatu gabe. Erosleek ST produktuei buruzko informazio garrantzitsuena eskuratu beharko lukete eskaerak egin aurretik. ST produktuak ST eskaeraren onarpen unean indarrean dauden salmenta baldintzen arabera saltzen dira.

Erosleek ST produktuak aukeratu, aukeratu eta erabiltzearen erantzule bakarrak dira eta STk ez du erantzukizunik hartzen aplikazioen laguntzarengatik edo Erosleen produktuen diseinuarengatik.
STek ez du baimenik, espresuki edo inplizituki, jabetza intelektualeko eskubiderik ematen.
ST produktuen birsalmentak hemen azaltzen den informazioaz bestelako xedapenak dituztenak baliogabetuko ditu STek produktu horrengatik emandako edozein berme.
ST eta ST logotipoa ST-ren marka komertzialak dira. ST markei buruzko informazio gehiago lortzeko, mesedez, jo www.st.com/trademarks helbidera. Gainerako produktu edo zerbitzu-izen guztiak dagozkien jabeen jabetzakoak dira.
Dokumentu honetako informazioak dokumentu honen aurreko edozein bertsiotan emandako informazioa ordezkatzen eta ordezkatzen du.
© 2021 STMicroelectronics - Eskubide guztiak erreserbatuta

Dokumentuak / Baliabideak

ST X-CUBE-IOTA1 STM32Cuberako hedapen software paketea [pdfErabiltzailearen eskuliburua
ST, X-CUBE-IOTA1, Hedapena, Software Paketea, STM32Cube-rako

Erreferentziak

Erabiltzailearen eskuliburua

Sarrera