1 // ********************************************************************* 2 // Custom DPA Handler code example - Self Load Code * 3 // ********************************************************************* 4 // Copyright (c) MICRORISC s.r.o. 5 // 6 // File: $RCSfile: CustomDpaHandler-SelfLoadCode.c,v $ 7 // Version: $Revision: 1.7 $ 8 // Date: $Date: 2021/04/26 15:13:50 $ 9 // 10 // Revision history: 11 // 2018/10/25 Release for DPA 3.03 12 // 13 // ********************************************************************* 14 15 // Online DPA documentation https://doc.iqrf.org/DpaTechGuide/ 16 17 // This example demonstrates loading other Custom DPA Handler from the existing one. 18 // It exists in two variants. The "red" or "green" (see RED below). Based on the variant the corresponding LED is on all the time. 19 // When a button is pressed the other Custom DPA Handler variant is loaded and started. 20 // The example expects that both variants of the example are preloaded at the external EEPROM in the way they can be loaded by CMD_OS_LOAD_CODE command. 21 // Also, the example expects that there are parameters for CMD_OS_LOAD_CODE for loading the handlers stored at the external EEPROM too. 22 // Parameters for the "red: variant must be stored at address 0 and for the "green" variant at the address 6 respectively. 23 // Each set of parameters takes 6 bytes. Parameters have the following format (see https://www.iqrf.org/DpaTechGuide/#3.4.13%20LoadCode for details): 24 // offset name value 25 // 0 addrLow lower byte of the corresponding driver .hex image in the external EEPROM 26 // 1 addrHigh same as above but higher byte 27 // 2 lengthLow lower byte of the corresponding driver .hex image length in the external EEPROM 28 // 3 lengthHigh same as above but higher byte 29 // 4 checksumLow lower byte of the corresponding driver .hex image checksum in the external EEPROM 30 // 5 checksumHigh same as above but higher byte 31 // 32 // IQRF IDE Tools / IQRF Network Manager / Control / Upload can be used to upload both .hex images into the external EEPROM. 33 // Then Terminal in DPA mode is used to write LoadCode parameters into external EEPROM too. 34 35 // Default IQRF include (modify the path according to your setup) 36 #include "IQRF.h" 37 38 // Default DPA header (modify the path according to your setup) 39 #include "DPA.h" 40 // Default Custom DPA Handler header (modify the path according to your setup) 41 #include "DPAcustomHandler.h" 42 43 //############################################################################################ 44 45 // Defined for the "RED" variant otherwise "GREEN" variant is compiled 46 #define RED 47 48 // Based on the variant define the variant specific symbols 49 #ifdef RED 50 #define setLED() setLEDR() 51 #define pulseOtherLED() pulseLEDG() 52 #define OTHER_HANDLER_ADDRESS 6 53 54 #else // #ifdef RED 55 #define setLED() setLEDG() 56 #define pulseOtherLED() pulseLEDR() 57 #define OTHER_HANDLER_ADDRESS 0 58 59 #endif 60 61 // Must be the 1st defined function in the source code in order to be placed at the correct FLASH location! 62 //############################################################################################ 63 bit CustomDpaHandler() 64 //############################################################################################ 65 { 66 // Handler presence mark 67 clrwdt(); 68 69 // Detect DPA event to handle (unused event handlers can be commented out or even deleted) 70 switch ( GetDpaEvent() ) 71 { 72 // ------------------------------------------------- 73 case DpaEvent_Idle: 74 { 75 // Do a quick background work when RF packet is not received 76 77 // Light your LED all the time 78 setLED(); 79 80 // Variable to save last 8 states of the IQRF button to avoid "pressing" button at CK-USB-04x or a button bouncing in general 81 static uns8 lastButton; 82 // bit.0 will hold the current button state, so let's make a room for it 83 lastButton <<= 1; 84 // Set bit.0 if the button is pressed 85 if ( buttonPressed ) 86 lastButton |= 1; 87 88 // Was the button kept pressed for the last 7 Idle events? 89 if ( lastButton == ( (uns8)-1 >> 1 ) ) 90 { 91 // Read CMD_OS_LOAD_CODE parameters (address, length, checksum) into bufferINFO for loading the other driver 92 eeeReadData( OTHER_HANDLER_ADDRESS ); 93 // Copy CMD_OS_LOAD_CODE parameters to the correct offset at the DPA request 94 memoryOffsetTo = offsetof( TPerOSLoadCode_Request, Address ); 95 // Copy loaded parameters from bufferINFO into bufferRF where actually _DpaMessage is 96 copyBufferINFO2RF(); 97 // We load custom DPA handler stored at .hex format and want to really load it 98 _DpaMessage.PerOSLoadCode_Request.Flags = 0x01; 99 // Set peripheral and its command for LoadCode 100 _PNUM = PNUM_OS; 101 _PCMD = CMD_OS_LOAD_CODE; 102 // Length of the DPA request 103 _DpaDataLength = sizeof( _DpaMessage.PerOSLoadCode_Request ); 104 // Perform LoadCode, if it succeeds the device resets 105 DpaApiLocalRequest(); 106 // If the LoadCode failed (reason: .hex not loaded at the external EEPROM memory or the LoadCode parameters stored at external EEPROM are incorrect) ... 107 if ( !_DpaMessage.Response.PData[0].0 ) 108 // Pulse the other LED to indicate error when loading other handler 109 pulseOtherLED(); 110 } 111 112 break; 113 } 114 } 115 116 return FALSE; 117 } 118 //############################################################################################ 119 // Default Custom DPA Handler header; 2nd include to implement Code bumper to detect too long code of the Custom DPA Handler (modify the path according to your setup) 120 #include "DPAcustomHandler.h" 121 //############################################################################################