X-CUBE-IOTA1 Expansion Software Package ho an'ny STM32Cube User Manual

ny X-CUBE-IOTA1 fanitarana rindrambaiko fonosana ho an'ny STM32Cube mandeha amin'ny STM32 ary misy middleware mba ahafahan'ny IOTA Distributed Ledger Technology (DLT) miasa.
Ny IOTA DLT dia fametrahana fifampiraharahana sy fifindran'ny data ho an'ny Internet of Things (IoT). Ny IOTA dia mamela ny olona sy ny milina handefasana vola sy/na angona tsy misy saram-pandraharahana amin'ny tontolo tsy azo itokisana, tsy nahazoana alalana ary tsy misy idirana. Ity teknôlôjia ity mihitsy aza no mahatonga ny fandoavam-bola madinika tsy mila mpanelanelana azo itokisana na inona na inona. Ny fanitarana dia natsangana tamin'ny teknolojia rindrambaiko STM32Cube mba hanamaivanana ny fifindran'ny microcontrollers STM32 samihafa. Ny dikan-teny ankehitriny amin'ny rindrambaiko dia mandeha amin'ny Sary B-L4S5I-IOT01A Kitapo Discovery ho an'ny node IoT ary mifandray amin'ny Internet amin'ny alàlan'ny interface Wi-Fi mifamatotra.

Rohy mifandraika

Tsidiho ny ecosystem STM32Cube web pejy ao amin'ny www.st.com raha mila fanazavana fanampiny
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

Fanafohezana sy fanafohezana

Tabilao 1. Lisitry ny fanafohezana

fanafohezan-teny	Description
DLT	Teknolojian'ny boky fizarazarana
IDE	Tontolo fampandrosoana mitambatra
IoT	Internet ny zavatra
PoW	Porofon'ny asa

X-CUBE-IOTA1 fanitarana rindrambaiko ho an'ny STM32Cube

TAPITRAview

ny X-CUBE-IOTA1 mivelatra ny fonosana rindrambaiko STM32Cube fampiasa miaraka amin'ireto endri-javatra fototra manaraka ireto:

Firmware feno hanamboarana rindranasa IOTA DLT ho an'ny boards miorina amin'ny STM32

Middleware libraries ahitana:
- FreeRTOS
- Fitantanana Wi-Fi
- encryption, hashing, fanamarinana hafatra, ary sonia nomerika (Cryptolib)
- fiarovana amin'ny ambaratonga fitaterana (MbedTLS)
- IOTA Client API amin'ny fifandraisana amin'ny Tangle
Mpamily feno hanorina fampiharana miditra amin'ny fihetsiketsehana sy ny tontolo iainana sensor

Exampmanampy anao hahatakatra ny fomba famolavolana fampiharana IOTA DLT Client
Mora entina amin'ny fianakaviana MCU samihafa, noho ny STM32Cube

Fepetra fahazoan-dàlana maimaim-poana, mora ampiasaina

Ny fanitarana ny rindrambaiko dia manome ny middleware ahafahan'ny IOTA DLT amin'ny microcontroller STM32. Ny IOTA DLT dia fametrahana fifampiraharahana sy fifindran'ny data ho an'ny Internet of Things (IoT). Ny IOTA dia mamela ny olona sy ny milina handefasana vola sy/na angona tsy misy saram-pandraharahana amin'ny tontolo tsy azo itokisana, tsy nahazoana alalana ary tsy misy idirana. Ity teknôlôjia ity mihitsy aza no mahatonga ny fandoavam-bola madinika tsy mila mpanelanelana azo itokisana na inona na inona.

IOTA 1.0

Distributed Ledger Technologies (DLTs) dia naorina amin'ny tamba-jotra node izay mitahiry ledger zaraina, izay angon-drakitra voaaro amin'ny fomba kriptografika sy zaraina mba hanoratana ny fifanakalozana. Ny Nodes dia mamoaka fifampiraharahana amin'ny alàlan'ny protocol consensus.
IOTA dia teknôlôjia mpizara voazara natao manokana ho an'ny IoT.
Ny ledger zaraina IOTA dia antsoina hoe tangle ary noforonin'ny fifanakalozana navoakan'ny nodes ao amin'ny tambajotra IOTA.
Mba hamoahana ny fifampiraharahana amin'ny korontana, ny node dia tsy maintsy:

manamarina ny fifampiraharahana roa tsy nankatoavina antsoina hoe toro-hevitra

mamorona sy manao sonia ny fifanakalozana vaovao
manatanteraka Proof-of-Work ampy

mandefa ny fifanakalozana vaovao amin'ny tambajotra IOTA

Ny fifampiraharahana dia mifamatotra amin'ny fangalarana miaraka amin'ny references roa manondro ny fifampiraharahana voamarina.
Ity rafitra ity dia azo alaina ho toy ny grafofaonina acyclic mivantana, izay ny vertices dia maneho ny fifampiraharahana tokana ary ny sisiny dia maneho ny references amin'ny fifampiraharahana tsiroaroa.
Ny fifampiraharahana amin'ny fototarazo dia eo amin'ny fototry ny fikorontanana ary ahitana ny marika IOTA rehetra misy, antsoina hoe iota.
IOTA 1.0 dia mampiasa fomba fampiharana tsy mahazatra mifototra amin'ny fanehoana trinaire: ny singa rehetra ao amin'ny IOTA dia faritana amin'ny fampiasana trits = -1, 0, 1 fa tsy bits, ary trytes amin'ny trits 3 fa tsy bytes. Ny tryte dia aseho ho integer manomboka amin'ny -13 ka hatramin'ny 13, voahodidin'ny litera (AZ) sy laharana 9.
IOTA 1.5 (Chrysalis) dia manolo ny firafitry ny fifampiraharahana trinaire amin'ny rafitra binary.
Ny tambajotra IOTA dia misy nodes sy mpanjifa. Ny node dia mifamatotra amin'ny mpiara-mianatra ao amin'ny tambajotra ary mitahiry ny dika mitovy amin'ny korontana. Ny mpanjifa dia fitaovana misy voa ampiasaina hamoronana adiresy sy sonia.
Ny mpanjifa dia mamorona sy manao sonia ny fifampiraharahana ary mandefa azy ireo any amin'ny node mba hahafahan'ny tambajotra manamarina sy mitahiry azy ireo. Tsy maintsy misy sonia manankery ny fisintonana ny fifanakalozana. Rehefa heverina ho manan-kery ny fifampiraharahana, dia ampidirin'ny node ao amin'ny bokim-bolany izany, manavao ny fifandanjan'ny adiresy voakasika ary mandefa ny fifampiraharahana amin'ireo mpifanolo-bodirindrina aminy.

IOTA 1.5 - Chrysalis

Ny tanjon'ny IOTA Foundation dia ny hanatsara ny harato lehibe IOTA alohan'ny Coordicide ary hanolotra vahaolana vonona ho an'ny orinasa ho an'ny tontolo iainana IOTA. Izany dia tratra amin'ny fanavaozana manelanelana antsoina hoe Chrysalis. Ny fanavaozana lehibe nampidirin'i Chrysalis dia:

Adiresy azo ampiasaina indray: ny fananganana ny rafitra sonia Ed25519, fanoloana ny rafitra sonia iray (W-OTS) Winternitz, dia ahafahan'ny mpampiasa mandefa mari-pankasitrahana imbetsaka amin'ny adiresy mitovy;

Tsy misy amboara intsony: IOTA 1.0 dia mampiasa ny foto-kevitry ny amboara hamoronana famindrana. Ny bundles dia fitambarana fifampiraharahana mifamatotra amin'ny fakany fototra (voankazo). Miaraka amin'ny fanavaozana IOTA 1.5, nesorina ny fananganana bundle taloha ary nosoloina ny fifanakalozana Atomic tsotra kokoa. Ny vertex Tangle dia asehon'ny Hafatra izay karazana kaontenera afaka manana enta-mavesatra tsy misy dikany (izany hoe, Token payload na Indexation payload);
Modely UTXO: tany am-boalohany, ny IOTA 1.0 dia nampiasa maodely mifototra amin'ny kaonty ho an'ny fanaraha-maso ny mari-pamantarana IOTA tsirairay: ny adiresy IOTA tsirairay dia manana marika maromaro ary ny isan'ny mari-pamantarana natambatra avy amin'ny adiresy IOTA rehetra dia mitovy amin'ny totalin'ny famatsiana. Fa kosa, ny IOTA 1.5 dia mampiasa ny maodely famoahana varotra tsy lany, na UTXO, mifototra amin'ny hevitra momba ny fanaraha-maso ireo marika tsy ampiasaina amin'ny alàlan'ny rafitra data antsoina hoe output;

Ray aman-dreny hatramin'ny 8: miaraka amin'ny IOTA 1.0, tsy maintsy nanondro fifampiraharahana ray aman-dreny 2 foana ianao. Miaraka amin'ny Chrysalis, maro kokoa ny node ray aman-dreny voatonona (hatramin'ny 8) no ampidirina. Mba hahazoana vokatra tsara indrindra dia ray aman-dreny tsy manam-paharoa 2 farafahakeliny no atolotra.

Rohy mifandraika
Raha mila fanazavana fanampiny momba an'i Chrysalis, tsidiho azafady ity pejy fanangonam-baovao ity

Porofon'ny asa

Ny protocol IOTA dia mampiasa Proof-of-Work ho fitaovana hamerana ny tambajotra.
IOTA 1.0 dia nampiasa ny Curl-P-81 trinary hash function ary nitaky hash miaraka amin'ny isa mifanandrify amin'ny trailing zero trits hamoahana fifampiraharahana amin'ny Tangle.
Miaraka amin'ny Chrysalis, azo atao ny mamoaka hafatra mimari-droa amin'ny habeny tsy misy dikany. Ity RFC ity dia mamaritra ny fomba hampifanaraka ny mekanika PoW efa misy amin'ny fepetra vaovao. Izy io dia mikendry ny tsy hanakorontana araka izay azo atao amin'ny mekanika PoW ankehitriny.

Architecture

Ity fanitarana STM32Cube ity dia ahafahan'ny fampivoarana ny rindranasa miditra sy mampiasa ny middleware IOTA DLT.
Izy io dia mifototra amin'ny sosona abstraction hardware STM32CubeHAL ho an'ny microcontroller STM32 ary manitatra ny STM32Cube miaraka amin'ny fonosana fanohanana board manokana (BSP) ho an'ny birao fanitarana mikrô sy singa midadasika ho an'ny fanodinana feo sy fifandraisana USB amin'ny PC.
Ny sosona rindrambaiko ampiasain'ny rindrambaiko fampiharana hidirana sy hampiasana ny takelaka fanitarana mikrô dia:

STM32Cube HAL sosona: manome andiana API maromaro maromaro hifaneraserana amin'ny sosona ambony (fampiharana, tranomboky ary stacks). Izy io dia ahitana API generic sy fanitarana mifototra amin'ny maritrano mahazatra izay ahafahan'ny sosona hafa toy ny layer middleware miasa tsy misy fanamafisam-peo manokana Microcontroller Unit (MCU). Ity rafitra ity dia manatsara ny fampiasana indray ny kaody famakiam-boky ary miantoka ny fifindran'ny fitaovana mora.
Board Support Package (BSP) sosona: dia andiana API izay manome interface tsara fandaharana ho an'ny birao manokana periferika (LED, bokotra mpampiasa sns). Ity interface ity dia manampy amin'ny famantarana ny dikan-board manokana ary manome fanohanana amin'ny fanombohana ny periferika MCU ilaina sy ny famakiana angona.

Sary 1. X-CUBE-IOTA1 rafitra rindrambaiko

Firafitry ny lahatahiry

Sary 2. Firafitry ny lahatahiry X-CUBE-IOTA1

Ireto lahatahiry manaraka ireto dia tafiditra ao anatin'ny fonosana rindrambaiko:

Documentation: misy HTML natambatra file novokarina avy amin'ny kaody loharano sy antontan-taratasy antsipirihan'ireo singa rindrambaiko sy API
mpamily: misy ny mpamily HAL sy ny mpamily manokana ho an'ny boards tohanana sy ny sehatra hardware, ao anatin'izany ireo ho an'ny singa ao anaty board sy ny sosona abstraction hardware tsy miankina amin'ny mpivarotra CMSIS ho an'ny andiany processeur ARM® Cortex®-M
Middlewares: misy tranomboky misy FreeRTOS; fitantanana Wi-Fi; encryption, hashing, fanamarinana hafatra, ary sonia nomerika (Cryptolib); fiarovana ara-pitaterana (MbedTLS); IOTA Client API hifanerasera amin'ny Tangle
Tetikasa: misy examphanampy anao hamolavola rindranasa mpanjifa IOTA DLT ho an'ny sehatra STM32 tohanana (B-L4S5I-IOT01A), miaraka amin'ny tontolo fampandrosoana telo, IAR Embedded Workbench for ARM (EWARM), RealView Kit Fampandrosoana Microcontroller (MDK-ARM) sy STM32CubeIDE

API

Ny fampahalalana ara-teknika amin'ny antsipiriany miaraka amin'ny fiasan'ny API mpampiasa feno sy ny famaritana parameter dia ao anaty HTML natambatra file ao amin'ny lahatahiry "Documentation".

IOTA-Famaritana momba ny fampiharana mpanjifa

Ny tetikasa files ho an'ny fampiharana IOTA-Client dia hita ao amin'ny: $BASE_DIR\Projects\B-L4S5IIOT01A\Applications\IOTA-Client.
Misy tetikasa efa vonona ho an'ny IDE maro.
Ny interface interface dia omena amin'ny alàlan'ny seranana serial ary tsy maintsy amboarina miaraka amin'ireto toe-javatra manaraka ireto:

Sary 3. Tera Term - Fametrahana terminal

Figure 4. Tera Term - Serial port setup

Mba hampandehanana ny fampiharana dia araho ny dingana etsy ambany.
Dingana 1. Sokafy ny terminal serial hahitana ny diarin'ny hafatra.
Dingana 2. Ampidiro ny fikirakirana tamba-jotra Wi-Fi (SSID, Security Mode, ary tenimiafina).
Dingana 3. Apetraho ny mari-pankasitrahana TLS root CA.
Dingana 4. Adikao ary apetaho ny votoatin'ny Projects\B-L4S5I-IOT01A\Applications\IOTAClient\usertrust_thetangle.pem. Mampiasa azy ireo ilay fitaovana hanamarinana ireo mpampiantrano lavitra amin'ny alàlan'ny TLS.

Fanamarihana: Aorian'ny fametrahana ny masontsivana dia azonao atao ny manova azy ireo amin'ny alàlan'ny famerenana indray ny solaitrabe ary manosika ny bokotra User (bokotra manga) ao anatin'ny 5 segondra. Ity angona ity dia hotehirizina ao amin'ny fahatsiarovana Flash.

Sary 5. Fikirana paramètre Wi-Fi

Dingana 5. Andraso ny hafatra hoe “Press any key to continue” hiseho. Ny efijery dia havaozina miaraka amin'ny lisitry ny asa lehibe:

Mandefasa hafatra fanondroana ankapobeny

Alefaso hafatra sensor fanondroana (anisan'izany ny fotoanaamp, maripana ary hamandoana)
Makà fifandanjana
Alefaso ny Transaction

Asa hafa

Sary 6. Main menu

Dingana 6. Safidio ny safidy 3 hizaha toetra ny iray amin'ireto fiasa manaraka ireto:

Mahazoa fampahalalana node	Mahazoa toro-hevitra
Mahazoa vokatra	Output avy amin'ny adiresy
Makà fifandanjana	Fahadisoana valiny
Mahazoa hafatra	Alefaso hafatra
Mitadiava hafatra	Kitapo fitsapana
Mpamorona hafatra	Andrana crypto

Sary 7. Asa hafa

Rohy mifandraika
Raha mila fanazavana fanampiny momba ny fiasa IOTA 1.5 dia jereo ny antontan-taratasin'ny mpanjifa IOTA C

Torolàlana fananganana rafitra

Famaritana momba ny fitaovana

STM32L4+ Discovery kit IoT node

Ny kitapo Discovery B-L4S5I-IOT01A ho an'ny node IoT dia ahafahanao mamolavola rindranasa mifandray mivantana amin'ireo mpizara rahona.
Ny kitapo Discovery dia manome fampiharana isan-karazany amin'ny alàlan'ny fanararaotana ny fifandraisan-davitra ambany, ny fandrenesana fomba maro ary ny endri-javatra andiany STM4L32+ miorina amin'ny ARM®Cortex® -M4+.
Izy io dia manohana ny Arduino Uno R3 sy ny fifandraisana PMOD izay manome fahafaha-manao fanitarana tsy misy fetra miaraka amin'ny safidy lehibe amin'ny birao fanampiny natokana.

Sary 8. Kitapo fikarohana B-L4S5I-IOT01A

Fametrahana fitaovana

Ireto fitaovana manaraka ireto dia ilaina:

kitapo STM32L4+ Discovery ho an'ny node IoT misy interface tsara Wi-Fi (kaody baiko: B-L4S5I-IOT01A)

tariby USB A mankany amin'ny Mini-B USB Type B mba hampifandraisana ny solaitrabe STM32 amin'ny PC

Fametrahana rindrambaiko

Ireto singa rindrambaiko manaraka ireto dia ilaina mba hametrahana ny tontolo fampandrosoana amin'ny famoronana rindranasa IOTA DLT ho an'ny B-L4S5I-IOT01A:

X-CUBE-IOTA1: azo alaina ao amin'ny st.com ny firmware sy ny antontan-taratasy mifandraika amin'izany

rojo fitaovana fampandrosoana sy mpamoron-kira: ny rindrambaiko fanitarana STM32Cube dia manohana ireto tontolo manaraka ireto:
- IAR Embedded Workbench ho an'ny ARM ® (EWARM) fitaovana + ST-LINK/V2
– TenaView Kitapo fampivoarana microcontroller (MDK-ARM) + ST-LINK/V2
- STM32CubeIDE + ST-LINK/V2

Fametrahana rafitra

Ny B-L4S5I-IOT01A Discovery board dia mamela ny fitrandrahana ny endri-javatra IOTA DLT. Ny birao dia mampiditra ny ST-LINK/V2-1 debugger/programmer. Azonao atao ny misintona ny kinova mifandraika amin'ny mpamily USB ST-LINK/V2-1 ao amin'ny STSW- LINK009.

Tantara fanavaozana

Tabilao 2. Tantaran'ny fanavaozana ny antontan-taratasy

Daty	fanitsiana	FIOVANA
13-Jona-19	1	Famoahana voalohany
18-Jona-19	2	Fizarana 3.4.8.1 TX_IN sy TX_OUT nohavaozina, Fizarana 3.4.8.3 Mandefa angona amin'ny sanda aotra fifampiraharahana ary Fizarana 3.4.8.4 Fandefasana vola amin'ny alalan'ny fifampiraharahana.
6-Mey-21	3	Fampidirana nohavaozina, Fizarana 1 Fanafohezana sy fanafohezana, Fizarana 2.1 Mihoatraview, Fizarana 2.1.1 IOTA 1.0, Fizarana 2.1.3 Proof-of-Work, Fizarana 2.2 Architecture, Fizarana 2.3 Firafitry ny lahatahiry, Fizarana 3.2 Fanamboarana fitaovana, Fizarana 3.3 Fametrahana rindrambaiko ary Fizarana 3.4 Fanamboarana rafitra. Nesorina ny Fizarana 2 ary nosoloina rohy ao amin'ny Fampidirana. Nesorina Fizarana 3.1.2 Transactions sy budles, Fizarana 3.1.3 Kaonty sy sonia, Fizarana 3.1.5 Hashing. Fizarana 3.4 Ahoana ny fanoratana rindranasa sy zana-pizarana mifandraika, Fizarana 3.5 Famaritana fampiharana IOTALightNode sy fizarana mifandraika, ary Fizarana 4.1.1 STM32 Ny sehatra Nucleo dia nampiana Fizarana 2.1.2IOTA 1.5 - Chrysalis, Fizarana 2.5 IOTA-famariparitana ny fampiharana mpanjifa, Fizarana 2.4 API ary fizarana 3.1.1 STM32L4 + Discovery kit IoT node.

FANAMARIHANA MAHAY - MBA VAKIO TSARA

Ny STMicroelectronics NV sy ireo mpiara-miasa aminy ("ST") dia manan-jo hanao fanovana, fanitsiana, fanatsarana, fanovana, fanatsarana ny vokatra ST sy / na an'ity antontan-taratasy ity amin'ny fotoana rehetra tsy misy fampandrenesana. Ny mpividy dia tokony hahazo vaovao farany mifandraika amin'ny vokatra ST alohan'ny hametrahana baiko. Ny vokatra ST dia amidy arakaraka ny fepetra sy ny fividianana ST amin'ny toerany amin'ny fotoana fanekena ny filaminana.

Tompon'andraikitra amin'ny safidy sy ny fisafidianana ary ny fampiasana ny vokatra ST ihany ny mpividy ary ST dia tsy tompon'andraikitra amin'ny fanampiana na famolavolana ny vokatry ny Mpividy.
Tsy misy fahazoan-dàlana, na mazava na an-kolaka, amin'ny zon'ny fananana ara-tsaina omen'ny ST eto.
Ny fivarotana indray ny vokatra ST miaraka amin'ny fepetra hafa amin'ny fampahalalana voalaza eto dia hanafoana ny fiantohana omen'ny ST ho an'ny vokatra toy izany.
ST sy ny ST logo dia marika famantarana ny ST. Raha mila fanazavana fanampiny momba ny marika ST, tsidiho azafady www.st.com/trademarks. Ny anaran'ny vokatra na serivisy hafa rehetra dia fananan'ny tompony tsirairay avy.
Ny fampahalalana ato amin'ity antontan-taratasy ity dia manolo sy manolo ny fampahalalana efa nomena tamin'ny dikan-teny teo aloha amin'ity antontan-taratasy ity.
© 2021 STMicroelectronics – Zo rehetra voatokana

Documents / Loharano

ST X-CUBE-IOTA1 Expansion Software Package ho an'ny STM32Cube [pdf] Boky Torolàlana
ST, X-CUBE-IOTA1, Fanitarana, Package Software, ho an'ny, STM32Cube

References

User Manual

Sava lalana