Sharing

1. TIS-PY 介紹
Taka Wang
20230202

2. Of
f
icial Resources
Windows Examples
Linux SDK (with low-level Examples)
Linux Examples

3. Windows Device Driver
USB3
GigE

4. Prerequisite - USB Camera
USB-FS
udev rules 動態核
心
裝置管理
https://medium.com/takas-dev-blog/con
f
iguring-usb-fs-for-usb3-vision-camera-5c5727bd0c3d

5. Prerequisite - GigE Camera
Jumbo Frame
https://s1-dl.theimagingsource.com/api/2.5/packages/publications/whitepapers-cameras/wpgigecamerastartup/4df6c9cb-9
f
b5-50d0-8b42-82259fd2124b/
wpgigecamerastartup_1.0.en_US.pdf
Linux
Windows

6. Software Architecture
The imaging Source Camera Firmware (proprietary)
GStreamer GLib/GObject
Aravis (GeniCam) V4L2
libusb
Tiscam Library
tis.py*
tiscam.py (ours)
Device Driver (proprietary)
IC Imaging Control C Library
TIS_UDSHL11_x64.dll
tisgrabber_x86.dll (ctypes)
tisgrabber.py*
tiscam.py (ours)
Python Applications
Software
Hardware
Windows
Linux

7. The imaging Source Camera Firmware (proprietary)
GStreamer GLib/GObject
Aravis (GeniCam) V4L2
libusb
Tiscam Library
tis.py*
tiscam.py (ours)
Device Driver (proprietary)
IC Imaging Control C Library
TIS_UDSHL11_x64.dll
tisgrabber_x86.dll (ctypes)
tisgrabber.py*
tiscam.py (ours)
Python Applications
Windows
Linux

8. Minimal Operations
• open()
• open_by_dialog()
• show_property_dialog()
• close()
• start()
• stop()
• read()
open
start
read
stop
close
tiscam.py

9. Minimal Example
open
start
read
stop
close

10. Class Constructor
camera class
Linux
Windows

11. Device Properties
ic.IC_printItemandElementNames(hGrabber)
tcam-ctrl -p 48224019-aravis
Linux
Windows

12. Con
f
ig Files
Linux
Windows

13. Unit Tests
20%

14. End-User Programs

15. IC Capture (Windows)
https://www.theimagingsource.com/support/downloads-for-windows/end-user-software/iccapture/

16. tcam-capture (Linux)
打開 container 裡
面
已經有包了

17. Demo

18. Trigger Mode

21. Line Trigger Polarity

22. ROI Focus

23. 2448
2048
1920
1080
(0, 0)
ROI
128
16

25. 2448
2048
1920
1080
(0, 0)
128
16
8
64
(left, top)
(right, bottom)

26. 2448
2048
1920
1080
(0, 0)
128
16
8
64
(left, top)
(right, bottom)
auto_focus_roi_once(x, y)

27. Trace Code
Next slide

28. Naming Convention
• __xxxx(): 雙底線不要
用
• _yyyy(): 單底線
一
般不需要
用
• xyz(): 無底線為 public method
• return
首
值為成功失敗
• get_xxxx() -> (bool, …)
• set_yyy() -> bool
• xxx_once() -> bool
• toggle_xxx_() -> bool
• get_xxx_toggle() -> (bool, …)
Button
Toggle
Getter
Setter
Get Toggle
tiscam.py

29. Callback

30. grabber
frame_ready_callback(buffer, user_data):
do what you want to do…
user_data
tiscam.py

31. grabber
frame_ready_callback(buffer, user_data):
do what you want to do…
user_data
tiscam.py
External Trigger

32. grabber
frame_ready_callback(buffer, user_data):
do what you want to do…
user_data
tiscam.py
External Trigger
call

33. grabber
frame_ready_callback(buffer, user_data):
convert bu
ff
er to frame
trigger pyqt_callback(_pyqt_user_data)
pyqt_user_data
tiscam.py
frame
pointer
signal
object
pyqt_callback(pData, frame):
pData.frame = frame
pData.signals.newimage.emit(pData)
on_new_image:
update screen
Inject signal biding

34. grabber
frame_ready_callback(buffer, user_data):
convert bu
ff
er to frame
trigger pyqt_callback(_pyqt_user_data)
pyqt_user_data
tiscam.py
External Trigger
frame
pointer
signal
object
pyqt_callback(pData, frame):
pData.frame = frame
pData.signals.newimage.emit(pData)
on_new_image:
update screen
Inject signal biding

35. grabber
frame_ready_callback(buffer, user_data):
convert bu
ff
er to frame
trigger pyqt_callback(_pyqt_user_data)
pyqt_user_data
tiscam.py
External Trigger
call
frame
pointer
signal
object
pyqt_callback(pData, frame):
pData.frame = frame
pData.signals.newimage.emit(pData)
on_new_image:
update screen
Inject signal biding

36. grabber
frame_ready_callback(buffer, user_data):
convert bu
ff
er to frame
trigger pyqt_callback(_pyqt_user_data)
pyqt_user_data
tiscam.py
External Trigger
call
frame
pointer
signal
object
pyqt_callback(pData, frame):
pData.frame = frame
pData.signals.newimage.emit(pData)
on_new_image:
update screen
Inject signal biding
call

37. grabber
frame_ready_callback(buffer, user_data):
convert bu
ff
er to frame
trigger pyqt_callback(_pyqt_user_data)
pyqt_user_data
tiscam.py
External Trigger
call
frame
pointer
signal
object
pyqt_callback(pData, frame):
pData.frame = frame
pData.signals.newimage.emit(pData)
on_new_image:
update screen
Inject signal biding
call
call

38. Callback Notes
• Windows
• Frame Ready
• Connection Lost
• Linux
• Frame Ready (Not Yet)
• Connection Lost (Depends)

39. 常
用
功能

40. Primitive UI Control (IMO)
• Gain
• Exposure
• Partical Scan
• Focus
• Iris
• Zoom
• Trigger (Depends)

41. Remarks

42. Facts
• Windows
• 80% common function ready.
• 80% of 80% Unit Tests
• implement more func if it is
necessary (not now)
• TODO:
• GPIO test
• External line Trigger test
• Linux
• 50% common function
ready.
• 20% of 50% Unit Tests
• TODO:
• Long story