RELIMINARY NOTE T h is doc umen t is in te nde d for sp ecialis ts . T hes e s pec ia lis ts are p eop le w ho are qua lified b y t he ir a pp r opr ia t e tra in in g an d t h ei r e xp er i enc e to s ee r is k s a nd t o a vo id poss ib le haz- a rds th at ma y be ca use d du ring op era tio n or ma in te nance o f the de vice .
NSTALLATION ► Use ca bles w i th s tra in re lie f . Object distance ► C ho os e t h e mo un t in g pos i t ion o f t he c a me r a s o th a t t h e ob jec t o f in t er es t i s c o mp le te l y l oc a t ed w i th in t he f ie ld o f vi ew of t h e c am er a .
► B r i gh t ext r a ne ous li gh t s uc h as e . g . s un li gh t inc id en t on th e s u r f ace of th e ob jec t of i n te r es t or o n the c ame r a lens s ho ul d be a vo id ed .
5 LED DISPLAY L ED beh a vi ou r , de v ic e s t a tus L ED 1 ON : s upp l y v o l ta ge a va i lab le , devi c e r ead y f or op era t io n Power ( green) f l ash in g ( 0 ,5 H z )
LECTRICAL CONNECTION A T T EN T ION T he un i t mus t be c o nn ec ted b y a qua l i fi ed e lec t r ic ia n . Device of protec tion c lass III (PC III) E l ec tr ic s up pl y v ia P EL V c ir c u i ts o nl y .
7 XML-RPC I NTERFACE In c ase th e ca mer a O3D 3 xx shou ld no t b e co n figur ed b y the “ i fmVision Assis ta n t” , the XML- R PC in ter fac e can be us ed ins tea d . No te : ge ner al in formation abo u t XML-R PC is fo und on th e webs ite http://xmlrpc .scripting.c om/spec T o sen d a co mmand ove r the XML -RPC in ter fac e the co mmand has to be on a s pec ia l la y-...
F o l low ing e xa mp l e co nta i ns one co m ma nd of t he O3D 3xx : P O ST / ap i /r pc/ v 1 /c o m.i f m .e f ec tor / User-Agent: Frontier/5.1.2 (WinNT) Host: 192.168.0.69 Content-Type: text/xml...
7.2.1 Main-Object: O b j e c t- U R I: / a p i /r p c / v1 /c om . i fm .e f e c tor / T h is is th e m a in- o bj ect o f R PC , i t a l low s to acc es s s om e b as ic in f or m a ti on a nd c o n ta ins me th ods for ac tiva ting e dit-mo de .
7.2.7 App./ImagerConfig-Object (O3D3xx) O b j e c t- U R I e . g . : /a pi/rpc /v1 /co m.ifm.e fec tor /sess io n_d 21c8 0d b5bc 106 99 32 fb b9a 3b d84 1d0 b /e dit/app lica tio n /i m ag er _0 01/ A s the r e is o nl y one im ger - c on f ig on O 3D 3x x , t h e ID m us t be f i xe d to "0 01 ".
8.2 Receiving images F or r ec e i vin g the i mag e da t a ther e has to be a TC P / I P s oc k e t c om mu nic a ti on es tab l ishe d . T h is c ommu nic a tion wo rks on th e Por t 500 10 .
Page 19
D iag nos t ic d a ta o u tpu t h as the f oll ow ing s t r uc tur e : I l l u m i n a t i o n T e m p e r a - 3 2 - b i t s i g n e d i n t 4 b yt e s t u r e...
8.3 Image data F or e ver y imag e ther e w ill b e a se par a te chu nk . Th e ch unk is a pa rt o f the res pons e fra me d a ta fro m th e pr oces s i n te r f ace .
Page 21
0 x 0 0 1 4 I M A G E _ H E I G T H I m a g e h e i g h t i n p i x e l 0 x 0 0 1 8 P I X E L _ F O R M A T P i x e l - F o r m a t 0 x 0 0 1 C...
Page 22
A va i l a b l e C h u n t yp e s C o n s t a n t V a l u e D e s c r i p t i o n U S E R D A T A u n d e f i n e d u s e r d a t a wi t h a r b r i t r a r y c o n t e n t E a c h p i x e l o f t h e d i s t a n c e m a t r i x d e n o t e s t h e...
Page 23
I P f l o a t 3 2 ) I f a v a l u e l a r g e r ( s m a l l e r ) t h a n 1 0 0 ( 0 ) t h e c o n v e r t e d v a l u e i s t o b e s e t t o 6 5 5 3 5 ( 0 ) .
C A R T E S I A N _ X _ C O M P O N E N T , C A R T E - S I A N _ Y _ C O M P O N E N T , C A R T E - C A R T E S I A N _ A L L 2 0 3 S I A N _ Z _ C O M P O N E N T...
8.4 Additional information for image data Further information for the Confidence image B i t V a l u e D e s c r i p t i o n 1 = p i x e l i n v a l i d P i x e l i n va l i d ( N V ) T h e p i x e l i s i n v a l i d .
Page 26
p e c t " o r " d e f e c t " a n d v a l u e s h a v e b e e n r e p l a c e d b y i n t e r p o l a t e d v a l u e s f r o m t h e s u r r o u n d i n g .
8.5 Configuration of PCIC output T he user has t he p os s ib il i t y to de f in e h is own PC IC ou t pu t . T his c o n fi gur a tio n is on l y v a l id for the cu rre n t PC IC co nnec tio n .
Page 28
T he act ua l d a ta is de f in ed w i th in t h e “ e le men ts ” pro pert i es a nd ma y c ons is t o f t hese s et - tings : N a m e D e s c r i p t i o n...
Page 29
l i m i t s t h e o u t p u t t o t wo b y t e i n b i n a r y- e n c o d i n g , b e s i d e t h e b i n a r y l i m i t a t i o n i t u i n t 1 6 a c t s l i k e u i n t 3 2 l i m i t s t h e o u t p u t t o t wo b y t e i n b i n a r y- e n c o d i n g , b e s i d e t h e b i n a r y l i m i t a t i o n i t...
Page 30
ASCII format properites: Format-Properties Allowed values Default width output width. If the resulting value exceeds the width field the the result will not be turncated fill fill character " " precision Precision is the number of digits behind the decimalseparator. displayformat fixed,scientific fixed...
Page 31
T he fo l low in g e le men t i ds a r e a va i lab le : D e s c r i p t i o n N a t i ve D a t a t y p e e v a l u a t i o n t i m e f o r c u r r e n t f r a m e i n m i l l i s e c o n d s u n s i g n e d i n t e va l t i m e...
8.6 Sample C++ Code for setting up a socket //Inc luding the winsocket library for c reating s ockets later in th e code # inc lu de <w insock .h> # pr a gma comment( " w s 2_ 32 . li b ") void in(void...
9 XML-RPC COMMAND REFERENCES 9.1 "setParameter" must be implemented on all RPC-objects which offer parameter M e t h o d N a m e s e t P a r a m e t e r S e t s a p a r a m e t e r t o a s p e c i f i c v a l u e . D e s c r i p t i o n 1 .
9.2.3 "getSWVersion" Method Name g e t SWV er s i on Re turns vers io n-in forma tion o f all s o ftwar e co mp one nen ts De sc r ipt ion Input Parame- n one t ers 1 .
9.2.4 "getHWInfo" g e tHW In fo Method Name R e t ur ns har dware - i n for ma t ion o f a l l c o mpo ne n ts De sc r ipt ion n one I n pu t P ar amet er s S t r uc t o f s tr in gs ( e .g .
9.2.6 "requestSession" r equ es tSess ion Method Name Re ques t a sess io n-o bjec t for access to the co n figur a tio n an d for ch ang in g de vice ope ra tin g-mode. T h is s ho uld block pa ra lle l ed iting and allows to pu t ed iting beh in d p as s w or d .
9.3 Session-Object 9.3.1 "heartbeat" h ear tbea t M e t h o d N a m e E x t e n d t h e l i v e t i m e o f e d i t - s e s s i o n S es s ion T ime ou t "...
9.3.4 "importConfig” i m p o r tCo n fi g M e t h o d N a m e i m p o r t wh o l e c o n f i g u r a t i o n , wi t h t h e o p t i o n t o s k i p s p e c i f i c p a r t s D e s c r i p t i o n 1 .
9.3.7 "setOperatingMode" se tOper a tin gMode M e t h o d N a m e Ch ang es the ope ra tion mod e o f the de vice . D e s c r i p t i o n Setting this to "e dit"...
9.4 EditMode-Object 9.4.1 "factoryReset" fac tor yRese t M e t h o d N a m e s e ts al l c on f ig ura t io ns b ac k to "we r k s e ins te l lun ge n" D e s c r i p t i o n n one I n p u t P a r a m e -...
9.4.4 "createApplication" cr ea te Ap plica tio n M e t h o d N a m e Cr ea tes an "e mp ty" ap plica tio n . T he emb edd ed s ide sh ou ld in itializ e a ll D e s c r i p t i o n n eed ed p ara me ters and s tr uc tur es .
9.5 DeviceConfig-Object 9.5.1 "activatePassword" ac tiva tePassword M e t h o d N a m e S e t a pas s w o r d a nd ac t i va te i t for th e ne x t e di t - s ess ion . D e s c r i p t i o n M ak ing t his c h ang e pr esis t an t r e qu ires t o c a l l "sa ve "...
9.5.4 Parameters P ar am e ter s o f D e vic eC o n fi g Me th ods for p ara me ter acc ess are de fine d he re : P a r a m e t e r N a m e D a t a D e s c r i p t i o n T y p e...
Page 45
E x t r i n s i c C a l i b T r a n s Z d o u b l e E x t r i n s i c c a l i b r a t i o n , T r a n s i t i o n i n Z d i r e c t i o n E x t r i n s i c C a l i b R o t X d o u b l e E x t r i n s i c c a l i b r a t i o n , R o t a t i o n a r o u n d X - a x i s E x t r i n s i c C a l i b R o t Y...
Page 46
d e g r e e C e l s i u s . M e a s u r e d i n s i d e t h e m a i n C P U . d o u b l e r e a d o n l y , T e m p e r a t u r e m e a s u r e d i n t h e d e v i c e , v a l u e i s i n T e m p e r a t u r e I l l u d e g r e e C e l s i u s .
Page 47
E x t r i n s i c C a l i b R o t Z d o u b l e 0 . 0 I P A d d r e s s C o n f i g i n t P a s s wo r d A c t i v a t e d b o o l...
Page 48
Minimu m an d ma ximum va lues of De viceC on fig par ame ters T he minimu m a nd maximum va lues o f the de vice c on fig ura tio n par ame ters ar e: P a r a m e t e r N a m e M i n i m u m V a - M a x i m u m V a l u e...
9.6 Device/NetworkConfig-Object 9.6.1 "saveAndActivateConfig" saveAndActivateC onfig M e t h o d N a m e R e in i t ia l iz e t h e ne tw ork in te r f ace s o t ha t i t uses t he c on f ig ura t io n w h ich D e s c r i p t i o n w as s e t b y t h e o th er R P C - me th ods .
9.7.3 "validate" validate M e t h o d N a m e V a l ida t es th e ap pl ica ti on , t his me ans i t c hec k s i f the ap pl ica t io n c a n D e s c r i p t i o n b e ac t i va ted .
9.7.4 Parameters P ar am e ter s o f Ap pl ica t io n Me th ods for p ara me ter acc ess are de fine d he re : P a r a m e t e r N a m e D a t a D e s c r i p t i o n T y p e...
Page 52
D e f au l t va lu es o f a pp li c a t ion para me t ers T he de fa ul t v a lu es o f a pp lic a ti on p ar a me te r s ar e : P a r a m e t e r N a m e D a t a D e f a u l t V a l u e...
9.8 App./ImgagerConfig-Object 9.8.1 "changeType" ch ang eT ype M e t h o d N a m e C h a n g e s t h e t y p e o f i m a g e r - c o n f i g u r a t i o n . D e s c r i p t i o n T h i s c h a n g e s t h e s e t o f a v a i l a b l e p a r a m e t e r s a n d m i g h t a l s o c h a n g e a v a i l a b l e R P C - m e t h o d s .
9.8.3 Parameters P ar am e ter s o f al l t ypes o f A pp l ica t io n- Im ag erC o n fi g Me th ods for p ara me ter acc ess are de fine d he re : P a r a m e t e r N a m e D a t a T y p e D e s c r i p t i o n...
Page 55
Minimu m an d ma ximum va lues of co mmon Imag erCon fig p ara me te rs T he mi ni mu m a nd m ax i m um va lues o f the c o mm on imag er co n figur ation p arame ters are: P a r a m e t e r N a m e M i n i m u m M a x i m u m V a l u e...
Page 56
Minimu m an d ma ximum va lues of th e "und er 5m_ low " mod e par ame ters P a r a m e t e r N a m e M i n i m u m M a x i m u m V a - V a l u e l u e...
Page 57
Minimu m an d ma ximum va lues of th e "und er 5m_ mo dera te " mo de p ara me te rs P a r a m e t e r N a m e M i n i m u m M a x i m u m V a - V a l u e l u e...
Page 58
P ar am e ter s o nl y in " up t o30 m_ low "- t yp e o f A p pl ica t io n- I mag erC on f ig P a r a m e t e r N a m e D a t a D e s c r i p t i o n T y p e...
Page 59
P ar am e ter s o nl y in " up t o30 m_ mo der a te "- t yp e o f Ap pl ica t io n- Im ag erC o n fi g P a r a m e t e r N a m e D a t a D e s c r i p t i o n T y p e...
Page 60
P a r a m e t e r N a m e D a t a D e s c r i p t i o n T y p e C h a n n e l i n t A l l o we d v a l u e s : * h a s l i m i t s...
9.9 Image-Settings Filter-Parameter T o s e t th e s p a ti al or te mp ora l fi l te r use th e g ene r a l “ s et t er ” me t hod . 9.9.1 Parameters Pa ra met ers of Sp at ia l Me d ian o r Sp at ia l M ea n F ilt er P a r a m e t e r N a -...
Page 62
Pa ra met ers of T e mpo ra l A da ptive Ex p one nt ia l F ilte r P a r a m e t e r D a t a D e s c r i p t i o n N a m e T y p e M i n S m o o t h D i f f...
10 P ROCESS NTERFACE COMMAND REFERENCE N o t e: A l l re ce i ve d me ssa ge s w h i ch are se nd bec aus e of t he f o l l ow ing co m m and s , w il l b e s end w it ho ut “...
i n v a l i d c o m m a n d l e n g t h n o t e < a p p l i c a t i o n n u m b e r > 2 d i g i t s f o r t h e a p p l i c a t i o n n u m b e r a s d e c i m a l v a l u e 10.6 A? command...
10.7 v command v < v e r s i o n > c o m m a n d d e s c r i p t i o n s e t t h e c u r r e n t p r o t o c o l l v e r s t i o n . T h e d e v i c e c o n f i g u r a t i o n i s n o t a f e c t e d a c t i o n...
10.9 c command c < l e n g t h > < c o n f i g u r a t o n > c o m m a n d u p l o a d a P C I C o u t p u t c o n f i g u r a - d e s c r i p t i o n t i o n l a s t i n g t h i s s e s s i o n a c t i o n...
Need help?
Do you have a question about the O3D303 and is the answer not in the manual?
Questions and answers