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

1 ;/*

2 ; * FreeRTOS Kernel V10.2.1

4 ; *

5 ; * Permission is hereby granted, free of charge, to any person obtaining a copy of

6 ; * this software and associated documentation files (the "Software"), to deal in

7 ; * the Software without restriction, including without limitation the rights to

8 ; * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of

9 ; * the Software, and to permit persons to whom the Software is furnished to do so,

10 ; * subject to the following conditions:

11 ; *

12 ; * The above copyright notice and this permission notice shall be included in all

13 ; * copies or substantial portions of the Software.

14 ; *

15 ; * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

16 ; * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS

17 ; * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR

18 ; * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER

19 ; * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN

20 ; * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

21 ; *

22 ; * http://www.FreeRTOS.org

23 ; * http://aws.amazon.com/freertos

24 ; *

25 ; * 1 tab == 4 spaces!

26 ; */

27

28 ;*

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

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

31 ; *

32

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

34 ; portRESTORE_CONTEXT().

35 #include "ISR_Support.h"

36

37 PUBLIC vANExampleISR_ASM_Wrapper

38 EXTERN vAnExampleISR_C_Handler

39

40 RSEG CODE:CODE

41

42 ; *

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

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

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

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

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

48 ; *

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

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

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

52 ; * instructions.

53 ; *

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

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

56 ; * the bottom of this file.

57 ; *

58

59 vANExampleISR_ASM_Wrapper:

60

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

62 ; wrapper.

63 portSAVE_CONTEXT

64

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

66 call !!vAnExampleISR_C_Handler

67

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

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

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

71 ; that was running before the interrupt started).

72 portRESTORE_CONTEXT

73 reti

74

75

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

77 ; assembly file.

78

79 ; Ensure the vector table segement is used.

80 COMMON INTVEC:CODE:ROOT(1)

81 ;

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

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

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

85 ORG 58

86 DW vANExampleISR_ASM_Wrapper

87

88 END

89