aboutsummaryrefslogtreecommitdiff
path: root/recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT
diff options
context:
space:
mode:
authorWestergreen, Dalon <dalon.westergreen@intel.com>2017-03-29 15:41:36 -0700
committerWestergreen, Dalon <dalon.westergreen@intel.com>2017-03-30 16:35:30 -0700
commit9a293641b9abf9e4fca34f46a2de781f50847da9 (patch)
tree743a6aaa5f9834987a2e69881ced6eaf9efb3592 /recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT
parent8abd3fefd939f796ae49191d6f5af641f2d624d0 (diff)
downloadmeta-de10-nano-9a293641b9abf9e4fca34f46a2de781f50847da9.tar.xz
Initial commit of de10-nano recipes
Please note that this is purely for development. Only superficial efforts have been made to resolve security concerns, and it should be noted that the board ships with an EMPTY ROOT PASSWORD and support for root login via ssh. This allows passwordless access to the board via ssh. recipes-bsp/u-boot: Contains the uboot 2017.03rc2 recipe and patches to support the de10-nano board recipes-connectivity/avahi: bbappend to remove unwanted packages recipes-connectivity/bluez: bbappend to add --compat to the bluetooth service to support legacy SDP APIs recipes-connectivity/openssh: bbappend to add a custom sshd_config recipes-core/base-files: bbappend to customize fstab and inputrc recipes-core/imagemagick: bbappend to change build configuration for the de10-nano board recipes-core/packagegroups: bbappend to remove an unwanted package recipes-core/webkit: bbappend to remove support for opengl recipes-demo: Various demo applications recipes-devtools: MRAA and UPM recipes recipes-images/angstrom/de10-nano-image.bb: DE10-Nano image definition recipes-kernel/de10-nano-linux-firmware: FPGA related firmware required for fpga configuration and devicetree overlay support recipes-kernel/linux: bbappend to customize configuration of linux kernel as well as patch in the de10-nano devicetree recipes-misc: various initialization and systemd scripts recipes-qt/qt5: bbappend to modify qt build options recipes-support/neon: bbappend to remove unwanted package recipes-support/upower: bbappend to remove unwanted package recipes-webserver: webserver configuration and webcontent for board hostedweb portal recipes-xfce/thunar-volman: bbappend to remove unwanted package recipes-xfce/xfce-pointers: add configuration so that xfce does not use the adxl input as a mouse recipes-xfce/xfce4-settings: bbappend to remove unwanted package Signed-off-by: Westergreen, Dalon <dalon.westergreen@intel.com>
Diffstat (limited to 'recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT')
-rw-r--r--recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT114
1 files changed, 114 insertions, 0 deletions
diff --git a/recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT b/recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT
new file mode 100644
index 0000000..a0ff7fa
--- /dev/null
+++ b/recipes-demo/de10-nano-fftsw-apps/files/README_TARGET.TXT
@@ -0,0 +1,114 @@
+On the DE10-Nano target board, you should be able to run the following script to
+install and execute the FFT example applications:
+
+./setup_target_fft_env.sh
+ this target script will ensure that the fft_driver is installed, ensure
+ that /mnt/ram has a 100MB tmpfs ram disk mounted, and then extract the
+ fft.tgz archive into /mnt/ram/fft and run the create_input_waveforms.sh
+ script and then runs the run_all.sh script
+
+Description of directory contents:
+
+create_input_waveforms.sh
+ target script that executes waveform creation applications and
+ duplication scripts to create all input waveforms for the applications
+ to consume
+
+duplicate_x128.sh
+duplicate_x32.sh
+duplicate_x8.sh
+ these target scripts duplicate a file x8, x32 or x128 times. These are
+ used to replicate the fundamental waveforms into longer patterns
+
+run_all.sh
+run_fft_256.sh
+run_fft_256x32.sh
+run_fft_256x32x128.sh
+run_fft_4096.sh
+run_stream_256x32x128.sh
+ these target scripts execute all of the various permutations of the demo
+ applications mentioned below
+
+setup_target_fft_env.sh
+ this target script is used to extract the fft.tgz archive onto the ram
+ disk mounted at /mnt/ram
+
+c16_256
+c16_256x32
+c16_256x32x128
+c16_4096
+ these applications use the NE10 C functions to implement the FFT
+ algorithm for a variety of input sample sizes with 16-bit resolution
+
+c32_256
+c32_256x32
+c32_256x32x128
+c32_4096
+ these applications use the NE10 C functions to implement the FFT
+ algorithm for a variety of input sample sizes with 32-bit resolution
+
+fft_256
+fft_256x32
+fft_256x32x128
+fft_4096
+ these applications use the FPGA logic to implement the FFT
+ algorithm for a variety of input sample sizes. This variant pushes
+ the input samples into the FPGA and pulls the results back out using
+ programmed I/O from the HPS Cortex A9 processor
+
+fftdma_256
+fftdma_256x32
+fftdma_256x32x128
+fftdma_4096
+ these applications use the FPGA logic to implement the FFT
+ algorithm for a variety of input sample sizes. This variant moves
+ the input samples into the FPGA and the results back out using DMA
+ through the ACP port of the Cortex A9 processor
+
+neon16_256
+neon16_256x32
+neon16_256x32x128
+neon16_4096
+ these applications use the NE10 NEON functions to implement the FFT
+ algorithm for a variety of input sample sizes with 16-bit resolution
+
+neon32_256
+neon32_256x32
+neon32_256x32x128
+neon32_4096
+ these applications use the NE10 NEON functions to implement the FFT
+ algorithm for a variety of input sample sizes with 32-bit resolution
+
+stream_fpga_256x32x128
+stream_fpga_256x16x1
+stream_fpga_256x1x1
+stream_neon32_256x32x128
+stream_neon32_256x16x1
+stream_neon32_256x1x1
+stream_raw_256x32x128
+stream_raw_256x16x1
+stream_raw_256x1x1
+ these applications stream data from the FPGA into ramdisk files, the
+ fpga variant DMAs the input stream thru the FPGA FFT logic before it
+ is DMAed through the ACP port of the Cortex A9, the neon variant DMAs
+ the raw input data stream through the ACP port and then computes the FFT
+ algorithm on it before saving to the ram disk, the raw variant DMAs the
+ raw input data stream through the ACP port and then directly into the
+ ram disk
+
+create_real_short_sine32
+create_real_short_square32
+create_real_short_triangle32
+ these applications create the initial 32 samples of their respective
+ waveform, sine, square and triangle
+
+real_short_to_ne10cpx_long
+real_short_to_ne10cpx_short
+ these applications translate the real short data format into ne10cpx
+ long and short format which is consumed by the demo applications
+
+ne10cpx_long_to_text
+ne10cpx_short_to_text
+ these applications translate the ne10cpx long and short format binary
+ data into text format output which may be read by gnu plot for example
+