Download EMU Software Manual

Contents
1.
Introduction ...............................................................................................................................4
2.
Using Emu ..................................................................................................................................5
I.
Choosing A Binary .......................................................................................................................................................... 5
II.
Choosing An Interface ................................................................................................................................................... 5
III.
Device Drivers ................................................................................................................................................................ 7
IV.
Finding Hardware .......................................................................................................................................................... 9
V.
The Menu System ........................................................................................................................................................ 11
VI.
The “emu.ini” File ........................................................................................................................................................ 12
VII.
Basic Operations: Set Clocks, Configure FPGAs ........................................................................................................... 13
VIII.
Running Field Tests To Verify Board Operation ........................................................................................................... 13
IX.
NMB Memory Space and “MainRef” Design Examples ............................................................................................... 14
3.
Building Emu From Source ........................................................................................................ 16
I.
Finding the Source Code .............................................................................................................................................. 16
II.
The QT Environment .................................................................................................................................................... 16
III.
The Config File (Switching between GUI and CMD builds) .......................................................................................... 16
IV.
The Project Files .......................................................................................................................................................... 17
V.
Build Types: Debug vs. Release, Static vs. Dynamic ..................................................................................................... 17
VI.
Compiling..................................................................................................................................................................... 18
VII.
Run Configurations ...................................................................................................................................................... 18
VIII.
Dynamic Linking and Missing Libraries (*.DLL or *.so) ................................................................................................ 19
IX.
Plugins ......................................................................................................................................................................... 19
X.
Static Linking................................................................................................................................................................ 19
XI.
What Went Wrong? .................................................................................................................................................... 20
XII.
Building in Visual Studio .............................................................................................................................................. 21
XIII.
64-bit Builds................................................................................................................................................................. 22
4.
Expanding Emu: Modifying The Source ...................................................................................... 24
I.
The “Custom” menu .................................................................................................................................................... 24
II.
Basic Application Structure.......................................................................................................................................... 24
III.
Emu I/O System ........................................................................................................................................................... 24
IV.
Adding One-Shot Tests To Emu ................................................................................................................................... 25
5.
EMULIB Library ......................................................................................................................... 27
I.
Methods of using the EMULIB library .......................................................................................................................... 27
II.
Compiling EMULIB directly into an application ........................................................................................................... 27
III.
Building EMULIB into a standalone library .................................................................................................................. 28
IV.
Using the EMULIB API .................................................................................................................................................. 28
V.
EMULIB API Error Reporting ........................................................................................................................................ 30