Viavi ATC-5000NG Operation Manual page 335

/ / F u n c t i o n N a m e : R e a d A n d S t o r e I n t o B u f f e r ( )
/ / P u r p o s e : R e a d s o v e r G P I B a n d s t o r e s t h e r e s u l t i n t o a b u f f e r .
/ / P a r a m e t e r L i s t : i n s t H a n d l e - V I S A s e s s i o n h a n d l e
/ / R e t u r n V a l u e s : Z e r o o n s u c c e s s , n o n - z e r o o t h e r w i s e
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
s t a t i c l o n g R e a d A n d S t o r e I n t o B u f f e r ( V i S e s s i o n i n s t H a n d l e )
{
l o n g d e v i c e = 0 ;
u n s i g n e d l o n g r e t _ c o u n t = 0 ;
l o n g s t a t u s ;
i f ( ( s t a t u s = A T C _ n x t C m d W a i t ( i n s t H a n d l e ) ) < 0 )
r e t u r n s t a t u s ;
s t a t u s = v i R e a d ( i n s t H a n d l e , ( u n s i g n e d c h a r * ) s a v e d _ b u f f e r [ d e v i c e ] ,
/ / L o g t h i s a s t h e l a s t c o m m a n d t r a n s m i s s i o n t i m e
i f ( ( s t a t u s = A T C _ n x t C m d L o g ( i n s t H a n d l e , W A I T T I M E 0 _ 0 3 ) ) < 0 )
r e t u r n s t a t u s ;
s a v e d _ b u f f e r [ d e v i c e ] [ r e t _ c o u n t ] = 0 ;
i f ( s t a t u s < 0 )
r e t u r n s t a t u s ;
i s _ b u f f e r _ o c c u p i e d [ d e v i c e ] = ( r e t _ c o u n t > 0 ) ? 1 : 0 ;
r e t u r n s t a t u s ;
}
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
/ / F u n c t i o n N a m e : C l e a r S t o r e d B u f f e r ( )
/ / P u r p o s e : C l e a r s t h e b u f f e r .
/ / P a r a m e t e r L i s t : i n s t H a n d l e - V I S A s e s s i o n h a n d l e
/ / R e t u r n V a l u e s : Z e r o o n s u c c e s s , n o n - z e r o o t h e r w i s e
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
s t a t i c v o i d C l e a r S t o r e d B u f f e r ( V i S e s s i o n i n s t H a n d l e )
{
l o n g d e v i c e = 0 ;
s a v e d _ b u f f e r [ d e v i c e ] [ 0 ] = 0 ;
i s _ b u f f e r _ o c c u p i e d [ d e v i c e ] = 0 ;
}
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
/ / F u n c t i o n : B o o l e a n V a l u e O u t O f R a n g e - V i B o o l e a n
/ / P u r p o s e : T h i s f u n c t i o n c h e c k s a B o o l e a n t o s e e i f i t i s e q u a l t o V I _ T R U E
/ / o r V I _ F A L S E . I f t h e v a l u e i s o u t o f r a n g e , t h e r e t u r n v a l u e i s
/ / V I _ T R U E , o t h e r w i s e t h e r e t u r n v a l u e i s V I _ F A L S E .
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
V i B o o l e a n A T C _ i n v a l i d V i B o o l e a n R a n g e ( V i B o o l e a n v a l )
{
r e t u r n ( ( v a l ! = V I _ F A L S E & & v a l ! = V I _ T R U E ) ? V I _ T R U E : V I _ F A L S E ) ;
}
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
/ / F u n c t i o n : I n i t i a l i z e C l e a n U p
/ / P u r p o s e : T h i s f u n c t i o n i s u s e d o n l y b y t h e A T C _ i n i t f u n c t i o n . W h e n
/ / a n e r r o r i s d e t e c t e d t h i s f u n c t i o n i s c a l l e d t o c l o s e t h e
/ / o p e n r e s o u r c e m a n a g e r a n d i n s t r u m e n t o b j e c t s e s s i o n s a n d t o
/ / s e t t h e i n s t H a n d l e t h a t i s r e t u r n e d f r o m A T C _ i n i t t o
/ / V I _ N U L L .
/ / = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
1-2-5
Page 172
5 1 1 , & r e t _ c o u n t ) ;
ATC-5000NG ATC/DME Test Set Operation Manual
Subject to Export Control. See Cover Page for details.
Operation, Remote Operation
Examples
Rev. L0
February 2020