Setting up VisualDSP++ 3.0 environment Lab. 1 M. Smith, Electrical and Computer Engineering, University of Calgary, Canada smithmr @ ucalgary.ca

ENCM515 Lab. 1 -- VisualDSP basics Select partners -- 2 people per station and select station in ICT320 with Summit / Mountain ICE capability. Stations throughout the Department support the 20 floating licenses for VisualDSP++3.0 and the ADSP-21061 simulator Build a Visual DSP project – Looking at developing a simple IIR (Infinite duration Impulse Response filter) Test out VisualDSP software simulation environment Set up and test out VisualDSP hardware environment Develop simple IIR filter Test in stand-alone situation Test with Lab. 0 Test running LOCAL_AUDIOSOURCE program – will need ear-phones for testing 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Checking that the software exists Use lab. 0 program to test your station Remember to HOLD-DOWN control-key while activating VisualDSP++ to ensure that you can have a choice of session Make sure that you exit from VisualDSP++ before hooking up the ICE probe to the boards. Also connect the probe to the boards, then power up the boards, then activate VisualDSP++ to avoid probe damage 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Configuring ICE hardware --1 TAKE CARE -- THESE ARE VERY EXPENSIVE PROBES -- I want to use them for a number of years! Make sure that you have exited from Visual DSP and powered down the boards before connecting the ICE probes to the boards Use a Proper wrist grounding strap to avoid electrostatic discharge. Power down the EZ-LITE board and remove the two jumpers from the EZ-ICE socket. Place the jumpers into the electrostatic bag. Identify the ICE cable coming from the Lab. Station PC. These cables are connected to special hardware on the ICT320 stations (Summit ICE). 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Configuring ICE hardware -- 2 TAKE CARE -- THESE ARE VERY EXPENSIVE PROBES -- I want to use them for a number of years! Please use proper grounding strap. Identify the ICE cable coming from the Lab. Station PC. Connect the ICE Probe (from the lab. kit) to the ICE cable. If you are having to force the probe onto the connector then you are connecting it the wrong way. Connect the ICE probe to the EZ-ICE JTAG socket on the board (Collection of about 14 pins in 2 rows near the processor chip) There is a right and wrong way. The correct way will have the probe cable coming in from the top of the board and NOT over the top of the SHARC processor chip. The missing pin on the EZ-ICE header corresponds to the blocked pin on the probe connector. Check that the board “input jumpers” (JP-8, JP-9) are set to “LINE” and NOT to MIC to avoid destroying the mic amplifiers Power up the board. DON’T power VisualDSP up yet. 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Configuring ICE hardware -- 3 TAKE CARE -- THESE ARE VERY EXPENSIVE PROBES -- I want to use them for a number of years! Please use proper grounding strap. Add your “stereo” head phones to Output Jack (J22 - jack nearest corner) -- you should hear the dreaded “Peter Gunn” Select and run Programs | VisualDSP | JTAG ICE Configurator from the Windows START MENU 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Configuring ICE hardware -- 4 TAKE CARE -- THESE ARE VERY EXPENSIVE PROBES -- I want to use them for a number of years! Please use proper grounding strap. In the configuration window Select Summit ICE (ICT320), Select Copy Change Type to EZ-ICE -- followed by OK. You now have configured the system to accept the in-circuit emulator as one sessionfor use during debugging code. You should not have to do this configuration again if YOU come back to the same laboratory station. Use ICE Test Utility program to test out connections. 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Checking that the Hardware talks to VisualDSP++ Use lab. 0 program to test your station Remember to HOLD-DOWN control-key while activating VisualDSP++ to ensure that you can have a choice of session. You now want – Summit ICE session Make sure that you exit from VisualDSP++ before disconnect the ICE probe to the boards. Also exit from VisualDSP, power down the board and then disconnect the probe. 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Test -- hard ware Reactivate VisualDSP – Hold down control key From new session list select DSP0 (ADSP-21061) Ez-kit ADSP-21061 ADSP-21xxxx Summit ICE Click OK on File could not be found window if it appears. Download lab0.prj file Activate the .tcl file We now need to display the input and output files associated with this executable Activate the 2 plot windows Activate the Run and Pause (0x7F) option Run the program -- should go a lot faster (if you are not still run the simulator by mistake (MFE -- my favourite error)). 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

To Power down ICE hardware -- 5 TAKE CARE -- THESE ARE VERY EXPENSIVE PROBES -- I want to use them for a number of years! Please use proper grounding strap. Make sure that “run light” on the probe is off This means exit “debugging environment” program If you have crashed the system, you may have to reactivate the debugging program and then exit again before the light goes off. Power down the 21061 board and then disconnect -- the probe is “very expensive” to replace. 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Main Subroutine void main(void){ int polar = BIPOLAR; // Build the left and right channels BuildSignalChannel( left_channel, LEFTCHANNELPERIOD, polar ); BuildSignalchannel( right_channel, RIGHTCHANNELPERIOD, polar ); // Pass the left and right channel through the low and high pass filter LowPassFilter( left_channel, MAXCHANNELLENGTH, low_pass_output ); HighPassFilter( right_channel, MAXCHANNELLENGTH, high_pass_output ); // Set the printing flag PrintActivation( NONWRITE ); // Print if printing is activated if( CheckPrintActivation() ) { puts( "The program runs successfully." ); fflush( stdout ); } } 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Audio Channel Construction void BuildSignalchannel( int *channel_in, const int channelPeriod, const int polar ) { int point = 0, signalValue = 0, halfChannelPeriod = 0, pointCount = 0; halfChannelPeriod = channelPeriod / 2; // divided the value channelPeriod by half pointCount = 1; // store a periodic square wave signal into the array for( point = 0; point < MAXCHANNELLENGTH; point++ ) { if( pointCount > halfChannelPeriod ) { if( signalValue == ZERO ) if( polar == BIPOLAR ) signalValue = -CHANNELPEAK; else signalValue = ZERO; } else signalValue = CHANNELPEAK; } pointCount = 1; } // save the filtered value *channel_in = signalValue; // increment pointer and counter channel_in++; pointCount++; } 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

(Poor) Low Pass IIR filter #define FILTERCOEFF 0.1 #define ONEMINUSFILTERCOEFF 0.9 void LowPassFilter( int *channel_in, const int channel_in_length, int *channel_out ){ static float oldValue float newValue int point for( point < channel_in_length ) {           newValue = ( float ) channel_in(point);           channel_out(point) = ( integer ) oldValue;           oldValue = ONEMINUSFILTERCOEFF * oldValue + FILTERCOEFF * newValue; } 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

High pass filter Try the effect of High pass signal = signal – low pass (signal) 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

Simple assembly code link demo The laboratory involves a simple example of linking to an assembly code routine Basically, check an input parameter and then do something based on that decision Examine the code put out by the “C” compiler to get an idea of the required format 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

If you move fast enough Cut and paste the IIR filter from Lab. 1 into the process sound .c file Change the INPUT sound options to SQUARE_WAVE and SIMPLE_IIR filter and check that the code from Lab. 0 works 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

For the really keen and “gifted” Gifted – means lucky enough not to make too many mistakes  Audio-test Copy your Lab. 0 project file as “lab0.online.prj” Unlink to the offline library and relink to the “online” library. Set the compile options to “-D LOCAL_AUDIOTEST” Use ear phones and run the program Pressing switch on the board will cut out the processing so you can hear the unprocessed sound The low-pass filter will make the sound like that from a 1910 phonograph – which were unable to record the high-frequency sounds on the wax cylinders See ECE-ADI-Project web-pages – Lab.2 for more details 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca

ENCM515 Lab. 1 -- VisualDSP basics Select partners -- 2 people per station and select station in ICT320 with Summit / Mountain ICE capability. Stations throughout the Department support the 20 floating licenses for VisualDSP++3.0 and the ADSP-21061 simulator Build a Visual DSP project – Looking at developing a simple IIR (Infinite duration Impulse Response filter) Test out VisualDSP software simulation environment Set up and test out VisualDSP hardware environment Develop simple IIR filter Test in stand-alone situation Test with Lab. 0 Test running LOCAL_AUDIOSOURCE program – will need ear-phones 12/10/2018 ENCM515 -- Setting up VisualDSP++3.0 Environment Copyright M. Smith -- smithmr@ucalgary,ca