USB-CAN шина интерфейсі
Адаптер интерфейсінің функциясы
Кітапхана пайдаланушы нұсқаулығы
БІРІНШІ БӨЛІМVIEW
Егер пайдаланушы CAN шинасының байланыс сынағына өту үшін жай ғана USB-CAN шиналық интерфейс адаптерін пайдаланса, содан кейін ол сынақ деректерін жіберу және қабылдау үшін берілген USB-CAN құралы бағдарламалық құралын тікелей пайдалана алады.
Егер пайдаланушы өз өнімдері үшін бағдарламалық жасақтама жазуды жоспарласа. Төмендегі нұсқауларды мұқият оқып шығыңыз және s сілтемесін алыңызampбіз қамтамасыз ететін код:
⑴ C++ Builder ⑵C# ⑶VC ⑷VB ⑸VB.NET ⑹Delphi ⑺LabVIEW ⑻ LabWindows/CVI ⑼Matlab ⑽QT ⑾Python/Python-can.
Кітапхананы дамыту file ：ControlCAN.lib, ControlCAN.DLL
VC нұсқасының функциясының мәлімдемесі file :ControlCAN.h
VB нұсқасының функциясының декларациясы file: ControlCAN.bas
ЗертханаVIEW нұсқа кітапханасы функциясы пакетінің модулі:ControlCAN.llb
Delphi нұсқасының функция декларациясы file: ControlCAN.pas
ЕКІНШІ БӨЛІМ Үйлесімді Функция КІТАПХАНА ЖӘНЕ ДЕРЕКТЕР ҚҰРЫЛЫМЫ
2.1. ТҮР АНЫҚТАУ
2.1.1. Құрылғы түрі
| Түр анықтамасы | Мәнді теріңіз | Сипаттама |
| DEV_USBCAN2 | 4 | USBCAN-2A/USBCAN-2C/CANalyst-II MiniPCIe-CAN |
2.1.2. VCI_BOARD_INFO
VCI_BOARD_INFO құрылымында USB-CAN сериясы интерфейс картасы құрылғысының ақпараты бар.
Құрылым VCI_ReadBoardInfo функциясында толтырылады.
Мүше:
hw_Version
Аппараттық нұсқаның нөмірі, он алтылық белгісі. Мысалы, 0x0100 V1.00 білдіреді.
fw_Нұсқасы
Аппараттық нұсқаның нөмірі, он алтылық белгісі. Мысалы, 0x0100 V1.00 білдіреді.
2-бет
dr_Version
Драйвер нұсқасының нөмірі, он алтылық белгісі. Мысалы, 0x0100 V1.00 білдіреді.
in_Version
Интерфейс кітапханасының нұсқасының нөмірі, он алтылық белгісі. Мысалы, 0x0100 V1.00 білдіреді.
irq_Num
Жүйе резервтелген.
can_Num
CAN арнасының жалпы санын білдіреді.
str_Serial_Num
Бұл тақта картасының сериялық нөмірі.
str_hw_Type
«USBCAN V1.00» сияқты аппараттық құрал түрі (Ескертпе: '\0' жол терминаторын қамтиды).
Резервтелген
Жүйе резервтелген.
2.1.3. VCI_CAN_OBJ
VCI_Transmit және VCI_Receive функцияларында VCI_CAN_OBJ құрылымы CAN хабарлама кадрын жіберу үшін пайдаланылады.
Мүше:
ID
Хабарлама идентификаторы. Тікелей идентификатор пішімі, оң жаққа тураланған, мынаны қараңыз: Бірінші қосымша: ID туралау мәліметтері.
УақытStamp
Қабылдау стamp уақыт шеңбері туралы ақпарат, CAN контроллері инициализацияланған кезде іске қосу уақыты, құрылғы 0. 1мс.
Уақыт жалауы
Уақытты пайдалану-пайдалану тұрғысынан стamp, 1 - тиімді уақыт Stamp. TimeFlag және TimeStamp кадр қабылданған кезде ғана мағыналы болады.
SendType
Жіберу түрі. = 0 Қалыпты түрді көрсетеді, = 1 Бір реттік жіберуді көрсетеді.
RemoteFlag
Мейлі ол шалғайдағы ту болсын. = 1 қашықтағы жалаушаны көрсетеді, = 0 деректер жалауын көрсетеді.
Сыртқы жалау
Ол сыртқы жалау болсын. = 1 сыртқы жалаушаны көрсетеді, = 0 стандартты жалаушаны көрсетеді.
DataLen
Деректер ұзындығы (<=8) ， яғни деректер ұзындығы.
Деректер
Пакеттік деректер.
Резервтелген
Жүйе резервтелген.
2.1.4. VCI_INIT_CONFIG
VCI_INIT_CONFIG құрылымы CAN баптандыру конфигурациясын анықтайды. Құрылым VCI_InitCan функциясында толтырылады.
Мүше:
AccCode
Сүзгіден өткен қабылдау кодын алыңыз.
AccMask
Сүзгі маскасын алыңыз.
Резервтелген
Резервтелген.
Сүзгі
0-3 диапазонын орнатуға мүмкіндік беретін сүзу әдісі, толық ақпаратты сүзгі режимі кестесінің 2.2.3 бөлімінен қараңыз.
Уақыт 0
SJA1000 жіберу жылдамдығы параметрі, Timing0 (BTR0) .
Уақыт 1
SJA1000 жіберу жылдамдығы параметрі, Timing1 (BTR1) .
Режим
Жұмыс режимі, 0 = қалыпты жұмыс, 1 = тек тыңдау режимі, 2 = өздігінен қабылдау және жіберу сынақ режимі.
Ескертпелер:
Сүзгі параметрлері туралы мынаны қараңыз: Қосымша II: CANпараметрін орнату нұсқаулары.
CAN Timing0 және Timing1 жіберу жылдамдығын орнату үшін пайдаланылады, бұл екі параметр тек инициализация кезінде пайдаланылады.tage.
Кәдімгі Boud анықтамалық кестесі:
| CAN жіберу жылдамдығы | Уақыт 0(BTR0) | Уақыт 1(BTR1) |
| 10 мың бит/с | 0x31 | 0х1С |
| 20 мың бит/с | 0x18 | 0х1С |
| 40 мың бит/с | 0x87 | 0xFF |
| 50 мың бит/с | 0x09 | 0х1С |
| 80 мың бит/с | 0x83 | 0xFF |
| 100 мың бит/с | 0x04 | 0х1С |
| 125 мың бит/с | 0x03 | 0х1С |
| 200 мың бит/с | 0x81 | 0xFA |
| 250 мың бит/с | 0x01 | 0х1С |
| 400 мың бит/с | 0x80 | 0xFA |
| 500 мың бит/с | 0x00 | 0х1С |
| 666 мың бит/с | 0x80 | 0xB6 |
| 800 мың бит/с | 0x00 | 0x16 |
| 1000 мың бит/с | 0x00 | 0x14 |
| 33.33 Кбит/с | 0x09 | 0x6F |
| 66.66 Кбит/с | 0x04 | 0x6F |
| 83.33 Кбит/с | 0x03 | 0x6F |
- Пайдаланушылар жіберу жылдамдығы параметрін орнату үшін тек SJA1000 (16 МГц) параметрін орындауы керек.
- Адаптер 10K-тан төмен уақытша жіберу жылдамдығын қолдамайды.
2.2. ФУНКЦИЯНЫҢ СИПАТТАМАСЫ
2.2.1. VCI_OpenDevice
Бұл функция құрылғыларды қосу үшін пайдаланылады.
DWORD __stdcall VCI_OpenDevice(DWORD DevType, DWORD DevIndex, DWORD сақталған);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
Резервтелген
Сақтау параметрлері, 0 толтырыңыз.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
2.2.2. VCI_CloseDevice
Бұл функция қосылымды жабу үшін пайдаланылады.
DWORD __stdcall VCI_CloseDevice(DWORD DevType,DWORD DevIndex);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
2.2.3. VCI_InitCan
Бұл функция көрсетілген CAN параметрін инициализациялау үшін пайдаланылады.
DWORD __stdcall VCI_InitCAN(DWORD DevType, DWORD DevIndex, DWORD CANIindex,
PVCI_INIT_CONFIG pInitConfig);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
CANindex
CAN арнасының индексі, мысалы, бір ғана CAN арнасы болғанда, индекс нөмірі 0, егер екеуі болса, индекс нөмірі 0 немесе 1 болуы мүмкін.
pInitConfig
Инициализация параметрінің құрылымы. Мүшелердің параметр тізімі:
| мүше | Функционалдық сипаттамасы |
| pInitConfig->AccCode | AccCode және AccMask қай пакеттерді қабылдауға болатынын анықтау үшін бірге жұмыс істей алады. Бұл екі регистр идентификаторды солға реттелген орнату үшін пайдаланылады, яғни AccCode және AccMask ең жоғары биті (Bit31) идентификатор мәнінің ең жоғары битімен тураланады. |
| pInitConfig->AccMask | Жеке куәлікті туралау туралы қосымшаларды қараңыз: I қосымша: ID туралау мәліметтері. Мысалы:AccCode мәнін 0x24600000 етіп орнатсаңыз (яғни 0x123 солға 21 битке жылжиды), AccMask мәні 0x00000000 мәніне орнатылған, содан кейін тек CAN хабарлама кадрының идентификаторы 0x123 болатын пакеттерді ғана қабылдауға болады (0x00000000 AccMask мәні барлық биттердің сәйкес екенін көрсетеді |
| бит). Егер AccCode мәні 0x24600000 мәніне орнатылса, AccMask мәні 0x600000 мәніне орнатылады (0x03 21 бит солға жылжиды), содан кейін CAN хабарлама кадрының идентификаторы 0x120 ~ 0x123 болатын пакеттерді ғана қабылдауға болады (AccMask мәні 0x600000 бит0 ~ бит1-ден басқа басқа биттердің (бит2 ~ бит10) сәйкес бит екенін көрсетеді). Ескерту: Бұл сүзгі параметрі, мысалыampстандартты жақтауға, мысалыample, жоғары 11-бит жарамды бит; кеңейтілген кадр жағдайында, содан кейін жарамды ID 29-бит болып табылады. AccCode және AccMask жарамды бит ретінде жоғары 29-битті орнатады! |
|
| pInitConfig-> Сақталған | сақталған |
| pInitConfig->Сүзгі | Сүзгі режимінің параметрлері сүзгі режимі кестесінің бөлімін қараңыз. |
| pInitConfig->Timing0 | Беріліс жылдамдығыT0 параметрі |
| pInitConfig->Timing1 | Беріліс жылдамдығыT1 параметрі |
| pInitConfig-> Режим | Жұмыс режимі: 0-қалыпты жұмыс 1-Тек тыңдау режимі 2-стихиялы қабылдау және жіберу сынақ режимі (бұл мән ZLG функциялары кітапханасынан алынып тасталды) |
Сүзгі режимінің кестесі:
| Мән | Аты | Сипаттама |
| 1 | Барлық түрлерін алыңыз | Стандартты және ұзартылған жақтауға сәйкес келеді! |
| 2 | Тек стандартты жақтауды алыңыз | Стандартты жақтауға жарамды және ұзартылған |
| жақтау тікелей сүзу арқылы жойылады! | ||
| 3 | Тек кеңейтілген кадрды алыңыз | Ұзартылған жақтауға жарамды және стандартты жақтау арқылы жойылады тікелей сүзу! . |
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
Мысалы
2.2.4. VCI_ReadBoardInfo
Бұл функция адаптердің аппараттық ақпаратын оқу үшін пайдаланылады. Жалпы айтқанда, оны елемеуге болады.
DWORD __stdcall VCI_ReadBoardInfo(DWORD DevType,DWORD
DevIndex,PVCI_BOARD_INFO pInfo);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен. pInfo
VCI_BOARD_INFO құрылғы ақпарат құрылымы көрсеткішін сақтау үшін пайдаланылады.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
2.2.5. VCI_GetReceiveNum
Бұл функция қабылданған, бірақ тағайындалған қабылдау буферінде оқылмаған кадрларды көрсету үшін пайдаланылады.
DWORD __stdcall VCI_GetReceiveNum(DWORD DevType, DWORD DevIndex, DWORD CANIindex);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болса, индекс сандары 0-ден бастап өсу ретімен.
CANindex
CAN арнасының индексі.
Қайтарулар:
Әлі оқылмаған кадрларды қайтарыңыз.
Мысалы
#include “ControlCan.h” int ret=VCI_GetReceiveNum(2,0,0);
2.2.6. VCI_ClearBuffer
Бұл функция арқылы белгіленген арнаның қабылдау және жіберу буферін тазалау үшін пайдаланылады
USB-CAN адаптері.
DWORD __stdcall VCI_ClearBuffer(DWORD DevType, DWORD DevIndex, DWORD CANIindex);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болса, индекс сандары 0-ден бастап өсу ретімен.
CANindex
CAN арнасының индексі.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
2.2.7. VCI_StartCAN
Бұл функция CAN контроллерін және адаптердің ішкі үзулерді қабылдау функциясын іске қосу үшін пайдаланылады.
DWORD __stdcall VCI_StartCAN(DWORD DevType, DWORD DevIndex, DWORD CANIindex);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
CANindex
CAN арнасының индексі.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
2.2.8. VCI_ResetCAN
Бұл функция CAN контроллерін бастапқы қалпына келтіру үшін пайдаланылады.
DWORD __stdcall VCI_ResetCAN(DWORD DevType, DWORD DevIndex, DWORD CANIindex);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
CANindex
CAN арнасының индексі.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
2.2.9. VCI_Transmit
Бұл функция CAN хабарлама жақтауын жіберу үшін пайдаланылады.
DWORD __stdcall VCI_Transmit(DWORD DeviceType, DWORD DeviceInd, DWORD CANInd,PVCI_CAN_OBJ pSend, DWORD ұзындығы);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
CANindex
CAN арнасының индексі. pSend
Жіберілуі тиіс деректер кадрының массивтерінің бірінші мекенжайы.
Ұзындығы
Жіберілуі тиіс деректер кадрларының саны, максималды саны - 1000, ұсынылған мән - жоғары жылдамдықта 48.
Қайтарулар:
Жіберілген кадрлардың нақты санын қайтарыңыз, қайтару мәні = -1 құрылғы қатесін көрсетеді.
Мысалы
2.2.10. VCI_Receive
Бұл функция қабылдауды сұрау үшін пайдаланылады.
DWORD __stdcall VCI_Receive(DWORD DevType, DWORD DevIndex, DWORD CANIndex, PVCI_CAN_OBJ қабылдау, ULONG Len, INT күту уақыты);
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
CANindex
CAN арнасының индексі.
қабылдау
Деректер кадрларының бірінші орнату көрсеткішін алу үшін.
Лен
Қалыпты хабарламаны қайтару үшін деректер кадрының массив ұзындығы 2500-ден көп болуы керек.
Әйтпесе, хабарлама алынғанына қарамастан, қайтару ұзындығы нөлге тең болады. адаптер әрбір арна үшін 2000 кадр буферін орнатады. Өз жүйесі мен жұмыс ортасына негізделген пайдаланушы 2500-ден сәйкес массив ұзындығын таңдай алады.
Күту уақыты сақталған.
Қайтарулар:
Шын мәнінде оқылған кадрлар санын қайтарыңыз, -1 құрылғы қателерін көрсетеді.
Мысалы
ҮШІНШІ БӨЛІМ БАСҚА ФУНКЦИЯЛАР ЖӘНЕ ДЕРЕКТЕР ҚҰРЫЛЫМЫНЫҢ СИПАТТАМАСЫ
Бұл тарауда ControlCAN.dll USB-CAN адаптер интерфейсінің кітапханасында қамтылған сәйкес келмейтін ZLG интерфейс кітапханасының басқа деректер түрлері мен функциялары сипатталған. Өтінемін, жасаңыз
үйлесімділікке әсер етпеу үшін қосымша әзірлеу үшін үйлесімді ZLG үлгісін пайдалансаңыз, бұл функцияларды шақырмаңыз.
3.1 ФУНКЦИЯНЫҢ СИПАТТАМАСЫ
3.1.1. VCI_UsbDeviceReset
USB-CAN адаптерін қалпына келтіріңіз, VCI_OpenDevice арқылы қалпына келтіргеннен кейін құрылғыны қайта ашу қажет.
DWORD __stdcall VCI_UsbDeviceReset(DWORD DevType, DWORD DevIndex, DWORD сақталған
Параметрлер:
DevType
Құрылғы түрі. Қараңыз: Адаптер құрылғысы түрінің анықтамасы.
DevIndex
Құрылғы индексі, мысалыample, тек бір USB-CAN адаптері болғанда, индекс нөмірі 0 болады, бірнеше USB-CAN адаптері болғанда, индекс сандары 0-ден басталатын өсу ретімен.
Резервтелген резервтелген.
Қайтарулар:
Қайтару мәні = 1, бұл операция сәтті болғанын білдіреді; = 0 операцияның орындалмағанын көрсетеді; = -1 құрылғының жоқ екенін көрсетеді.
bRel = VCI_UsbDeviceReset(nDeviceType, тәуелсіздік, 0);
3.1.2. VCI_FindUsbDevice2
Бір компьютер бірнеше USB-CAN пайдаланған кезде, пайдаланушы ағымдағы құрылғыны табу үшін осы функцияны пайдалана алады.
DWORD __stdcall VCI_FindUsbDevice2(PVCI_BOARD_INFO pInfo);
Параметрлер:
pInfo
pInfo бірінші деректер буферінің мекенжай көрсеткішінің параметрлерін сақтау үшін пайдаланылады.
Қайтарады
Компьютерге қосылған USB-CAN адаптерінің нөмірін қайтарыңыз.
Төртінші бөлім Интерфейс кітапханасының функциялары процесті пайдалану
Құрылғы функциясын көбейту үшін біз қосымша функцияларды бердік (жасыл фондық функциялар), бұл функцияларға мыналар кіреді: VCI_FindUsbDevice2 VCI_UsbDeviceReset. Екінші әзірлеу кезінде бұл функцияларды міндетті түрде шақыру қажет емес. Тіпті бұл функциялар еленбейді, барлық USB-CAN адаптерінің функцияларына қол жеткізуге болады.
www.waveshare.com
www.waveshare.com/wiki
Құжаттар / Ресурстар
 |
WAVESHARE USB-CAN шина аралық адаптер интерфейсі функцияларының кітапханасы [pdf] Instruction Manual USB-CAN шина аралық адаптер интерфейсі функциялары кітапханасы, USB-CAN, автобус аралық адаптер интерфейсі функцияларының кітапханасы, интерфейс функцияларының кітапханасы, функциялар кітапханасы |
