DSP Link User Manual Document for EMDBY

DSP LINK USER MANUAL DOCUMENT FOR EMDBY

REL1.0
7 Feb 2013
th

Authors

Sujay

APPROVAL
Name
Mr. Hemachandra Bhat
Distribution

Function

Organization
Wipro

Date

Signature

Mohamed Saliya
Abdullah Khan

CONTACT INFO
Name
iWave Systems Technologies Pvt. Ltd.
No. 7/B, 29th Main,
BTM Layout 2nd Stage,
Bangalore - 560 076. INDIA.

Telephone
+91-80-26786245,
+91-80-26683700

iWave Systems Technologies Pvt. Ltd.

Page No: 1

e-mail
emdby@iwavesystems.com

DSP Link User Manual Document for EMDBY

DOCUMENT IDENTIFICATION
Project Name
Document Name
Document Home
Revision No
Status
Audience

EMDBY
DSP Link User Manual Document for EMDBY
REL5.0
Draft
Wipro

DOCUMENTATION REVISION HISTORY

Revision
1.0

Date
07-02-2013

Description
Initial Draft version

Author
Sujay

Reviewer(s)

PROPRIETARY NOTICE: This document contains proprietary material for the sole use of the
intended recipient(s). Do not read this document further if you are not the intended recipient.
Any review, use, distribution or disclosure by others is strictly prohibited. If you are not the
intended recipient (or authorized to receive for the recipient), you are hereby notified that any
disclosure, copy or distribution or use of any of the information contained within this document
is STRICTLY PROHIBITED. Thank you. iWave Systems Tech. Pvt. Ltd.

iWave Systems Technologies Pvt. Ltd.

Page No: 2

DSP Link User Manual Document for EMDBY

Table of Content
1

INTRODUCTION.........................................................................................................................................4
1.1
1.2

PURPOSE..................................................................................................................................................4
GLOSSARY...............................................................................................................................................4

TEST PROCEDURE.....................................................................................................................................5
2.1
2.2
2.3
2.4

POWER ON UTLP BOARD AND SET BOOT ARGUMENT............................................................................5

LOAD DSP_LINK DRIVER........................................................................................................................5
RUN RINGIO APPLICATION....................................................................................................................5
OUTPUT CONSOLE SCREEN SHOT.............................................................................................................6

1 Introduction
1.1 Purpose
The purpose of this document is to explain the execution procedure for DSP LINK application in
UTLP platform.

1.2 Glossary

Acronyms
API
CMEM
DSP
GPP

Description
Application program interface
Contiguous memory
Digital Signal Processing
General Purpose Processor

iWave Systems Technologies Pvt. Ltd.

Page No: 3

DSP Link User Manual Document for EMDBY

UTLP

Unified technology learning platform

2 Test Procedure
Follow below procedure to execute ringio DSP_Link application in UTLP platform

2.1 Power on UTLP board and set boot argument

Copy delivered cmem.ko, dsplink.ko and ringio binaries from

ULK_DVD/sources/software/DSP_CMEM/ folder to Windows partition of SD card
Insert the SD card to board.
Switch the board mode into Lab Mode.
Connect 5v power supply and power on UTLP board.
Open minicom and do essential settings.
Press any key to enter into UBOOT COMMAND PROMPT.
If any key is not pressed within the specified time then Linux will boot up.
Please refer below document to do above settings;

iW-EMDBY-UM-01-R1
.0-REL2.1_diagnostics_user_manual.pdf

iWave Systems Technologies Pvt. Ltd.

Page No: 4

DSP Link User Manual Document for EMDBY

Give below uBoot arguments to set up DSP_link;

setenv bootargs 'console=ttyS2,115200n8 console=tty0 root=/dev/mmcblk0p2

rootdelay=4 rw rootfstype=ext3 rootwait omapfb.mode=dvi:320x240-16@60
omapdss.def_disp=dvi omapfb.vram=0:8M,1:4M mem=99M'

mmcinit;fatload mmc 0 80200000 uImage-v-1-0.bin

bootm 80200000

After issuing the above commands let linux to launch.

2.2 Load DSP_link driver

Once linux kernel and root filesytem launched Mount the SD card using below
commands.

mount /dev/mmcblk0p1 /mnt

cd /mnt

Load the DSP_Link driver as mentioned below;

insmod cmemk.ko phys_start=0x88000000 phys_end=0x8A000000

insmod dsplinkk.ko

2.3 Run ringio application.

Issue below command to run ringio application;

./ringiogpp ringio.out 1024 256

2.4 Output console screen shot

iWave Systems Technologies Pvt. Ltd.

Page No: 5

DSP Link User Manual Document for EMDBY

Important Notes:
1. DSPLink: It provides a generic API that abstracts the characteristics of the physical link
connecting GPP and DSP from the applications.
2. CMEM: CMEM is an API and library for managing one or more blocks of physically
contiguous memory. This physically contiguous memory is useful as data buffers that will be
shared with another processor (e.g. for the DSP on an OMAP3).
3. RingIO: Circular ring buffer based data streaming.
This will have definitions for interfaces and structures for RingIO module.
The RingIO component provides data streaming between GPP and DSP using a ring buffer as
the transport.
In a multiprocessor system having shared access to a memory region, an efficient mode of
data transfer can be implemented, which uses a ring buffer created within the shared memory.
The reader and writer of the ring buffer can be on different processors.

iWave Systems Technologies Pvt. Ltd.

Page No: 6