RAKwireless RAK4631-R WisBlock kodola moduļa lietotāja rokasgrāmata

Kas jums nepieciešams?

Pirms katras RAK4631-R WisBlock Core Moduļa instalēšanas rokasgrāmatas darbības veikšanas noteikti sagatavojiet tālāk norādītos nepieciešamos vienumus.

Aparatūra

• RAK4631-R WisBlock kodols
• Jūsu izvēle WisBlock bāze
• USB kabelis
• Li-Ion/LiPo akumulators (pēc izvēles)
• Saules lādētājs (pēc izvēles)

Programmatūra

Arduino IDE

• Lejupielādējiet un instalējiet Arduino IDE .

BRĪDINĀJUMS
Ja izmantojat operētājsistēmu Windows 10. NEINstalējiet Arduino IDE no Microsoft App Store. Tā vietā instalējiet sākotnējo Arduino IDE no Arduino amatpersonas webvietne. Arduino lietotnei no Microsoft App Store ir problēmas, izmantojot trešās puses padomes atbalsta pakotnes.

• Pievienojiet RAK4631-R kā atbalstītu plati Arduino IDE, atjauninot Board Manager URLs Arduino IDE preferenču iestatījumos ar šo JSON URL:
  https://raw.githubusercontent.com/RAKWireless/RAKwireless-Arduino-BSP-Index/main/package_rakwireless.com_rui_index.json .
• Pēc tam varat pievienot RAKwireless RUI nRF plates, izmantojot Arduino plates pārvaldnieku.

Visual Studio IDE

Lejupielādējiet un instalējiet Visual Studio IDE 2019 kopienas versija 16.11 .

Produkta konfigurācija

Aparatūras iestatīšana

Jūsu RAK4631-R nedarbosies viens pats. Tam ir jābūt vismaz savienotam ar WisBlock Base kopā ar pievienotajām antenām. Pēc tam varat saskarties ar dažādiem WisBlock moduļiem, izmantojot pieejamos slotus WisBlock bāzē. Varat arī pievienot akumulatoru kā strāvas avotu un papildu saules enerģijas uzlādi. Šeit ir apskatītas visas ar aparatūru saistītās jūsu RAK4631-R konfigurācijas. Šī sadaļa aptver:

• RAK4631-R savienojums ar pamatplati
• RAK4631-R savienojums ar citiem moduļiem
• WisBlock moduļu montāža un demontāža
• Antenas un akumulatora/saules savienojums

RAK4631-R uz WisBlock bāzi

RAK4631-R nedarbosies bez WisBlock Base plates. WisBlock Base nodrošina USB savienojumu RAK4631-R programmēšanai. Tas nodrošina arī barošanas avotu un dažādas saskarnes ar RAK4631, lai to varētu savienot ar citiem WisBlock moduļi izmantojot dažādus moduļu slotus.

RAKwireless piedāvā daudzas WisBlock bāzes dēļi saderīgs ar WisBlock Core. Ir ļoti ieteicams aplūkot šīs WisBlock Base plates, lai redzētu, kas atbilst jūsu prasībām attiecībā uz pieejamajiem moduļu slotiem, barošanas avota iespējām un kopējo izmēru.

Lai ilustrētu, RAK4631-R var savienot ar RAK5005-O WisBlock Base, kā parādīts 1. attēlā.

RAK5005-O ir redzamas dažas tapas, un jūs varat tās viegli izmantot, izmantojot galvenes tapas. Etiķetes atrodas aizmugurē, kā parādīts 2. attēlā.

Katrai WisBlock Base platei ir pieejams savs galvenes tapu komplekts, ko varat izmantot. Tomēr šīs galvenes tapas nav pilnīgi vienādas katrā WisBlock bāzē. WisBlock Base platē parasti ir redzamas IO tapas un sakaru protokola tapas, piemēram, I2C un UART. Plašāku informāciju var atrast vietnē konkrētās WisBlock bāzes oficiālā dokumentācija izmantojāt savā projektā.

RAK1-R UART4631 tiek izmantots arī DFU (ierīces programmaparatūras jaunināšanai), izmantojot UART. Ja UART1 konsoles savienojums ir veiksmīgs, USB seriālā konsole nedarbosies.

WisBlock bāzē ir arī izmantojamas gaismas diodes. Varat tos kontrolēt savā kodā, izmantojot makro GREEN_LED un BLUE_RED.

RAK4631-R uz WisBlock moduļiem

RAK4631-R WisBlock Core ir paredzēts saskarnei ar citiem WisBlock moduļiem, piemēram, sensoriem, displejiem un citām saskarnēm. Šie moduļi ir jāpievieno saderīgajiem WisBlock bāzes slotiem.

3. attēlā ir parādīts ilustrācija par to, kā jūs varat apvienot dažādus WisBlock moduļus ar RAK4631-R WisBlock Core, izmantojot WisBlock Base plati.

WisBlock moduļu montāža un demontāža

Salikšana

4. attēlā parādīts, kā uzstādīt RAK4631-R moduli uz WisBlock Base plates (RAK5005-O). Uzmanīgi ievērojiet WisBlock moduļa montāžas/demontāžas instrukcijās norādīto procedūru, lai droši nostiprinātu savienojumu. Pēc pievienošanas uzmanīgi piestipriniet moduli ar vienu vai vairākām M1.2 x 3 mm skrūvēm atkarībā no moduļa.

Demontāža

Jebkura veida WisBlock moduļa izjaukšanas procedūra ir vienāda.

1. Vispirms noņemiet skrūves.

2. Kad skrūves ir noņemtas, pārbaudiet moduļa sietspiedi, lai atrastu pareizo vietu, kur var pielietot spēku.

3. Pielieciet spēku modulim savienotāja vietā, kā parādīts 7. attēlā, lai atvienotu moduli no grīdlīstes.

LoRa un BLE antena

Vēl viena svarīga RAK4631-R sastāvdaļa ir antenas.

Lai nodrošinātu labu LoRa un BLE signālu, jums ir jānodrošina, lai tie būtu pareizi savienoti. Ņemiet vērā arī to, ka jūs varat sabojāt mikroshēmas RF daļu, ja moduli barojat bez antenas, kas pievienota IPEX savienotājam.

Uz RAK4631-R uzlīmes ir uzlīme, kur pievienot antenas, kā parādīts 10. attēlā.

PIEZĪME
Sīkāka informācija par RAK4631-R BLE un LoRa antenu ir atrodama antenas datu lapā.

BRĪDINĀJUMS
Izmantojot LoRa vai Bluetooth Low Energy raiduztvērējus, pārliecinieties, vai antena vienmēr ir pievienota. Šo raiduztvērēju izmantošana bez antenas var sabojāt sistēmu. Noteikti piestipriniet moduli ar skrūvēm, lai nodrošinātu pareizu darbību.

Savienojums ar akumulatoru un saules enerģiju

RAK4631-R var darbināt, izmantojot USB kabeli vai Li-Ion/LiPo akumulatoru, izmantojot tam paredzētos savienotājus, kā parādīts 11. attēlā. Akumulatora vadu atbilstošais savienotājs ir JST PHR-2 2 mm mātīte .

Šajā ilustrācijā kā WisBlock bāze tiek izmantots RAK5005-O. Ir arī citi WisBlock bāze ir pieejamas plates, un jums ir jāpārbauda konkrētās WisBlock Base plates datu lapā pareizā polaritāte un citi parametri.

BRĪDINĀJUMS

• Baterijas var nodarīt kaitējumu, ja tās netiek pareizi apstrādātas.
• Tiek atbalstītas tikai 3.7–4.2 V uzlādējamās LiPo baterijas. Ļoti ieteicams sistēmā neizmantot cita veida akumulatorus, ja vien nezināt, ko darāt.
• Ja tiek izmantots neuzlādējams akumulators, tas vispirms ir jāatvieno, pirms USB kabeli pievienojat plates USB portam, lai konfigurētu ierīci. To nedarot, var sabojāt akumulatoru vai izraisīt ugunsgrēku.
• Tiek atbalstīti tikai 5 V saules paneļi. Neizmantojiet 12 V saules paneļus. Tas iznīcinās uzlādes bloku un galu galā arī citas elektroniskās daļas.
• Pārliecinieties, vai akumulatora vadi atbilst RAK5005-O plates polaritātei. Ne visām baterijām ir vienādi vadi.

Akumulatoru var uzlādēt arī, izmantojot nelielu saules bateriju paneli, kā parādīts 13. attēlā. Saules paneļa vadu atbilstošais savienotājs ir JST ZHR-2 1.5 mm mātīte .

Akumulatora un saules paneļa specifikācijas ir atrodamas WisBlock Base datu lapā.

Programmatūras sākotnējā rokasgrāmata

RAK4631-R programmaparatūra ļauj izstrādāt pielāgotu programmaparatūru papildus iebūvētajam AT komandu iestatījumam. Lai izstrādātu programmaparatūru, izmantojot Arduino IDE, vispirms Arduino plates pārvaldniekā jāpievieno RAKwireless RUI nRF plates, kas tiks aplūkotas šajā rokasgrāmatā. Pēc tam varat izmantot RUI3 API paredzētajai lietojumprogrammai. AT komandām varat to nosūtīt, izmantojot USB savienojumu, UART1 vai bezvadu savienojumu, izmantojot BLE savienojumu.

Šī sadaļa attiecas uz:

• Arduino IDE ar RAK4631-R
• Visual Studio IDE ar RAK4631-R
• AT Command Demo, izmantojot BLE
• Vairāk ceļvežu var atrast vietnē Demo un Examples lapā

RAK4631-R plates atbalsta pakotne Arduino IDE

Ja jums vēl nav Arduino IDE, varat to lejupielādēt vietnē Arduino amatpersona webvietne un izpildiet instalēšanas procedūru, kas sniegta šī dokumenta dažādajā sadaļā.

PIEZĪME
Windows 10 lietotājiem: ja jūsu Arduino IDE tika instalēts no Microsoft App Store, jums ir jāpārinstalē Arduino IDE, lejupielādējot to no Arduino oficiālā. webvietne. Arduino lietotnei no Microsoft App Store ir problēmas, izmantojot trešās puses padomes atbalsta pakotnes.

Kad Arduino IDE ir veiksmīgi instalēts un esat sapratis galvenās Arduino IDE daļas, varat veikt dažas Arduino IDE konfigurācijas izmaiņas, lai to varētu pielāgot RAKWireless WisBlock.

1. Atveriet Arduino IDE un dodieties uz File > Preferences.

2. Lai savam Arduino dēļu sarakstam pievienotu RAK4631-R WisBlock Core, jums ir jārediģē papildu dēļu pārvaldnieks. URLs. Noklikšķiniet uz ikonas, kā parādīts 15. attēlā.

3. Nokopējiet URL https://raw.githubusercontent.com/RAKWireless/RAKwireless-Arduino-BSPIndex/main/package_rakwireless.com_rui_index.json un ielīmējiet to uz lauka, kā parādīts 16. attēlā. Ja ir citi URLjau ir, vienkārši pievienojiet tos nākamajā rindā. Pēc pievienošanas URL, noklikšķiniet uz Labi.

4. Restartējiet Arduino IDE. 5. Izvēlnē Rīki atveriet Boards Manager.

6. Meklēšanas joslā ierakstiet RAK, kā parādīts 18. attēlā. Tas parādīs pieejamos RAKwireless WisBlock Core plates, kuras varat pievienot savam Arduino dēļu sarakstam. Atlasiet un instalējiet RAKwireless RUI nRF plates

7. Kad BSP ir instalēts, atlasiet Rīki > Plātņu pārvaldnieks > RAKWireless RUI nRF moduļi > WisBlock Core RAK4631 plate.

Programmēšana RAK4631-R, izmantojot Visual Studio IDE

Visual Studio IDE lejupielāde un instalēšana

Ja jums vēl nav Visual Studio IDE, lejupielādējiet instalēšanas programmu Visual Studio IDE kopiena 2019 .

Windows iestatīšana

Instalējiet tikko lejupielādēto Visual Studio Community 2019 savā Windows datorā.

1. Noklikšķiniet uz pogas Turpināt.

2. Nākamajā instalēšanas logā atlasiet cilni Darbvirsmas izstrāde ar C++ un pēc tam noklikšķiniet uz pogas Instalēt.

3. Pēc veiksmīgas instalēšanas ir nepieciešama atsāknēšana. Pirms Visual Studio lietošanas restartējiet datoru.

4. Pēc datora restartēšanas lejupielādējiet Arduino IDE programmai Visual Studio 2019 .

• Alternatīva saite: Arduino IDE programmai Visual Studio 2019

5. Noklikšķiniet uz pogas Instalēt, lai instalētu Arduino IDE VSIX paplašinājumu.

• Arduino IDE VSIX instalēšana ir pabeigta.

Visual Studio Community 2019 konfigurēšana

1. Atveriet Visual Studio 2019, pēc tam noklikšķiniet uz Turpināt bez koda.

2. Cilnē Izvēlne noklikšķiniet uz Extensions un atlasiet vMicr, pēc tam Visual Micro Explorer.

3. Parādās Micro Explorer logs. Cilnē IDE atlasiet IDE Arduino 1.6/1.8, pēc tam noklikšķiniet uz cilnes IDE atrašanās vietas.

4. Pēc tam veiciet tālāk norādītās darbības, lai konfigurētu IDE atrašanās vietas:

• Laukā Lietot instalēto IDE atlasiet Arduino 1.6/1.8.
• Pārbaudiet, vai Arduino IDE jau ir instalēts mapē C: Program Files (x86)Arduino .
• Kopējiet RUI URL: https://raw.githubusercontent.com/RAKWireless/RAKwireless-Arduino-BSPIndex/main/package_rakwireless.com_rui_index.json un ielīmējiet to izvēles pievienošanas dēļu pārvaldniekā urls.

5. Instalējiet RAKwireless RUI nRF plates.

• Restartējiet Visual Studio IDE.
• Atveriet Visual Micro Explorer sadaļā Extensions -> vMicro -> Visual Micro Explorer.
• Noklikšķiniet uz cilnes Board Manager un atzīmējiet RAKwireless RUI nRF plates. Tas parādīs pieejamās RAKwireless RUI nRF plates versijas.

• Atlasiet jaunāko pieejamo RAKwireless RUI nRF plates versiju un pēc tam noklikšķiniet uz Labi, lai instalētu.

PIEZĪME
Varat arī instalēt RAKwireless RUI nRF plates, izmantojot RAK4631-R plates atbalsta paketi. Visual Studio IDE 2019 importē Arduino IDE iestatījumus.

Sastādīt Example Ar RAK4631-R

1. Palaidiet Visual Studio IDE un atveriet Visual Micro Explorer uz Extensions -> vMicro -> Visual Micro Explorer.

2. Noklikšķiniet uz Examples un pēc tam meklējiet RAK4631 RUI_V3_examples mape.

3. Programmā Visual Micro — palīdzība un piemamplogā noklikšķiniet uz pogas Atvērt kopiju.

4. Tagad aizveriet Micro Explorer logu un Solution Explorer logā atveriet Arduino skici:

• Noklikšķiniet uz x ikonas, lai aizvērtu Micro Explorer.
• Noklikšķiniet uz trīsstūra ikonas, lai atvērtu Solution Explorer.

5. Risinājumu pārlūkā zem RAK4631 noklikšķiniet uz RAK4631.ino file.

6. Konfigurējiet risinājumu, platformu un seriālo portu. Noklikšķiniet uz nolaižamās izvēlnes un izvēlieties tālāk norādīto.

• Risinājuma konfigurācijas lauks: Atlaidiet
• Risinājumu platformu lauks: x86
• Sērijas porta lauks: izvēlieties Windows ierīču pārvaldniekā noteikto RAK4631-R COM portu.

7. Noklikšķiniet uz ikonas Build and Upload (Izveidot un augšupielādēt), lai RAK4631-R parādītu projektu.

PIEZĪME:
Kad programmaparatūra tiek augšupielādēta, izmantojot Arduino IDE, RAK4631-R automātiski pāriet uz sāknēšanas režīmu.
Ja BOOT režīms netiek aktivizēts, divreiz velciet, lai iezemētu RESET tapu (vai veiciet dubultklikšķi uz atiestatīšanas pogas, ja tāda ir pieejama), lai piespiestu BOOT režīmu.

Pēc veiksmīgas augšupielādes tagad varat izmantot vēlamo konsoles UART rīku, lai izveidotu savienojumu ar RAK4631-R COM portu. Ja savienojums ir veiksmīgs, jūs redzēsit izvades ziņojumus.

8. Ievadiet šīs komandas, lai pārbaudītu pašreizējo programmaparatūras versiju:

AT pavēle ​​virs BLE

Šajā sadaļā ir parādīts, kā izmantot AT komandas, izmantojot BLE, izmantojot seriālo Bluetooth termināli.

Visas pieejamās komandas var atrast RAK4631-R AT komandu rokasgrāmatā.

1. Lejupielādējiet un instalējiet seriālo Bluetooth termināli, lai savienotu ierīci.

2. Pārliecinieties, vai jūsu mobilajā tālrunī ir ieslēgts Bluetooth.

3. Atlasiet Kategorija un pēc tam Ierīces.

4. Izvēlieties Bluetooth LE ikonu un noklikšķiniet uz ikonas SCAN, lai skenētu ierīci.

5. Lietotnes skeneru sarakstā atrodiet BLE ierīci ar nosaukumu “RAK.XXXXXX” un izveidojiet savienojumu ar šo ierīci.

PIEZĪME
Pēc noklusējuma RAK4631-R BLE signāls automātiski izslēdzas, ja pēc 30 sekundēm netiek izveidots savienojums. Izveidojiet savienojumu ar RAK4631-R BLE signālu tūlīt pēc atiestatīšanas pogas nospiešanas.

6. Pārliecinieties, vai savienojums ir izveidots veiksmīgi, izmantojot “RAK.XXXXXX”.

7. Nosūtiet AT komandu un pārbaudiet, vai attālā konsole ir saņemta.

8. Attālā ierīce saņems tās pašas AT komandas.

Dažādi

Arduino instalēšana

Dodieties uz Arduino oficiālo vietni webvietni un lejupielādējiet Arduino IDE . Varat skatīt vairākas operētājsistēmai Windows, Linux un Mac OS X pieejamās versijas. Izvēlieties pareizo Arduino IDE versiju un lejupielādējiet to.

Operētājsistēmai Windows

PIEZĪME
Operētājsistēmas Windows 10 lietotājiem: NEinstalējiet Arduino IDE no Microsoft App Store. Instalējiet sākotnējo Arduino IDE no Arduino amatpersonas webvietne. Arduino lietotnei no Microsoft App Store ir problēmas, izmantojot trešās puses padomes atbalsta pakotnes.

1. Instalējiet tikko lejupielādēto Arduino IDE savā Windows datorā.

2. Noklikšķiniet uz Es piekrītu, pēc tam uz Tālāk, lai turpinātu.

3. Noklikšķiniet uz Instalēt.

Pēc 100% progresa Arduino IDE ir veiksmīgi instalēts.

Linux

Pirmkārt, jums ir jāpārbauda saderība ar savu sistēmu un jāizvēlas starp 32 bitu, 64 bitu un ARM versijām Arduino IDE operētājsistēmai Linux.

Instalēšana, izmantojot tarbolu

1. Pēc pareizās Arduino versijas lejupielādes atveriet termināli un pēc tam palaidiet ls, lai pārbaudītu instalāciju file lejupielādes mapē.

2. Tarball ir saspiestas mapes veids, piemēram, .zip file, ko parasti izmanto programmatūras izplatīšanai operētājsistēmā Linux. Lai iegūtu files no tarbola, mainiet direktoriju uz to, kur atrodas lejupielādētais tarbols, un pēc tam palaidiet:

3. Kad tar komanda ir pabeigta, palaidiet ls vēlreiz. Tiks izveidota mape ar nosaukumu arduino versija.

4. Mainiet pašreizējo direktoriju un dodieties uz jaunizveidoto mapju direktoriju. Būs a file ar nosaukumu install.sh mapē. Lai instalētu Arduino IDE, izpildiet sudo ./install.sh.

Komanda sudo uz laiku paaugstina privilēģijas, ļaujot instalētājam veikt sensitīvus uzdevumus, nepiesakoties kā root lietotājs.

Mac OS X

Operētājsistēmā Mac OS X, tāpat kā Linux, nav instalēšanas procesa. Tas ir tikai dekompresijas process, pēc tam varat veiksmīgi atvērt Arduino IDE.

Arduino IDE detaļu rokasgrāmata

58. attēlā parādītas piecas (5) Arduino IDE daļas.

1. IDE opciju izvēlne
Varat konfigurēt dažus vispārīgus parametrus, piemēram, seriālo portu, plates informāciju, bibliotēkas, rediģēšanas parametrus un tā tālāk.

2. Darbības pogas
Darbības pogām ir piecas darbības:

• Pārbaudiet/kompilējiet avota kodu.
• Augšupielādējiet apkopoto kodu WisBlock.
• Atveriet jaunu Arduino IDE logu vai esošu lietojumprogrammu.
• Saglabājiet pašreizējo lietojumprogrammu.

3. Koda apgabals
Varat rediģēt avota kodu, kas vēlāk šajā apgabalā tiks apkopots un augšupielādēts programmā WisBlock.

4. Štata apgabals

5. Izvades ziņojumu apgabals Šajā apgabalā varat redzēt izvades ziņojumu neatkarīgi no tā, vai tā ir informācija par neveiksmi vai panākumiem.

Pēdējo reizi atjaunināts: 11., 9:2022:8

Dokumenti / Resursi

RAKwireless RAK4631-R WisBlock kodola modulis [pdfLietotāja rokasgrāmata RAK4631-R, RAK4631-R WisBlock kodola modulis, WisBlock kodola modulis, pamata modulis, modulis

Atsauces

• Lietotāja rokasgrāmata