usb_macros.h File Reference

Go to the source code of this file.

Functions
reg	usb_slider (handle h)
	get the value of a slider from the host More...
	usb_aout (areg a1, handle h)
	sample and output an entire 256x256 AREG plane More...
	usb_d2aout (dreg b1, handle h)
	output an entire 256x256 DREG plane as an analog image More...
	usb_stream_begin (handle h)
	begin streaming data to the host More...
	usb_stream_send (r_int v)
	send a value for the ongoing stream More...
	usb_stream_end (r_int p, r_int v)
	end an ongoing data stream More...
	usb_scan_events (handle h, dreg r, r_int16 n)
	scan upto a certain number of points in a DREG plane and send their coordinates to the host More...

Detailed Description

Author

Jianing Chen

Function Documentation

reg usb_slider

(

handle

h

)

get the value of a slider from the host

Parameters

h	handle of the slider

Returns

the value of the slider

Example Usage:

s0 = usb.slider(my_slider_1)

usb_aout	(	areg	a1,
		handle	h
	)

sample and output an entire 256x256 AREG plane

Parameters

a1	the analogue register
h	handle of the display window

This transmit the image stored in an analogue register array to the host.

Note, this macro contains a large routine and some polling waits. In fact, for most of alogrithms in development, the output macros within a frame cycle takes much more time than the alogrithm itself.

Example Usage:

pe.rpix(B,C)
usb.aout(C,my_window_1)

usb_d2aout	(	dreg	b1,
		handle	h
	)

output an entire 256x256 DREG plane as an analog image

Parameters

b1	the digital register
h	handle of the display window

This macro first renders the DREG plane as a black/white analogue image, then transmit the analogue image to the host.

Example Usage:

pe.rpix(B,C)
where(C)
R5 = FLAG
all
usb.d2aout(R5,my_window_1)

usb_stream_begin

(

handle

h

)

begin streaming data to the host

Parameters

h	the datesheet to hold the values

usb_stream_send

(

r_int

v

)

send a value for the ongoing stream

Parameters

v	value to be sent

usb_stream_end	(	r_int	p,
		r_int	v
	)

end an ongoing data stream

Parameters

p	number of padding bytes
v	value to be padded

usb_scan_events	(	handle	h,
		dreg	r,
		r_int16	n
	)

scan upto a certain number of points in a DREG plane and send their coordinates to the host

Parameters

h	the datesheet to hold the values
r	the DREG plane to be scanned
n	maximum number of points