Linux Build for Vivante's Graphics Testsuite Contents 1. Quick start 2. Prerequisite 3. Build 4. Run the applications 1. Quick start ============== 1) Uncompress the source code, and set the root directory of test source code. # Please make sure driver and test source package are unzipped in different # directory. # must be a full path. export PROJECTS_TEST_DIR=/TEST mkdir -p $PROJECTS_TEST_DIR tar zxvf VIVANTE_GAL_Unified_Src_tst_.tgz -C $PROJECTS_TEST_DIR. # Just set the root directory of test source code. # Do not care $AQARCH any more for test building. export AQROOT=$PROJECTS_TEST_DIR # Notice: the path of the AQROOT at here is different with the path where # driver source code was installed. 2) Set Vivante driver SDK environment variables. # Tests building depends on Vivante driver SDK. # Set 3 environment variables according to the path where your driver SDK # was installed to make sure the tool chain can find Vivante driver SDK. export VIVANTE_SDK_DIR= export VIVANTE_SDK_INC=/include export VIVANTE_SDK_LIB=/drivers 3) Set other environment variables. # Set cross compile toolchain. export CROSS_COMPILE= # Set the Linux kernel directory. export KERNEL_DIR= # Set X11 installation path. # If you are not using X11 as the GUI system, this variable is not necessary. export X11_ARM_DIR= # Set DirectFB installation path. # Exported this variable to support DirectFB accelerator building; # Set it to empty to skip DirectFB accelerator building export DFB_DIR= # Set the toolchain path. export TOOLCHAIN= # Set the static library path which contains libc.a, etc. # If you are not building the package with static link, this variable is not necessary. export LIB_DIR= # The binaries will be installed at $SDK_DIR. # By default, SDK_DIR=$AQROOT/build/sdk, you can modify it as following: TEST_SDK_DIR= export SDK_DIR=$TEST_SDK_DIR # Add the toolchain to the PATH. export PATH=$TOOLCHAIN/bin:$PATH # We use arm-2010q1 toolchain to compile this package. 3) Build. cd $AQROOT make -f makefile.linux make -f makefile.linux install The binaries are installed at . More build options please see 'Build commands'. 4) Run the applications. Move to the target board. a) Copy to the target board. b) Create device node. mknod /dev/galcore c 199 0 c) Insert the kernel driver. insmod /galcore.ko registerMemBase= irqLine= contiguousSize= d) Set environment variable. export LD_LIBRARY_PATH= e) Run the application. eg. Run tutorial1. cd /samples/tutorial ./tutorial1 2. Prerequisite =============== 1) Get the Vivante driver SDK Before building the Vivante test suites, you need to get or build Vivante driver SDK. 3. Build ========= 1) Build commands. a) Build make -f makefile.linux b) Install make -f makefile.linux install c) Clean make -f makefile.linux clean Please see section 3) for the details on OPTIONS. 2) The targets There are a lot of modules in the package. Use the following the commands to build, install and clean a specific module. a) Build make -f makefile.linux b) Install make -f makefile.linux V_TARGET=install c) Clean make -f makefile.linux V_TARGET=clean MODULE list: hal_drv: Build HAL driver, including galcore.ko, libGAL.so. gfx_test: Build DirectFB samples. vdktest: Build VDK samples, including OpenGL ES 1.1/2.0 tutorials. tiger: Build OpenVG 1.1 sample: tiger. Please see the section 3) for the details on OPTIONS. 3) The options There are a lot of OPTIONS to control how to build the driver. To enable/disable an option, set