X-CUBE-IOTA1 Expansion Software Package for STM32Cube User Manual

Cov X-CUBE-IOTA 1 expansion software pob rau STM32 kub khiav ntawm STM32 thiab suav nrog cov khoom nruab nrab los pab rau IOTA Distributed Ledger Technology (DLT) ua haujlwm.
IOTA DLT yog ib qho kev sib cog lus thiab cov ntaub ntawv hloov chaw rau Internet ntawm Yam (IoT). IOTA tso cai rau tib neeg thiab lub tshuab hloov nyiaj thiab / lossis cov ntaub ntawv yam tsis muaj nqi hloov pauv hauv ib puag ncig tsis ntseeg, tsis muaj kev tso cai thiab tsis muaj kev cuam tshuam. Cov thev naus laus zis no txawm ua rau micro-payment tau yam tsis tas yuav tsum muaj kev ntseeg siab ntawm txhua yam. Qhov nthuav dav yog tsim los ntawm STM32Cube software thev naus laus zis kom yooj yim txav mus los thoob plaws STM32microcontrollers sib txawv. Tam sim no version ntawm lub software khiav ntawm lub B-L4S5I-IOT01A Cov khoom siv Discovery rau IoT node thiab txuas rau Is Taws Nem los ntawm kev txuas nrog Wi-Fi interface.

QHOV CHAW UA HAUJ LWM

Mus ntsib STM32Cube ecosystem web nplooj ntawv ntawm www.st.com yog xav paub ntxiv
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

Acronyms thiab abbreviations

Table 1. Cov npe ntawm cov lus sau

Lub ntsiab lus	Kev piav qhia
DLT	Distributed ledger technology
IDE	Integrated kev loj hlob ib puag ncig
IoT	Internet ntawm yam
PoW	Pov thawj-ntawm-ua haujlwm

X-CUBE-IOTA1 software nthuav dav rau STM32Cube

Tshajview

Cov X-CUBE-IOTA 1 software pob expands STM32 kub functionality nrog cov yam ntxwv tseem ceeb hauv qab no:

Ua kom tiav firmware los tsim IOTA DLT daim ntawv thov rau STM32-based boards

Middleware qiv featuring:
- FreeRTOS
- Kev tswj hwm Wi-nkaus
- encryption, hashing, message authentication, thiab kos npe digital (Cryptolib)
- Kev nyab xeeb thauj mus los (MbedTLS)
- IOTA Client API rau kev cuam tshuam nrog Tangle
Ua kom tiav tus tsav tsheb los tsim cov ntawv thov nkag mus rau cov lus tsa suab thiab ib puag ncig sensors

Examples los pab nkag siab yuav ua li cas los tsim ib daim ntawv thov IOTA DLT Client
Yooj yim txav mus los thoob plaws MCU tsev neeg, ua tsaug rau STM32Cube
Free, user-friendly licence cov ntsiab lus

Lub software nthuav dav muab cov khoom nruab nrab los pab rau IOTA DLT ntawm STM32 microcontroller. IOTA DLT yog ib qho kev sib cog lus thiab cov ntaub ntawv hloov chaw rau Internet ntawm Yam (IoT). IOTA tso cai rau tib neeg thiab lub tshuab hloov nyiaj thiab / lossis cov ntaub ntawv yam tsis muaj nqi hloov pauv hauv ib puag ncig tsis ntseeg, tsis muaj kev tso cai thiab tsis muaj kev cuam tshuam. Cov thev naus laus zis no txawm ua rau micro-payment tau yam tsis tas yuav tsum muaj kev ntseeg siab ntawm txhua yam.

IOTA 1.0

Distributed Ledger Technologies (DLTs) yog tsim los ntawm lub network node uas tuav cov ntaub ntawv faib khoom, uas yog cov ntaub ntawv pov thawj kev ruaj ntseg, faib cov ntaub ntawv los sau cov kev hloov pauv. Nodes teeb meem kev lag luam los ntawm kev pom zoo raws tu qauv.
IOTA yog ib qho kev faib khoom siv thev naus laus zis tshwj xeeb tsim los rau IoT.
IOTA daim ntawv faib khoom yog hu ua tangle thiab yog tsim los ntawm kev lag luam tawm los ntawm cov nodes hauv IOTA network.
Txhawm rau tshaj tawm kev lag luam hauv tangle, ib lub ntawm yuav tsum:

validate ob qhov kev hloov pauv tsis pom zoo hu ua cov lus qhia
tsim thiab kos npe rau qhov kev hloov pauv tshiab
ua cov ntawv pov thawj txaus
tshaj tawm qhov kev hloov pauv tshiab rau IOTA network

Cov kev sib pauv tau txuas nrog rau qhov tangle ua ke nrog ob qho kev qhia taw qhia rau cov kev hloov pauv tau siv tau.
Cov qauv no tuaj yeem ua qauv raws li daim duab qhia acyclic, qhov twg cov vertices sawv cev rau ib qho kev lag luam thiab cov npoo sawv cev rau cov ntaub ntawv ntawm cov khub kev lag luam.
Kev hloov pauv keeb kwm yog nyob ntawm lub hauv paus tangle thiab suav nrog tag nrho cov muaj IOTA tokens, hu ua iotas.
IOTA 1.0 siv ib qho kev coj ua tsis zoo raws li kev sawv cev trinary: txhua lub ntsiab lus hauv IOTA tau piav qhia siv trits = -1, 0, 1 tsis yog cov khoom, thiab trytes ntawm 3 trits es tsis txhob bytes. Lub tryte yog sawv cev ua tus lej ntawm -13 txog 13, encoded siv cov ntawv (AZ) thiab tus lej 9.
IOTA 1.5 (Chrysalis) hloov qhov kev sib pauv hloov pauv nrog cov qauv binary.
IOTA network suav nrog cov nodes thiab cov neeg siv khoom. Ib lub node txuas nrog cov phooj ywg hauv lub network thiab khaws cov ntawv luam ntawm tangle. Tus neeg siv khoom yog ib qho khoom siv nrog cov noob siv los tsim chaw nyob thiab kos npe.
Tus neeg siv khoom tsim thiab kos npe rau kev lag luam thiab xa lawv mus rau ntawm qhov chaw kom lub network tuaj yeem siv tau thiab khaws cia. Kev rho tawm yuav tsum muaj daim ntawv kos npe siv tau. Thaum ib qho kev sib pauv tau pom zoo, cov node ntxiv rau nws daim ntawv teev npe, hloov kho qhov sib npaug ntawm cov chaw nyob cuam tshuam thiab tshaj tawm cov kev pauv mus rau nws cov neeg nyob ze.

IOTA 1.5 - Chrysalis

Lub hom phiaj ntawm IOTA Foundation yog txhawm rau txhim kho IOTA lub luag haujlwm tseem ceeb ua ntej Coordicide thiab muab kev lag luam npaj kev daws teeb meem rau IOTA ecosystem. Qhov no tau ua tiav los ntawm kev hloov kho nruab nrab hu ua Chrysalis. Cov kev hloov kho tseem ceeb qhia los ntawm Chrysalis yog:

Reusable chaw nyob: kev txais yuav ntawm Ed25519 kos npe tswv yim, hloov Winternitz ib zaug kos npe scheme (W-OTS), tso cai rau cov neeg siv kom nyab xeeb xa cov tokens los ntawm tib qhov chaw nyob ob peb zaug;

Tsis muaj pob khoom ntxiv: IOTA 1.0 siv lub tswv yim ntawm pob khoom los tsim kev hloov pauv. Bundles yog ib txheej ntawm kev lag luam txuas ua ke los ntawm lawv cov hauv paus siv (lub cev). Nrog IOTA 1.5 hloov tshiab, cov khoom qub qub raug tshem tawm thiab hloov los ntawm kev hloov pauv Atomic yooj yim dua. Lub Tangle vertex yog sawv cev los ntawm Cov Lus uas yog ib hom ntawm cov thawv uas tuaj yeem muaj cov khoom xa tuaj (xws li, Token payload lossis Indexation payload);
UTXO qauv: Ameslikas, IOTA 1.0 siv tus account-raws li qauv rau taug qab ib tug neeg IOTA tokens: txhua IOTA chaw nyob tuav ib tug xov tooj ntawm tokens thiab cov aggregated tooj ntawm tokens los ntawm tag nrho cov IOTA chaw nyob yog sib npaug rau tag nrho cov khoom. Hloov chaw, IOTA 1.5 siv cov qauv tsim tawm tsis siv nyiaj, lossis UTXO, raws li lub tswv yim ntawm kev taug qab cov lej tsis siv nyiaj ntawm cov tokens los ntawm cov qauv ntaub ntawv hu ua cov zis;

Txog 8 Tus Niam Txiv: nrog IOTA 1.0, koj ib txwm yuav tsum tau hais txog 2 niam txiv kev hloov pauv. Nrog Chrysalis, ntau dua ntawm cov niam txiv hais txog cov nodes (txog 8) tau qhia. Txhawm rau kom tau txais txiaj ntsig zoo tshaj plaws, tsawg kawg 2 tus niam txiv tshwj xeeb ntawm ib lub sijhawm raug pom zoo.

QHOV CHAW UA HAUJ LWM
Yog xav paub ntxiv txog Chrysalis, thov mus saib nplooj ntawv cov ntaub ntawv no

Pov thawj-ntawm-ua haujlwm

IOTA raws tu qauv siv Pov Thawj-of-Work raws li ib tug txhais tau tias rau tus nqi-txheej network.
IOTA 1.0 siv Curl-P-81 trinary hash muaj nuj nqi thiab yuav tsum muaj tus hash nrog tus lej sib npaug ntawm qhov kev sib tw xoom trits los muab kev lag luam rau Tangle.
Nrog Chrysalis, nws muaj peev xwm muab cov lus binary ntawm qhov loj me. Qhov no RFC piav qhia yuav ua li cas hloov cov txheej txheem PoW uas twb muaj lawm rau cov kev cai tshiab. Nws lub hom phiaj ntawm kev cuam tshuam tsawg dua li qhov ua tau rau lub tshuab PoW tam sim no.

Kev tsim vaj tsev

Qhov kev nthuav dav STM32Cube no ua rau kev txhim kho cov ntawv thov nkag mus thiab siv IOTA DLT nruab nrab.
Nws yog ua raws li STM32CubeHAL kho vajtse abstraction txheej rau STM32 microcontroller thiab txuas ntxiv STM32Cube nrog ib lub rooj txhawb nqa tshwj xeeb (BSP) rau lub microphone expansion board thiab cov khoom nruab nrab rau kev ua suab thiab kev sib txuas lus USB nrog lub PC.
Cov txheej txheem software siv los ntawm daim ntawv thov software nkag mus thiab siv lub microphone expansion board yog:

STM32Cube HAL txheej: muab cov txheej txheem dav dav, ntau qhov piv txwv ntawm APIs cuam tshuam nrog cov txheej txheem sab saud (daim ntawv thov, tsev qiv ntawv thiab pawg). Nws muaj cov generic thiab extension APIs raws li ib qho kev sib koom ua ke uas tso cai rau lwm cov khaubncaws sab nraud povtseg xws li cov txheej txheem nruab nrab ua haujlwm yam tsis muaj Microcontroller Unit (MCU) kho vajtse configurations. Cov qauv no txhim kho cov tsev qiv ntawv code reusability thiab lav cov cuab yeej yooj yim portability.
Board Support Package (BSP) txheej: yog ib txheej ntawm APIs uas muab cov programming interface rau qee lub rooj tsav xwm tshwj xeeb (LED, tus neeg siv khawm thiab lwm yam). Qhov kev sib txuas no kuj tseem pab txhawm rau txheeb xyuas qhov tshwj xeeb ntawm pawg thawj coj saib thiab muab kev txhawb nqa rau kev pib tsim MCU peripherals thiab nyeem cov ntaub ntawv.

Daim duab 1. X-CUBE-IOTA1 software architecture

Folder qauv

Daim duab 2. X-CUBE-IOTA1 folder structure

Cov folders hauv qab no suav nrog hauv pob software:

Cov ntaub ntawv: muaj ib tug compiled HTML file tsim los ntawm qhov chaws code thiab cov ntaub ntawv ntxaws ntxaws ntawm software Cheebtsam thiab APIs
Cov tsav tsheb: muaj cov tsav tsheb HAL thiab cov tsav tsheb tshwj xeeb rau kev txhawb nqa lub rooj tsavxwm thiab cov khoom siv kho vajtse, suav nrog cov khoom siv rau ntawm lub rooj tsavxwm thiab CMSIS tus neeg muag khoom-kev ywj pheej kho vajtse abstraction txheej rau ARM® Cortex®-M processor series.

Middlewares: muaj cov tsev qiv ntawv uas muaj FreeRTOS; Kev tswj hwm Wi-nkaus; encryption, hashing, message authentication, thiab digital signing (Cryptolib); thauj-theem kev ruaj ntseg (MbedTLS); IOTA Client API los cuam tshuam nrog Tangle
Tej yaam num: muaj examples los pab koj tsim daim ntawv thov IOTA DLT Client rau kev txhawb nqa STM32 raws platform (B-L4S5I-IOT01A), nrog rau peb qhov kev loj hlob ib puag ncig, IAR Embedded Workbench for ARM (EWARM), RealView Microcontroller Development Kit (MDK-ARM) thiab STM32CubeIDE

API

Cov ntaub ntawv qhia ntxaws ntxaws nrog rau tag nrho cov neeg siv API muaj nuj nqi thiab cov lus piav qhia parameter yog nyob rau hauv cov ntaub ntawv HTML file hauv "Cov ntaub ntawv" folder.

IOTA-Client daim ntawv thov piav qhia

Qhov project files rau daim ntawv thov IOTA-Client tuaj yeem pom hauv: $BASE_DIR\Projects\B-L4S5IIOT01A\Applications\IOTA-Client.
Cov phiaj xwm npaj tsim muaj rau ntau IDEs.
Tus neeg siv interface yog muab los ntawm qhov chaw nres nkoj serial thiab yuav tsum tau teeb tsa nrog cov chaw hauv qab no:

Daim duab 3. Tera Term – Terminal setup

Daim duab 4. Tera Term – Serial chaw nres nkoj teeb

Txhawm rau khiav daim ntawv thov, ua raws li cov txheej txheem hauv qab no.
Kauj ruam 1. Qhib lub davhlau ya nyob twg serial kom pom lub cav ntawm cov lus.
Kauj ruam 2. Nkag mus rau koj qhov kev teeb tsa Wi-Fi network (SSID, Kev Ruaj Ntseg, thiab lo lus zais).
Kauj ruam 3. Teeb TLS hauv paus CA daim ntawv pov thawj.
Kauj ruam 4. Luam thiab muab cov ntsiab lus ntawm Projects\B-L4S5I-IOT01A\Applications\IOTAClient\usertrust_thetangle.pem. Cov cuab yeej siv lawv los txheeb xyuas cov chaw taws teeb tswj los ntawm TLS.

Nco tseg: Tom qab teeb tsa cov kev txwv, koj tuaj yeem hloov lawv los ntawm kev rov pib lub rooj tsavxwm thiab thawb tus neeg siv khawm (xiav khawm) hauv 5 vib nas this. Cov ntaub ntawv no yuav raug cawm hauv Flash nco.

Daim duab 5. Wi-Fi parameter nqis

Kauj ruam 5. Tos kom cov lus "Nias ib qho yuam sij mus ntxiv" tshwm. Tom qab ntawd lub vijtsam yog rov kho dua nrog cov npe ntawm cov haujlwm tseem ceeb:

Xa ib tsab xov xwm indexation
Xa cov lus ntsuas ntsuas ntsuas (nrog rau lub sijhawmamp, Kub, thiab Humidity)

Tau nyiaj tshuav
Xa Kev Lag Luam
Lwm cov haujlwm

Daim duab 6. Main zaub mov

Kauj ruam 6. Xaiv qhov kev xaiv 3 los sim ib qho ntawm cov haujlwm hauv qab no:

Tau txais cov ntaub ntawv node	Tau txais cov lus qhia
Tau txais cov zis	Outputs los ntawm chaw nyob
Tau nyiaj tshuav	Teb yuam kev
Tau txais xov xwm	Xa lus
Nrhiav cov lus	Kuaj hnab nyiaj
Message builder	Test crypto

Daim duab 7. Lwm cov haujlwm

QHOV CHAW UA HAUJ LWM
Yog xav paub ntxiv txog IOTA 1.5 kev ua haujlwm, xa mus rau IOTA C Client cov ntaub ntawv

Daim ntawv qhia kev teeb tsa

Cov lus piav qhia khoom kho vajtse

STM32L4 + Cov khoom siv Discovery IoT node

B-L4S5I-IOT01A Cov khoom siv Discovery rau IoT node tso cai rau koj los tsim cov ntawv thov txuas ncaj qha rau huab servers.
Cov khoom siv Discovery ua rau muaj ntau yam kev siv los ntawm kev siv kev sib txuas lus qis, ntau txoj kev paub thiab ARM®Cortex® -M4+ core-based STM32L4+ series nta.
Nws txhawb nqa Arduino Uno R3 thiab PMOD kev sib txuas muab cov peev xwm nthuav dav tsis txwv nrog kev xaiv loj ntawm nplooj siab ntxiv-rau cov laug cam.

Daim duab 8. B-L4S5I-IOT01A Discovery kit

Kev teeb tsa kho vajtse

Cov nram qab no hardware Cheebtsam yuav tsum tau:

ib qho khoom siv STM32L4 + Discovery rau IoT node nruab nrog Wi-nkaus interface (kev txiav txim code: B-L4S5I-IOT01A)
USB hom A rau Mini-B USB Hom B cable txuas rau STM32 nrhiav pom board rau PC

Kev teeb tsa software

Cov khoom siv hauv qab no yog xav tau los teeb tsa qhov chaw tsim kho rau kev tsim IOTA DLT daim ntawv thov rau B-L4S5I-IOT01A:

X-CUBE-IOTA1: firmware thiab lwm yam ntaub ntawv muaj nyob rau ntawm st.com
txoj kev loj hlob cuab yeej-chain thiab compiler: lub STM32Cube expansion software txhawb nqa ib puag ncig hauv qab no:
- IAR Embedded Workbench rau ARM ® (EWARM) toolchain + ST-LINK / V2
- Tiag tiagView Microcontroller Development Kit (MDK-ARM) toolchain + ST-LINK/V2
- STM32CubeIDE + ST-LINK/V2

Kev teeb tsa

B-L4S5I-IOT01A Discovery board tso cai rau kev siv IOTA DLT nta. Lub rooj tsavxwm ua ke nrog ST-LINK/V2-1 debugger/programmer. Koj tuaj yeem rub tawm qhov cuam tshuam ntawm ST-LINK / V2-1 USB tsav tsheb ntawm STSW- LINK009.

Kev kho keeb kwm

Table 2. Cov ntaub ntawv kho dua tshiab

Hnub tim	Kev kho dua	Hloov
13-Lub Ib Hlis-19	1	Kev tso tawm thawj zaug
18-Lub Ib Hlis-19	2	Updated Section 3.4.8.1 TX_IN and TX_OUT, Section 3.4.8.3 Xa cov ntaub ntawv los ntawm pes tsawg-tus nqi kev pauv nyiaj thiab Tshooj 3.4.8.4 Xa cov nyiaj los ntawm kev hloov pauv.
Peb 6-21	3	Hloov Kho Kev Taw Qhia, Ntu 1 Cov Lus Cim thiab cov ntawv luv, Ntu 2.1 Tshajview, Tshooj 2.1.1 IOTA 1.0, Tshooj 2.1.3 Kev Pov Thawj-ntawm-Kev Ua Haujlwm, Tshooj 2.2 Architecture, Tshooj 2.3 Folder qauv, Tshooj 3.2 Kev teeb tsa kho vajtse, Tshooj 3.3 Software teeb tsa thiab Tshooj 3.4 Kev teeb tsa. Tshem tawm Tshooj 2 thiab hloov los ntawm qhov txuas hauv Kev Taw Qhia. Tshem tawm Tshooj 3.1.2 Kev Ua Lag Luam thiab Cov Pob Khoom, Tshooj 3.1.3 Tus Kheej thiab kos npe, Tshooj 3.1.5 Nws. Tshooj 3.4 Yuav ua li cas sau cov ntawv thov thiab cov ntu muaj feem cuam tshuam, Tshooj 3.5 IOTALightNode daim ntawv thov piav qhia thiab lwm ntu, thiab Tshooj 4.1.1 STM32 Nucleo platform Ntxiv Tshooj 2.1.2IOTA 1.5 - Chrysalis, Tshooj 2.5 IOTA-Client daim ntawv thov piav qhia, Tshooj 2.4 API thiab Tshooj 3.1.1 STM32L4+ Cov khoom siv Discovery IoT node.

LUS TSEEM CEEB - THOV NYEEM DAIM NTAWV ZOO

STMicroelectronics NV thiab nws cov chaw pabcuam ("ST") muaj cai hloov pauv, kho, txhim kho, hloov kho, thiab txhim kho rau cov khoom lag luam ST thiab / lossis rau daim ntawv no txhua lub sijhawm yam tsis muaj kev ceeb toom. Cov neeg yuav khoom yuav tsum tau txais cov ntaub ntawv tshiab muaj feem ntawm cov khoom lag luam ST ua ntej tso cov xaj. ST cov khoom lag luam raug muag raws li ST cov lus thiab nqe lus ntawm kev muag hauv qhov chaw thaum lub sijhawm lees paub kev lees paub.

Cov neeg yuav khoom tsuas yog lub luag haujlwm rau txoj kev xaiv, xaiv, thiab siv ST khoom thiab ST tsis muaj kev lav phib xaub rau kev thov kev pabcuam lossis kev tsim qauv ntawm Cov Neeg yuav khoom.
Tsis muaj daim ntawv tso cai, qhia lossis qhia, rau txhua txoj cai kev txawj ntse tau tso cai los ntawm ST ntawm no.
Kev muag khoom ntawm ST cov khoom lag luam nrog cov kev cai sib txawv ntawm cov ntaub ntawv tau teev tseg hauv qab no yuav tsis muaj kev lees paub los ntawm ST rau cov khoom lag luam zoo li no.
ST thiab ST logo yog cov cim lag luam ntawm ST. Yog xav paub ntxiv txog ST trademarks, thov mus saib ntawm www.st.com/trademarks. Tag nrho lwm yam khoom lossis kev pabcuam npe yog cov cuab yeej ntawm lawv cov tswv.
Cov ntaub ntawv hauv daim ntawv no hloov pauv thiab hloov cov ntaub ntawv yav dhau los uas tau muab rau hauv ib qho ua ntej ntawm daim ntawv no.
© 2021 STMicroelectronics - All rights reserved

Cov ntaub ntawv / Cov ntaub ntawv

ST X-CUBE-IOTA1 Expansion Software Pob rau STM32Cube [ua pdf] Tus neeg siv phau ntawv
ST, X-CUBE-IOTA1, Expansion, Software Package, rau, STM32Cube

Cov ntaub ntawv

Cov neeg siv phau ntawv

Taw qhia