USB-CAN kopnes interfeiss
Adaptera interfeisa funkcija
Bibliotēkas lietotāja instrukcija
PIRMĀ DAĻA BEIGASVIEW
Ja lietotājs vienkārši izmanto USB-CAN kopnes interfeisa adapteri, lai veiktu CAN kopnes komunikācijas testu, un tad viņš var tieši izmantot komplektācijā iekļauto USB-CAN Tool programmatūru testa datu nosūtīšanai un saņemšanai.
Ja lietotājs plāno rakstīt programmatūras programmu saviem produktiem. Lūdzu, uzmanīgi izlasiet tālāk sniegtos norādījumus un ņemiet vērā sampmūsu nodrošinātais kods:
⑴ C++Builder ⑵C# ⑶VC ⑷VB ⑸VB.NET ⑹ Delphi ⑺LabVIEW ⑻ LabWindows/CVI ⑼Matlab ⑽QT ⑾Python/Python-can.
Attīstīt bibliotēku file ：ControlCAN.lib, ControlCAN.DLL
VC versijas funkcijas deklarācija file ：ControlCAN.h
VB versijas funkciju deklarācija file: ControlCAN.bas
LabVIEW versijas bibliotēkas funkciju pakotnes modulis ：ControlCAN.llb
Delphi versijas funkciju deklarācija file: ControlCAN.pas
OTRĀ DAĻA SADERĪGA FUNKCIJAS BIBLIOTĒKA UN DATU STRUKTŪRA
2.1. TIPA DEFINĪCIJA
2.1.1. Ierīces veids
| Tipa definīcija | Ierakstiet vērtību | Apraksts |
| DEV_USBCAN2 | 4 | USBCAN-2A/USBCAN-2C/CANalyst-II MiniPCIe-CAN |
2.1.2. VCI_BOARD_INFO
VCI_BOARD_INFO struktūra satur USB-CAN sērijas interfeisa kartes ierīces informāciju.
Struktūra tiks aizpildīta funkcijā VCI_ReadBoardInfo.
Biedrs:
hw_Version
Aparatūras versijas numurs, heksadecimālais apzīmējums. Piemēram, 0x0100 apzīmē V1.00.
fw_Version
Aparatūras versijas numurs, heksadecimālais apzīmējums. Piemēram, 0x0100 apzīmē V1.00.
2. lpp
dr_Version
Draivera versijas numurs, heksadecimālais apzīmējums. Piemēram, 0x0100 apzīmē V1.00.
in_Version
Interfeisa bibliotēkas versijas numurs, heksadecimālais apzīmējums. Piemēram, 0x0100 apzīmē V1.00.
irq_Num
Sistēma rezervēta.
can_Num
Apzīmē kopējo CAN kanālu skaitu.
str_Serial_Num
Šīs dēļa kartes sērijas numurs.
str_hw_Tips
Aparatūras veids, piemēram, “USBCAN V1.00” (piezīme: ietver virknes terminatoru “\0”).
Rezervēts
Sistēma rezervēta.
2.1.3. VCI_CAN_OBJ
Funkcijās VCI_Transmit un VCI_Receive, CAN ziņojuma rāmja pārsūtīšanai tiek izmantota VCI_CAN_OBJ struktūra.
Biedrs:
ID
Ziņojuma identifikators. Tiešais ID formāts, līdzinājums pa labi, lūdzu, skatiet: XNUMX. pielikumu: informācija par ID līdzinājumu.
TimeStamp
Saņemot svamp informācija par laika posmu, sākuma laiks, kad CAN kontrolleris ir inicializēts, mērvienība ir 0. 1ms.
Laika karogs
Runājot par to, vai izmantot laiku stamp, 1 ir efektīvais TimeStamp. TimeFlag un TimeStamp ir nozīmīgi tikai tad, kad tiek saņemts kadrs.
SendType
Sūtīšanas veids. = 0 norāda uz parasto veidu, = 1 norāda uz vienu sūtīšanu.
RemoteFlag
Vai tas ir attālināts karogs. = 1 norāda attālo karogu, = 0 norāda datu karogu.
Ārējais karogs
Vai tas ir ārējais karogs. = 1 apzīmē ārējo karogu, = 0 norāda standarta karogu.
DataLen
Datu garums (<=8) ， tas ir, datu garums.
Dati
Pakešu dati.
Rezervēts
Sistēma rezervēta.
2.1.4. VCI_INIT_CONFIG
VCI_INIT_CONFIG struktūra nosaka CAN inicializācijas konfigurāciju. Struktūra tiks aizpildīta VCI_InitCan funkcijā.
Biedrs:
AccCode
Saņemiet filtrētu pieņemšanas kodu.
AccMask
Saņemiet filtra masku.
Rezervēts
Rezervēts.
Filtrs
Filtrēšanas metode, kas pieļauj iestatījumu diapazonu 0-3, sīkāku informāciju skatiet filtra režīmu tabulas 2.2.3. sadaļā.
Laiks 0
SJA1000 Pārraides ātruma parametrs, Timing0 (BTR0) .
Laiks 1
SJA1000 Pārraides ātruma parametrs, Timing1 (BTR1) .
Režīms
Darba režīms, 0 = normāla darbība, 1 = tikai klausīšanās režīms, 2 = spontāna uzņemšana un nosūtīšanas testa režīms.
Piezīmes:
Informāciju par filtra iestatījumiem skatiet: II pielikums: CANparametra iestatīšanas instrukcijas.
CAN Timing0 un Timing1 tiek izmantoti, lai iestatītu bodu ātrumu, šie divi parametri tiek izmantoti tikai inicializācijas stage.
Parastā Baud atsauces tabula:
| CAN Baud likme | Laiks0 (BTR0) | Laiks1 (BTR1) |
| 10 kb/s | 0x31 | 0x1C |
| 20 kb/s | 0x18 | 0x1C |
| 40 kb/s | 0x87 | 0xFF |
| 50 kb/s | 0x09 | 0x1C |
| 80 kb/s | 0x83 | 0xFF |
| 100 kb/s | 0x04 | 0x1C |
| 125 kb/s | 0x03 | 0x1C |
| 200 kb/s | 0x81 | 0xFA |
| 250 kb/s | 0x01 | 0x1C |
| 400 kb/s | 0x80 | 0xFA |
| 500 kb/s | 0x00 | 0x1C |
| 666 kb/s | 0x80 | 0xB6 |
| 800 kb/s | 0x00 | 0x16 |
| 1000 kb/s | 0x00 | 0x14 |
| 33.33 Kb/s | 0x09 | 0x6F |
| 66.66 Kb/s | 0x04 | 0x6F |
| 83.33 Kb/s | 0x03 | 0x6F |
- Lai iestatītu pārraides ātruma parametru, lietotājiem ir jāievēro tikai SJA1000 (16MHz).
- Adapteris īslaicīgi neatbalsta datu pārraides ātrumu, kas mazāks par 10 K.
2.2. FUNKCIJAS APRAKSTS
2.2.1. VCI_OpenDevice
Šo funkciju izmanto ierīču savienošanai.
DWORD __stdcall VCI_OpenDevice(DWORD DevType,DWORD DevIndex,DWORD rezervēts);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
Rezervēts
Saglabāšanas parametri, ierakstiet 0.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
2.2.2. VCI_CloseDevice
Šī funkcija tiek izmantota, lai aizvērtu savienojumu.
DWORD __stdcall VCI_CloseDevice(DWORD DevType,DWORD DevIndex);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
2.2.3. VCI_InitCan
Šī funkcija tiek izmantota, lai inicializētu norādīto CAN.
DWORD __stdcall VCI_InitCAN(DWORD DevType, DWORD DevIndex, DWORD CANIindex,
PVCI_INIT_CONFIG pInitConfig);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss, piemēram, ja ir tikai viens CAN kanāls, indeksa numurs ir 0, ja ir divi, indeksa numurs var būt 0 vai 1.
pInitConfig
Inicializācijas parametru struktūra. Dalībnieku parametru saraksts:
| Biedrs | Funkcionālais apraksts |
| pInitConfig-> AccCode | AccCode un AccMask var strādāt kopā, lai noteiktu, kuras paketes var pieņemt. Šie divi reģistri tiek izmantoti, lai iestatītu ID līdzinājumu pa kreisi, tas ir, AccCode augstākais bits (Bit31) un AccMask tiek saskaņots ar ID vērtības augstāko bitu. |
| pInitConfig-> AccMask | Par ID izlīdzināšanu skatiet pielikumus: I pielikums: ID līdzināšanas informācija. Piemēram: ja iestatāt AccCode vērtību kā 0x24600000 (ti, 0x123 tiek pārvietots pa kreisi par 21 bitu), AccMask vērtība ir iestatīts uz 0x00000000, un tad var pieņemt tikai tās paketes ar CAN ziņojuma kadra ID ir 0x123 (AccMask vērtība 0x00000000 norāda, ka visi biti ir atbilstoši |
| biti). Ja AccCode vērtība ir iestatīta uz 0x24600000, AccMask vērtība ir iestatīta uz 0x600000 (0x03 tiek pārvietots pa kreisi par 21 bitu), un tad var pieņemt tikai tās paketes ar CAN ziņojuma kadra ID ir 0x120 ~ 0x123 (AccMask vērtība 0x600000 norāda, ka bez bit0 ~ bit1 citi biti (bit2 ~ bit10) ir svarīgi biti). Piezīme: Šis filtra iestatījums, piemampuz standarta rāmi, piemēramample, augstais 11 bits ir derīgais bits; paplašinātā kadra gadījumā, un tad derīgais ID ir 29 bitu. AccCode un AccMask kā derīgo bitu ir iestatīti 29 biti! |
|
| pInitConfig-> Rezervēts | rezervēts |
| pInitConfig-> Filtrs | Filtrēšanas režīma iestatījumus skatiet filtra režīmu tabulas sadaļā. |
| pInitConfig->Timing0 | Pārraides ātrumaT0 iestatījums |
| pInitConfig->Timing1 | Pārraides ātrumaT1 iestatījums |
| pInitConfig-> Mode | Darbības režīms: 0-normāla darbība 1-Tikai klausīšanās režīms 2 spontānas uzņemšanas un nosūtīšanas testa režīms (šī vērtība nav iekļauta ZLG funkciju bibliotēkā) |
Filtru režīmu tabula:
| Vērtība | Vārds | Apraksts |
| 1 | Saņem visu veidu | Piemērots gan standarta, gan pagarinātajam rāmim! |
| 2 | Saņemiet tikai standarta rāmi | Piemērots standarta rāmim un pagarinātam |
| rāmis tiks noņemts tieši filtrējot! | ||
| 3 | Saņemiet tikai pagarināto kadru | Piemērots pagarinātam rāmim, un standarta rāmis tiks noņemts filtrēšana tieši! . |
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
Piem
2.2.4. VCI_ReadBoardInfo
Šī funkcija tiek izmantota, lai nolasītu adaptera aparatūras informāciju. Vispārīgi runājot, to var ignorēt.
DWORD __stdcall VCI_ReadBoardInfo(DWORD DevType,DWORD
DevIndex,PVCI_BOARD_INFO pInfo);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0. pInfo
VCI_BOARD_INFO tiek izmantots, lai saglabātu ierīces informācijas struktūras rādītāju.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
2.2.5. VCI_GetReceiveNum
Šī funkcija tiek izmantota, lai norādītu saņemtos, bet nav nolasītos kadrus norādītajā saņemšanas buferī.
DWORD __stdcall VCI_GetReceiveNum(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss.
Atgriež:
Atgriezt vēl neizlasītos kadrus.
Piem
#include “ControlCan.h” int ret=VCI_GetReceiveNum(2,0,0);
2.2.6. VCI_ClearBuffer
Šī funkcija tiek izmantota, lai notīrītu norādītā kanāla saņemšanas un nosūtīšanas buferi
USB-CAN adapteris.
DWORD __stdcall VCI_ClearBuffer(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
2.2.7. VCI_StartCAN
Šo funkciju izmanto, lai palaistu CAN kontrolieri un adaptera iekšējo pārtraukumu uztveršanas funkciju.
DWORD __stdcall VCI_StartCAN(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
2.2.8. VCI_ResetCAN
Šī funkcija tiek izmantota, lai atiestatītu CAN kontrolleri.
DWORD __stdcall VCI_ResetCAN(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
2.2.9. VCI_Transmit
Šī funkcija tiek izmantota, lai nosūtītu CAN ziņojuma rāmi.
DWORD __stdcall VCI_Transmit(DWORD ierīces tips, DWORD ierīces veids, DWORD CANInd, PVCI_CAN_OBJ pSūtīšana, DWORD garums);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss. pSūtīt
Pirmā nosūtāmo datu rāmju masīvu adrese.
Garums
Nosūtāmo datu kadru skaits, maksimālais skaits ir 1000, ieteicamā vērtība ir 48 lielā ātrumā.
Atgriež:
Atgriezt faktisko jau nosūtīto kadru skaitu, atgriešanas vērtība = -1 norāda uz ierīces kļūdu.
Piem
2.2.10. VCI_Saņemt
Šī funkcija tiek izmantota, lai pieprasītu saņemšanu.
DWORD __stdcall VCI_Receive(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_CAN_OBJ pReceive, ULONG Len, INT WaitTime);
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
CANindekss
CAN kanāla indekss.
pSaņemt
Lai saņemtu datu kadru pirmo iestatīto rādītāju.
Len
Lai atgrieztu parasto ziņojumu, datu rāmja masīva garumam ir jābūt lielākam par 2500.
Pretējā gadījumā atgriešanas garums būs nulle neatkarīgi no tā, vai ziņojums ir saņemts vai nē. adapteris katram kanālam iestatīja 2000 kadru buferi. Pamatojoties uz savu sistēmu un darba vidi, lietotājs var izvēlēties piemērotu masīva garumu no 2500.
Gaidīšanas laiks rezervēts.
Atgriež:
Atgriež faktiski nolasīto kadru skaitu, -1 norāda ierīces kļūdas.
Piem
TREŠĀ DAĻA CITAS FUNKCIJAS UN DATU STRUKTŪRAS APRAKSTS
Šajā nodaļā ir aprakstīti citi USB-CAN adaptera interfeisa bibliotēkas ControlCAN.dll nesaderīgās ZLG interfeisa bibliotēkas datu tipi un funkcijas. Lūdzu dari
neizsaukt šīs funkcijas, ja sekundārajai izstrādei izmantojat saderīgu ZLG modeli, lai neietekmētu saderību.
3.1 FUNKCIJAS APRAKSTS
3.1.1. VCI_UsbDeviceReset
Atiestatiet USB-CAN adapteri. Pēc atiestatīšanas ierīce ir atkārtoti jāatver, izmantojot VCI_OpenDevice.
DWORD __stdcall VCI_UsbDeviceReset(DWORD DevType,DWORD DevIndex,DWORD rezervēts
Parametri:
DevType
Ierīces veids. Skatiet: Adaptera ierīces tipa definīcija.
DevIndex
Ierīces indekss, piemēram,ampja ir tikai viens USB-CAN adapteris, indeksa numurs ir 0, ja ir vairāki USB-CAN adapteri, indeksa numuri augošā secībā, sākot no 0.
Rezervēts Rezervēts.
Atgriež:
Atgriešanas vērtība = 1, kas nozīmē, ka darbība ir veiksmīga; = 0 norāda, ka darbība neizdevās; = -1 norāda, ka ierīce neeksistē.
bRel = VCI_UsbDeviceReset(nDeviceType, Independence, 0);
3.1.2. VCI_FindUsbDevice2
Ja viens un tas pats dators izmanto vairākus USB-CAN, lietotājs var izmantot šo funkciju, lai atrastu pašreizējo ierīci.
DWORD __stdcall VCI_FindUsbDevice2(PVCI_BOARD_INFO pInfo);
Parametri:
pInfo
pInfo izmanto, lai saglabātu pirmā datu bufera adreses rādītāja parametrus.
Atgriežas
Atgrieziet datoram pievienotā USB-CAN adaptera numuru.
Ceturtā daļa Interfeisa bibliotēkas funkcijas, izmantojot procesu
Lai pavairotu ierīces funkciju, mēs nodrošinājām papildu funkcijas (funkcijas, kas attēlotas ar zaļu fonu), šīs funkcijas ietver: VCI_FindUsbDevice2 VCI_UsbDeviceReset. Otrās izstrādes laikā šīs funkcijas nav obligāti jāizmanto. Pat šīs funkcijas tiek ignorētas, var sasniegt visas USB-CAN adaptera funkcijas.
www.waveshare.com
www.waveshare.com/wiki
Dokumenti / Resursi
 |
WAVESHARE USB-CAN kopnes interfeisa adaptera interfeisa funkciju bibliotēka [pdfLietošanas instrukcija USB-CAN kopnes interfeisa adaptera interfeisa funkciju bibliotēka, USB-CAN, kopnes interfeisa adaptera interfeisa funkciju bibliotēka, interfeisa funkciju bibliotēka, funkciju bibliotēka |
