GitHub - christophe-lyon/arm-neon-tests: Tests for ARM/Neon instructions, useful for compilers and simulators.

christophe-lyon / arm-neon-tests Public

Notifications You must be signed in to change notification settings
Fork 16
Star 35

Tests for ARM/Neon instructions, useful for compilers and simulators.

Unknown, Unknown licenses found

Licenses found

35 stars 16 forks Branches Tags Activity

Star

Notifications

Branches Tags

Name		Name	Last commit message	Last commit date
Latest commit History 82 Commits
.travis.yml		.travis.yml
Init.s		Init.s
InitCache.s		InitCache.s
LICENSE		LICENSE
Makefile		Makefile
Makefile.gcc		Makefile.gcc
README		README
armscript.inc		armscript.inc
compute_ref.axf		compute_ref.axf
compute_ref.c		compute_ref.c
compute_ref.gccarm		compute_ref.gccarm
compute_ref.gccarm-rvct		compute_ref.gccarm-rvct
compute_ref_data.c		compute_ref_data.c
expected_input4gcc-nofp16.txt		expected_input4gcc-nofp16.txt
expected_input4gcc.txt		expected_input4gcc.txt
license.html		license.html
ref-rvct-all.txt		ref-rvct-all.txt
ref-rvct-neon-nofp16.txt		ref-rvct-neon-nofp16.txt
ref-rvct-neon.txt		ref-rvct-neon.txt
ref_dsp.c		ref_dsp.c
ref_dspfns.c		ref_dspfns.c
ref_integer.c		ref_integer.c
ref_v_binary_op.c		ref_v_binary_op.c
ref_v_binary_sat_op.c		ref_v_binary_sat_op.c
ref_v_comp_f_op.c		ref_v_comp_f_op.c
ref_v_comp_op.c		ref_v_comp_op.c
ref_v_unary_op.c		ref_v_unary_op.c
ref_v_unary_sat_op.c		ref_v_unary_sat_op.c
ref_vaba.c		ref_vaba.c
ref_vabal.c		ref_vabal.c
ref_vabd.c		ref_vabd.c
ref_vabdl.c		ref_vabdl.c
ref_vabs.c		ref_vabs.c
ref_vadd.c		ref_vadd.c
ref_vaddhn.c		ref_vaddhn.c
ref_vaddl.c		ref_vaddl.c
ref_vaddw.c		ref_vaddw.c
ref_vand.c		ref_vand.c
ref_vbic.c		ref_vbic.c
ref_vbsl.c		ref_vbsl.c
ref_vcage.c		ref_vcage.c
ref_vcagt.c		ref_vcagt.c
ref_vcale.c		ref_vcale.c
ref_vcalt.c		ref_vcalt.c
ref_vceq.c		ref_vceq.c
ref_vcge.c		ref_vcge.c
ref_vcgt.c		ref_vcgt.c
ref_vcle.c		ref_vcle.c
ref_vcls.c		ref_vcls.c
ref_vclt.c		ref_vclt.c
ref_vclz.c		ref_vclz.c
ref_vcnt.c		ref_vcnt.c
ref_vcombine.c		ref_vcombine.c
ref_vcreate.c		ref_vcreate.c
ref_vcvt.c		ref_vcvt.c
ref_vdup.c		ref_vdup.c
ref_vdup_lane.c		ref_vdup_lane.c
ref_veor.c		ref_veor.c
ref_vext.c		ref_vext.c
ref_vget_high.c		ref_vget_high.c
ref_vget_lane.c		ref_vget_lane.c
ref_vget_low.c		ref_vget_low.c
ref_vhadd.c		ref_vhadd.c
ref_vhsub.c		ref_vhsub.c
ref_vld1.c		ref_vld1.c
ref_vld1_dup.c		ref_vld1_dup.c
ref_vld1_lane.c		ref_vld1_lane.c
ref_vldX.c		ref_vldX.c
ref_vldX_dup.c		ref_vldX_dup.c
ref_vldX_lane.c		ref_vldX_lane.c
ref_vmax.c		ref_vmax.c
ref_vmin.c		ref_vmin.c
ref_vmla.c		ref_vmla.c
ref_vmla_lane.c		ref_vmla_lane.c
ref_vmla_n.c		ref_vmla_n.c
ref_vmlal.c		ref_vmlal.c
ref_vmlal_lane.c		ref_vmlal_lane.c
ref_vmlal_n.c		ref_vmlal_n.c
ref_vmls.c		ref_vmls.c
ref_vmls_lane.c		ref_vmls_lane.c
ref_vmls_n.c		ref_vmls_n.c
ref_vmlsl.c		ref_vmlsl.c
ref_vmlsl_lane.c		ref_vmlsl_lane.c
ref_vmlsl_n.c		ref_vmlsl_n.c
ref_vmovl.c		ref_vmovl.c
ref_vmovn.c		ref_vmovn.c
ref_vmul.c		ref_vmul.c
ref_vmul_lane.c		ref_vmul_lane.c
ref_vmul_n.c		ref_vmul_n.c
ref_vmull.c		ref_vmull.c
ref_vmull_lane.c		ref_vmull_lane.c
ref_vmull_n.c		ref_vmull_n.c
ref_vmvn.c		ref_vmvn.c
ref_vneg.c		ref_vneg.c
ref_vorn.c		ref_vorn.c
ref_vorr.c		ref_vorr.c
ref_vpadal.c		ref_vpadal.c
ref_vpadd.c		ref_vpadd.c
ref_vpaddl.c		ref_vpaddl.c
ref_vpmax.c		ref_vpmax.c

Repository files navigation

ARM Neon reference tests
========================
This package contains extensive tests for the ARM/Neon instructions.

It works by building a program which uses all of them, and then
executing it on an actual target or a simulator.

It can be used to validate the simulator against an actual HW target,
or to validate C compilers in presence of Neon intrinsics calls.

The supplied Makefile enables to build with both ARM RVCT compiler and
GNU GCC (for the ARM target), and supports execution with ARM RVDEBUG
on an ARM simulator and with QEMU.

For convenience, the ARM ELF binary file (as compiled with RVCT) is
supplied (compute_ref.axf), as well as expected output (ref-rvct.txt).

A second file containing expected output is also supplied:
ref-rvct-neon.txt, which contains only the results of the Neon
instrinsics tests. It is aimed at being used to check GCC's results,
since this compiler does not support the integer & dsp builtins whose
results are also present in ref-rvct.txt.

Typical usage when used to debug QEmu:
$ make all # to build the test program with ARM rvct and execute with QEmu
$ make check # to compare the results with the expected output


Known issues:
-------------
Some tests currently fail to build with GCC/ARM:
- missing include files: dspfns.h, armdsp.h

As GCC/ARM provides no support for the
Neon_Cumulative_Saturation/fpsrc register, auxiliary accessor
functions have been implemented in stm-arm-neon-ref.h.

Engineering:
------------
In order to cover all the Neon instructions extensively, these tests
make intensive use of the C-preprocessor, to save maintenance efforts.

Most tests (the more regular ones) share a common basic structure. In
general, variable names are suffixed by their type name, so as to
differentiate variables with the same purpose but of differente types.
Hence vector1_int8x8, vector1_int16x4 etc...

For instance in ref_vmul.c the layout of the code is as follows:

- declare input and output vectors (named 'vector1', 'vector2' and
  'vector_res') of each possible type (s/u, 8/16/32/64 bits).

- clean the result buffers.

- initialize input vectors 'vector1' and 'vector2'.

- call each variant of the intrinsic and store the result in a buffer
  named 'buffer', whose contents is printed after execution.

One can then compare the actual result with the expected one.