begriffs open source - cmsis-freertos/blob - Demo/RL78_multiple

2 ;

3 ; FEATURES AND PORTS ARE ADDED TO FREERTOS ALL THE TIME. PLEASE VISIT

4 ; http://www.FreeRTOS.org TO ENSURE YOU ARE USING THE LATEST VERSION.

5 ;

6 ; ***************************************************************************

7 ; * *

8 ; * FreeRTOS tutorial books are available in pdf and paperback. *

9 ; * Complete, revised, and edited pdf reference manuals are also *

10 ; * available. *

11 ; * *

12 ; * Purchasing FreeRTOS documentation will not only help you, by *

13 ; * ensuring you get running as quickly as possible and with an *

14 ; * in-depth knowledge of how to use FreeRTOS, it will also help *

15 ; * the FreeRTOS project to continue with its mission of providing *

16 ; * professional grade, cross platform, de facto standard solutions *

17 ; * for microcontrollers - completely free of charge! *

18 ; * *

19 ; * >>> See http://www.FreeRTOS.org/Documentation for details. <<< *

20 ; * *

21 ; * Thank you for using FreeRTOS, and thank you for your support! *

22 ; * *

23 ; ***************************************************************************

24 ;

25 ;

26 ; This file is part of the FreeRTOS distribution.

27 ;

28 ; FreeRTOS is free software; you can redistribute it and/or modify it under

29 ; the terms of the GNU General Public License (version 2) as published by the

30 ; Free Software Foundation AND MODIFIED BY the FreeRTOS exception.

31 ;

32 ; >>>>>>NOTE<<<<<< The modification to the GPL is included to allow you to

33 ; distribute a combined work that includes FreeRTOS without being obliged to

34 ; provide the source code for proprietary components outside of the FreeRTOS

35 ; kernel.

36 ;

37 ; FreeRTOS is distributed in the hope that it will be useful, but WITHOUT ANY

38 ; WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS

39 ; FOR A PARTICULAR PURPOSE. See the GNU General Public License for more

40 ; details. You should have received a copy of the GNU General Public License

41 ; and the FreeRTOS license exception along with FreeRTOS; if not it can be

42 ; viewed here: http://www.freertos.org/a00114.html and also obtained by

43 ; writing to Real Time Engineers Ltd., contact details for whom are available

44 ; on the FreeRTOS WEB site.

45 ;

46 ; 1 tab == 4 spaces!

47 ;

48 ; ***************************************************************************

49 ; * *

50 ; * Having a problem? Start by reading the FAQ "My application does *

51 ; * not run, what could be wrong?" *

52 ; * *

53 ; * http://www.FreeRTOS.org/FAQHelp.html *

54 ; * *

55 ; ***************************************************************************

56 ;

57 ;

58 ; http://www.FreeRTOS.org - Documentation, books, training, latest versions,

59 ; license and Real Time Engineers Ltd. contact details.

60 ;

61 ; http://www.FreeRTOS.org/plus - A selection of FreeRTOS ecosystem products,

62 ; including FreeRTOS+Trace - an indispensable productivity tool, and our new

63 ; fully thread aware and reentrant UDP/IP stack.

64 ;

65 ; http://www.OpenRTOS.com - Real Time Engineers ltd license FreeRTOS to High

66 ; Integrity Systems, who sell the code with commercial support,

67 ; indemnification and middleware, under the OpenRTOS brand.

68 ;

69 ; http://www.SafeRTOS.com - High Integrity Systems also provide a safety

70 ; engineered and independently SIL3 certified version for use in safety and

71 ; mission critical applications that require provable dependability.

72

73 ;*

74 ; * This file defines the assembler wrapper for the example interrupt that is

75 ; * defined in main.c. The wrapper is the interrupt entry point.

76 ; *

77

78 ; ISR_Support.h contains the definitions of portSAVE_CONTEXT() and

79 ; portRESTORE_CONTEXT().

80 #include "ISR_Support.h"

81

82 PUBLIC vANExampleISR_ASM_Wrapper

83 EXTERN vAnExampleISR_C_Handler

84

85 RSEG CODE:CODE

86

87 ; *

88 ; * This demo does not include a functional interrupt service routine - so

89 ; * this dummy handler (which is not actually installed) is provided as an

90 ; * example of how an ISR that needs to cause a context switch needs to be

91 ; * implemented. ISRs that do not cause a context switch have no special

92 ; * requirements and can be written as per the compiler documentation.

93 ; *

94 ; * This assembly wrapper function calls the main handler, which is called

95 ; * vAnExampleISR_C_Handler(), and is implemented in main.c. See the

96 ; * documentation page for this demo on the FreeRTOS.org website for full

97 ; * instructions.

98 ; *

99 ; * NOTE: vANExampleISR_ASM_Wrapper needs to be installed into the relevant

100 ; * vector, an example of how to do this from an assembly file is locate at

101 ; * the bottom of this file.

102 ; *

103

104 vANExampleISR_ASM_Wrapper:

105

106 ; portSAVE_CONTEXT() must be the first thing called in the ASM

107 ; wrapper.

108 portSAVE_CONTEXT

109

110 ; Once the context has been saved the C handler can be called.

111 call !!vAnExampleISR_C_Handler

112

113 ; Finally the ISR must end with a call to portRESTORE_CONTEXT()

114 ; followed by a reti instruction to return from the interrupt to whichever

115 ; task is now the task selected to run (which may be different to the task

116 ; that was running before the interrupt started).

117 portRESTORE_CONTEXT

118 reti

119

120

121 ; The interrupt handler can be installed into the vector table in the same

122 ; assembly file.

123

124 ; Ensure the vector table segement is used.

125 COMMON INTVEC:CODE:ROOT(1)

126 ;

127 ; Place a pointer to the asm wrapper at the correct index into the vector

128 ; table. Note 56 is used is purely as an example. The correct vector

129 ; number for the interrupt being installed must be used.

130 ORG 58

131 DW vANExampleISR_ASM_Wrapper

132

133 END

134