ENCM511 Assignment 1 Version 16 September 2012

Transcription

1 ENCM511 Assignment 1 Version 16 September 2012 This is an individual assignment, essentially a take home quiz. This means the purpose behind this assignment is for YOU to show the skills learnt during the familiarization laboratory (Section 2, 18 th September, Section 1, 25 th September). This assignment is due two weeks after your lab. HINT READ ALL THE REQUIREMENTS BEFORE STARTING ANY CODING There are a lot of useful code samples that will help speed up your coding. Demonstrate A) Demonstrate your ability to develop a VDSP project, write code and run a Blackfin executable on the BF533 Board B) Demonstrate your ability to write and run a short program that activates a single LED on the board C) Demonstrate your ability to run a short program that activates singles LEDs in a given order with a time delay between activations D) The ability to write and run a short program that activates multiple LEDs at the same time using a super loop controller (You are REQUIRED to demonstrate the use of C++ bit wise AND and OR operations to control the LED embedded interface). NOTE: IF you want to put all the marks for part D into part F and concentrate on audio analysis program okay by me but let me know you plan to do that. E) The ability to write some simple tests to check the functions you develop F) Building a mock Audio Analysis program on the Blackfin Board for the Ranchlands Hum (see lik on ENCM511 webpage). MARKS 15% OF ASSIGNMENT (MEANING YOU CAN GET AN A WITHOUT DOING THIS PART. BASICALLY ITS THERE FOR A LITTLE BIT OF FUN NOT REALLY NEEDED BUT IDEAS SHOULD BE THOUGHT ABOUT AS WOULD MAKE EXCELLENT QUIZ OR MIDTERM QUESTIONS. G) Provide (hand in) documented code prepared according the requirements of this course. Work will not be marked if the front page of the report does not include a signed declaration that this is your own work, and that you have followed the Smith 20 minute Rule in seeking assistance from others. Explain the 20 minute rule as part of your declaration. Early bird hand in date Sunday 30 th September. Section 2; Sunday 7 Oct. Section 1. There is a 10% bonus for handing in Assignment 1 by this early due date. Last date to hand in Assignment 1 Sunday 7 Oct. Section 2; Sunday 14 Oct. Section 1. NO FURTHER EXTENSION. Assignment 1 demos will start during the Lab periods (4 pm to 5 pm) following 7 th October for Section 2 and after 14 th October for Section 1. Be prepared to demonstrate using code in your own directory at 15 minutes notice.

2 INITIAL INSTRUCTIONS ASSIGNMENT 1 PART A Demonstrate the ability to develop your own VDSP project (.prj), write code and run a Blackfin executable (.dxe) on the BF533 Board In the Familarization Laboratory, you developed various LED functions. You are going to reuse those ideas in this Assignment. During Lab. 0, you downloaded the following OBJECT files from ENCM511 Familiarization Laboratory website into your ENCM511 / Familiarization directory. NOTE: Actual names might be different in minor ways; demonstrate your ability to modify the project to handle this situation DrSmith_LEDDeviceDriverCPP.doj, LEDReadWriteCPP.doj and DrSmith_WaitForKeyBoardEntryCPP.doj In your ENCM511 / Assignment 1 directory, build a project called ActivateSingleLED_Keyboard.dpj ADD all the doj files downloaded into the Familiarization directory to this project. NOTE: This means demonstrate how to add existing files to a project. It does not mean copy the files in the Familiarization directory into the new Assignment 1 directory. Add the following assignment1.h INCLUDE file to your Assignment 1 directory. Another name used for this sort of file is header file means the same thing, different stress on the functionality behind using the file. #ifndef ASSIGNMENT1_H #define ASSIGNMENT1_H #include <stdio.h> void InitFlashCPP(void); // Initialize EBIU interface (Dr. Smith version) PROVIDED void InitFlashPortCPP(void); // Initialize Flash port used to control LED PROVIDED extern C void StartProcessorCycleCounter(void); // Clear and Start cycle counter PROVIDED extern C unsigned long long int ReadCurrentProcessorCycleCount(void); // Return (64 bit) values of Blackfin Cycle Counter PROVIDED unsigned int ReadFlashLEDASM(void); void WriteFlashLEDASM(unsigned int LEDvalue); // Read current state of LED output register PROVIDED // Write new state to LED output register PROVIDED void DrSmith_WaitForKeyBoardEntry(void); // Press return to continue PROVIDED void LEDLoop_WithKeyBoardWait(unsigned int LEDinfo[ ], int lengthledinfo); // Displays series of LED values PROVIDED void LEDLoop_WithTimedWait(unsigned int LEDinfo[ ], int lengthledinfo, int waitthistimeinseconds); // THIS IS JUST THE PROTOTYPE // Displays series of LED valuesautomaically THE CODE IS FOR YOU TO WRITE void LEDShow_MyFirstNameInitial(void); void LEDShow_MySurnameFirstLetter(void); // THIS IS JUST THE PROTOTYPE THE CODE IS FOR YOU TO WRITE // THIS IS JUST THE PROTOTYPE THE CODE IS FOR YOU TO WRITE void WaitThisNumberOfTenthsOfSecond(unsigned int numberoftenthsofsecond); // THIS IS JUST THE PROTOTYPE THE CODE IS FOR YOU TO WRITE #endif

3 Add the following ActivateSingleLED_Keyboard_mainCPP.cpp SOURCE file to your directory DO A CODE REVIEW AND REMOVE DELIBERATE (and some accidental) TYPOS. o Expect to have to do a code review on all the source files I give you in the lab and assignments. If I just let people download and use the files, they will never learn the material for the course. Note the code behind the.doj files is hidden to you. #include../assignment1/assignment1.h void main(void) { LEDShow_MyFirstNameInitial( ); // When all the code is complete, this function will not work if called at this point in the code // Add comments to your code to explain why DrSmith_WaitForKeyBoardEntry( ); // Stops the program and gives you time to examine the LED output InitFlashCPP( ); InitFlashPortCPP( ); LEDShow_MySurnameFirstLetter( ); // This function should now work Add comments to your code to explain why DrSmithWaitForKeyBoardentry( ); // Stops the program and gives you time to examine the LED output LEDShow_MyFirstNameInitial( ); DrSmithWaitForKeyBoardEntry( ); // This should now work unsigned int LEDcontrolFirstArray[5] = { 0x3F, 0x3F, 0x33, 0x37, 0x21, 0x22, 0x00, 0x00; // Turn on a number of LEDs should look like the shuttle door on the Voyager opening LEDLoop_WithKeyBoardWait(LEDcontroFirstlArray, 5); // Add your own function call to make the LEDs look like a shuttle door closing printf( Done assignment 1 A\n ); If you now build this project, you will get error messages from the LINKER about not finding the LEDShow_MyFirstNameInitial( ) and LEDShow_MySurnameFirstLetter( ) routines. As discussed in class, add missing functions as stubs to allow the project to build, link and load. STUBS MEANS NO CODE OTHER THAN WHAT IS NEEDED TO SATISFY THE COMPILER. If you now run the code, then after 3 presses of the enter key, you should see the LED light up with the bits that look like the Voyager Shuttle bay opening. You can easily add additional the code so that the lights move from left to right This represents the shuttle moving into the shuttle bay, and then more code to close the shuttle doors Total amount of code needed 4 lines of C++ added to the main.cpp code. ASSIGNMENT 1 PART B Demonstrate the ability to write and run a short program that activates a single LED s on the board In another.cpp file, you are now to write the code for LEDShow_MyFirstNameInitial( ) and LEDShow_MySurnameFirstLetter( ), Each of these CPP functions require about 3 lines of code using the functions you already have put into the project My last name is Smith the ascii code for the letter S can be automatically generated in C++ by using the symbol S (meaning the character S ). Thus if I write the code WriteFlashLEDASM( S ) I would expect to see the ascii bit pattern for the letter S appearing on the screen.

4 HAND IN YOUR C++ CODE FOR THESE TWO FUNCTIONS (Actually I have been told that since these functions don t return anything (return void) they are subroutines. These days you can have a function that returns void pointers (capable of being used to point to any type of variable so why can t you have a function that return a void value ). PROVIDE A SCREEN CAPTURE TO DEMONSTRATE THE SOURCE FILES LINKED TO YOUR PROJECT AND THE FACT THAT THE PROJECT COMPILED, LINKED AND DOWNLOADED WITHOUT ERROR EVEN BEFORE ALL THE FUNCTIONS FOR THE ABOVE CODE HAVE BEEN WRITTEN, IT IS POSSIBLE TO EXPLAIN AT THE HARDWARE AND SOFTWARE LEVEL WHY (A) THE CALL to LEDShow_MyFirstNameInitial( ) IN THE ABOVE CODE SHOULD NOT BE EXPECTED TO WORK THE FIRST TIME IT IS CALLED, WORK THE SECOND TIME IT IS CALLED IN THE SAME PROJECT CODE, AND (B) WHY YOU WOULD EXPECT THE BOTH CALLS TO FUNCTION TO WORK IF YOU RERAN THE CODE AND (C) THIS BEHAVIOUR GOES BACK TO NOT RUNNING THE FIRST TIME IF YOU DOWNLOAD THE EXECUTABLE TO THE BOARD A SECOND TIME. GIVE (D) THE ASCII HEX VALUES FOR YOUR FIRST NAME INITIAL, (E) WHAT YOU EXPECTED TO SEE IN THE LED LIGHTS AFTER RUNNING THE CODE LEDShow_MyFirstNameInitial( ), (F) WHAT YOU ACTUALLY SAW, AND (G) IF DIFFERENT, WHY THE DIFFERENCE (H) GIVE THE ASCII HEX VALUES FOR YOUR SURNAME FIRST LETTER, (I) WHAT YOU EXPECTED TO SEE IN THE LED LIGHTS AFTER RUNNING THE CODE LEDShow_MySurnameFirstLetter( ), (J) WHAT YOU ACTUALLY SAW, AND (K) IF DIFFERENT, WHY THE DIFFERENCE ASSIGNMENT 1 PART C Demonstrate the ability to write and run a short program that activates singles LED s in a given order with a time delay between activations In your ENCM511 / Assignment directory, build a project called ActivateSingleLED_Timed.dpj o Yes, you can have more than one project file in a directory. It s not a great idea unless all the projects are just minor variations of each other. To this project, add all the doj files downloaded into the Assignment 1 directory and also the assignment1.h include file with all the common subroutine and function prototypes. Remember ADD the files to the projects. There is no need to make extra copies. You will need to write this function void WaitThisNumberOfTenthsOfSecond(int numberoftenthsofsecond); // 12 lines of code Suppose you had this subroutine working, and then wrote some C++ code that looked roughly like the following pseudocode. WriteLEDASM(1) // Pseudo code is roughly like C++ WaitThisNumberOfTenthsOfSecond(10); // but not worrying about exact syntax WriteLEDASM(2) WaitThisNumberOfTenthsOfSecond(20); // Pseudo code expresses ideas not syntax WriteLEDASM(1) // so missing semi colons is okay here but not in straight code WaitThisNumberOfTenthsOfSecond(5); WriteLEDASM(0)

5 This sequence of calls would cause LED 1 to stay on for 1 second and then be replaced by LED 2 being on, and then 2 second later, LED 1 would come on again, before all LED s are turned off. I have provided you with two functions to help you write this code inside the object file CycleCountASM.doj, JUST USE THEM; How do they work worry about it later WAIL!. extern C void StartProcessorCycleCounter(void); // Clear and Start cycle counter extern C unsigned long long int ReadCurrentProcessorCycleCount(void); // Return (64 bit) values of Blackfin Cycle Counter Remember that the processor clock has a frequency of 500 MHz (roughly). NOTE: My test board actually had a clock frequency of 200 MHz as I had switched it into power saving mode. Do a rough check that your lights are flashing at 1 second intervals using a stop watch 10% accuracy is good enough as long as all the lights have equivalent timing. You can t have one light flashing at 1.1 secs and the other at 0.9. Will discuss power saving mode in class later. Now you need to write the routine void LEDLoop_WithTimedWait(unsigned int LEDinfo[ ], int lengthledinfo, int waitthistimeinseconds); // 6 lines of code where the requirements are Display on the LED all the bit patterns associated stored in the array LEDinfo[ ]; changing the LED image at intervals of waitthistimeinseconds which is timed by calling the routine WaitThisNumberOfTenthsOfSecond( ). Program the code so that the number of seconds between the LED image changes is equal to the number of letters in your last name. (Hint try it with a pretend name of 2 letters; once working change it to the proper timing.) (A) HAND IN YOUR C++ CODE AND A SCREEN DUMP SHOWING THAT THIS CODE COMPILED, LINKED AND LOADED (B) FIND A PERSON (NOT YOUR LAB PARTNER) WHOSE HAS A SURNAME WHOSE INITIAL IS NOT THE SAME AS YOURS, BUT IS + 3 LETTERS FROM YOUR INITIAL. (C) HAVE THEM COME IN AND SIGN OFF ON YOUR CODE TO SAY IT IS WORKING. (D) 5% BONUS IF YOU CAN SHOW THAT PERSON HOW TO CHANGE THE ARRAY, SO THAT THE LIGHTS FLASH UP AND THEN FLASH DOWN LIKE THE LIGHTS ON A ZYLON HEAD BAND (Battlestar Galatica), then compile, load and run the code. (E) You will need a third person to sign off on the correct working of this code. HAND IN THIS CODE

6 ASSIGNMENT 1 PART D Demonstrate the ability to write and run a short program that activates multiple LEDs at the same time using a super loop controller. In this part of the assignment you will need to demonstrate the use of C++ bitwise AND and OR operations to control the LED embedded interface. NOTE: IF you want to put all the marks for part D into part F and concentrate on building the video game okay by me but it s on your head. A super loop looks like this main( ) { InitInterfaces( ); while (1) { // The super loop YOUR CODE HERE TO CONTROL THE INTERFACE GOES HERE ( ) See various example pieces of code The requirements are the following Using bit wise C++ AND and OR instructions write the code for a function void ChangeLEDLight(unsigned int whichled, bool on_off); which turns the LED whichled on or off, leaving the other LEDs not selected unchanged Example: Suppose the LED pattern was % (The symbol % is used to show that these are binary bits it does not mean take modulus In C you would have to write 0x15) ChangeLEDLight(1, 0) ChangeLEDLight(2, 1) would leave the LED pattern as % Using ChangeLEDLight(3, 1) ChangeLEDLight(4, 0) would leave the LED pattern as % but ChangeLEDLight(3, 0) ChangeLEDLight(4, 1) would give the LED pattern as %

7 Now, using the super loop implement the following requirements using ChangeLEDLight( ) and ReadCurrentProcessorCycleCount LED 1 toggles every 0.75 seconds toggles means on then off every 0.75 seconds (50% duty cycle) LED 3 toggles every 2.5 seconds LED 5 does not do anything for 4.5 seconds and then toggles every 3 seconds for 12 seconds and then stops for 5 seconds then starts this pattern all over again Example of a super loop task is given at the end of the assignment HAND IN YOUR CODE with screen dumps HAVE SOMEBODY SIGN OFF THAT IT WORKS ARRANGE TO DEMONSTRATE TO A T.A. OR MYSELF BIG PROBLEM How can you wait for 0.75 seconds on one light when you are already waiting for another light for 2 seconds? Light 1 flashes every 1 second Code : for ever { Wait 1 second; toggle Light 1 Light 1 flashes every 1 second; Light 2 flashes every 2 seconds Code : for ever { Wait 1 second; toggle Light 1 Wait 2 seconds; toggle Light 2 DOES NOT WORK Code : for ever { Wait 1 second; toggle Light 1; Wait 1 second Wait 1 seconds; toggle Light 1 ; toggle Light 2 WORKS BUT UGLY CODE WITH SIX LIGHTS AND WEIRD TIME INTERVALS Better code for more details see later pages for more explanations around using a superloop For ever { if (timenow( ) >= nexttimeforled1) { // Put a comment in your code to explain why use == is not a good idea. Toggle LED 1; nexttimeforled1 + = 1 second if (timenow( ) >= nexttimeforled2) { Toggle LED 2; nexttimeforled2 + = 2 second

8 ASSIGNMENT 1 PART E Demonstrate the ability to write some simple tests to check the functions you develop Make a project in your Assignment1_Test directory and use the EmbeddedUnit GUI to make it an Embedded Unit test project Write the test code to demonstrate that ChangeLEDLight( ) works correctly. HAND IN YOUR CODE with screen dumps HAVE SOMEBODY SIGN OFF THAT IT WORKS How many tests should I write? The answer enough! Knowing how many tests to write is one of the key issues in testing. Write too few, and the company loses a lot of money as the code is returned for fixing in your company s case, too low an assignment mark now, and a lot of time fixing the code so it can be re used in the next assignment or lab Write too many, and the company loses money as the code is never released, or released after somebody else has released and equivalent product. In your case, you waste time you could have spent socializing or completing another assignment Discuss this with one of the software engineering students ask about Partitioning ASSIGNMENT 1 PART F PRATICAL APPLICATION OF THESE IDEAS 15 % OF ASSIGNMENT (MEANING YOU CAN GET AN A WITHOUT DOING THIS PART) BASICALLY ITS THERE FOR A LITTLE BIT OF FUN NOT REALLY NEEDED BUT IDEAS SHOULD BE THOUGHT ABOUT AS WOULD MAKE EXCELLENT QUIZ OR MIDTERM QUESTIONS) Read the one page abstract Solving Health Issues Associated with Urban Low Frequency Noise Irritants by E. Marasco and M. Smith to give you the idea of the problem associated with the Calgary Ranchland s Hum Develop a project Mock_Ranchlands_Hum that fakes a super loop program that monitors houses to see if the 40 Hz Hum is present. We will mock the situation by pretending that every real day is simulated by 24 seconds. The noise at House #1 is to be measured every 4 hours. The noise at House #2 is to be measured every 6 hours. The noise at House #3 is to be measured every 9 hours. The noise at Industrial site #4 is to be measured every 3 hours. The noise at Industrial site #5 is to be measured every 4 hours. If the 40 Hz Hum is present at any site, then blink the LED associated with that site.; meaning if the noise is present at house #3, blink LED #3 ever hour (1/2 second on, ½ second off). If the noise is present at both a house and an industrial site, then BLINK LED#6 on for ¼ second and off for ¼ second.

9 Mocking functions are (simple) software functions that behave like the real hardware. project Put this code in its own file and link into // Pretend that there are stored audio frequency files on the internet. Each file contains an array of ARRAYSIZE floats that contains the power in frequency bands 10 Hz, 20 Hz, 30 Hz up to 190 Hz. // Hz 0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 100, 110, 120, 130, 140, 150, 160, 170, 180, 190 // Example pretendinternetfile[ ] = { 60, 00, 00, 60, 00, 00, 00, 00, 00, 00, 00, 00, 00, 00,... Does not show the hum(40, 80, 120) // Example pretendinternetfile[ ] = { 60, 00, 00, 60, 60, 00, 00, 00, 00, 00, 00, 00, 00, 00,... Show a 40 Hz signal, not the hum // Example pretendinternetfile[ ] = { 60, 00, 00, 60, 60, 00, 00, 00, 80, 00, 00, 00, 80, 00,... Shows true hum characteristics // Example pretendinternetfile[ ] = { 60, 00, 00, 60, 60, 00, 00, 00, 80, 00, 00, 00, 40, 00,... Shows false hum characteristics #define ARRAYSIZE 20 static float pretendinternetfile[arraysize]; #include <stdlib.h> int rand(void); // The rand function returns a pseudo random integer value in the range [0, ]. // For this function, the measure of randomness is its periodicity the number of values it is likely to generate before // repeating a pattern. The output of the pseudo random number generator has a period in the order of float * Mock_GetFrequencyMeasurementsFromSite( void) { for (int count = 1, count < ARRAYSIZE, count++) { float dummyreading = 20.0 * (rand( ) % 5); pretendinternetfile[count] = dummyreading; return pretendinternetfile; int Is40HzHumPresent(float *audiofile) { // Check the array for 40 Hz signal and its first and second overtone (80 Hz and 120 Hz) are ALL present at the same time with a strength greater than 50. // If so, return 1, otherwise return 0 The pseudo code for the Main program will look something like this except you should be using super loop syntax void main( ) { SetStuffUp( ); int humpresent = 0; quit = 0; while (quit == 0) for (site = 0; site < 6; site++) if timetomeasuresite( site) == true { GetFrequencyMeasurementsFromSite( ); unsigned int ispresent = Is40HzHumPresent( ); if ispresent == 1 { humpresent = humpresent (1 < site); // Turns on IS THERE bit using OR operator // Turn on LED #site as well else { humpresent = humpresent & ~(1 < site); // Turns off IS THERE bit using AND and NOT (twiddle) operator // Turn off LED #site as well

10 // Use logical and Bit wise AND and OR operations to activate blinking if ((humpresent % 0x38) > 0) // Industrial site noise MASK using b && ((humpresent % 007) > 0) // House site noise MASK using b StartBlinkingAction( ) else StopBlinkingAction( );

11 Example of a super loop task The task void LED1ControlTask(void) has three possible states LED1_UNKNOWN, LED1_ON and LED1_OFF. Code that information via a C++ enum statement. Task stories enum {LED1_UNKNOWN, LED1_ON. LED1_OFF; If the task is run and ends up in an unknown state issue error message If the task is run when in state LED1_OFF, turn the led on If the task is run when in state LED1_ON, turn the led off; So the task code would look something like this void LED1ControlTask(void) { static unsigned int currentstate = UNKNOWN unsigned int nextstate = UNKNOWN // What does the C++ keyword static mean switch (currentstate) { case LED1_ON: Function call to turn LED 1 off nextstate = LED1_OFF break; case LED1_OFF: Function call to turn LED 1 on nextstate = LED1_ON break; default: printf( UNKNOWN STATE IN LED1ControlTask\n ); // Can t use print statement for errors in real embedded systems why not? nextstate = UNKNOWN; break; currentstate = nextstate;

12 When I generate tasks with states, I like to make some text substitutions in the source file using C++ define statements to make the code easier to read #define BEGIN_STATE case #define END_STATE break #define ERROR_STATE default // Add this to the assignment 1 include / header file so only need to add once void LED1ControlTask(void) { static unsigned int currentstate = UNKNOWN unsigned int nextstate = UNKNOWN // What is the C++ keyword static mean switch (currentstate) { BEGIN_STATE LED1_ON: Function call to turn LED 1 off nextstate = LED1_OFF END_STATE; BEGIN_STATE: LED1_OFF: Function call to turn LED 1 on nextstate = LED1_ON END_STATE; ERROR_STATE: printf( UNLNOWN STATE IN LED1ControlTask\n ); // Can t use print statement for errors in real embedded systems why not? nextstate = UNKNOWN; END_STATE; currentstate = nextstate; With the task written, we can add it to the super loop code. There are many ways to do this Key rule when writing tasks no task is allowed to wait to do something (wait for 1 second then turn light off). That would cause the other tasks to block To avoid blocking other tasks, I would call the LED1 task like this #define ULL unsigned long long int // Place in include / header file ULL currecntcyclecount =.. ULL nextled1executiontime = currecntcyclecount + ONE_SECOND while (1) { currecntcyclecount =.. if (nextled1executiontime < currentcyclecount) { nextled1executiontime = nextled1executiontime + ONE_SECOND // Why add to nextled1executiontime and not to currentcyclecount? LED1Task( ); etc.