NanoLib C++ Ríomhchlárú
Eolas Táirge
Sonraíochtaí
- Ainm Táirge: NanaLib
- Ríomhchlárú Teanga: C++
- Leagan Táirgí: 1.3.0
- Leagan Lámhleabhar Úsáideora: 1.4.2
Tá leabharlann NanoLib deartha le haghaidh bogearraí rialaithe ríomhchlárú do rialtóirí Nanotec. Soláthraíonn sé comhéadan úsáideora, feidhmiúlachtaí lárnacha, agus leabharlanna cumarsáide chun forbairt feidhmchlár rialaithe a éascú.
Treoracha Úsáide Táirge
- Sula dTosaíonn Tú:
- Cinntigh go gcomhlíonann do chóras na riachtanais crua-earraí atá sonraithe sa lámhleabhar. Áirítear ar an lucht féachana atá beartaithe don táirge seo forbróirí atá ag iarraidh bogearraí rialaithe a chruthú do rialtóirí Nanotec.
- Ag Tosú:
- Chun NanoLib a úsáid, lean na céimeanna seo:
- Tosaigh trí NanoLib a iompórtáil isteach i do thionscadal.
- Cumraigh socruithe do thionscadail de réir mar is gá.
- Tóg do thionscadal chun feidhmiúlachtaí NanoLib a ionchorprú.
- Tionscadail a Chruthú:
- Is féidir leat tionscadail a chruthú le haghaidh timpeallachtaí Windows agus Linux araon. Lean na treoracha sonracha a chuirtear ar fáil sa lámhleabhar do gach ardán.
- Tagairt Aicmí / Feidhmeanna:
- Déan tagairt don lámhleabhar úsáideora le haghaidh treoir mhionsonraithe ar na ranganna agus na feidhmeanna atá ar fáil i NanoLib le haghaidh bogearraí rialaithe ríomhchlárú.
CCanna
- C: Cad é cuspóir NanoLib?
- A: Is leabharlann é NanoLib le haghaidh bogearraí rialaithe ríomhchlárú do rialtóirí Nanotec, a sholáthraíonn feidhmiúlachtaí riachtanacha agus cumais chumarsáide.
- C: Conas is féidir liom tosú le NanoLib?
- A: Tosaigh trí NanoLib a iompórtáil isteach i do thionscadal, socruithe tionscadail a chumrú, agus tógáil do thionscadal chun úsáid a bhaint as gnéithe NanoLib.
“`
Nanolib lámhleabhar úsáideora
C++
Bailí le leagan táirge 1.3.0
Leagan Lámhleabhar Úsáideora: 1.4.2
Aidhm agus coinbhinsiúin a dhoiciméadú
Déanann an doiciméad seo cur síos ar shocrú agus úsáid na leabharlainne NanoLib agus tá tagairt ann do gach rang agus feidhm chun do bhogearraí rialaithe féin a ríomhchlárú do rialtóirí Nanotec. Úsáidimid na cló-aghaidheanna seo a leanas:
Déanann téacs a bhfuil líne faoi a mharcáil crostagairt nó hipearnasc.
Example 1: Le haghaidh treoracha cruinne ar an NanoLibAccessor, féach Socrú. example 2: Suiteáil an tiománaí Ixxat agus ceangail an t-adapter CAN-to-USB. Ciallaíonn téacs iodálach: Is réad ainmnithe é seo, conair / mír roghchláir, cluaisín / file ainm nó (más gá) slonn teanga iasachta.
Example 1: Roghnaigh File > Nua > Doiciméad Bán. Oscail an táb Uirlisí agus roghnaigh Comment. example 2: Roinneann an doiciméad seo úsáideoirí (= Nutzer; usuario; utente; utilisateur; utente etc.) ó:
– Úsáideoir tríú páirtí (= Drittnutzer; tercero usuario; terceiro utente; tiers utilisateur; terzo utente etc.). – Úsáideoir deiridh (= Endnutzer; usuario final; utente final; utilisateur final; utente finale etc.).
Marcanna cúiréireachta bloic cód nó orduithe ríomhchlárúcháin. example 1: Trí Bash, cuir glaoch ar sudo déan shuiteáil chun rudaí roinnte a chóipeáil; ansin glaoigh ar ldconfig. example 2: Úsáid an fheidhm NanoLibAccessor seo a leanas chun an leibhéal logála i NanoLib a athrú:
// ***** C++ athraitheach *****
setLoggingLevel (leibhéal LogLevel);
Cuireann téacs trom béim ar fhocail aonair ríthábhachtacha. Mar mhalairt air sin, cuireann marcanna lúibíní lúibíní béim ar an (!) ríthábhachtach.
Example 1: Cosain tú féin, daoine eile agus do threalamh. Lean ár nótaí sábháilteachta ginearálta a bhaineann go ginearálta le gach táirge Nanotec.
Example 2: Chun do chosaint féin, lean freisin nótaí sábháilteachta sonracha a bhaineann leis an táirge sonrach seo. Ciallaíonn an briathar comhchliceáil cliceáil trí eochair luiche tánaisteach chun roghchlár comhthéacs a oscailt etc.
Example 1: Comhchliceáil ar an file, roghnaigh Athainmnigh, agus athainmnigh an file. example 2: Chun na hairíonna a sheiceáil, comh-cliceáil ar an file agus roghnaigh Airíonna.
Leagan: doc 1.4.2 / NanoLib 1.3.0
4
Sula dtosaíonn tú
Sula dtosaíonn tú ag baint úsáide as NanoLib, ullmhaigh do ríomhaire agus cuir tú féin ar an eolas faoin úsáid atá beartaithe agus faoi na teorainneacha leabharlainne.
2.1 Riachtanais chórais agus crua-earraí
FÓGRA Mífheidhm ón oibríocht 32-giotán nó ón gcóras scortha! Córas 64-giotán a úsáid agus a chothabháil go seasta. Breathnaigh ar scor agus treoracha OEM.
Tacaíonn NanoLib 1.3.0 le gach táirge Nanotec le CANopen, Modbus RTU (USB ar phort com fíorúil), Modbus TCP, EtherCat, agus Profinet. Do NanoLibs níos sine: Féach changelog san rian. Ar do phriacal amháin: úsáid córais oidhreachta. Nóta: Lean treoracha bailí OEM chun an latency a shocrú chomh híseal agus is féidir má bhíonn fadhbanna agat agus tú ag baint úsáide as cuibheoir USB bunaithe ar FTDI.
Riachtanais (córas 64-giotán éigeantach)
Windows 10 nó 11 w/ Visual Studio 2019 leagan 16.8 nó níos déanaí agus Windows SDK 10.0.20348.0 (leagan 2104) nó níos déanaí
C ++ athdháilte 2017 nó níos airde CANopen: Ixxat VCI nó tiománaí bunúsach PCAN (roghnach) Modúl EtherCat / Profinet DCP: modúl Npcap nó WinPcap RESTful: Npcap, WinPcap, nó cead riaracháin chun
cumarsáid a dhéanamh le bootloaders Ethernet
Linux w/ Ubuntu 20.04 LTS go 24 (gach x64 agus arm64)
Ceanntásca eithne agus paicéad libpopt-dev Profinet DCP: CAP_NET_ADMIN agus CAP_NET_RAW abili-
ceangail CANopen: Tiománaí Ixxat ECI nó adapter Buaic PCAN-USB EtherCat: CAP_NET_ADMIN, CAP_NET_RAW agus
Cumais CAP_SYS_NICE RESTful: CAP_NET_ADMIN cumas cumarsáid a dhéanamh w/ Eth-
bootloaders ernet (molta freisin: CAP_NET_RAW)
Teanga, cuibheoirí bus páirce, cáblaí
C++ GCC 7 nó níos airde (Linux)
EtherCAT: Cábla Ethernet VCP / mol USB: anois stóráil mais USB USB aonfhoirmeach: cábla USB REST: Cábla Ethernet CANopen: Ixxat USB-go-CAN V2; Na-
nóta ZK-USB-CAN-1, Buaic-oiriúnóir PCANUSB Uimh tacaíocht Ixxat do Ubuntu ar arm64
Modbus RTU: Nanotec ZK-USB-RS485-1 nó adapter coibhéiseach; Cábla USB ar phort com fíorúil (VCP)
Modbus TCP: Cábla Ethernet de réir na mbileog táirge
2.2 Úsáid agus lucht féachana atá beartaithe
Is éard atá i NanoLib ná leabharlann cláir agus comhpháirt bogearraí chun rialtóirí Nanotec a oibriú agus cumarsáid a dhéanamh leo i raon leathan feidhmeanna tionsclaíochta agus do ríomhchláraitheoirí cuí-oilte amháin.
Mar gheall ar chrua-earraí éagumasach fíor-ama (PC) agus córas oibriúcháin, níl NanoLib le húsáid in iarratais a dteastaíonn gluaiseacht il-ais sioncrónach orthu nó go ginearálta atá íogair ó thaobh ama de.
Ní féidir i gcás ar bith leat NanoLib a chomhtháthú mar chomhpháirt sábháilteachta i dtáirge nó i gcóras. Nuair a sheachadtar iad chuig úsáideoirí deiridh, ní mór duit fógraí rabhaidh agus treoracha comhfhreagracha maidir le húsáid shábháilte agus oibriú sábháilte a chur le gach táirge a bhfuil comhpháirt monaraithe Nanotec ann. Ní mór duit gach fógra rabhaidh arna eisiúint ag Nanotec a chur ar aghaidh díreach chuig an úsáideoir deiridh.
2.3 Scóip seachadta agus bharántas
Tagann NanoLib mar fhillteán * .zip ónár íoslódáil websuíomh le haghaidh EMEA / APAC nó AMERICA. Déan do íoslódáil a stóráil agus a dhí-zipeáil go cuí roimh an socrú. I bpacáiste NanoLib tá:
Leagan: doc 1.4.2 / NanoLib 1.3.0
5
2 Sula dtosaíonn tú
Ceanntásca comhéadain mar chód foinse (API)
Feidhmeanna lárnacha mar leabharlanna i bhformáid dhénártha: nana-
Leabharlanna a éascaíonn cumarsáid: nanolibm_ lib.dll
[do bhus páirce].dll etc.Example tionscadal: Example.sln (Visual Studio
tionscadal) agus example.cpp (príomh file)
Maidir le raon an bharántais, breathnaigh le do thoil a) ár dtéarmaí agus coinníollacha maidir le ceachtar den EMEA / APAC nó AMERICA agus b) téarmaí ceadúnais go léir. Nóta: Níl Nanotec faoi dhliteanas as cáilíocht lochtach nó míchuí, láimhseáil, suiteáil, oibriú, úsáid agus cothabháil trealaimh tríú páirtí! Ar mhaithe le sábháilteacht chuí, lean treoracha bailí OEM i gcónaí.
Leagan: doc 1.4.2 / NanoLib 1.3.0
6
An ailtireacht NanoLib
Ligeann struchtúr bogearraí modúlach NanoLib duit feidhmeanna rialaithe mótair / bus páirce inoiriúnaithe faoi shaoirse a shocrú timpeall ar chroílár atá réamhthógtha go docht. Tá na modúil seo a leanas i NanoLib:
Comhéadan úsáideora (API)
croí NanoLib
Ranganna comhéadain agus cúntóirí a Leabharlanna a
Leabharlanna cumarsáide Leabharlanna a bhaineann go sonrach le Fieldbus a
rochtain a fháil ort ar fheidhmiúlacht do rialtóra feidhmiúlacht API do comhéadan idir NanoLib
OD (foclóir réad)
idirghníomhú le leabharlanna bus.
crua-earraí lárnacha agus bus.
bonn ar chroífheidhm NanoLib-
náisiúntachtaí.
3.1 Comhéadan úsáideora
Is éard atá sa comhéadan úsáideora ná comhéadan ceanntásc files is féidir leat é a úsáid chun rochtain a fháil ar pharaiméadair an rialaitheora. Ceadaíonn na ranganna comhéadan úsáideora mar a thuairiscítear sa tagairt Ranganna / feidhmeanna duit:
Ceangail leis an dá na crua-earraí (fieldbus adapter) agus an gléas rialaithe. Faigh rochtain ar OD an ghléis, chun paraiméadair an rialtóra a léamh/a scríobh.
3.2 croí NanoLib
Tagann croí NanoLib leis an leabharlann allmhairithe nanolib.lib. Cuireann sé feidhmiúlacht an chomhéadain úsáideora i bhfeidhm agus tá sé freagrach as:
Na leabharlanna cumarsáide a lódáil agus a bhainistiú. Feidhmiúlachtaí an chomhéadain úsáideora a sholáthar sa NanoLibAccessor. Tá an pointe iontrála cumarsáide seo de-
fíneálacha a dhéanamh ar shraith oibríochtaí is féidir leat a dhéanamh ar leabharlanna lárnacha agus cumarsáide NanoLib.
3.3 Leabharlanna cumarsáide
Chomh maith le nanotec.services.nanolib.dll (úsáideach do do Stiúideo Plug & Drive roghnach), cuireann NanoLib na leabharlanna cumarsáide seo a leanas ar fáil:
nanolibm_canopen.dll nanolibm_modbus.dll
nanolibm_ethercat.dll nanolibm_restful-api.dll
nanolibm_usbmmsc.dll nanolibm_profinet.dll
Leagann gach leabharlann ciseal astarraingthe crua-earraí idir croí agus rialtóir. Luchtaíonn an croí iad ag am tosaithe ón bhfillteán tionscadail ainmnithe agus úsáideann sé iad chun cumarsáid a bhunú leis an rialtóir trí phrótacal comhfhreagrach.
Leagan: doc 1.4.2 / NanoLib 1.3.0
7
Ag tosnú
Léigh conas NanoLib a shocrú go cuí do do chóras oibriúcháin agus conas crua-earraí a nascadh de réir mar is gá.
4.1 Ullmhaigh do chóras
Sula ndéantar na tiománaithe oiriúnaithe a shuiteáil, ullmhaigh do ríomhaire feadh an chórais oibriúcháin ar dtús. Chun an ríomhaire a ullmhú feadh do Windows OS, suiteáil MS Visual Studio le C ++ síntí. Chun déanamh agus gcc le Linux Bash a shuiteáil, cuir glaoch ar sudo apt install build-sentials. Cumasaigh cumais CAP_NET_ADMIN, CAP_NET_RAW, agus CAP_SYS_NICE don fheidhmchlár a úsáideann NanoLib: 1. Glaoigh ar sudo setcap 'cap_net_admin,cap_net_raw,cap_sys_nice+eip'
ainm >. 2. Ach ansin, a shuiteáil do thiománaithe adapter.
4.2 Suiteáil an tiománaí adapter Ixxat do Windows
Is féidir leat adapter USB-go-CAN V2 Ixxat a úsáid ach amháin tar éis an tiománaí a shuiteáil. Léigh lámhleabhar táirge na dtiomántáin USB, le fáil amach an bhfuil / conas an compórt fíorúil (VCP) a ghníomhachtú. 1. Íoslódáil agus suiteáil tiománaí VCI 4 Ixxat do Windows ó www.ixxat.com. 2. Ceangail adapter dhlúth USB-go-CAN V2 Ixxat leis an ríomhaire trí USB. 3. Le Bainisteoir Gléas: Seiceáil an bhfuil an tiománaí agus an cuibheoir araon suiteáilte/aitheanta go cuí.
4.3 Suiteáil an tiománaí Peak adapter do Windows
Is féidir leat adapter PCAN-USB Peak a úsáid ach amháin tar éis an tiománaí a shuiteáil. Léigh lámhleabhar táirge na dtiomántáin USB, le fáil amach an bhfuil / conas an compórt fíorúil (VCP) a ghníomhachtú. 1. Íoslódáil agus suiteáil an socrú tiománaí gléas Windows (= pacáiste suiteála w / tiománaithe gléas, uirlisí, agus
APIs) ó http://www.peak-system.com. 2. Ceangail adapter PCAN-USB Peak leis an ríomhaire trí USB. 3. Le Bainisteoir Gléas: Seiceáil an bhfuil an tiománaí agus an cuibheoir araon suiteáilte/aitheanta go cuí.
4.4 Suiteáil an tiománaí adapter Ixxat le haghaidh Linux
Is féidir leat adapter USB-go-CAN V2 Ixxat a úsáid ach amháin tar éis an tiománaí a shuiteáil. Nóta: Teastaíonn do cheadanna ó oiriúnóirí eile a dtacaítear leo le sudo chmod +777/dev/ttyACM* (* uimhir gléis). Léigh lámhleabhar táirge na dtiomántáin USB, le fáil amach an bhfuil / conas an compórt fíorúil (VCP) a ghníomhachtú. 1. Suiteáil na bogearraí is gá don tiománaí ECI agus feidhmchlár taispeána:
sudo apt-get update apt-get install libusb-1.0-0-dev libusb-0.1-4 libc6 libstdc++6 libgcc1 buildessential
2. Íoslódáil an tiománaí ECI-for-Linux ó www.ixxat.com. Unzip é trí:
unzip eci_driver_linux_amd64.zip
3. Suiteáil an tiománaí trí:
cd /EciLinux_amd/src/KernelModule sudo déan install-usb
4. Seiceáil le haghaidh suiteáil tiománaí rathúil tríd an iarratas taispeána a thiomsú agus a thosú:
cd /EciLinux_amd/src/EciDemos/ sudo déan cd /EciLinux_amd/bin/release/ ./LinuxEciDemo
Leagan: doc 1.4.2 / NanoLib 1.3.0
8
4 Tús a chur leis
4.5 Suiteáil an tiománaí adapter Buaic le haghaidh Linux
Is féidir leat adapter PCAN-USB Peak a úsáid ach amháin tar éis an tiománaí a shuiteáil. Nóta: Teastaíonn do cheadanna ó oiriúnóirí eile a dtacaítear leo le sudo chmod +777/dev/ttyACM* (* uimhir gléis). Léigh lámhleabhar táirge na dtiomántáin USB, le fáil amach an bhfuil / conas an compórt fíorúil (VCP) a ghníomhachtú. 1. Seiceáil an bhfuil ceanntásca eithne ag do Linux: ls /usr/src/linux-headers-`uname -r`. Mura bhfuil, suiteáil
iad: sudo apt-get install linux-headers-`uname -r` 2. Anois, suiteáil an paicéad libpopt-dev: sudo apt-get install libpopt-dev 3. Íoslódáil an pacáiste tiománaí atá ag teastáil (buaic-linux-driver- xxx.tar.gz) ó www.peak-system.com. 4. Chun é a dhíphacáil, bain úsáid as: tar xzf peak-linux-driver-xxx.tar.gz 5. Sa fhillteán díphacáil: Tiomsaigh agus suiteáil na tiománaithe, bunleabharlann PCAN, etc.: déan gach
sudo make install 6. Chun an fheidhm a sheiceáil, plug an cuibheoir PCAN-USB isteach.
a) Seiceáil an modúl eithne:
lsmod | grep pcan b) … agus an leabharlann roinnte:
ls -l / usr/lib/libpcan*
Nóta: Má tharlaíonn fadhbanna USB3, bain úsáid as port USB2.
4.6 Ceangail do chrua-earraí
Chun a bheith in ann tionscadal NanoLib a reáchtáil, ceangail rialtóir Nanotec comhoiriúnach leis an ríomhaire ag baint úsáide as d'oiriúntóir. 1. Trí chábla oiriúnach, ceangail do adapter leis an rialtóir. 2. Ceangail an adapter leis an ríomhaire de réir an bhileog sonraí adapter. 3. Cumhacht ar an rialtóir ag baint úsáide as soláthar cumhachta oiriúnach. 4. Más gá, athraigh socruithe cumarsáide an rialaitheora Nanotec mar a threoraítear ina lámhleabhar táirge.
4.7 Luchtaigh NanoLib
Chun tús a chur leis an gcéad dul síos le bunghnéithe tapa agus éasca, féadfaidh tú (ach ní féidir) úsáid a bhaint as ár sean-ample tionscadal. 1. Ag brath ar do réigiún: Íoslódáil NanoLib ónár websuíomh le haghaidh EMEA / APAC nó AMERICA. 2. Unzip an phacáiste files / fillteáin agus ná roghnaigh rogha amháin: Le haghaidh bunúsacha tapaidh agus éasca: Féach Ag tosú an example tionscadal. Le haghaidh saincheaptha chun cinn i Windows: Féach Cruthú do thionscadal Windows féin. Le haghaidh saincheaptha chun cinn i Linux: Féach Cruthú do thionscadal Linux féin.
Leagan: doc 1.4.2 / NanoLib 1.3.0
9
Ag tosú ar an seanample tionscadal
Le NanoLib luchtaithe go cuí, tá an t-example project léiríonn tú trí úsáid NanoLib le rialtóir Nanotec. Nóta: I gcás gach céime, tá tuairimí san example cód mínigh na feidhmeanna a úsáidtear. An seanample tionscadal comhdhéanta de: an `* _functions_example.*' files, ina bhfuil na feidhmeanna don chomhéadan NanoLib feidhmíonn an `* _callback_example.*' files, ina bhfuil feidhmithe do na aisghlaonna éagsúla (scanadh, sonraí agus
logáil) an `roghchlár_*.*' file, ina bhfuil an loighic roghchláir agus cód an Example.* file, arb é an príomhchlár é, ag cruthú an roghchláir agus ag tosú na paraiméadair go léir a úsáidtear an Sampler_example.* file, ina bhfuil an seanample feidhmiú le haghaidh sampúsáid ler. Is féidir leat teacht ar níos mó examples, le roinnt orduithe gluaisne do mhodhanna oibríochta éagsúla, sa Bhonn Eolais ag nanotec.com. Tá siad go léir inúsáidte i Windows nó Linux.
I Windows le Visual Studio 1. Oscail an Example.sln file. 2. Oscail an seanample.cpp. 3. Tiomsú agus rith an example cód.
I Linux via Bash 1. Unzip an fhoinse file, nascleanúint go dtí an fillteán le hábhar unzipped. An príomh file don seanample is
example.cpp. 2. Sa bash, glaoigh ar:
a. “sudo make install” chun na cuspóirí comhroinnte a chóipeáil agus ldconfig a ghlaoch. b. “déan gach rud” chun an tástáil inrite a thógáil. 3. Tá sean-inrite san fhillteán araidample file. De réir bash: Téigh go dtí an fillteán aschuir agus cineál ./example. Mura dtarlaíonn aon earráid, tá do chuid rudaí comhroinnte suiteáilte go cuí anois, agus tá do leabharlann réidh le húsáid. Má léann an earráid ./example: earráid agus leabharlanna roinnte á luchtú: libnanolib.so: ní féidir réad roinnte a oscailt file: Níl a leithéid file nó eolaire, theip ar shuiteáil na n-oibiachtaí roinnte. Sa chás seo, lean na chéad chéimeanna eile. 4. Cruthaigh fillteán nua laistigh de /usr/local/lib (cearta riaracháin ag teastáil). Isteach sa bhash, mar sin clóscríobh:
sudo mkdir /usr/local/lib/nanotec
5. Cóipeáil gach réad roinnte ón zip filefillteán 'lib:
suiteáil ./lib/*.so /usr/local/lib/nanotec/
6. Seiceáil an t-ábhar ar an fillteán sprice le:
ls -al /usr/local/lib/nanotec/
Ba cheart go liostódh sé an réad roinnte files ón bhfillteán lib. 7. Rith ldconfig ar an bhfillteán seo:
sudo ldconfig /usr/local/lib/nanotec/
An seanample cuirtear i bhfeidhm é mar fheidhmchlár CLI agus soláthraíonn sé comhéadan roghchláir. Tá na hiontrálacha roghchláir bunaithe ar chomhthéacs agus beidh siad cumasaithe nó díchumasaithe, ag brath ar staid an chomhthéacs. Tugann siad deis duit feidhmeanna éagsúla leabharlainne a roghnú agus a fheidhmiú tar éis an tsreafa oibre tipiciúil chun rialtóir a láimhseáil: 1. Seiceáil an ríomhaire le haghaidh crua-earraí ceangailte (oiriúnóirí) agus liostaigh iad. 2. Nasc le adapter a bhunú. 3. Scan an bus le haghaidh feistí rialaitheora nasctha. 4. Ceangail le gléas.
Leagan: doc 1.4.2 / NanoLib 1.3.0
10
5 Ag tosú ar an seanample tionscadal
5. Déan tástáil ar cheann amháin nó níos mó d'fheidhmeanna na leabharlainne: Léigh/scríobh ó/chuig foclóir oibiachta an rialaitheora, nuashonraigh an firmware, uaslódáil agus rith clár NanoJ, cuir an mótar ar siúl agus tiúnta é, cumraigh agus úsáid an logáil/na logaíampler.
6. Dún an nasc, ar dtús chuig an bhfeiste, ansin chuig an adapter.
Leagan: doc 1.4.2 / NanoLib 1.3.0
11
Ag cruthú do thionscadal Windows féin
Cruthaigh, tiomsaigh agus rith do thionscadal Windows féin chun NanoLib a úsáid.
6.1 Iompórtáil NanoLib
Iompórtáil an ceanntásc NanoLib files agus leabharlanna trí MS Visual Studio.
1. Stiúideo Amharc Oscailte. 2. Trí Cruthaigh tionscadal nua > Consól App C++ > Ar Aghaidh: Roghnaigh cineál tionscadail. 3. Ainmnigh do thionscadal (anseo: NanolibTest) chun fillteán tionscadail a chruthú sa Solution Explorer. 4. Roghnaigh Críochnaigh. 5. Oscail na fuinneoga file taiscéalaí agus déan nascleanúint chuig an bhfillteán tionscadail nua cruthaithe. 6. Cruthaigh dhá fhillteán nua, inc agus lib. 7. Oscail an fillteán pacáiste NanoLib. 8. Ó ann: Cóipeáil an ceanntásc files ón bhfillteán áireamh isteach i d'fhillteán tionscadail inc agus gach .lib agus .dll
files chuig d’fhillteán tionscadail nua lib. 9. Seiceáil d'fhillteán tionscadail le haghaidh struchtúr cuí, le haghaidh example:
fillteán ect don struchtúr cuí:
. NanolibTest inc accessor_factory.hpp bus_hardware_id.hpp … od_index.hpp result_od_entry.hpp lib nanolibm_canopen.dll nanolib.dll … nanolib.lib NanolibTest.cpp NanolibTest.vcxproj NanolibTest.vcxproj.filters.filters. NanolibTest.sln
6.2 Cumraigh do thionscadal
Bain úsáid as an Solution Explorer in MS Visual Studio chun tionscadail NanoLib a chur ar bun. Nóta: Chun oibriú ceart NanoLib, roghnaigh an chumraíocht scaoileadh (ní dífhabhtaithe!) i socruithe tionscadail Visual C++; ansin déan an tionscadal a thógáil agus a nascadh le hamanna rite VC na n-earraí in-athdháilte C++ [2022].
1. Sa Réiteach Explorer: Téigh go dtí d'fhillteán tionscadail (anseo: NanolibTest). 2. Comhchliceáil ar an bhfillteán chun an roghchlár comhthéacs a oscailt. 3. Roghnaigh Airíonna. 4. Gníomhachtaigh Gach cumraíocht agus Gach ardán. 5. Roghnaigh C/C++ agus téigh go dtí an Eolaire Breise san áireamh. 6. Ionsáigh: $(ProjectDir)Nanolib/áirítear;%(AdditionalIncludeDirectories) 7. Roghnaigh Nascóir agus téigh chuig Eolaire Leabharlainne Breise. 8. Ionsáigh: $(ProjectDir)Nanolib;%(AdditionalLibraryDirectories) 9. Leathnaigh Nascóir agus roghnaigh Ionchur. 10.Téigh go Spleáchais Bhreise agus cuir isteach: nanolib.lib;%(AdditionalDependencies) 11.Confirm via OK.
Leagan: doc 1.4.2 / NanoLib 1.3.0
12
6 Do thionscadal Windows féin a chruthú
12.Téigh go Cumraíocht > C++ > Teanga > Caighdeán Teanga > Caighdeán ISO C++17 agus socraigh an caighdeán teanga go C++17 (/std:c++17).
6.3 Tóg do thionscadal
Tóg do thionscadal NanoLib in MS Visual Studio. 1. Oscail an príomh *.cpp file (anseo: nanolib_example.cpp) agus cuir an cód in eagar, más gá. 2. Roghnaigh Tógáil > Bainisteoir Cumraíochta. 3. Ardáin réitigh Ghníomhach a athrú go x64. 4. Deimhnigh trí Dún. 5. Roghnaigh Tógáil > Tóg réiteach. 6. Gan earráid? Seiceáil an bhfuil d'aschur tiomsaithe ag tuairisciú go cuí:
1>—— Glan tosaithe: Tionscadal: NanolibTest, Cumraíocht: Dífhabhtaithe x64 —–========= Glan: D'éirigh le 1, theip ar 0, níor éirigh le 0 =========
Leagan: doc 1.4.2 / NanoLib 1.3.0
13
7 Do thionscadal Linux féin a chruthú
7 Do thionscadal Linux féin a chruthú
Cruthaigh, tiomsaigh agus rith do thionscadal Linux féin chun NanoLib a úsáid. 1. Sa trealamh suiteála NanoLib unzipped: Oscailte /nanotec_nanolib. 2. Faigh gach réad roinnte sa tar.gz file. 3. Roghnaigh rogha amháin: Suiteáil gach lib le Déanfile nó de láimh.
7.1 Suiteáil na réada roinnte le Makefile
Bain úsáid as Déanfile le Linux Bash chun gach réamhshocrú * .so a shuiteáil go huathoibríoch files. 1. Via Bash: Téigh go dtí an fillteán ina bhfuil an déanamhfile. 2. Cóipeáil na réada roinnte trí:
sudo make install 3. Deimhnigh trí:
ldconfig
7.2 Suiteáil na rudaí roinnte de láimh
Bain úsáid as Bash chun gach * .so a shuiteáil files de NanoLib de láimh. 1. Trí Bash: Cruthaigh fillteán nua laistigh /usr/local/lib. 2. Cearta riaracháin ag teastáil! Cineál:
sudo mkdir /usr/local/lib/nanotec 3. Athraigh chuig an bhfillteán pacáiste suiteála gan zipped. 4. Cóipeáil gach réad roinnte ón bhfillteán lib trí:
shuiteáil ./nanotec_nanolib/lib/*.so /usr/local/lib/nanotec/ 5. Seiceáil ábhar an fhillteáin sprice trí:
ls -al /usr/local/lib/nanotec/ 6. Seiceáil an bhfuil gach réad roinnte ón bhfillteán lib liostaithe. 7. Rith ldconfig ar an bhfillteán seo trí:
sudo ldconfig /usr/local/lib/nanotec/
7.3 Cruthaigh do thionscadal
Le do rudaí roinnte suiteáilte: Cruthaigh tionscadal nua do do Linux NanoLib. 1. Via Bash: Cruthaigh fillteán tionscadail nua (anseo: NanoLibTest) trí:
mkdir NanoLibTest cd NanoLibTest
2. Cóipeáil an ceanntásc files chuig fillteán áireamh (anseo: inc) via: mkdir inc cp / FILE IS>/nanotec_nanolib/inc/*.hpp inc
3. Cruthaigh príomhlíonra file (NanoLibTest.cpp) trí: # cuir “accessor_factory.hpp” san áireamh #cuir san áireamh
Leagan: doc 1.4.2 / NanoLib 1.3.0
14
7 Do thionscadal Linux féin a chruthú
int príomh(){ nlc::NanoLibAccessor *accessor = getNanoLibAccessor();
nlc::ResultBusHwIds toradh = accessor->listAvailableBusHardware();
if(result.hasError()) { std::cout << result.getError() << std::endl; }
eile{ std::cout << “Success” << std::endl; }
cúlpháirtí a scriosadh; filleadh 0; }
4. Seiceáil d'fhillteán tionscadail le haghaidh struchtúr cuí:
. NanoLibTest
inc accessor_factory.hpp bus_hardware_id.hpp … od_index.hpp result.hpp NanoLibTest.cpp
7.4 Do thionscadal a thiomsú agus a thástáil
Déan do Linux NanoLib réidh le húsáid trí Bash.
1. Via Bash: Tiomsaigh an príomh- file via:
g++ -Wall -Wextra -pedantic -I./inc -c NanoLibTest.cpp -o NanoLibTest
2. Nasc an inrite le chéile trí:
g++ -Wall -Wextra -pedantic -I./inc -o tástáil NanoLibTest.o L/usr/local/lib/nanotec -lnanolib -ldl
3. Rith an clár tástála trí:
./tástáil
4. Seiceáil má thuairiscíonn do Bash go cuí:
rath
Leagan: doc 1.4.2 / NanoLib 1.3.0
15
8 Tagairt do ranganna/feidhmeanna
8 Tagairt do ranganna/feidhmeanna
Faigh anseo liosta de ranganna comhéadan úsáideora NanoLib agus a bhfeidhmeanna ball. Áirítear le cur síos tipiciúil ar fheidhm réamhrá gearr, sainmhíniú na feidhme agus paraiméadar / liosta fillte:
ExampleFunction () Insíonn sé duit go hachomair cad a dhéanann an fheidhm.
folús fíorúil nlc ::NanoLibAccessor::ExampleFunction (Param_a const & param_a, Param_b const & param_B)
Paraiméadair param_a param_b
Filleann ResultVoid
Trácht breise más gá. Trácht breise más gá.
8.1 NanoLibAccessor
Rang comhéadain a úsáidtear mar phointe iontrála chuig na NanoLib. Breathnaíonn sreabhadh oibre tipiciúil mar seo:
1. Tosaigh ag scanadh le haghaidh crua-earraí le NanoLibAccessor.listAvailableBusHardware (). 2. Socraigh na socruithe cumarsáide le BusHardwareOptions (). 3. Oscail an nasc crua-earraí le NanoLibAccessor.openBusHardwareWithProtocol (). 4. Scan an bus le haghaidh feistí nasctha le NanoLibAccessor.scanDevices (). 5. Cuir gléas le NanoLibAccessor.addDevice (). 6. Ceangail leis an bhfeiste le NanoLibAccessor.connectDevice (). 7. Tar éis an oibríocht a chríochnú, dícheangail an gléas le NanoLibAccessor.disconnectDevice (). 8. Bain an gléas le NanoLibAccessor.removeDevice (). 9. Dún an nasc crua-earraí le NanoLibAccessor.closeBusHardware ().
Tá na feidhmeanna ball poiblí seo a leanas ag NanoLibAccessor:
listAvailableBusHardware () Úsáid an fheidhm seo chun na crua-earraí fieldbus atá ar fáil a liostú.
Toradh FíorúilBusHwIds nlc ::NanoLibAccessor ::listAvailableBusHardware ()
Filleann ToradhBusHwIds
Seachadann sé eagar ID bus páirce.
openBusHardwareWithProtocol () Úsáid an fheidhm seo chun crua-earraí bus a nascadh.
Virtual ResultVoid nlc ::NanoLibAccessor ::openBusHardwareWithProtocol (BusHardwareId const & busHwId, BusHardwareOptions const & busHwOpt)
Paraiméadair busHwId busHwOpt
Filleann ResultVoid
Sonraíonn an fieldbus a oscailt. Sonraíonn sé roghanna oscailte bus páirce. Deimhníonn sé gur rith feidhm fholús.
isBusHardwareOpen () Úsáid an fheidhm seo le seiceáil an bhfuil do nasc crua-earraí bus páirce oscailte.
Virtual ResultVoid nlc ::NanoLibAccessor ::openBusHardwareWithProtocol (const BusHardwareId & busHwId, const BusHardwareOptions & busHwOpt)
Leagan: doc 1.4.2 / NanoLib 1.3.0
16
8 Tagairt do ranganna/feidhmeanna
Paraiméadair Tuairisceáin BusHardwareId fíor
bréagach
Sonraíonn sé gach bus páirce le hoscailt. Tá crua-earraí oscailte. Tá crua-earraí dúnta.
getProtocolSpecificAccessor () Úsáid an fheidhm seo chun an réad rochtana prótacail-shonrach a fháil.
Virtual ResultVoid nlc ::NanoLibAccessor ::getProtocolSpecificAccessor (BusHardwareId const & busHwId)
Paraiméadair BusHwId Returns ResultVoid
Sonraítear an bus páirce chun an cúlpháirtí a fháil dó. Deimhníonn sé gur rith feidhm fholús.
getProfinetDCP () Úsáid an fheidhm seo chun tagairt do chomhéadan Profinet DCP a chur ar ais.
ProfinetDCP fíorúil & getProfinetDCP ()
Filleann ProfinetDCP
faigheannSamplerInterface () Úsáid an fheidhm seo chun tagairt a fháil don sampcomhéadan ler.
fíorúil SamplerInterface & faigheannSamplerInterface ()
Filleann SamplerInterface
Tagraíonn sé do na samprang comhéadan ler.
setBusState () Úsáid an fheidhm seo chun staid an phrótacail bhus a shocrú go sonrach.
Virtual ResultVoid nlc ::NanoLibAccessor ::setBusState (ar a bhfuil BusHardwareId & busHwId, const std ::string & state)
Paraiméadair staid busHwId
Filleann ResultVoid
Sonraíonn an fieldbus a oscailt. Sanntar stát bus-shonrach mar luach teaghrán. Deimhníonn sé gur rith feidhm fholús.
scanDevices () Úsáid an fheidhm seo chun scanadh le haghaidh gléasanna sa líonra.
Virtual ResultDeviceIds nlc ::NanoLibAccessor::scanDevices (ar nós BusHardwareId & busHwId, NlcScanBusCallback*)
Paraiméadair aisghlao busHwId
Filleann ResultDeviceIds IOError
Sonraítear an bus páirce le scanadh. Lorgaire dul chun cinn NlcScanBusCallback. Seachadann sé eagar aitheantais gléis. Cuirtear ar an eolas nach bhfuarthas gléas.
Leagan: doc 1.4.2 / NanoLib 1.3.0
17
8 Tagairt do ranganna/feidhmeanna
cuir Gléas ()
Úsáid an fheidhm seo chun gléas bus a bhfuil cur síos déanta air ag deviceId a chur le liosta gléasanna inmheánacha NanoLib, agus chun deviceHandle a chur ar ais dó.
Virtual ResultDeviceHandle nlc ::NanoLibAccessor::addDevice (DeviceId const & deviceId)
Parameters deviceId Filleann ResultDeviceHandle
Sonraítear an gléas le cur leis an liosta. Seachadann láimhseáil gléas.
connectDevice ( ) Úsáid an fheidhm seo chun gléas a nascadh le gléas Handle.
Virtual ResultVoid nlc ::NanoLibAccessor ::connectDevice (DeviceHandle const deviceHandle)
Paraiméadair deviceHandle Returns ResultVoid
IOEarráid
Sonraítear cén gléas bus a nascann NanoLib leis. Deimhníonn sé gur rith feidhm fholús. Cuirtear ar an eolas nach bhfuarthas gléas.
getDeviceName () Úsáid an fheidhm seo chun ainm gléis a fháil de réir deviceHandle.
virtual ResultString nlc ::NanoLibAccessor ::getDeviceName (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultString
Sonraítear cén gléas bus a fhaigheann NanoLib an t-ainm dó. Seachadann sé ainmneacha gléasanna mar theaghrán.
getDeviceProductCode () Úsáid an fheidhm seo chun cód táirge gléis a fháil le deviceHandle.
Toradh fíorúil nlc ::NanoLibAccessor ::getDeviceProductCode (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultInt
Sonraítear cén gléas bus a fhaigheann NanoLib cód an táirge dó. Seachadann sé cóid táirge mar shlánuimhir.
getDeviceVendorId () Úsáid an fheidhm seo chun aitheantas díoltóir an ghléis a fháil trí deviceHandle.
Virtual ResultInt nlc ::NanoLibAccessor ::getDeviceVendorId (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultInt
Acmhainn Níl ar fáil
Sonraítear cén gléas bus a fhaigheann NanoLib aitheantas an díoltóra dó. Seachadann sé aitheantais díoltóirí mar shlánuimhir. Cuirtear ar an eolas nach bhfuarthas aon sonraí.
Leagan: doc 1.4.2 / NanoLib 1.3.0
18
8 Tagairt do ranganna/feidhmeanna
getDeviceId () Úsáid an fheidhm seo chun aitheantas gléis ar leith a fháil ó liosta inmheánach NanoLib.
Virtual ResultDeviceId nlc ::NanoLibAccessor::getDeviceId (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultDeviceId
Sonraítear cén gléas bus a fhaigheann NanoLib aitheantas an ghléis dó. Seachadann sé aitheantas gléis.
getDeviceIds () Úsáid an fheidhm seo chun aitheantas gach gléas a fháil ó liosta inmheánach NanoLib.
Virtual ResultDeviceIds nlc ::NanoLibAccessor ::getDeviceIds ()
Filleann ResultDeviceIds
Seachadann sé liosta aitheantais gléis.
getDeviceUid () Úsáid an fheidhm seo chun aitheantas uathúil gléis (96 giotán / 12 beart) a fháil le deviceHandle.
Fíorúil ToradhArrayByte nlc ::NanoLibAccessor::getDeviceUid (DeviceHandle const deviceHandle)
Paraiméadair deviceHandle Returns ResultArrayByte
Acmhainn Níl ar fáil
Sonraítear cén gléas bus a fhaigheann NanoLib an t-aitheantas uathúil dó. Seachadann sé aitheantais uathúla mar eagar beart. Cuirtear ar an eolas nach bhfuarthas aon sonraí.
getDeviceSerialNumber () Úsáid an fheidhm seo chun sraithuimhir gléis a fháil trí deviceHandle.
Virtual ResultString NanolibAccessor::getDeviceSerialNumber (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultString
Acmhainn Níl ar fáil
Sonraítear cén gléas bus a fhaigheann NanoLib an tsraithuimhir dó. Seachadann sé sraithuimhreacha mar theaghrán. Cuirtear ar an eolas nach bhfuarthas aon sonraí.
getDeviceHardwareGroup () Úsáid an fheidhm seo chun grúpa crua-earraí gléis bus a fháil de réir deviceHandle.
Virtual ResultDeviceId nlc ::NanoLibAccessor::getDeviceHardwareGroup (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultInt
Sonraítear cén gléas bus a fhaigheann NanoLib an grúpa crua-earraí dó.
Seachadann sé grúpaí crua-earraí mar shlánuimhir.
getDeviceHardwareVersion () Úsáid an fheidhm seo chun leagan crua-earraí gléas bus a fháil le deviceHandle.
Virtual ResultDeviceId nlc ::NanoLibAccessor::getDeviceHardwareVersion (DeviceHandle const deviceHandle)
Leagan: doc 1.4.2 / NanoLib 1.3.0
19
8 Tagairt do ranganna/feidhmeanna
Paraiméadair gléas Handle
Tuairisceáin
ResultString ResourceUnavailable
Sonraítear cén gléas bus a fhaigheann NanoLib an leagan crua-earraí dó. Seachadann sé ainmneacha gléasanna mar theaghrán. Cuirtear ar an eolas nach bhfuarthas aon sonraí.
getDeviceFirmwareBuildId () Bain úsáid as an bhfeidhm seo chun aitheantas tógála firmware gléis bus a fháil le deviceHandle.
Fíorúil ToradhDeviceId nlc ::NanoLibAccessor::getDeviceFirmwareBuildId (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultString
Sonraítear cén gléas bus a fhaigheann NanoLib ID an firmware dó.
Seachadann sé ainmneacha gléasanna mar theaghrán.
getDeviceBootloaderVersion () Úsáid an fheidhm seo chun leagan tosaithe de ghléas bus a fháil de réir deviceHandle.
Toradh fíorúil nlc ::NanoLibAccessor ::getDeviceBootloaderVersion (DeviceHandle const deviceHandle)
Paraiméadair gléas Handle
Tuairisceáin
ResultInt ResourceUnavailable
Sonraítear cén gléas bus a fhaigheann NanoLib an leagan bootloader dó. Seachadann sé leaganacha bootloader mar shlánuimhir. Cuirtear ar an eolas nach bhfuarthas aon sonraí.
getDeviceBootloaderBuildId () Úsáid an fheidhm seo chun ID tosaithe an ghléis bhus a fháil le deviceHandle.
Virtual ResultDeviceId nlc ::NanoLibAccessor :: (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultString
Sonraítear cén gléas bus a fhaigheann NanoLib aitheantas tógála an bootloader dó.
Seachadann sé ainmneacha gléasanna mar theaghrán.
rebootDevice () Úsáid an fheidhm seo chun an gléas a atosú le deviceHandle.
Virtual ResultVoid nlc ::NanoLibAccessor ::rebootDevice (const DeviceHandle deviceHandle)
Paraiméadair deviceHandle Returns ResultVoid
Sonraítear an fieldbus a atosóidh. Deimhníonn sé gur rith feidhm fholús.
getDeviceState ( ) Úsáid an fheidhm seo chun an staid a bhaineann go sonrach le gléas-phrótacal a fháil.
virtual ResultString nlc ::NanoLibAccessor ::getDeviceState (DeviceHandle const deviceHandle)
Paraiméadair gléas Handle
Sonraítear cén gléas bus a fhaigheann NanoLib an stát dó.
Leagan: doc 1.4.2 / NanoLib 1.3.0
20
8 Tagairt do ranganna/feidhmeanna
Filleann ResultString
Seachadann sé ainmneacha gléasanna mar theaghrán.
setDeviceState ( ) Úsáid an fheidhm seo chun staid an phrótacail ghléis a shocrú.
Virtual ResultVoid nlc ::NanoLibAccessor::setDeviceState (const DeviceHandle deviceHandle, const std::teaghrán & luaigh)
Paraiméadair gléas Handle staid
Filleann ResultVoid
Sonraítear cén gléas bus a shocraíonn NanoLib an stát dó. Sanntar stát bus-shonrach mar luach teaghrán. Deimhníonn sé gur rith feidhm fholús.
getConnectionState ()
Úsáid an fheidhm seo chun an staid nasctha dheireanach a bhí ar eolas ag gléis ar leith a fháil trí deviceHandle (= Dícheangailte, Ceangailte, ConnectedBootloader)
Virtual ResultConnectionState nlc::NanoLibAccessor::getConnectionState (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultConnectionState
Sonraítear cén gléas bus a fhaigheann NanoLib an staid nasctha dó.
Seachadann sé staid nasc (= Dícheangailte, Ceangailte, ConnectedBootloader).
seiceáilConnectionState ()
Mura raibh an staid dheireanach ar eolas dícheangailte: Úsáid an fheidhm seo chun staid nasctha gléis ar leith a sheiceáil agus b'fhéidir a nuashonrú trí deviceHandle agus trí roinnt oibríochtaí mód-shonracha a thástáil.
Virtual ResultConnectionState nlc::NanoLibAccessor::checkConnectionState (DeviceHandle const deviceHandle)
Parameters deviceHandle Returns ResultConnectionState
Sonraítear cén gléas bus a dhéanann NanoLib seiceáil ar staid an naisc.
Soláthraítear staid nasctha (= gan a bheith dícheangailte).
assignObjectDictionary () Úsáid an fheidhm láimhe seo chun foclóir oibiachtaí (OD) a shannadh do ghléas Handle leat féin.
Foclóir Fíorúil ToradhObject nlc::NanoLibAccessor::assignObjectDictionary (DeviceHandle const deviceHandle, ObjectDictionary const & objectDictionary)
Parameters deviceHandle objectDictionary
Filleann ResultObjectDictionary
Sonraítear cén gléas bus a sannann NanoLib an OD dó. Taispeáin airíonna foclóir oibiachta.
autoAssignObjectDictionary ()
Úsáid an t-uathoibriú seo chun ligean do NanoLib foclóir oibiachta (OD) a shannadh do Handle gléas. Ar aimsiú agus lódáil OD oiriúnach, sannann NanoLib go huathoibríoch don fheiste é. Nóta: Má tá OD comhoiriúnach luchtaithe cheana féin sa leabharlann oibiachtaí, úsáidfidh NanoLib é go huathoibríoch gan an t-eolaire a cuireadh isteach a scanadh.
Foclóir Fíorúil ToradhObject nlc::NanoLibAccessor::autoAssignObjectDictionary (DeviceHandle const deviceHandle, const std::teaghrán & foclóiríLocationPath)
Leagan: doc 1.4.2 / NanoLib 1.3.0
21
8 Tagairt do ranganna/feidhmeanna
Paraiméadair gléas Handle
Tuairisceáin
foclóiríLocationPath ResultObjectDictionary
Sonraítear cén gléas bus a dhéanfaidh NanoLib a scanadh go huathoibríoch le haghaidh ODanna oiriúnacha. Sonraítear an cosán chuig an eolaire OD. Taispeáin airíonna foclóir oibiachta.
getAssignedObjectDictionary ()
Úsáid an fheidhm seo chun foclóir na n-oibiachtaí a shannadh do ghléas trí ghléas Handle.
Foclóir Fíorúil ToradhObject nlc::NanoLibAccessor::getAssignedObjectDictionary (DeviceHandle const device
láimhseáil)
Parameters deviceHandle Returns ResultObjectDictionary
Sonraítear cén gléas bus a fhaigheann NanoLib an OD sannta dó. Taispeáin airíonna foclóir oibiachta.
getObjectDictionaryLibrary() Tugann an fheidhm seo tagairt OdLibrary ar ais.
OdLibrary fíorúil& nlc ::NanoLibAccessor::getObjectDictionaryLibrary ()
Filleann OdLibrary&
Osclaíonn sé an leabharlann OD ar fad agus a foclóirí oibiachta.
setLoggingLevel () Bain úsáid as an bhfeidhm seo chun na sonraí logála is gá a shocrú (agus logáil file méid). Is é an leibhéal réamhshocraithe Info.
folús fíorúil nlc ::NanoLibAccessor::setLoggingLevel (LogLevel level)
Leibhéal paraiméadair
Is féidir na mionsonraí logála seo a leanas:
0 = Rian 1 = Dífhabht 2 = Eolas 3 = Rabhadh 4 = Earráid 5 = Criticiúil 6 = As
An leibhéal is ísle (log is mó file); logálann aon mhionsonraí indéanta, chomh maith le tosú / stad bogearraí. Logs faisnéis dífhabhtaithe (= torthaí eatramhacha, ábhar seolta nó faighte, etc.) Leibhéal réamhshocraithe; logs teachtaireachtaí faisnéise. Logálann fadhbanna a tharla ach nach stopfaidh an t-algartam reatha. Logs ach dtrioblóid mhór a chuir stop leis an algartam. An leibhéal is airde (log is lú file); cuireann sé an logáil as; gan logáil a thuilleadh ar chor ar bith. Gan logáil ar chor ar bith.
setLoggingCallback ()
Úsáid an fheidhm seo chun pointeoir aisghlao logála agus modúl logála (= leabharlann) a shocrú don aisghlao sin (ní don logálaí féin).
folús fíorúil nlc ::NanoLibAccessor::setLoggingCallback (aisghlaoch NlcLoggingCallback*, const nlc::LogModule & logModule)
Paraiméadair *loga aisghlao Modúl
Socraíonn sé pointeoir aisghlao. Tiúin an aisghlao (ní logálaí!) chuig do leabharlann.
0 = NanolibCore 1 = NanolibCANopen 2 = NanolibModbus 3 = NanolibEtherCAT
Gníomhachtaíonn sé aisghlao do chroílár NanoLib amháin. Gníomhachtaíonn sé aisghlao CANopen-amháin. Gníomhachtaíonn sé glao ar ais Modbus amháin. Gníomhachtaíonn sé aisghlao EtherCAT amháin.
Leagan: doc 1.4.2 / NanoLib 1.3.0
22
8 Tagairt do ranganna/feidhmeanna
4 = NanolibRest 5 = NanolibUSB
Gníomhachtaíonn sé aisghlao REST-amháin. Gníomhachtaíonn sé aisghlao USB-amháin.
unsetLoggingCallback () Úsáid an fheidhm seo chun pointeoir aisghlao logála a chealú.
folús fíorúil nlc ::NanoLibAccessor::unsetLoggingCallback ()
readNumber () Úsáid an fheidhm seo chun luach uimhriúil a léamh ón bhfoclóir oibiachta.
Virtual ResultInt nlc ::NanoLibAccessor::readNumber (const DeviceHandle deviceHandle, const OdIndex odIndex)
Paraiméadair deviceHandle odIndex
Filleann ResultInt
Sonraítear cén gléas bus a léann NanoLib as. Sonraítear an t-innéacs (fo-) le léamh uaidh. Soláthraíonn sé luach uimhriúil neamhléirmhínithe (is féidir é a shíniú, gan síniú, luachanna 16.16 giotán a shocrú).
readNumberArray () Úsáid an fheidhm seo chun eagair uimhriúla a léamh ón bhfoclóir oibiachta.
toradh fíorúil ArrayInt nlc ::NanoLibAccessor::readNumberArray (const DeviceHandle deviceHandle, const uint16_t index)
Paraiméadair gléas Handle innéacs
Filleann ResultArrayInt
Sonraítear cén gléas bus a léann NanoLib as. Innéacs réad eagar. Seachadann sraith slánuimhir.
readBytes () Úsáid an fheidhm seo chun bearta treallach (sonraí oibiachta fearainn) a léamh ón bhfoclóir oibiachta.
Toradh fíorúilArrayByte nlc::NanoLibAccessor::readBytes (const DeviceHandle deviceHandle, const OdIndex odIndex)
Paraiméadair deviceHandle odIndex
Filleann ResultArrayByte
Sonraítear cén gléas bus a léann NanoLib as. Sonraítear an t-innéacs (fo-) le léamh uaidh. Seachadann eagar beart.
readString () Úsáid an fheidhm seo chun teaghráin a léamh ón eolaire oibiachtaí.
virtual ResultString nlc ::NanoLibAccessor ::readString (const DeviceHandle deviceHandle, const OdIndex odIndex)
Paraiméadair deviceHandle odIndex
Filleann ResultString
Sonraítear cén gléas bus a léann NanoLib as. Sonraítear an t-innéacs (fo-) le léamh uaidh. Seachadann sé ainmneacha gléasanna mar theaghrán.
Leagan: doc 1.4.2 / NanoLib 1.3.0
23
8 Tagairt do ranganna/feidhmeanna
writeNumber () Úsáid an fheidhm seo chun luachanna uimhriúla a scríobh chuig an eolaire oibiachtaí.
Virtual ResultVoid nlc ::NanoLibAccessor::scríobh Uimhir (const DeviceHandle deviceHandle, luach int64_t, const OdIndex odIndex, int bitLength gan síniú)
Paraiméadair gléas Láimhseáil luach odIndex giotánLength
Filleann ResultVoid
Sonraítear cén gléas bus a scríobhann NanoLib chuige. An luach neamhléirmhínithe (is féidir é a shíniú, gan síniú, 16.16 a shocrú). Sonraítear an t-innéacs (fo-) le léamh uaidh. Fad i beagán. Deimhníonn sé gur rith feidhm fholús.
writeBytes () Úsáid an fheidhm seo chun bearta treallach (sonraí oibiachta fearainn) a scríobh chuig an eolaire oibiachtaí.
Virtual ResultVoid nlc ::NanoLibAccessor ::writeBytes (const DeviceHandle deviceHandle, const std::veicteoir & sonraí, ar bhonn OdIndex odIndex)
Paraiméadair gléas Láimhseáil sonraí odIndex
Filleann ResultVoid
Sonraítear cén gléas bus a scríobhann NanoLib chuige. Veicteoir beart / eagar. Sonraítear an t-innéacs (fo-) le léamh uaidh. Deimhníonn sé gur rith feidhm fholús.
uaslódáil Firmware ()
Úsáid an fheidhm seo chun firmware do rialtóra a nuashonrú.
Virtual ResultVoid nlc ::NanoLibAccessor ::uploadFirmware (const DeviceHandle deviceHandle, const std ::vector & fwData, NlcDataTransferCallback*)
Parameters deviceHandle fwData NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a nuashonraíonn NanoLib. Eagar ina bhfuil sonraí firmware. Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
Íoslódáil an firmware óFile ()
Bain úsáid as an bhfeidhm seo chun firmware do rialtóra a nuashonrú trí a file.
fíorúil ResultVoid nlc ::NanoLibAccessor::uploadFirmwareFromFile (const DeviceHandle deviceHandle, const std ::teaghrán & absalóideachFileConair, aisghlaoch NlcDataTransferCallback*)
Paraiméadair gléas Láimhseáil iomlánFileConair NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a nuashonraíonn NanoLib. Conair go file ina bhfuil sonraí firmware (std::string). Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
Leagan: doc 1.4.2 / NanoLib 1.3.0
24
8 Tagairt do ranganna/feidhmeanna
uaslódáilBootloader ()
Bain úsáid as an bhfeidhm seo chun do thosaitheoir rialaitheora a nuashonrú.
Virtual ResultVoid nlc ::NanoLibAccessor ::uploadBootloader (const DeviceHandle deviceHandle, const std ::vector & btData, NlcDataTransferCallback*)
Parameters deviceHandle btData NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a nuashonraíonn NanoLib. Eagar ina bhfuil sonraí bootloader. Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
Uaslódáil BootloaderÓFile ()
Bain úsáid as an bhfeidhm seo chun do thosaitheoir rialaitheora a nuashonrú trína uaslódáil file.
fíorúil ResultVoid nlc ::NanoLibAccessor ::uploadBootloaderFromFile (const DeviceHandle deviceHandle, const std :: teaghrán & lódóir tosaitheAbsoluteFileConair, aisghlaoch NlcDataTransferCallback*)
Paraiméadair deviceHandle bootloaderAbsoluteFileConair NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a nuashonraíonn NanoLib. Conair go file ina bhfuil sonraí bootloader (std::string). Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
uaslódáilBootloaderFirmware ()
Bain úsáid as an bhfeidhm seo chun do thosaitheoir rialtóra agus firmware a nuashonrú.
Virtual ResultVoid nlc ::NanoLibAccessor ::uploadBootloaderFirmware (const DeviceHandle deviceHandle, const std ::vector & btData, const std::veicteoir & fwData, NlcDataTransferCallback*)
Parameters deviceHandle btData fwData NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a nuashonraíonn NanoLib. Eagar ina bhfuil sonraí bootloader. Eagar ina bhfuil sonraí firmware. Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
UaslódáilBootloaderFirmwareFromFile ()
Bain úsáid as an bhfeidhm seo chun do thosaitheoir rialaitheora agus firmware a nuashonrú trí an files.
Virtual ResultVoid nlc ::NanoLibAccessor ::uploadBootloaderFirmwareFromFile (const DeviceHandle deviceHandle, const std :: teaghrán & lódóir tosaitheAbsoluteFileConair, constd::teaghrán & iomlánFileConair, aisghlaoch NlcDataTransferCallback*)
Paraiméadair deviceHandle bootloaderAbsoluteFileConair iomlánFileConair NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a nuashonraíonn NanoLib. Conair go file ina bhfuil sonraí bootloader (std::string). Conair go file ina bhfuil sonraí firmware (uint8_t). Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
Leagan: doc 1.4.2 / NanoLib 1.3.0
25
8 Tagairt do ranganna/feidhmeanna
uaslódáil NanoJ ()
Úsáid an fheidhm phoiblí seo chun an clár NanoJ a uaslódáil chuig do rialtóir.
Virtual ResultVoid nlc ::NanoLibAccessor ::uploadNanoJ (DeviceHandle const deviceHandle, std ::vector const & vmmData, NlcDataTransferCallback*)
Parameters deviceHandle vmmData NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a uaslódálann NanoLib chuige. Eagar ina bhfuil sonraí NanoJ. Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
uaslódáil nanojfromFile ()
Bain úsáid as an bhfeidhm phoiblí seo chun an clár NanoJ a uaslódáil chuig do rialtóir tríd an file.
Virtual ResultVoid nlc ::NanoLibAccessor::uploadNanoJFromFile (const DeviceHandle deviceHandle, const std ::teaghrán & absalóideachFileConair, aisghlaoch NlcDataTransferCallback*)
Paraiméadair gléas Láimhseáil iomlánFileConair NlcDataTransferCallback
Filleann ResultVoid
Sonraítear cén gléas bus a uaslódálann NanoLib chuige. Conair go file ina bhfuil sonraí NanoJ (std::string). Lorgaire dul chun cinn sonraí. Deimhníonn sé gur rith feidhm fholús.
disconnectDevice () Úsáid an fheidhm seo chun do ghléas a dhínascadh le deviceHandle.
Virtual ResultVoid nlc ::NanoLibAccessor ::disconnectDevice (DeviceHandle const deviceHandle)
Paraiméadair deviceHandle Returns ResultVoid
Sonraítear cén gléas bus a dhínascann NanoLib uaidh. Deimhníonn sé gur rith feidhm fholús.
removeDevice ( ) Úsáid an fheidhm seo chun do ghléas a bhaint de liosta gléasanna inmheánacha NanoLib.
Virtual ResultVoid nlc ::NanoLibAccessor::removeDevice (const DeviceHandle deviceHandle)
Paraiméadair deviceHandle Returns ResultVoid
Sonraítear cén gléas bus a dhéanann NanoLib delists. Deimhníonn sé gur rith feidhm fholús.
closeBusHardware () Úsáid an fheidhm seo le dínascadh ó do chrua-earraí bus páirce.
Virtual ResultVoid nlc ::NanoLibAccessor ::closeBusHardware (BusHardwareId const & busHwId)
Paraiméadair BusHwId Returns ResultVoid
Sonraítear an bus páirce le dínascadh uaidh. Deimhníonn sé gur rith feidhm fholús.
Leagan: doc 1.4.2 / NanoLib 1.3.0
26
8 Tagairt do ranganna/feidhmeanna
8.2 BusHardwareId
Bain úsáid as an rang seo chun crua-earraí bus a aithint duine le duine nó chun crua-earraí bus éagsúla a idirdhealú óna chéile. Tá faisnéis ag an aicme seo (gan feidhmeanna socraitheoirí a bheith do-ath-inchurtha ón gcruthú ar aghaidh) freisin:
Crua-earraí (= ainm cuibheora, cuibheoir líonra srl.) Prótacal le húsáid (= Modbus TCP, CANopen etc.) Sonróir crua-earraí bus (= ainm an phoirt srathach, ainm MAC Friendly
seoladh srl.)
BusHardwareId () [1/3] Cruthaitheoir a chruthaíonn réad aitheantais crua-earraí bus nua.
nlc ::BusHardwareId ::BusHardwareId (std:: string const & busHardware_, std :: string const & protocol_, std :: string const & hardwareSpecifier_, std :: string const & name_)
Paraiméadair busHardware_ prótacal_ hardwareSpecifier_ extraHardwareSpecifier_ name_
Cineál crua-earraí (= ZK-USB-CAN-1 etc.). Prótacal cumarsáide bus (= CANopen etc.). Sonróir crua-earraí (= COM3 etc.). Sonróir breise na crua-earraí (abair, eolas suímh USB). Ainm cairdiúil (= AdapterName (Port) etc.).
BusHardwareId () [2/3] Cruthaitheoir a chruthaíonn réad aitheantais crua-earraí bus nua, leis an rogha le haghaidh sonraíocht crua-earraí breise.
nlc ::BusHardwareId ::BusHardwareId (std:: string const & busHardware_, std :: string const & protocol_, std :: string const & hardwareSpecifier_, std :: string const & extraHardwareSpecifier_, ds :: string const & name_)
Paraiméadair busHardware_ prótacal_ hardwareSpecifier_ extraHardwareSpecifier_ name_
Cineál crua-earraí (= ZK-USB-CAN-1 etc.). Prótacal cumarsáide bus (= CANopen etc.). Sonróir crua-earraí (= COM3 etc.). Sonróir breise na crua-earraí (abair, eolas suímh USB). Ainm cairdiúil (= AdapterName (Port) etc.).
BusHardwareId () [3/3] Cruthaitheoir a dhéanann cóip de busHardwareId atá ann cheana.
nlc ::BusHardwareId ::BusHardwareId (BusHardwareId const &)
nlc ::BusHardwareId ::BusHardwareId (BusHardwareId const &)
Paraiméadair busHardwareId
Ainmníonn an t-aitheantas crua-earraí bus le cóipeáil uaidh.
ionann () Déanann sé ID crua-earraí bus nua a chur i gcomparáid leis na cinn atá ann cheana.
bool nlc ::BusHardwareId :: cothrom (BusHardwareId const & eile) const
Paraiméadair Tuairisceáin eile fíor
Rud eile den aicme chéanna. Má tá an dá cheann cothrom i ngach luach.
Leagan: doc 1.4.2 / NanoLib 1.3.0
27
8 Tagairt do ranganna/feidhmeanna
bréagach
Má tá difríocht idir na luachanna.
getBusHardware () Léann sé teaghrán crua-earraí an bhus amach.
std ::string nlc ::BusHardwareId ::getBusHardware () const
Teaghrán tuairisceáin
getHardwareSpecifier () Léann sé teaghrán sonraíochta crua-earraí an bhus (= ainm líonra etc.).
std ::string nlc ::BusHardwareId ::getHardwareSpecifier () const
Teaghrán tuairisceáin
getExtraHardwareSpecifier () Léann sé teaghrán sonraíochta crua-earraí breise an bhus (= seoladh MAC etc.).
std ::string nlc ::BusHardwareId ::getExtraHardwareSpecifier () const
Teaghrán tuairisceáin
getName () Léann sé amach ainm cairdiúil crua-earraí an bhus.
std ::string nlc ::BusHardwareId ::getName () const
Teaghrán tuairisceáin
getProtocol () Léann sé teaghrán prótacal an bhus amach.
std ::string nlc ::BusHardwareId ::getProtocol () const
Teaghrán tuairisceáin
toString () Filleann sé ID crua-earraí an bhus mar theaghrán.
std::string nlc::BusHardwareId::toString () const
Teaghrán tuairisceáin
8.3 BusHardwareOptions
Faigh sa rang seo, i liosta teaghráin de bhunluach, na roghanna go léir is gá chun crua-earraí bus a oscailt.
Leagan: doc 1.4.2 / NanoLib 1.3.0
28
8 Tagairt do ranganna/feidhmeanna
BusHardwareOptions () [1/2] Tógtar réad rogha crua-earraí bus nua.
nlc ::BusHardwareOptions::BusHardwareOptions () Úsáid an fheidhm addOption () chun péirí eochairluacha a chur leis.
BusHardwareOptions () [2/2] Tógtar oibiacht nua do roghanna crua-earraí bus agus an léarscáil eochairluacha i bhfeidhm cheana féin.
nlc ::BusHardwareOptions ::BusHardwareOptions (std :: map const & roghanna)
Roghanna paraiméadair
Léarscáil le roghanna chun na crua-earraí bus a oibriú.
addOption () Cruthaíonn eochracha agus luachanna breise.
neamhní nlc ::BusHardwareOptions::addOption (std:: string const & key, std :: string const & value)
Paraiméadair luach eochrach
Example: BAUD_RATE_OPTIONS_NAME, féach bus_hw_options_ réamhshocraithe
Example: BAUD_RATE_1000K, féach bus_hw_options_defaults
ionann () Déanann sé comparáid idir na BusHardwareOptions agus na cinn atá ann cheana.
bool nlc ::BusHardwareOptions::comhionann (BusHardwareOptions const & eile) const
Paraiméadair Tuairisceáin eile fíor
bréagach
Rud eile den aicme chéanna. Má tá na roghanna céanna go léir ag an réad eile. Má tá eochracha nó luachanna éagsúla ag an réad eile.
getOptions () Léann sé amach gach péire eochair-luach breise.
std::léarscáil nlc ::BusHardwareOptions::getOptions () const
Filleann léarscáil teaghrán
toString () Filleann sé gach eochair / luach mar teaghrán.
std::string nlc::BusHardwareId::toString () const
Teaghrán tuairisceáin
8.4 BusHwOptionsDefault
Tá na tréithe poiblí seo a leanas ag an aicme roghanna cumraíochta réamhshocraithe seo:
Leagan: doc 1.4.2 / NanoLib 1.3.0
29
8 Tagairt do ranganna/feidhmeanna
const CanBus const Sraithuimhir RESTfulBus const EtherCATBus
canBus = CanBus () sraitheach = sraitheach () restfulBus = RESTfulBus() ethercatBus = EtherCATBus()
8.5 Ráta CanBaud
Struchtúr ina bhfuil baudrates bus CAN sna tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string
BAUD_RATE_1000K = “1000k” BAUD_RATE_800K = “800k” BAUD_RATE_500K = “500k” BAUD_RATE_250K = “250k” BAUD_RATE_125K = “125k” BAUD_RATE_100K = “BARATE_100K” ATE_50K = “50k” BAUD_RATE_20K = “20k” BAUD_RATE_10K = “10k”
8.6 CanBus
Aicme roghanna cumraíochta réamhshocraithe leis na tréithe poiblí seo a leanas:
const std ::string const CanBaudRate const Ixxat
BAUD_RATE_OPTIONS_NAME = “is féidir ráta baud an oiriúntóra” baudRate = Ráta CanBaud () ixxat = Ixxat ()
8.7 CanOpenNmtService
Maidir leis an tseirbhís NMT, tá stáit CANopen NMT sa struchtúr seo mar luachanna teaghrán sna tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string const std::string
START = “START” STOP = “STOP” PRE_OPERATIONAL = “PRE_OPERATIONAL” ATHShocraigh = “ATHShocraigh” RESET_COMMUNICATION = “RESET_COMMUNICATION”
8.8 CanOpenNmtState
Cuimsíonn an struchtúr seo stáit CANopen NMT mar luachanna teaghrán sna tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string const std::string
STOPPED = “STOPPED” PRE_OPERATIONAL = “PRE_OPERATIONAL” OIBRIÚCHÁIN = “OIBRIÚCHÁN” TIONSCNAIMH = “TIONSCNAIMH” AN AIRE = “Anaithnid”
8.9 Struchtúr EtherCATBus
Tá na roghanna cumraíochta cumarsáide EtherCAT sna tréithe poiblí seo a leanas sa struchtúr seo:
Leagan: doc 1.4.2 / NanoLib 1.3.0
30
8 Tagairt do ranganna/feidhmeanna
const std :: string NETWORK_FIRMWARE_STATE_OP- Déileáiltear le stát líonra mar mhodh firmware. Inghlactha
TION_NAME = “Stát Firmware Líonra”
luachanna (réamhshocraithe = PRE_OPERATIONAL):
EtherCATState ::PRE_OPERATIONAL EtherCATState::SAFE_OPERATIONAL EtherCATState::OPERATIONAL
const std::teaghrán DEFAULT_NETWORK_FIRMWARE_ STATE = “PRE_OPERATIONAL”
const std ::teaghrán EXCLUSIVE_LOCK_TIMEOUT_OP- Teorainn ama sna milleasoicindí chun glas eisiach a fháil ar
TION_NAME = “Am istigh glas comhroinnte”
an líonra (réamhshocraithe = 500 ms).
gan síniú isteach DEFAULT_EXCLUSIVE_LOCK_ TIMEOUT = “500”
const std ::teaghrán SHARED_LOCK_TIMEOUT_OPTION_ Teorainn ama sna milleasoicindí chun glas comhroinnte a fháil ar siúl
NAME = “Am istigh Glais Roinnte”
an líonra (réamhshocraithe = 250 ms).
gan síniú isteach DEFAULT_SHARED_LOCK_TIMEOUT = “250”
const std ::string READ_TIMEOUT_OPTION_NAME = Teorainn ama sna milleasoicindí le haghaidh oibríocht léite (réamhshocraithe
“Léigh Teorainn Ama”
= 700 ms).
gan síniú isteach DEFAULT_READ_TIMEOUT = “700”
const std ::string WRITE_TIMEOUT_OPTION_NAME = Teorainn ama sna milleasoicindí le haghaidh oibríocht scríofa (réamhshocraithe
“Scríobh Am istigh”
= 200 ms).
gan síniú isteach DEFAULT_WRITE_TIMEOUT = “200”
const std :: string READ_WRITE_ATTEMPTS_OPTION_ Uasmhéid iarrachtaí léite nó scríofa (luachanna neamh-nialais
NAME = “Léigh/Scríobh Iarrachtaí”
amháin; réamhshocraithe = 5).
gan síniú isteach DEFAULT_READ_WRITE_ATTEMPTS = “5”
const std::string CHANGE_NETWORK_STATE_ATTEMPTS_OPTION_NAME = “Athraigh Iarrachtaí Staid an Líonra”
Uaslíon iarrachtaí chun staid an líonra a athrú (luachanna neamh-nialais amháin; réamhshocraithe = 10).
gan síniú isteach DEFAULT_CHANGE_NETWORK_ STATE_ATTEMPTS = “10”
const std ::teaghrán PDO_IO_ENABLED_OPTION_NAME Cumasaíonn nó díchumasaítear próiseáil PDO le haghaidh in- /
= “PDO IO Cumasaithe”
aschuir (“Fíor” nó “Bréagach” amháin; réamhshocraithe = “Fíor”).
const std::string DEFAULT_PDO_IO_ENABLED = “Fíor”
8.10 Struchtúr EtherCATState
Cuimsíonn an struchtúr seo na stáit sclábhaithe / líonra EtherCAT mar luachanna teaghrán sna tréithe poiblí seo a leanas. Nóta: Is é PRE_OPERATIONAL an staid réamhshocraithe ag cumhacht ar; Ní féidir le NanoLib aon stát “OIBRIÚCHÁIN” iontaofa a sholáthar i gcóras oibriúcháin neamhfhíor-ama:
const std::string const std::string const std::string const std::string const std::string const std::string const
NONE = “NONE” INIT = “INIT” PRE_OPERATIONAL = “PRE_OPERATIONAL” BOOT = “BOOT” SAFE_OPERATIONAL = “SAFE_OPERATIONAL” OIBRIÚCHÁIN = “OIBRIÚCHÁIN”
Leagan: doc 1.4.2 / NanoLib 1.3.0
31
8 Tagairt do ranganna/feidhmeanna
8.11 Ixxat
Coinníonn an struchtúr seo gach faisnéis don Ixxat usb-to-can sna tréithe poiblí seo a leanas:
const std::teaghrán
ADAPTER_BUS_NUMBER_OPTIONS_NAME = “uimhir bhus cuibheora ixxat”
const IxxatAdapterBusNumber adapterBusUimhir = IxxatAdapterBusUimhir ()
8.12 Uimhir Bhus IxxatAdapter
Coinníonn an struchtúr seo uimhir an bhus don Ixxat usb-to-can sna tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string
BUS_NUMBER_0_DEFAULT = “0” BUS_NUMBER_1 = “1” BUS_NUMBER_2 = “2” BUS_NUMBER_3 = “3”
8.13 Buaic
Coinníonn an struchtúr seo gach faisnéis don Buaic usb-go-can sna tréithe poiblí seo a leanas:
const std::teaghrán
ADAPTER_BUS_NUMBER_OPTIONS_NAME = “buaicuimhir bhus cuibheora”
const PeakAdapterBusNumber adapterBusNumber = BuaicAdapterBusUimhir ()
8.14 BuaicAdapterBusUimhir
Coinníonn an struchtúr seo uimhir an bhus don Peak usb-to-can sna tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string
BUS_NUMBER_1_DEFAULT = std::to_string (PCAN_USBBUS1) BUS_NUMBER_2 = std::to_string (PCAN_USBBUS2) BUS_NUMBER_3 = std::to_teaghrán (PCAN_USBBUS3) BUS_NUMBER_4 = std::to_string (PCAN_USBBUS4) BUS_NUMBER_5 = std::go_teaghrán (PCAN_USBBUS5) BUS_NUMBER_6 = std::to_USBBUS6 (PCAN_USBBUS7) std::to_USBBUS7 (PCAN_USBBUS8: std)::to_USBBUS8 (PCAN_USBBUS9): (PCAN_USBBUS9) BUS_NUMBER_10 = std::le_teaghrán (PCAN_USBBUS10) BUS_NUMBER_11 = std::to_string (PCAN_USBBUS11) BUS_NUMBER_12 = std::to_teaghrán (PCAN_USBBUS12) BUS_NUMBER_13 = std::to_USBBUS_NUMBER std::to_string (PCAN_USBBUS13) BUS_NUMBER_14 = std::to_string (PCAN_USBBUS14) BUS_NUMBER_15 = std::go_teaghrán (PCAN_USBBUS15) BUS_NUMBER_16 = std::to_string (PCAN_USBBUS_NUMBER:to_string (PCAN_USBBUS_NUMBER) BUS_USBBUS16:to_string (PCAN_USBBUS_NUMBER) (PCAN_USBBUSXNUMX) BUS_NUMBER_XNUMX = std::to_string (PCAN_USBBUSXNUMX) BUS_NUMBER_XNUMX = std::go_teaghrán (PCAN_USBBUSXNUMX)
8.15 Láimhseáil Gléas
Is ionann an aicme seo agus hanla chun gléas a rialú ar bhus agus tá na feidhmeanna ball poiblí seo a leanas aige.
DeviceHandle () DeviceHandle (láimhseáil uint32_t)
Leagan: doc 1.4.2 / NanoLib 1.3.0
32
8 Tagairt do ranganna/feidhmeanna
ionann () Déanann sé é féin i gcomparáid le hanla feiste tugtha.
ionann bool (DeviceHandle const other) const (uint32_t handle)
toString () Filleann sé léiriú teaghrán de hanla an ghléis.
std::string toString () const
faigh () Tuairisceáin láimhseáil an fheiste.
uint32_t fháil() const
8.16 Id Gléas
Úsáid an aicme seo (nach féidir a athrú ón gcruthú ar aghaidh) chun gléasanna ar bhus a aithint agus a idirdhealú:
Aitheantóir adapter crua-earraí
Aitheantóir gléas
Cur síos
Braitheann an bhrí atá le ID feiste / luachanna tuairisce ar an mbus. Le haghaidh example, féadfaidh bus CAN úsáid a bhaint as an ID slánuimhir.
DeviceId () [1/3] Tógtar oibiacht aitheantais gléis nua.
nlc ::DeviceId ::DeviceId (BusHardwareId const & busHardwareId_, int deviceId_ gan síniú, std :: string const & description_)
Paraiméadair busHardwareId_ deviceId_ cur síos_
Aitheantóir an bhus. Innéacs; faoi réir bus (= ID nód CANopen etc.). Cur síos (d'fhéadfadh a bheith folamh); faoi réir bus.
DeviceId () [2/3] Tógtar oibiacht aitheantais gléis nua le roghanna aitheantais sínte.
nlc ::DeviceId ::DeviceId (BusHardwareId const & busHardwareId, int deviceId_ gan síniú, std :: string const & description_ std ::veicteoir const & extraId_, std :: string const & extraStringId_)
Paraiméadair busHardwareId_ deviceId_ cur síos_ extraId_ extraStringId_
Aitheantóir an bhus. Innéacs; faoi réir bus (= ID nód CANopen etc.). Cur síos (d'fhéadfadh a bheith folamh); faoi réir bus. ID breise (d'fhéadfadh a bheith folamh); Braitheann brí ar bhus. ID teaghrán breise (d'fhéadfadh a bheith folamh); Braitheann brí ar bhus.
DeviceId () [3/3] Tógtar cóip de réad aitheantais gléis.
nlc ::DeviceId ::DeviceId (DeviceId ar feadh &)
Leagan: doc 1.4.2 / NanoLib 1.3.0
33
8 Tagairt do ranganna/feidhmeanna
Paraiméadair deviceId_
Aitheantas an ghléis le cóipeáil uaidh.
ionann () Déanann sé comparáid idir rudaí nua agus réad atá ann cheana féin.
bool nlc ::DeviceId :: cothrom (DeviceId const & eile) const
Filleann Boolean
getBusHardwareId () Léann sé amach ID crua-earraí an bhus.
BusHardwareId nlc ::DeviceId ::getBusHardwareId () const
Filleann BusHardwareId
getDescription ( ) Léann sé amach tuairisc an ghléis (b'fhéidir gan úsáid).
std::string nlc::DeviceId::getDescription () const
Teaghrán tuairisceáin
getDeviceId () Léann sé amach ID an ghléis (b'fhéidir gan úsáid).
gan síniú int nlc::DeviceId::getDeviceId () const
Filleann sé isteach gan síniú
toString () Filleann sé an réad mar teaghrán.
std::string nlc::DeviceId::toString () const
Teaghrán tuairisceáin
getExtraId () Léann sé amach aitheantas breise an ghléis (d'fhéadfadh sé nach bhfuil sé in úsáid).
const std::veicteoir &getExtraId()const
Veicteoir ar ais
Veicteoir de na IDanna breise breise (d'fhéadfadh a bheith folamh); Braitheann brí ar an mbus.
getExtraStringId () Léann sé amach teaghrán aitheantais breise an ghléis (seans nach bhfuil sé in úsáid).
std::string getExtraStringId() const
Leagan: doc 1.4.2 / NanoLib 1.3.0
34
8 Tagairt do ranganna/feidhmeanna
Teaghrán tuairisceáin
An ID teaghrán breise (d'fhéadfadh a bheith folamh); Braitheann brí ar an mbus.
8.17 LogLevelConverter
Filleann an rang seo do leibhéal loga mar theaghrán. std statach ::string toString (nlc ::logLevel logLevel)
8.18 LogModuleConverter
Filleann an rang seo do loga modúl a bhaineann go sonrach leis an leabharlannLoggingLevel () mar theaghrán.
std statach::teaghrán
toString (nlc ::LogModule logModule)
std statach ::string toString (nlc :: logModule LogModule)
8.19 Foclóir Cuspóir
Léiríonn an aicme seo foclóir oibiachta rialtóra agus tá na feidhmeanna ball poiblí seo a leanas aige: getDeviceHandle ()
fíorúil ResultDeviceHandle getDeviceHandle()const Returns ResultDeviceHandle
getObject() virtual ResultObjectSubEntry getObject (OdIndex const odIndex) Tuairisceáin ResultObjectSubEntry
getObjectEntry () fíorúil ResultObjectEntry getObjectEntry (innéacs uint16_t)
Filleann ResultObjectEntry
Cuireann sé eolas ar airíonna ruda.
faighXmlFileAinm ( ) fíorúil ResultString getXmlFileAinm () const
Filleann ResultString
Filleann an XML file ainm mar teaghrán.
léighUimhir ( ) Toradh Fíorúil LéamhUimhir (OdIndex const odIndex) Tuairisceáin ResultInt
readNumberArray () Toradh fíorúilArrayInt readNumberArray (innéacs const uint16_t)
Leagan: doc 1.4.2 / NanoLib 1.3.0
35
8 Tagairt do ranganna/feidhmeanna
Filleann ToradhArrayInt readString ()
Toradh fíorúilString readString (OdIndex le odIndex) Tuairisceáin ToradhString readBytes () Fíorúil ToradhArrayByte readBytes (OdIndex ar feadh odIndex) Tuairisceáin ToradhArrayByte writeUimhir () Toradh fíorúilVoid writeUimhir (OdIndex const odIndex, const insultBytes)ResultByte_tsults) fíorúil writeBytes (OdIndex mar OdIndex, std ::veicteoir
const & data) Tuairisceáin ToradhVoid Naisc Ghaolmhara OdIndex
8.20 ObjectIontráil
Léiríonn an aicme seo iontráil oibiachta san fhoclóir oibiachta, tá an aitreabúid statach cosanta aige agus feidhmeanna ball poiblí:
statach nlc ::ObjectSubEntry invalidObject
getName () Léann sé amach ainm an ruda mar theaghrán.
fíorúil std ::string getName ( ) const
getPrivate () Seiceálann sé an bhfuil an réad príobháideach.
bool fíorúil getPrivate() const
getIndex () Léann sé amach seoladh an innéacs oibiachta.
fíorúil uint16_t getIndex() const
Leagan: doc 1.4.2 / NanoLib 1.3.0
36
8 Tagairt do ranganna/feidhmeanna
getDataType () Léann sé amach cineál sonraí an oibiachta.
fíorúil nlc::ObjectEntryDataType getDataType () const
getObjectCode () Léann sé amach an cód oibiachta:
Cineál Cosanta Neamhní Scrios Taifead Var Array
0x00 0x05 0x06 0x07 0x08 0x09
fíorúil nlc ::ObjectCode getObjectCode() const
getObjectSaveable () Seiceálann an bhfuil an réad insábháilte agus an catagóir atá ann (féach an lámhleabhar táirge le haghaidh tuilleadh sonraí): IARRATAS, CUMARSÁID, DRIVE, MISC_CONFIG, MODBUS_RTU, NÍL, TUNING, CUSTAIMÉIRÍ, ETHERNET, CANOPEN, VERIFY1020, UNKNOWN_SAVEABLE_TYPEABLE
fíorúil nlc ::ObjectSaveable getObjectSaveable () const
getMaxSubIndex () Léann sé amach líon na bhfo-innéacsanna a dtacaíonn an réad seo leo.
fíorúil uint8_t getMaxSubIndex() const
getSubEntry () fíorúil nlc ::ObjectSubEntry & getSubEntry (uint8_t subIndex)
Féach freisin ObjectSubEntry.
8.21 ObjectSubIontráil
Léiríonn an aicme seo fo-iontráil oibiachta (fo-innéacs) den fhoclóir oibiachta agus tá na feidhmeanna ball poiblí seo a leanas aige:
getName () Léann sé amach ainm an ruda mar theaghrán.
fíorúil std ::string getName ( ) const
getSubIndex () Léann sé amach seoladh an fho-innéacs.
fíorúil uint8_t getSubIndex() const
Leagan: doc 1.4.2 / NanoLib 1.3.0
37
8 Tagairt do ranganna/feidhmeanna
getDataType () Léann sé amach cineál sonraí an oibiachta.
fíorúil nlc::ObjectEntryDataType getDataType () const
getSdoAccess () Seiceálann an bhfuil rochtain ar an bhfo-innéacs trí SDO:
Léigh Amháin
1
Scríobh Amháin
2
LéighScríobh
3
Gan Rochtain
0
fíorúil nlc ::ObjectSdoAccessAttribute getSdoAccess () const
getPdoAccess () Seiceálann an bhfuil an fo-innéacs inrochtana/mappable trí PDO:
Tx
1
Rx
2
TxRx
3
Níl
0
fíorúil nlc ::ObjectPdoAccessAttribute getPdoAccess() const
getBitLength() Seiceálann sé fad an fho-innéacs.
fíorúil uint32_t getBitLength()const
getDefaultValueAsNumeric () Léann sé amach luach réamhshocraithe an fho-innéacs le haghaidh cineálacha sonraí uimhriúla.
Toradh fíorúil getDefaultValueAsUimhiriúil (std::string const & key) const
getDefaultValueAsString () Léann sé amach luach réamhshocraithe an fho-innéacs le haghaidh cineálacha sonraí teaghrán.
Virtual ResultString getDefaultValueAsString (std::string const & key) const
getDefaultValues () Léann sé amach luachanna réamhshocraithe an fho-innéacs.
fíorúil std ::mapa getDefaultValues() const
Leagan: doc 1.4.2 / NanoLib 1.3.0
38
8 Tagairt do ranganna/feidhmeanna
readNumber () Léann sé amach luach iarbhír uimhriúil an fho-innéacs.
fíorúil ResultInt readNumber() const
readString () Léann sé amach luach iarbhír teaghrán an fho-innéacs.
fíorúil ResultString readString() const
readBytes () Léann sé amach luach iarbhír an fho-innéacs i mbearta.
fíorúil ResultArrayByte readBytes () const
writeUimhir () Scríobhann sé luach uimhriúil san fho-innéacs.
Fíorúil ToradhVoid writeNumber (luach int64_t) const
writeBytes () Scríobhann sé luach san fho-innéacs i mbearta.
toradh fíorúil Void writeBytes (std::veicteoir const&data) const
8.22 OdInnéacs
Úsáid an aicme seo (nach féidir a athrú ón gcruthú ar aghaidh) chun innéacsanna / fo-innéacsanna eolaire réad a chuimilt agus a aimsiú. Tá suas le 65535 (0xFFFF) sraitheanna agus 255 (0xFF) colún ag OD feiste; le bearnaí idir na sraitheanna neamhleanúnacha. Féach ar an gcaighdeán CANopen agus do lámhleabhar táirge le haghaidh tuilleadh sonraí.
OdIndex ( ) Tógann réad OdIndex nua.
nlc ::OdIndex ::OdIndex (innéacs uint16_t, fo-innéacs uint8_t)
Fo-innéacs paraiméadar innéacs
Ó 0 go 65535 (0xFFFF) san áireamh. Ó 0 go 255 (0xFF) san áireamh.
getIndex () Léann sé amach an t-innéacs (ó 0x0000 go 0xFFFF).
uint16_t nlc ::OdIndex::getIndex () const
Filleann uint16_t
getSubindex () Léann sé amach an fo-innéacs (ó 0x00 go 0xFF)
uint8_t nlc ::OdIndex ::getSubIndex () const
Leagan: doc 1.4.2 / NanoLib 1.3.0
39
8 Tagairt do ranganna/feidhmeanna
Filleann uint8_t
toString () Filleann sé an t-innéacs agus an fo-innéacs mar teaghrán. Seo a leanas an réamhshocrú teaghrán 0xIIII:0xSS:
I = innéacs ó 0x0000 go 0xFFFF
S = fo-innéacs ó 0x00 go 0xFF
std ::string nlc ::OdIndex ::toString () const
Filleann sé 0xIIII:0xSS
Léiriú teaghrán réamhshocraithe
8.23 OdLibrary
Úsáid an comhéadan ríomhchlárúcháin seo chun cásanna den aicme ObjectDictionary a chruthú ó XML. Trí shannadhObjectDictionary, is féidir leat gach cás a cheangal le gléas ar leith mar gheall ar aitheantóir uathúil cruthaithe. Stóráiltear cásanna ObjectDictionary a chruthaítear mar sin san oibiacht OdLibrary le rochtain trí innéacs. Luchtaíonn an rang ODLibrary míreanna ObjectDictionary ó file nó eagar, stóráiltear iad, agus tá na feidhmeanna comhalta poiblí seo a leanas aige:
getObjectDictionaryCount() fíorúil uint32_t getObjectDictionaryCount()const
getObjectDictionary () fíorúil ResultObjectDictionary getObjectDictionary (uint32_t odIndex)
Filleann ResultObjectDictionary
addObjectDictionaryFromFile ()
fíorúil ResultObjectDictionary addObjectDictionaryFromFile (std ::string const & absoluteXmlFilecosán)
Filleann ResultObjectDictionary
addObjectDictionary ()
Fíorúil ToradhObjectDictionary addObjectDictionary (std::veicteoir const & odXmlData, const std::teaghrán &xmlFileConair = std::teaghrán ())
Filleann ResultObjectDictionary
8.24 OdTypesHelper
Chomh maith leis na feidhmeanna ball poiblí seo a leanas, tá cineálacha sonraí saincheaptha san aicme seo. Nóta: Chun do chineálacha sonraí saincheaptha a sheiceáil, lorg an rang enum ObjectEntryDataType in od_types.hpp.
uintToObjectCode () Tiontaítear slánuimhreacha gan síniú go cód oibiachta:
Cineál Cosanta Neamhní
0x00 0x05
Leagan: doc 1.4.2 / NanoLib 1.3.0
40
8 Tagairt do ranganna/feidhmeanna
Defstruct Var Array Taifead
0x06 0x07 0x08 0x09
Cód Object statach uintToObjectCode (cód réad gan síniú)
isNumericDataType () Cuirtear ar an eolas má tá cineál sonraí uimhriúil nó nach bhfuil.
is é bool statach Cineál Sonraí Uimhriúil (Cineál sonraí ObjectEntryDataType)
isDefstructIndex () Cuireann sé ar an eolas más innéacs struchtúir sainmhínithe é réad nó nach ea.
bool statach isDefstructIndex (uint16_t typeNum)
isDeftypeIndex () Cuirtear ar an eolas más innéacs cineál sainmhínithe é réad nó nach ea.
bool statach isDeftypeIndex (uint16_t typeNum)
isComplexDataType () Cuirtear ar an eolas má tá cineál sonraí casta nó nach bhfuil.
is Cineál Sonraí Coimpléascacha é bool statach (Cineál sonraí ObjectEntryDataType)
uintToObjectEntryDataType () Tiontaítear slánuimhreacha gan síniú go cineál sonraí OD.
sstatic ObjectEntryDataType uintToObjectEntryDataType (uint16_t objectDataType)
objectEntryDataTypeToString () Athraíonn an cineál sonraí OD go teaghrán.
std statach ::string objectEntryDataTypeToString (ObjectEntryDataType odDataType)
stringToObjectEntryDatatype () Tiontaítear teaghrán go cineál sonraí OD más féidir. Seachas sin, seolfaidh sé UNKNOWN_DATATYPE ar ais.
statach ObjectEntryDataType stringToObjectEntryDatatype (std :: string dataTypeString)
Leagan: doc 1.4.2 / NanoLib 1.3.0
41
8 Tagairt do ranganna/feidhmeanna
objectEntryDataTypeBitLength () Cuirtear an cineál sonraí iontrála réada ar an eolas maidir le fad giotán.
statach uint32_t objectEntryDataTypeBitLength (ObjectEntryDataType const & dataType)
8.25 Struchtúr RESTfulBus
Tá na roghanna cumraíochta cumarsáide don chomhéadan RESTful (thar Ethernet) sa struchtúr seo. Tá na tréithe poiblí seo a leanas ann:
const std::string const gan síniú fada const std::string const gan síniú fada const std::string const gan síniú fada
CONNECT_TIMEOUT_OPTION_NAME = “Am istigh RESTful Connect” DEFAULT_CONNECT_TIMEOUT = 200 REQUEST_TIMEOUT_OPTION_NAME = “Am istigh d’Iarratas IS FEARR” DEFAULT_REQUEST_TIMEOUT = 200 FREAGRACH_TIMEOUT_OPTION_NAME = “Am istigh RESTful Freagartha” DSEFAULT
8.26 ProfinetDCP
Faoi Linux, tá cumais CAP_NET_ADMIN agus CAP_NET_RAW ag teastáil ón bhfeidhmchlár glaonna. Chun a chumasú: sudo setcap 'cap_net_admin, cap_net_raw+eip' ./executable. I Windows, úsáideann comhéadan ProfinetDCP WinPcap (tástáil le leagan 4.1.3) nó Npcap (tástáil le leaganacha 1.60 agus 1.30). Mar sin déanann sé cuardach ar an leabharlann wpcap.dll atá luchtaithe go dinimiciúil san ord seo a leanas (Nóta: níl tacaíocht Win10Pcap ann faoi láthair):
1. Eolaire Nanolib.dll 2. Eolaire córais Windows SystemRoot%System32 3. Eolaire suiteála npcap SystemRoot%System32Npcap 4. Conair an chomhshaoil
Léiríonn an aicme seo comhéadan Profinet DCP agus tá na feidhmeanna ball poiblí seo a leanas aige:
getScanTimeout ( ) Cuireann sé seo ar an eolas faoi am istigh scanadh gléis (réamhshocraithe = 2000 ms).
fíorúil uint32_t nlc ::ProfinetDCP ::getScanTimeout () const
setScanTimeout () Socraíonn sé teorainn ama maidir le scanadh gléis (réamhshocraithe = 2000 ms).
folús fíorúil nlc ::setScanTimeout (uint32_t timeoutMsec)
getResponseTimeout () Cuireann sé seo ar an eolas maidir le teorainn ama freagartha gléis le haghaidh oibríochtaí socraithe, athshocraithe agus blink (réamhshocraithe = 1000 ms).
fíorúil uint32_t nlc ::ProfinetDCP ::getResponseTimeout () const
setResponseTimeout () Cuireann sé seo ar an eolas maidir le teorainn ama freagartha gléis le haghaidh oibríochtaí socraithe, athshocraithe agus blink (réamhshocraithe = 1000 ms).
folús fíorúil nlc ::ProfinetDCP ::setResponseTimeout (uint32_t timeoutMsec)
Leagan: doc 1.4.2 / NanoLib 1.3.0
42
8 Tagairt do ranganna/feidhmeanna
isServiceAvailable ()
Úsáid an fheidhm seo chun infhaighteacht seirbhíse Profinet DCP a sheiceáil.
Bailíocht / infhaighteacht adapter líonra Windows: infhaighteacht WinPcap / Npcap Linux: cumais CAP_NET_ADMIN / CAP_NET_RAW
Virtual ResultVoid nlc ::ProfinetDCP ::isServiceAvailable (const BusHardwareId & busHardwareId)
Paraiméadair Tuairisceáin BusHardwareId fíor
bréagach
Aitheantas crua-earraí seirbhís Profinet DCP le seiceáil. Tá seirbhís ar fáil. Níl an tseirbhís ar fáil.
scanProfinetDevices () Úsáid an fheidhm seo chun an bus crua-earraí a scanadh le haghaidh láithreacht gléasanna Profinet.
Fíorúla ToradhProfinetDevices scanProfinetDevices (ar nós BusHardwareId & busHardwareId)
Paraiméadair Tuairisceáin BusHardwareId ResultProfinetDevices
Sonraíonn sé gach bus páirce le hoscailt. Tá crua-earraí oscailte.
setupProfinetDevice () Bunaítear na socruithe gléis seo a leanas:
Ainm an ghléis
Seoladh IP
Masc líonra
Geata réamhshocraithe
Virtual ResultVoid nlc ::setupProfinetDevice (const BusHardwareId & busHardwareId, const ProfinetDevice struct & ProfinetDevice, bool savePermanent)
resetProfinetDevice () Stopann an gléas agus athshocraíonn sé go mainneachtainí monarchan.
Virtual ResultVoid nlc ::resetProfinetDevice (const BusHardwareId & busHardwareId, le ProfinetDevice & profinetDevice)
blinkProfinetDevice () Ordaíonn an gléas Profinet chun tús a blinking a Profinet LED.
Virtual ResultVoid nlc ::blinkProfinetDevice (const BusHardwareId & busHardwareId, le ProfinetDevice &profinetDevice)
validateProfinetDeviceIp () Úsáid an fheidhm seo chun seoladh IP an ghléis a sheiceáil.
Toradh FíorúilVoid validateProfinetDeviceIp (ar nós BusHardwareId &busHardwareId, le ProfinetDevice & ProfinetDevice)
Paraiméadair BusHardwareId ProfinetDevice
Sonraíonn an t-aitheantas crua-earraí le seiceáil. Sonraítear an gléas Profinet le bailíochtú.
Leagan: doc 1.4.2 / NanoLib 1.3.0
43
8 Tagairt do ranganna/feidhmeanna
Filleann ResultVoid
8.27 Struchtúr ProfinetDevice
Tá na tréithe poiblí seo a leanas ag sonraí gléis Profinet:
std :: teaghrán std :: teaghrán std :: eagar< uint8_t, 6 > uint32_t uint32_t uint32_t
deviceName deviceVendor macAddress ipAddress netMask defaultGateway
Cuirtear an seoladh MAC ar fáil mar eagar san fhormáid macAddress = {xx, xx, xx, xx, xx, xx}; ach léirmhínítear seoladh IP, masc líonra agus geata mar uimhreacha móra heicsidheacha endian, mar:
Seoladh IP: 192.168.0.2 Masc líonra: 255.255.0.0 Geata: 192.168.0.1
0xC0A80002 0xFFFF0000 0xC0A80001
8.28 Aicmí torthaí
Bain úsáid as luachanna aischuir “roghnacha” na ranganna seo le seiceáil ar éirigh le glao feidhme nó nár éirigh, agus chun na cúiseanna teipe a aimsiú freisin. Ar rathúlacht, filleann an fheidhm hasError () bréagach. Le getResult (), is féidir leat luach an toraidh a léamh amach de réir cineáil (ResultInt etc.). Má theipeann ar ghlao, léigh tú amach an chúis ag getError ().
Tréithe cosanta
teaghrán NlcErrorCode uint32_t
errorString errorCode exErrorCode
Chomh maith leis sin, tá na feidhmeanna ball poiblí seo a leanas ag an aicme seo:
hasError () Léann sé amach rath glao feidhme.
bool nlc ::Toradh::hasError () const
Tuairisceáin
fíor bréagach
Theip ar an nglao. Úsáid getError () chun an luach a léamh amach. Glao rathúil. Úsáid getResult () chun an luach a léamh amach.
getError () Léann sé amach an chúis má theipeann ar ghlao feidhme.
const std ::string nlc ::Toradh::getError () const
Teaghrán const tuairisceáin
Leagan: doc 1.4.2 / NanoLib 1.3.0
44
8 Tagairt do ranganna/feidhmeanna
toradh () Cuidíonn na feidhmeanna seo a leanas leis na torthaí cruinne a shainiú:
Toradh (std:: string const & errorString_)
Toradh (NlcErrorCode const & errCode, std :: string const & errorString_)
Toradh (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
Toradh (Result const & toradh)
getErrorCode () Léigh an NlcErrorCode.
NlcErrorCode getErrorCode() const
getExErrorCode() uint32_t getExErrorCode() const
8.28.1 ToradhVoid
Seolann NanoLib sampla den aicme seo chugat má thagann an fheidhm ar neamhní. Faigheann an aicme na feidhmeanna poiblí agus na tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
ResultVoid () Cuidíonn na feidhmeanna seo a leanas le toradh beacht an fholaimh a shainiú:
ResultVoid (std:: string const &errorString_)
ResultVoid (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultVoid (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultVoid (Result const & toradh)
8.28.2 Toradh
Seolann NanoLib sampla den aicme seo chugat má thugann an fheidhm slánuimhir ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Filleann sé an toradh slánuimhir dá mbeadh rath ar ghlao feidhme.
int64_t getResult()const
Filleann int64_t
Leagan: doc 1.4.2 / NanoLib 1.3.0
45
8 Tagairt do ranganna/feidhmeanna
Toradh () Cuidíonn na feidhmeanna seo a leanas leis an toradh slánuimhir beacht a shainiú:
Toradh Int (int64_t toradh_)
ResultInt (std:: string const & errorString_)
ResultInt (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultInt (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultInt (Result const & toradh)
8.28.3 Sraith Torthaí
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm sreang ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach an toradh teaghrán má d'éirigh le glao feidhme.
const std ::string nlc ::ResultString::getResult () const
Teaghrán const tuairisceáin
ResultString () Cuidíonn na feidhmeanna seo a leanas leis an toradh teaghrán beacht a shainiú:
ResultString (std:: const teaghrán & teachtaireacht, bool hasError_)
ResultString (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultString (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultString (Result const & toradh)
8.28.4 ToradhArrayByte
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm eagar beart ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach an veicteoir beart dá mbeadh rath ar ghlao feidhme.
const std::veicteoir nlc ::ResultArrayByte ::getResult () const
Tuairisceáin const veicteoir
Leagan: doc 1.4.2 / NanoLib 1.3.0
46
8 Tagairt do ranganna/feidhmeanna
ResultArrayByte () Cuidíonn na feidhmeanna seo a leanas le toradh beacht an eagar beart a shainiú:
ResultArrayByte (std::veicteoir const & toradh_)
ResultArrayByte (std :: string const & errorString_)
ResultArrayByte (const & errCode NlcErrorCode, std :: string const & error String_)
ResultArrayByte (const & errCode NlcErrorCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultArrayByte (Result const & toradh)
8.28.5 ToradhArrayInt
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm eagar slánuimhir ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach an veicteoir slánuimhir dá mbeadh rath ar ghlao feidhme.
const std::veicteoir nlc ::ResultArrayInt::getResult () const
Tuairisceáin const veicteoir
ResultArrayInt () Cuidíonn na feidhmeanna seo a leanas le toradh beacht an eagar slánuimhreacha a shainiú:
ResultArrayInt (std::veicteoir const & toradh_)
ResultArrayInt (std:: string const & errorString_)
ResultArrayInt (const & errCode NlcErrorCode, std :: string const & error String_)
ResultArrayInt (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultArrayInt (Result const & toradh)
8.28.6 TorthaíBusHwIds
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm eagar aitheantais crua-earraí bus ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach an veicteoir bus-crua-earraí-aitheantas dá mbeadh rath ar ghlao feidhme.
const std::veicteoir nlc ::ResultBusHwIds ::getResult () const
Paraiméadair i veicteoir
Leagan: doc 1.4.2 / NanoLib 1.3.0
47
8 Tagairt do ranganna/feidhmeanna
ResultBusHwIds () Cuidíonn na feidhmeanna seo a leanas leis an toradh beacht ar eagar ID-crua-earraí bus a shainiú:
ResultBusHwIds (std::veicteoir const & toradh_)
ResultBusHwIds (std :: string const & errorString_)
ResultBusHwIds (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultBusHwIds (const & errCode NlcErrorCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultBusHwIds (Result const & toradh)
8.28.7 ResultDeviceId
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm ID gléis ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach veicteoir aitheantais an ghléis dá n-éireodh le glao feidhme.
DeviceId nlc::ResultDeviceId::getResult () const
Tuairisceáin const veicteoir
ResultDeviceId () Cuidíonn na feidhmeanna seo a leanas le toradh cruinn aitheantais gléis a shainiú:
ResultDeviceId (DeviceId const & result_)
ResultDeviceId (std:: string const & errorString_)
ResultDeviceId (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultDeviceId (const & errCode NlcErrorCode, const uint32_t exErrCode, std :: string errorString_)
ResultDeviceId (Toradh & toradh)
8.28.8 ResultDeviceIds
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm eagar aitheantais gléis ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Filleann sé veicteoir aitheantais an ghléis dá n-éireodh le glao feidhme.
DeviceId nlc ::ResultDeviceIds ::getResult () const
Tuairisceáin const veicteoir
Leagan: doc 1.4.2 / NanoLib 1.3.0
48
8 Tagairt do ranganna/feidhmeanna
ResultDeviceIds () Cuidíonn na feidhmeanna seo a leanas le toradh beacht an eagar aitheantais ghléis a shainiú:
ResultDeviceIds (std::veicteoir const & toradh_)
ResultDeviceIds (std:: string const & errorString_)
ResultDeviceIds (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultDeviceIds (const & errCode NlcErrorCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultDeviceIds (Torthaí & toradh)
8.28.9 HandDeviceDevice
Seolann NanoLib sampla den aicme seo chugat má thugann an fheidhm luach hanla gléis ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé seo láimhseáil an ghléis dá n-éireodh le glao feidhme.
DeviceHandle nlc ::ResultDeviceHandle::getResult () const
Láimhseáil Gléas Tuairisceáin
ResultDeviceHandle () Cuidíonn na feidhmeanna seo a leanas le toradh cruinn láimhseála an ghléis a shainiú:
ResultDeviceHandle (DeviceHandle const & result_)
ResultDeviceHandle (std :: string const & errorString_)
ResultDeviceHandle (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultDeviceHandle (const & errCode NlcErrorCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultDeviceHandle (Result const & toradh)
8.28.10 ResultObjectDictionary
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm inneachar i bhfoclóir oibiachta ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach veicteoir aitheantais an ghléis dá n-éireodh le glao feidhme.
const nlc ::ObjectDictionary & nlc ::ResultObjectDictionary::getResult () const
Leagan: doc 1.4.2 / NanoLib 1.3.0
49
8 Tagairt do ranganna/feidhmeanna
Tuairisceáin
veicteoir const
ResultObjectDictionary () Cuidíonn na feidhmeanna seo a leanas le toradh cruinn foclóir oibiachta a shainiú:
ResultObjectDictionary (nlc::ObjectDictionary const & result_)
ResultObjectDictionary (std:: string const & errorString_)
ResultObjectDictionary (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultObjectDictionary (NlcErrorCode const & errCode, const uint32_t exErrCode, std ::string const & errorString_)
ResultObjectDictionary (Result const & toradh)
8.28.11 StaidCeangal Torthaí
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm faisnéis maidir le ceangal-staid gléis ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé seo láimhseáil an ghléis dá n-éireodh le glao feidhme.
DeviceConnectionStateInfo nlc::ResultConnectionState::getResult () const
Filleann DeviceConnectionStateInfo Ceangailte / Dícheangailte / ConnectedBootloader
ResultConnectionState () Cuidíonn na feidhmeanna seo a leanas le toradh staid an cheangail a shainiú:
ResultConnectionState (DeviceConnectionStateInfo const & result_)
ResultConnectionState (std:: string const & errorString_)
ResultConnectionState (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultConnectionState (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultConnectionState (Result const & toradh)
8.28.12 ToradhObjectEntry
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm iontráil réad ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
Leagan: doc 1.4.2 / NanoLib 1.3.0
50
8 Tagairt do ranganna/feidhmeanna
getResult () Filleann sé veicteoir aitheantais an ghléis dá n-éireodh le glao feidhme.
nlc ::ObjectEntry const& nlc ::ResultObjectEntry ::getResult () const
Filleann sé mar ObjectEntry
ResultObjectEntry () Cuidíonn na feidhmeanna seo a leanas le toradh beacht iontrála oibiachta a shainiú:
ResultObjectEntry (nlc::ObjectEntry const & result_)
ResultObjectEntry (std:: string const & errorString_)
ResultObjectEntry (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultObjectEntry (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultObjectEntry (Result const & toradh)
8.28.13 ToradhObjectSubEntry
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm fo-iontráil réad ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Filleann sé veicteoir aitheantais an ghléis dá n-éireodh le glao feidhme.
nlc ::ObjectSubEntry const & nlc ::ResultObjectSubEntry ::getResult () const
Filleann sé mar ObjectSubEntry
ResultObjectSubEntry () Cuidíonn na feidhmeanna seo a leanas le toradh cruinn na fo-iontrála oibiachta a shainiú:
ResultObjectSubEntry (nlc::ObjectEntry const & result_)
ResultObjectSubEntry (std:: string const & errorString_)
ResultObjectSubEntry (NlcErrorCode const & errCode, std :: string const & errorString_)
ResultObjectSubEntry (NlcErrorCode const & errCode, const uint32_t exErrCode, std :: string const & errorString_)
ResultObjectSubEntry (Result const & toradh)
8.28.14 Gléasanna ResultProfinet
Seolann NanoLib sampla den aicme seo chugat má sheolann an fheidhm gléas Profinet ar ais. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
Leagan: doc 1.4.2 / NanoLib 1.3.0
51
8 Tagairt do ranganna/feidhmeanna
getResult () Léann sé amach veicteoir gléis Profinet dá n-éireodh le glao feidhme.
const std::veicteoir & getResult() const
ResultProfinetDevices () Cuidíonn na feidhmeanna seo a leanas le gléasanna cruinne Profinet a shainiú.
ResultProfinetDevices (const std::veicteoir & Gléasanna Profnet)
ResultProfinetDevices (ar lean Toradh & toradh)
ResultProfinetDevices (const std::string &errorText, NlcErrorCode errorCode = NlcErrorCode::GeneralError, uint32_t extendedErrorCode = 0)
8.28.15 TorthaíampleDataArray
Seolann NanoLib sampla den aicme seo chugat má fhilleann an fheidhm marample sraith sonraí. Faigheann an aicme feidhmeanna poiblí / tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult () Léann sé amach an t-eagar sonraí dá n-éireodh le glao feidhme.
const std ::veicteoir <SampleData> & getResult() const
TorthaíampleDataArray () Cuidíonn na feidhmeanna seo a leanas le sainiú na ngléasanna Profinet beachta.
TorthaíampleDataArray (const std::veicteoir <SampleData> & dataArray)
TorthaíampleDataArray (const std ::string &errorDesc, const NlcErrorCode errorCode = NlcErrorCode ::GeneralError, const uint32_t extendedErrorCode = 0)
TorthaíampleDataArray (const TorthaíampleDataArray & eile)
TorthaíampleDataArray (cons Toradh & toradh)
8.28.16 TorthaíamplerState
Seolann NanoLib sampla den aicme seo chugat má fhilleann an fheidhm marampler state.Tugann an aicme seo na feidhmeanna poiblí/na tréithe cosanta le hoidhreacht ón aicme torthaí agus tá na feidhmeanna ball poiblí seo a leanas aici:
getResult() Léann sé amach an sampler luaigh veicteoir dá mbeadh rath ar ghlao feidhme.
SamplerState getResult() const
Filleann SamplerState>
Neamhchumraithe / Cumraithe / Réidh / Rith / Críochnaithe / Theip / Cealaithe
Leagan: doc 1.4.2 / NanoLib 1.3.0
52
8 Tagairt do ranganna/feidhmeanna
TorthaíamplerState () Cuidíonn na feidhmeanna seo a leanas le sainiú na s cruinnampstáit ler.
TorthaíamplerState (cons Sampstát lerState)
TorthaíamplerState (const std::string & errorDesc, const NlcErrorCode errorCode = NlcErrorCode::GeneralError, const uint32_t
extendedErrorCode = 0)
TorthaíamplerState (const TorthaíamplerState & eile)
TorthaíamplerState (const Toradh & toradh)
8.29 Cód Earráid Nlc
Má théann rud éigin mícheart, tuairiscíonn na haicmí torthaí ceann de na cóid earráide a liostaítear san áireamh seo.
Cód earráide Success GeneralError BusNíl ar fáil CumarsáidEarráid ProtocolError
ODDoesN'lBann
Argóintí Neamhbhailí Rochtain Diúltaithe Acmhainn Ní bhfuarthas Acmhainn Ar fáil AsCuimhne Amach Earráid
C: Catagóir D: Cur síos R: Cúis C: Ceann ar bith. D: Gan earráid. R: Críochnaíodh an oibríocht go rathúil.
C: Neamhshonraithe. D: Earráid neamhshonraithe. R: Teip nach n-oireann d’aon chatagóir eile.
C: Bus. D: Níl bus crua-earraí ar fáil. R: Bus neamhláithriúil, scoite nó locht.
C: Cumarsáid. D: Cumarsáid neamhiontaofa. R: Sonraí gan choinne, CRC mícheart, earráidí fráma nó paireacht, etc.
C: Prótacal. D: Earráid phrótacail. R: Freagairt tar éis rogha prótacail nach dtacaítear leis, tuairiscigh ar an ngléas prótacal nach dtacaítear leis, earráid sa phrótacal (abair, giotán sioncronaithe SDO), srl. R: Freagra nó tuairisc ghléis ar phrótacal gan tacaíocht (roghanna) nó ar earráidí sa phrótacal (abair, SDO giotán sioncrónaithe deighleog), etc. R: Prótacal gan tacaíocht (roghanna) nó earráid sa phrótacal (abair, giotán sioncrónaithe deighleog SDO), etc.
C: Foclóir réad. D: Níl seoladh OD ann. R: Níl seoladh den sórt sin i bhfoclóir na n-oibiachtaí.
C: Foclóir réad. D: Rochtain ar sheoladh OD neamhbhailí. R: Déan iarracht seoladh inléite amháin a scríobh, nó léamh ó sheoladh scríofa amháin.
C: Foclóir réad. D: Cineál mímheaitseála. R: Luach neamhthiontaithe go cineál sonraithe, abair, in iarracht déileáil le téad mar uimhir.
C: Iarratas. D: Cuireadh deireadh leis an bpróiseas. R: Próiseas gearrtha de réir iarratais iarratais. Ní dhéantar tuairisceáin ach amháin nuair a chuireann feidhm aisghlaoch isteach, abair, ó scanadh busanna.
C: Coitianta. D: Próiseas gan tacaíocht. R: Gan tacaíocht bus crua-earraí / gléas.
C: Coitianta. D: Próiseas mícheart sa chomhthéacs reatha, nó neamhbhailí leis an argóint reatha. R: Iarracht a athcheangail le busanna / gléasanna atá nasctha cheana féin. Iarracht dínasctha leis na cinn atá dícheangailte cheana. Iarracht oibríocht bootloader i mód firmware nó vice versa.
C: Coitianta. D: Argóint neamhbhailí. R: Loighic nó comhréir mícheart.
C: Coitianta. D: Diúltaítear rochtain. R: Easpa cearta nó cumas chun an oibríocht iarrtha a dhéanamh.
C: Coitianta. D: Ní bhfuarthas an mhír shonraithe. R: Bus crua-earraí, prótacal, gléas, seoladh OD ar an ngléas, nó file níor aimsíodh.
C: Coitianta. D: Ní bhfuarthas an mhír shonraithe. R: gnóthach, gan a bheith ann, scoite nó lochtach.
C: Coitianta. D: Cuimhne neamhleor. R: Cuimhne róbheag chun an t-ordú seo a phróiseáil.
C: Coitianta. D: Tá an próiseas imithe thar am. R: Fill ar ais tar éis dul in éag. D’fhéadfadh teorainn ama a bheith i gceist le ham freagartha gléis, am chun rochtain acmhainní comhroinnte nó eisiach a fháil, nó am chun an bus / gléas a athrú go staid oiriúnach.
Leagan: doc 1.4.2 / NanoLib 1.3.0
53
8 Tagairt do ranganna/feidhmeanna
8.30 NlcCallback
Tá an fheidhm ball poiblí seo a leanas ag an rang tuismitheora seo le haghaidh aisghlaonna: aisghlao ()
aisghlaoch Fíorúil ToradhVoid ()
Tuairisceáin
ToradhVoid
8.31 NlcData TransferCallback
Bain úsáid as an rang aisghlao seo le haghaidh aistrithe sonraí (nuashonrú firmware, uaslódáil NanoJ etc.). 1. Le haghaidh uaslódála firmware: Sainmhínigh “comhaicme” a leathnaíonn an ceann seo le modh aisghlao saincheaptha
cur i bhfeidhm. 2. Bain úsáid as an “comhaicme” cásanna i NanoLibAccessor.uploadFirmware() glaonna. Tá an fheidhm bhall poiblí seo a leanas ag an bpríomhaicme féin:
aisghlaoch () aisghlaoch fíorúil ResultVoid (nlc ::faisnéis DataTransferInfo, sonraí int32_t)
Tuairisceáin
ToradhVoid
8.32 NlcScanBusCallback
Bain úsáid as an rang aisghlao seo le haghaidh scanadh bus. 1. Sainmhínigh “comhaicme” a leathnaíonn an ceann seo le modh aisghlao saincheaptha a chur i bhfeidhm. 2. Bain úsáid as cásanna “comhaicme” i nglaonna NanoLibAccessor.scanDevices(). Tá an fheidhm ball poiblí seo a leanas ag an bpríomhaicme féin.
glaoch ar ais ()
aisghlaoch fíorúil ResultVoid (nlc ::BusScanInfo info, std::vector const & feistí Aimsíodh, sonraí int32_t)
Filleann ResultVoid
8.33 NlcLoggingCallback
Úsáid an rang aisghlao seo chun glaonna ar ais a logáil. 1. Sainmhínigh rang a leathnaíonn an aicme seo le modh aisghlao saincheaptha a chur i bhfeidhm 2. Úsáid pointeoir dá chásanna chun aisghlao a shocrú le NanoLibAccessor >
setLoggingCallback (…).
aisghlaoch ar neamhní fíorúil (const std :: string & payload_str, const std :: string & formatted_str, const std :: teaghrán & logger_name, arb ionann é agus log_level gan síniú, const std :: uint64_t time_since_epoch, const size_t thread_id)
8.34 SamplerInterface
Úsáid an rang seo chun na s a chumrú, a thosú agus a stopadhampler, nó chun sampsonraí faoi stiúir agus beir marampstádas ler nó an earráid dheireanach. Tá na feidhmeanna ball poiblí seo a leanas ag an rang.
Leagan: doc 1.4.2 / NanoLib 1.3.0
54
8 Tagairt do ranganna/feidhmeanna
chumraigh () Cumraíonn sé marampler.
Virtual ResultVoid nlc::SamplerInterface::cumraigh (const DeviceHandle deviceHandle, const SamplerConfiguration & samplerCumraíocht)
Paraiméadair [i] ngléas Láimhseáil [in] samplerCumraíocht
Filleann ResultVoid
Sonraíonn cén gléas a chumrú an sampler le haghaidh. Sonraíonn sé luachanna tréithe cumraíochta. Deimhníonn sé gur rith feidhm fholús.
getData() Faigheann an sampsonraí faoi stiúir.
Torthaí FíorúlaampleDataArray nlc::SamplerInterface ::getData (const DeviceHandle deviceHandle)
Paraiméadair [in] deviceHandle Returns TorthaíampleDataArray
Sonraítear cén gléas chun na sonraí a fháil dó.
Seachadann an sampsonraí faoi stiúir, ar féidir leo a bheith ina eagar folamh má sampTá lerNotify gníomhach ar an tús.
getLastError() Faigheann marampearráid dheireanach ler.
Virtual ResultVoid nlc::SamplerInterface ::getLastError (const DeviceHandle deviceHandle)
Filleann ResultVoid
Deimhníonn sé gur rith feidhm fholús.
getState() Faigheann marampstádas ler.
Torthaí FíorúlaamplerState nlc::SamplerInterface ::getState (const DeviceHandle deviceHandle)
Torthaí TuairisceáinamplerState
Seachadann an sampstáit ler.
tús () Tosaíonn marampler.
Virtual ResultVoid nlc::SamplerInterface::tús (const DeviceHandle deviceHandle, SamplerCuir in iúl* samplerNotify, int64_t applicationData)
Paraiméadair [i] ngléas Láimhseáil [i] SamplerNotify [in] applicationData
Filleann ResultVoid
Sonraíonn cén gléas a thosóidh an sampler le haghaidh.
Sonraítear cén fhaisnéis roghnach atá le tuairisciú (is féidir a bheith nullptr).
Rogha: Cuir sonraí a bhaineann le feidhmchlár ar aghaidh (eagar 8 ngiotán de luach / aitheantas gléis / innéacs, nó dáta ama, pointeoir athróige / feidhme, etc.) chuig s.amplerFógra.
Deimhníonn sé gur rith feidhm fholús.
Leagan: doc 1.4.2 / NanoLib 1.3.0
55
8 Tagairt do ranganna/feidhmeanna
stopann () Stopann marampler.
Virtual ResultVoid nlc::SamplerInterface :: stop (const DeviceHandle deviceHandle)
Paraiméadair [in] deviceHandle Returns ResultVoid
Sonraíonn cén gléas a stopann an sampler le haghaidh. Deimhníonn sé gur rith feidhm fholús.
8.35 SamplerCumraíocht struchtúr
Cuimsíonn an struchtúr seo na sonraí samproghanna cumraíochta ler (statach nó nach ea).
Tréithe poiblí
std::veicteoir seoltaí rianaithe
Suas le 12 seoladh OD le bheith sampfaoi stiúir.
uint32_t
leagan
Leagan struchtúir.
uint32_t
réMilliseconds
Sampfad ling in ms, ó 1 go 65535
uint16_t
tréimhseMilleasoicindí
Samptréimhse ling in ms.
uint16_t
uimhirOfSamples
Samples méid.
uint16_t
preTriggerUimhirOfSamples
Samples méid réamh-truicear.
bool
ag baint úsáide asSoftwareImplementation
Bain úsáid as cur i bhfeidhm bogearraí.
bool
ag baint úsáide as NewFWSamplerImplementation Úsáid FW le haghaidh gléasanna a bhfuil a
Leagan FW v24xx nó níos nuaí.
SamplerMode
mód
Gnáth, athchleachtach nó leanúnach samplanga.
SamplerTriggerCondition triggerCondition
Coinníollacha truicear tosaigh: TC_FALSE = 0x00 TC_TRUE = 0x01 TC_SET = 0x10 TC_CLEAR = 0x11 TC_RISING_EDGE = 0x12 TC_FALLING_EDGE = 0x13 TC_BIT_TOGGLE = 0x14 TCGREATER_0x15 TC_RISING_EDGE 0x16 TC_LESS = 0x17 TC_LESS_OR_EQUAL = 0x18 TC_EQUAL = 0x19 TC_NOT_EQUAL = 0x1A TC_ONE_EDGE = 0x1B TC_MULTI_EDGE = 0x1C, OueIndex, triggerVal
SamplerTrigger
SamplerTrigger
Truicear le tosú marampler?
Tréithe poiblí statacha
constexpr statach size_t SAMPLER_CONFIGURATION_VERSION = 0x01000000 constexpr statach size_t MAX_TRACKED_ADDRESSES = 12
8.36 SamplerFógra
Úsáid an rang seo chun sampfógraí ler nuair a thosaíonn tú marampler. Tá an fheidhm ball poiblí seo a leanas ag an rang.
Leagan: doc 1.4.2 / NanoLib 1.3.0
56
8 Tagairt do ranganna/feidhmeanna
fógra a thabhairt ()
Seachadann sé iontráil fógra.
folús fíorúil nlc::SamplerNotify:: cuir in iúl (const ResultVoid & lastError, const SamplerState samplerState, const std::veicteoir <SampleData > & sampleDatas, int64_t applicationData)
Paraiméadair[i]deireadhEarráid[i]samplerState
[in] sampleDatas [in] applicationData
Tuairiscíonn gur tharla an earráid dheireanach agus samplanga. Tuairiscíonn an sampler status ag am fógartha: Neamhchumraithe / Cumraithe / Réidh / Rith / Críochnaithe / Theip / Cealaithe. Tuairiscíonn an sampeagar sonraí faoi stiúir. Tuairiscíonn sonraí a bhaineann go sonrach le feidhmchlár.
8.37 SampStruchtúr leData
Cuimsíonn an struchtúr seo na sampsonraí faoi stiúir.
uin64_t atriallUimhir
Tosaíonn ag 0 agus ní dhéantar ach méadú ar mhodh athchleachtach.
std::veicteoir<SampledValues > Contains he array of sampluachanna faoi stiúir.
8.38 SampStruchtúr faoi stiúirValue
Cuimsíonn an struchtúr seo na sampluachanna faoi stiúir.
in64_t luach uin64_t CollectTimeMsec
Tá luach seolta OD rianaithe ann.
Áiríonn sé an t-am bailiúcháin ina milleasoicindí, i gcoibhneas leis na sample tús.
8.39 SamplerTrigger struchtúr
Cuimsítear sa struchtúr seo socruithe truicear an sampler.
SamplerTrigger Coinníoll riocht
Luach OdIndex uin32_t
Coinníoll an truicear: TC_FALSE = 0x00 TC_TRUE = 0x01 TC_SET = 0x10 TC_CLEAR = 0x11 TC_RISING_EDGE = 0x12 TC_FALLING_EDGE = 0x13 TC_BIT_TOGGLE = 0x14 TC_GREATER_ TC0GREATER_ 15x0 TC_LESS = 16x0 TC_LESS_OR_EQUAL = 17x0 TC_EQUAL = 18x0 TC_NOT_EQUAL = 19x0A TC_ONE_EDGE = 1x0B TC_MULTI_EDGE = 1x0C
OdIndex an truicear (seoladh).
Luach coinníll nó uimhir ghiotán (ag tosú ó nialais ghiotán).
8.40 Struchtúr sraitheach
Faigh anseo do roghanna cumarsáide sraitheach agus na tréithe poiblí seo a leanas:
const std ::string const SerialBaudRate
BAUD_RATE_OPTIONS_NAME = “ráta baud sraitheach” baudRate = Struchtúr na Sraithe BaudRate
Leagan: doc 1.4.2 / NanoLib 1.3.0
57
8 Tagairt do ranganna/feidhmeanna
const std ::string const SerialParity
PARITY_OPTIONS_NAME = Paireacht “srathach” = Struchtúr na Sraithe Parity
8.41 Struchtúr SraitheBaudRate
Faigh anseo do ráta baud cumarsáide sraitheach agus na tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string const std::string
BAUD_RATE_7200 = “7200” BAUD_RATE_9600 = “9600” BAUD_RATE_14400 = “14400” BAUD_RATE_19200 = “19200” BAUD_RATE_38400 = “38400” BAUD_RATE_56000 “56000” BAUD_RATE_57600 = “57600” BAUD_RATE_115200 115200” BAUD_RATE_128000 = “128000” BAUD_RATE_256000 = “256000” BAUD_RATE_XNUMX = “XNUMX”
8.42 struchtúr Sraithpharthaíochta
Faigh anseo do roghanna paireacht sraitheach agus na tréithe poiblí seo a leanas:
const std::string const std::string const std::string const std::string const std::string
NONE = “none” ODD = “corr” EVEN = “cothrom” MARC = “marc” SPÁS = “spás”
Leagan: doc 1.4.2 / NanoLib 1.3.0
58
9 Ceadúnais
9 Ceadúnais
Ceanntásca comhéadan NanoLib API agus seanample cód foinse atá ceadúnaithe ag Nanotec Electronic GmbH & Co. KG faoin gCeadúnas Creative Commons Attribution 3.0 Unported (CC BY). Tá páirteanna leabharlainne a sholáthraítear i bhformáid dhénártha (leabharlanna cumarsáide lárnacha agus busanna machaire) ceadúnaithe faoin gCeadúnas Idirnáisiúnta Creative Commons AttributionNoDerivatives 4.0 (CC BY ND).
Commons Cruthaitheach
Ní chuirfear an achoimre seo a leanas inléite ag an duine in ionad an cheadúnais nó na gceadúnas féin. Is féidir leat an ceadúnas faoi seach a fháil ag creativecommons.org agus nasctha thíos. Tá tú saor chun:
CC LE 3.0
Comhroinn: Féach ar dheis. Oiriúnú: Remix, claochlú, agus tóg ar an
ábhar chun críche ar bith, fiú ar bhonn tráchtála.
CC BY-ND 4.0
Roinn: Cóipeáil agus athdháil an t-ábhar in aon mheán nó formáid.
Ní féidir leis an gceadúnaí na saoirsí thuas a chúlghairm chomh fada agus go gcloíonn tú leis na téarmaí ceadúnais seo a leanas:
CC LE 3.0
CC BY-ND 4.0
Attribution: Ní mór duit creidmheas cuí a thabhairt, Attribution: Féach ar chlé. Ach: Cuir nasc chuige seo
cuir nasc chuig an gceadúnas, agus cuir in iúl má
ceadúnas eile.
rinneadh athruithe. Is féidir leat é sin a dhéanamh in aon cheann
Gan díorthaigh: Má dhéanann tú remix, claochlú nó tógáil
ar mhodh réasúnta, ach ní ar aon chaoi a mhol-
ar an ábhar, ní féidir leat a dháileadh ar an
go dtacaíonn an ceadúnaí leat nó le d’úsáid.
ábhar modhnaithe.
Gan srianta breise: Ní féidir leat iarratas a dhéanamh Uimh srianta breise: Féach ar chlé. téarmaí dlíthiúla nó bearta teicneolaíochta a dhéanann go dlíthiúil
srian a chur ar dhaoine eile aon rud a dhéanamh leis an gceadúnas
ceadanna.
Nóta: Ní gá duit cloí leis an gceadúnas le haghaidh gnéithe den ábhar atá san fhearann poiblí nó sa chás go bhfuil d’úsáid ceadaithe ag eisceacht nó teorannú infheidhmithe.
Nóta: Níor tugadh aon bharántas. Ní fhéadfaidh an ceadúnas na ceadanna go léir atá riachtanach don úsáid atá beartaithe agat a thabhairt duit. Le haghaidh example, d’fhéadfadh cearta eile ar nós poiblíochta, príobháideachta nó cearta morálta srian a chur ar an gcaoi a n-úsáideann tú an t-ábhar.
Leagan: doc 1.4.2 / NanoLib 1.3.0
59
Imprint, teagmháil, leaganacha
©2024 Nanotec Electronic GmbH & Co.KGKapellenstr.685622 FeldkirchenGermanyTel.+49(0) 89 900 686- 0Fax+49(0)89 900 686-50 eolas@nanotec.dewww.nanotec.com Gach ceart ar cosaint. Earráid, easnamh, athrú teicniúil nó ábhar is féidir gan fógra. Is trádmharcanna de chuid a n-úinéirí iad brandaí/táirgí luaite agus caithfear déileáil leo mar sin. Bunleagan.
Doiciméad 1.4.2 2024.12 1.4.1 2024.10 1.4.0 2024.09 1.3.3 2024.07
1.3.2 2024.05 1.3.1 2024.04 1.3.0 2024.02
1.2.2 2022.09 1.2.1 2022.08 1.2.0 2022.08
+ Curtha leis > Athraíodh # Seasta > Athobair ar an sean-fhoramples.
+ NanoLib Modbus: Cuireadh meicníocht glasála feiste le Modbus VCP. # NanoLib Core: Seiceáil stáit nasc seasta. # Cód NanoLib: Baint tagartha crua-earraí bus ceartaithe.
+ NanoLib-CANopen: Tacaíocht do adapter Buaic PCAN-USB (IPEH-002021/002022).
> NanoLib Core: Comhéadan aisghlaoch logála athraithe (LogLevel in ionad LogModule). # NanoLib Logger: Ceartaíodh an deighilt idir croí-mhodúil agus modúil. # Modbus TCP: Nuashonrú firmware seasta do FW4. # EtherCAT: Uaslódáil clár NanoJ seasta le haghaidh Core5. # EtherCAT: Nuashonrú firmware seasta do Core5.
# Modbus RTU: Saincheisteanna ama seasta le rátaí baud íseal le linn nuashonrú firmware. # RESTful: Uaslódáil clár NanoJ seasta.
# Modúil NanoLib Sampler: Léamh ceart ar sampluachanna boolean faoi stiúir.
+ Tacaíocht Java 11 do gach ardán. + Tacaíocht Python 3.11 / 3.12 do gach ardán. + Comhéadan aisghlaoch logála nua (féach examples). + Doirtil aisghlao do NanoLib Logger. > Nuashonraigh logálaí go leagan 1.12.0. > Modúil NanoLib Sampler: Tacaíocht anois do firmware rialtóir Nanotec v24xx. > Modúil NanoLib Sampler: Athrú ar an struchtúr a úsáidtear le haghaidh sampcumraíocht ler. > Modúil NanoLib Sampler: Is ionann modh leanúnach agus gan deireadh; déantar an riocht truicear a sheiceáil uair amháin; líon na samples must be 0. > NanoLib Modúil Sampler: Gnáththosaíocht don snáithe a bhailíonn sonraí i mód firmware. > Modúil NanoLib Sampler: Algartam athscríofa chun trasdul idir staid Réidh & Rith a bhrath. # NanoLib Core: Gan sárú Rochtana níos mó (0xC0000005) ar dhúnadh 2 fheiste nó níos mó ag baint úsáide as na crua-earraí bus céanna. # NanoLib Core: Gan a thuilleadh Locht Deighilte ar oiriúntóir PEAK a cheangal faoi Linux. # Modúil NanoLib Sampler: Ceart sampléamh luachanna faoi stiúir i mód firmware. # Modúil NanoLib Sample: Cumraíocht cheart 502X:04. # Modúil NanoLib Sampler: Meascadh ceart maoláin le cainéil. # NanoLib-Canopen: Teorainneacha ama méadaithe CAN le haghaidh stóinsithe agus scanadh ceart ag baudrates níos ísle. # NanoLib-Modbus: algartam braite VCP le haghaidh feistí speisialta (USB-DA-IO).
+ Tacaíocht EtherCAT.
+ Nóta ar shocruithe tionscadail VS i Cumraigh do thionscadal.
+ getDeviceHardwareGroup (). + getProfinetDCP (isServiceAvailable). + getProfinetDCP (validateProfinetDeviceIp). +uathAssignObjectDictionary(). +fhaighXmlFileAinm (). + const std::teaghrán & xmlFileConair in addObjectDictionary(). + faigheannSamplerInterface ().
Táirge 1.3.0 1.2.1 1.2.0 1.1.3
1.1.2 1.1.1 1.1.0
1.0.1 (B349) 1.0.0 (B344) 1.0.0 (B341)
Leagan: doc 1.4.2 / NanoLib 1.3.0
60
10 Imprint, teagmháil, leaganacha
Doiciméad
1.1.2 2022.03 1.1.1 2021.11 1.1.0 2021.06 1.0.1 2021.06 1.0.0 2021.05
+ Curtha leis > Athraíodh # Seasta + rebootDevice (). + Cód earráide ResourceNíl ar fáil le haghaidh getDeviceBootloaderVersion (), ~VendorId (), ~HardwareVersion (), ~SrathachUimhir, agus ~Uid. > FirmwareUploadFromFile uaslódáil anoisFirmwareFromFile (). > firmwareUpload () anois uploadFirmware (). > bootloaderUploadFromFile () anois uploadBootloaderFromFile (). > bootloaderUpload () anois uploadBootloader (). > bootloaderFirmwareUploadFromFile () a uaslódáilBootloaderFirmwareFromFile (). > bootloaderFirmwareUpload () anois uploadBootloaderFirmware (). > nanojUploadÓFile () anois uaslódáilNanoJFromFile (). > nanojUpload() anois uploadNanoJ(). > objectDictionaryLibrary ( ) now getObjectDictionaryLibrary ( ). > String_String_Map anois StringStringMap. > NanoLib-Common: forghníomhú níos tapúla ar listAvailableBusHardware agus openBusHardwareWithProtocol le cuibheoir Ixxat. > NanoLib-CANopen: socruithe réamhshocraithe a úsáidtear (1000k baudrate, uimhir bus Ixxat 0) má tá roghanna crua-earraí bus folamh. > NanoLib-RESTful: cead admin imithe i léig le haghaidh cumarsáide le bootloaders Ethernet faoi Windows má tá tiománaí npcap / winpcap ar fáil. # NanoLib-CANopen: osclaíonn crua-earraí bus anois gan staonadh le roghanna folamh. # NanoLib-Common: openBusHardwareWithProtocol () gan aon sceitheadh cuimhne anois.
+ Tacaíocht Linux ARM64. + Tacaíocht stórála mais USB / REST / Profinet DCP. + seiceáilConnectionState(). + getDeviceBootloaderVersion(). + Gléasanna ResultProfinet. + NlcErrorCode (NanotecExceptions curtha ina ionad). + NanoLib Modbus: VCP / mol USB aontaithe le USB. > Tugann scanadh Modbus TCP torthaí ar ais. < Fanann latency cumarsáide Modbus TCP seasmhach.
+ Tuilleadh ObjectEntryDataType (casta agus profile-sonrach). + Fill ar Earráid mura bhfaighidh connectDevice () agus scanDevices () aon cheann. + Gan ach 100 ms teorainn ama ainmniúil do CanOpen / Modbus.
+ Tacaíocht Modbus (móide USB Hub trí VCP). + Caibidil Ag cruthú do thionscadal Linux féin. + ExtraHardwareSpecifier chuig BusHardwareId (). + extraId_ agus extraStringId_ chuig DeviceId ().
+ setBusState(). + getDeviceBootloaderBuildId(). + getDeviceFirmwareBuildId(). + getDeviceHardwareVersion(). # Ceartúcháin fhabht.
Eagrán.
Táirge
0.8.0 0.7.1 0.7.0 0.5.1 0.5.1
Leagan: doc 1.4.2 / NanoLib 1.3.0
61
Doiciméid / Acmhainní
![]() |
NanoLib C++ Ríomhchlárú [pdfLámhleabhar Úsáideora Clárú NanoLib C, Ríomhchlárú C, Ríomhchlárú |