USB-CAN Bus Interface
Fungsi panganteur adaptor
Parentah Pamaké Perpustakaan
BAGIAN HIJIVIEW
Upami pangguna ngan ukur nganggo adaptor antarmuka beus USB-CAN pikeun uji komunikasi beus CAN, teras anjeunna tiasa langsung nganggo parangkat lunak USB-CAN Tool anu disayogikeun pikeun ngirim sareng nampi data tés.
Lamun pamaké intends nulis program software pikeun produk sorangan. Mangga taliti maca parentah di handap ieu sarta nyandak rujukan ti sampkodeu kami nyadiakeun:
⑴ C++ Pangwangun ⑵C# ⑶VC ⑷VB ⑸VB.NET ⑹Delphi ⑺LabVIEW ⑻ LabWindows/CVI ⑼Matlab ⑽QT ⑾Python/Python-can.
Ngembangkeun perpustakaan file ：ControlCAN.lib, ControlCAN.DLL
deklarasi fungsi Vérsi VC file ：ControlCAN.h
deklarasi fungsi Vérsi VB file: ControlCAN.bas
LabVIEW Vérsi perpustakaan fungsi pakét modul:ControlCAN.llb
Déklarasi fungsi versi Delphi file: ControlCAN.pas
BAGIAN DUA FUNGSI COMPATIBLE PERPUSTAKAAN JEUNG STRUKTUR DATA
2.1. DEFINISI TIPE
2.1.1. Tipe Alat
| Tipe Harti | Nilai tipe | Katerangan |
| DEV_USBCAN2 | 4 | USBCAN-2A / USBCAN-2C / CANalyst-II MiniPCIe-bisa |
2.1.2. VCI_BOARD_INFO
Struktur VCI_BOARD_INFO ngandung inpormasi alat kartu panganteur USB-CAN Series.
Strukturna bakal dieusi dina fungsi VCI_ReadBoardInfo.
Anggota:
hw_Vérsi
Nomer versi hardware, notasi heksadesimal. Misalna 0x0100 ngagambarkeun V1.00.
fw_Vérsi
Nomer versi hardware, notasi heksadesimal. Misalna 0x0100 ngagambarkeun V1.00.
Kaca 2
dr_Vérsi
Nomer versi supir, notasi héksadesimal. Misalna 0x0100 ngagambarkeun V1.00.
dina_Vérsi
Nomer versi perpustakaan antarmuka, notasi heksadesimal. Misalna 0x0100 ngagambarkeun V1.00.
irq_Num
Sistim ditangtayungan.
can_Num
Ngagambarkeun jumlah total saluran CAN.
str_Serial_Num
Jumlah serial kartu dewan ieu.
str_hw_Type
Jenis hardware, sapertos "USBCAN V1.00" (Catetan: Ngawengku string terminator '\0').
Ditangtayungan
Sistim ditangtayungan.
2.1.3. VCI_CAN_OBJ
Dina fungsi VCI_Transmit na VCI_Receive, struktur VCI_CAN_OBJ dipaké pikeun ngirimkeun pigura pesen BISA.
Anggota:
ID
Identifier pesen. Format ID langsung, di-align katuhu, mangga tingal: Lampiran Hiji: Rincian Alignment ID.
TimeStamp
Narima Stamp Inpo ngeunaan pigura waktos, mimitian timing nalika BISA controller ieu initialized, unit nyaeta 0. 1ms.
TimeFlag
Dina watesan naha ngagunakeun waktos Stamp, 1 nyaeta TimeSt éféktifamp. TimeFlag sareng TimeStamp ngan hartina lamun pigura geus narima.
SendType
Jenis ngirim. = 0 nunjukkeun tipe Normal, = 1 nunjukkeun Single Kirim.
Jauh Bandéra
Naha éta bandéra jauh. = 1 nunjukkeun bandéra jauh, = 0 nunjukkeun bandéra data.
ExternFlag
Naha éta bandéra éksternal. = 1 nunjukkeun bandéra éksternal, = 0 nunjukkeun bandéra baku.
DataLen
Panjang data (<=8) ， nyaéta panjang data.
Data
Data pakét.
Ditangtayungan
Sistim ditangtayungan.
2.1.4. VCI_INIT_CONFIG
Struktur VCI_INIT_CONFIG ngahartikeun konfigurasi initialization tina CAN. Strukturna bakal dieusi dina fungsi VCI_InitCan.
Anggota:
AccCode
Nampi kode ditampa disaring.
AccMask
Nampi saringan masker.
Ditangtayungan
Ditangtayungan.
Nyaring
Métode nyaring, ngamungkinkeun rentang setelan 0-3, tingal bagian 2.2.3 tabel mode filter pikeun detil.
Waktosna0
SJA1000 parameter laju Baud, Timing0 (BTR0) .
Waktosna1
SJA1000 parameter laju Baud, Timing1 (BTR1) .
Modus
Mode operasi, 0 = operasi normal, 1 = Dengekeun-hijina mode, 2 = pangakuan spontan sarta ngirim mode test.
Catetan:
Ngeunaan setelan filter mangga tingal: Annex II: CANparameter parentah setelan.
CAN Timing0 sareng Timing1 dianggo pikeun nyetél baud rate, dua parameter ieu ngan ukur dianggo dina s initialization.tage.
Méja rujukan Baud konvensional:
| BISA Baud laju | Waktos 0(BTR0) | Waktos 1(BTR1) |
| 10k bps | 0x31 | 0 x 1C |
| 20k bps | 0x18 | 0 x 1C |
| 40k bps | 0x87 | 0xFF |
| 50k bps | 0x09 | 0 x 1C |
| 80k bps | 0x83 | 0xFF |
| 100k bps | 0x04 | 0 x 1C |
| 125k bps | 0x03 | 0 x 1C |
| 200k bps | 0x81 | 0xFA |
| 250k bps | 0x01 | 0 x 1C |
| 400k bps | 0x80 | 0xFA |
| 500k bps | 0x00 | 0 x 1C |
| 666k bps | 0x80 | 0xB6 |
| 800k bps | 0x00 | 0x16 |
| 1000k bps | 0x00 | 0x14 |
| 33.33 Kbps | 0x09 | 0x6f |
| 66.66 Kbps | 0x04 | 0x6f |
| 83.33 Kbps | 0x03 | 0x6f |
- Pamaké ngan kudu nuturkeun SJA1000 (16MHz) pikeun nyetel parameter laju Baud.
- adaptor nu teu ngarojong samentara Baud laju handap 10K.
2.2. DESKRIPSI FUNGSI
2.2.1. VCI_OpenDevice
Pungsi ieu dipaké pikeun nyambungkeun alat.
DWORD __stdcall VCI_OpenDevice(DWORD DevType,DWORD DevIndex,DWORD Ditangtayungan);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
Ditangtayungan
Parameter ingetan, eusian 0.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
2.2.2. VCI_CloseDevice
Pungsi ieu dipaké pikeun nutup sambungan.
DWORD __stdcall VCI_CloseDevice(DWORD DevType,DWORD DevIndex);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
2.2.3. VCI_InitCan
Pungsi ieu dipaké pikeun initialize CAN dieusian.
DWORD __stdcall VCI_InitCAN(DWORD DevType, DWORD DevIndex, DWORD CANIndex,
PVCI_INIT_CONFIG pInitConfig);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
Indéks saluran CAN, sapertos nalika aya ngan hiji saluran CAN, jumlah indéksna 0, upami aya dua, nomer indéks tiasa 0 atanapi 1.
pInitConfig
Struktur parameter initialization. Daptar parameter anggota:
| Anggota | Pedaran Fungsional |
| pInitConfig->AccCode | AccCode sareng AccMask tiasa damel babarengan pikeun nangtukeun pakét mana anu tiasa ditampi. Dua register ieu dipaké pikeun nyetél ID kénca-Blok, nyaeta, bit pangluhurna (Bit31) tina AccCode na AccMask ieu Blok jeung bit pangluhurna nilai ID. |
| pInitConfig->AccMask | Ngeunaan alignment ID tingal lampiran: Lampiran I: Rincian alignment ID. Misalna: Upami anjeun nyetél nilai AccCode janten 0x24600000 (nyaéta 0x123 digeser ka kénca ku 21 bit), nilai AccMask disetel ka 0x00000000, teras ngan ukur pakét sareng CAN pesen pigura ID nyaéta 0x123 tiasa ditampi (nilai AccMask 0x00000000 nunjukkeun yén sadaya bit relevan. |
| bit). Upami nilai AccCode disetel ka 0x24600000, nilai AccMask disetel ka 0x600000 (0x03 digeser ka kénca ku 21 bit), lajeng ngan ukur pakét sareng ID pigura pesen CAN nyaéta 0x120 ~ 0x123 tiasa ditarima (nilai AccMask. 0x600000 nunjukkeun yén sajaba ti bit0 ~ bit1 bit séjén (bit2 ~ bit10) mangrupakeun bit relevan). Catetan: Ieu setelan filter examples kana pigura baku, pikeun example, 11-bit tinggi nyaéta bit valid; dina kasus pigura nambahan, lajeng ID valid nyaeta 29-bit. AccCode sareng AccMask nyetél 29-bit tinggi salaku bit anu valid! |
|
| pInitConfig-> Ditangtayungan | ditangtayungan |
| pInitConfig-> Saringan | Setélan mode nyaring mangga tingal bagian tina tabel mode filter. |
| pInitConfig-> Timing0 | Setélan baud rateT0 |
| pInitConfig-> Timing1 | Setélan baud rateT1 |
| pInitConfig-> Modeu | Modeu operasi: 0-operasi normal 1-Dengekeun-hijina mode 2-pangakuan spontan sareng modeu tés ngirim (nilai ieu dikaluarkeun tina perpustakaan fungsi ZLG) |
Méja saringan mode:
| Nilai | Ngaran | Katerangan |
| 1 | Nampi sagala jinis | Cocog sareng pigura standar sareng diperpanjang! |
| 2 | Ngan nampi pigura baku | Cocog jeung pigura baku, sarta ngalegaan |
| pigura bakal dihapus ku filtration langsung! | ||
| 3 | Ngan nampi pigura nambahan | Cocog jeung pigura nambahan, sarta pigura baku bakal dihapus ku filtrasi langsung! . |
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
Misalna
2.2.4. VCI_ReadBoardInfo
Pungsi ieu dipaké pikeun maca inpo hardware adaptor. Sacara umum, éta tiasa dipaliré.
DWORD __stdcall VCI_ReadBoardInfo(DWORD DevType,DWORD
DevIndex,PVCI_BOARD_INFO pInfo);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-bisa, angka indéks 0, lamun aya sababaraha USB- bisa adapters, angka indéks dina urutan naek mimitian ti 0. pInfo
VCI_BOARD_INFO dianggo pikeun nyimpen petunjuk struktur inpormasi alat.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
2.2.5. VCI_GetReceiveNum
Pungsi ieu dipaké pikeun nangtukeun narima tapi teu acan dibaca pigura dina panyangga narima ditunjuk.
DWORD __stdcall VCI_GetReceiveNum(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji USB-CAN adaptor, angka indéks 0, lamun aya sababaraha USB- CAN adapters, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
CAN indéks channel.
Wangsul:
Balikkeun pigura anu teu acan dibaca.
Misalna
#include "ControlCan.h" int ret = VCI_GetReceiveNum (2,0,0);
2.2.6. VCI_ClearBuffer
Pungsi ieu dipaké pikeun mupus narima jeung ngirim panyangga tina channel ditunjuk dieusian ku
USB-CAN adaptor.
DWORD __stdcall VCI_ClearBuffer(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji USB-CAN adaptor, angka indéks 0, lamun aya sababaraha USB- CAN adapters, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
CAN indéks channel.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
2.2.7. VCI_StartCAN
Pungsi ieu dipaké pikeun ngamimitian CAN controller jeung interupsi interupsi fungsi panarimaan adaptor nu.
DWORD __stdcall VCI_StartCAN(DWORD DevType,DWORD DevIndex,DWORD CANINdex);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
CAN indéks channel.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
2.2.8. VCI_ResetCAN
Pungsi ieu dipaké pikeun ngareset CAN controller.
DWORD __stdcall VCI_ResetCAN(DWORD DevType,DWORD DevIndex,DWORD CANIndex);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
CAN indéks channel.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
2.2.9. VCI_Transmit
Pungsi ieu dipaké pikeun ngirim pigura pesen CAN.
DWORD __stdcall VCI_Transmit(DWORD DeviceType,DWORD DeviceInd,DWORD CANInd,PVCI_CAN_OBJ pSend,DWORD Length);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
CAN indéks channel. pKirim
Alamat kahiji tina arrays pigura data nu kudu dikirim.
Panjangna
Jumlah pigura data anu kudu dikirim, jumlah maksimum nyaéta 1000, nilai dianjurkeun nyaéta 48 dina speed tinggi.
Wangsul:
Balikkeun jumlah sabenerna pigura geus dikirim, nilai balik = -1 nunjukkeun kasalahan alat.
Misalna
2.2.10. VCI_Receive
Pungsi ieu dipaké pikeun ménta panarimaan.
DWORD __stdcall VCI_Receive(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_CAN_OBJ pReceive, ULONG Len, INT WaitTime);
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
CANIndeks
CAN indéks channel.
pReceive
Pikeun nampa set pointer kahiji tina pigura data.
Len
Panjang Asép Sunandar Sunarya pigura data kudu leuwih ti 2500 pikeun mulangkeun pesen normal.
Upami teu kitu, panjangna mulang bakal nol naha pesen anu ditampi atanapi henteu. adaptor nyetél panyangga 2000-pigura pikeun unggal saluran. Dumasar sistem sorangan sareng lingkungan kerjana, pangguna tiasa milih panjangna Asép Sunandar Sunarya ti 2500.
WaitTime Ditangtayungan.
Wangsul:
Balik jumlah pigura nu sabenerna geus dibaca, -1 nunjukkeun kasalahan alat.
Misalna
BAGIAN TILU FUNGSI LAIN JEUNG DESKRIPSI STRUKTUR DATA
bab ieu ngajelaskeun tipe data sejen tur fungsi perpustakaan panganteur ZLG sauyunan dikandung dina USB-bisa adaptor panganteur perpustakaan ControlCAN.dll. Mangga atuh
teu nelepon fungsi ieu lamun make model ZLG cocog pikeun ngembangkeun sekundér ku kituna teu mangaruhan kasaluyuan.
3.1 DESKRIPSI FUNGSI
3.1.1. VCI_UsbDeviceReset
Reset adaptor USB-CAN, kedah muka deui alat saatos ngareset nganggo VCI_OpenDevice.
DWORD __stdcall VCI_UsbDeviceReset(DWORD DevType,DWORD DevIndex,DWORD Ditangtayungan
Parameter:
DevType
Jinis alat. Tempo: Harti tipe alat adaptor.
DevIndex
Indéks Alat, contonaample, lamun aya ngan hiji adaptor USB-CAN, angka indéks nyaeta 0, lamun aya sababaraha adapters USB-BISA, angka indéks dina urutan naek mimitian ti 0.
Ditangtayungan Ditangtayungan.
Wangsul:
Nilai balik = 1, nu hartina operasi suksés; = 0 nunjukkeun yén operasi gagal; = -1 nunjukkeun yén alat teu aya.
bRel = VCI_UsbDeviceReset(nDeviceType, Kamerdikaan, 0);
3.1.2. VCI_FindUsbDevice2
Nalika PC anu sami nganggo sababaraha USB-CAN, pangguna tiasa nganggo fungsi ieu pikeun milarian alat anu ayeuna.
DWORD __stdcall VCI_FindUsbDevice2(PVCI_BOARD_INFO pInfo);
Parameter:
pInfo
pInfo dipaké pikeun nyimpen parameter tina pointer alamat panyangga data munggaran.
Mulih
Balikkeun nomer adaptor USB-CAN anu dicolokkeun kana komputer.
Bagian Opat Fungsi Perpustakaan Antarmuka Ngagunakeun Prosés
Pikeun ngalikeun fungsi alat, kami nyayogikeun fungsi tambahan (fungsi anu disayogikeun ku latar héjo), fungsi ieu kalebet: VCI_FindUsbDevice2 VCI_UsbDeviceReset. Salila pamekaran kadua, fungsi ieu henteu kedah dianggo. Malah fungsi ieu teu dipaliré, sadaya fungsi adaptor USB-CAN bisa dihontal.
www.waveshare.com
www.waveshare.com/wiki
Dokumén / Sumberdaya
 |
WAVESHARE USB-bisa Bus Inter raray adaptor Interface Perpustakaan Fungsi [pdf] Instruksi Manual USB-CAN Bus Interface Adaptor Interface Function Library, USB-CAN, Bus Interface Adapter Interface Function Library, Interface Function Library, Function Library |
