Subversion Repositories open8_urisc

; Copyright (c)2022 Jeremy Seth Henry
; All rights reserved.
;
; Redistribution and use in source and binary forms, with or without
; modification, are permitted provided that the following conditions are met:
;     * Redistributions of source code must retain the above copyright
;       notice, this list of conditions and the following disclaimer.
;     * Redistributions in binary form must reproduce the above copyright
;       notice, this list of conditions and the following disclaimer in the
;       documentation and/or other materials provided with the distribution,
;       where applicable (as part of a user interface, debugging port, etc.)
;
; THIS SOFTWARE IS PROVIDED BY JEREMY SETH HENRY ``AS IS'' AND ANY
; EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
; WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
; DISCLAIMED. IN NO EVENT SHALL JEREMY SETH HENRY BE LIABLE FOR ANY
; DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
; (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
; ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
; (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
; THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
;
;------------------------------------------------------------------------------
; taskmgr_config.s
;
;  Main Manager task specific constants (this must precede taskmgr_const.s)
;
; Revision History
; Author          Date     Change
;---------------- -------- ----------------------------------------------------
; Seth Henry      7/15/22  Initial Release
;------------------------------------------------------------------------------
 
;------------------------------------------------------------------------------
; Task Management Constants
;------------------------------------------------------------------------------
.DEFINE MAX_TASK_TIMESLICE   $FA       ; Preemption Time slice is 250uS
.DEFINE TASK_COUNT           2         ; Number of defined tasks
;------------------------------------------------------------------------------
 
;------------------------------------------------------------------------------
; Task RAM Placement Constants
;------------------------------------------------------------------------------
; Low memory regions (15:0)
; 0     - System Memory
; 1     - Task  0 Private Memory
; 2     - Task  1 Private Memory
; 3-15 - (Unused)
 
; High memory regions (31:16)
; 16-20 - (Unused)
; 30    - Task  0 Stack Memory
; 31    - Task  1 Stack Memory
 
; Assign each memory region within the 32 write protect blocks using 31 to 0
;  Note that regions from 15 to 0 are "low" memory (don't need to be adjusted
;  for the mask calculation) while regions from 31 to 16 are "high" memory, and
;  should have 16 subtracted to avoid overflowing a 16-bit value.
;
; Note that this implies a maximum task count of 15, as at least one region is
;  required for the task manager itself, unless an additional BRAM is allocated
;  for the task manager.
 
; Variable Memory regions (15:0)
.DEFINE SYSTEM_VAR_RGN    0
.DEFINE TASK0_VAR_RGN     1
.DEFINE TASK1_VAR_RGN     2
 
; Stack Memory regions (31:16)
.DEFINE TASK0_STACK_RGN   30
.DEFINE TASK1_STACK_RGN   31
 
; Note that the WPR masks are handled here in order to add flexibility, such as
;  adding a data buffer region in "high" memory or otherwise configuring a
;  task's WPR for its memory needs
;
; Note that, because of the nature of the WPR, additional memory regions, such
;  as a while region to handle block transfers, can be added by by logically
;  OR'ing the region masks together. Note that the resultant line does need to
;  be on one line or the assembler won't process it correctly.
; ie .DEFINE TASK_VAR_MASK  (2^TASK2_VAR_RGN) | (2^BUF_RGN0) | (2^BUF_RGN1)
 
; Note that the assembler can't generate a 32-bit value for the mask, so for values
;  greater than 15, an offset of 16 is subtracted and the mask value. Thus, there
;  is a "low mask" for regions 0-15 and a "high mask" for regions 16-31. 
.DEFINE HIGH_MEM_OFFSET      16
 
.DEFINE TASK0_WPR_LOW        2^TASK0_VAR_RGN
.DEFINE TASK1_WPR_LOW        2^TASK1_VAR_RGN
 
.DEFINE TASK0_WPR_HIGH       2^( TASK0_STACK_RGN - HIGH_MEM_OFFSET )
.DEFINE TASK1_WPR_HIGH       2^( TASK1_STACK_RGN - HIGH_MEM_OFFSET )
 
; Allocate the variable structures in memory. Note that WP_Rgn_Size is also
;  used in taskmgr_const.s to compute the address of each task's stack start
;  and end
.DEFINE WP_Rgn_Size          RAM_Size / RAM_Partitions ; From sys_hw_map.s
 
.DEFINE SYSTEM_VARMEM        RAM_Address + ( SYSTEM_VAR_RGN * WP_Rgn_Size )
.DEFINE TASK0_VARMEM         RAM_Address + ( TASK0_VAR_RGN  * WP_Rgn_Size )
.DEFINE TASK1_VARMEM         RAM_Address + ( TASK1_VAR_RGN  * WP_Rgn_Size )
 
;------------------------------------------------------------------------------
 
;------------------------------------------------------------------------------
; Task ROM Placement Constants
; Note that the task blocks define the initial location for each task's code
;  and data. If a region overflows, these constants will need to be adjusted.
;------------------------------------------------------------------------------
.DEFINE BOOT_BLOCK           $8000 ; Start of ROM
.DEFINE DATA_BLOCK           $8800 ; ROM Data
.DEFINE TASK0_BLOCK          $9000 ; Task 0
.DEFINE TASK1_BLOCK          $A000 ; Task 1
;------------------------------------------------------------------------------
 
;------------------------------------------------------------------------------
; Task I/O Write Qualification Constants
;------------------------------------------------------------------------------
.DEFINE TASK0_WQL            $00
.DEFINE TASK1_WQL            $00
;------------------------------------------------------------------------------
 
;------------------------------------------------------------------------------
; External I/O Interrupt Flag Macros - processed from within
;  CHECK_EXTERNAL_IO_INTS
;
; Note that the relevant tasks should define macros allowing access to their
;  ISR flag variables and/or other code that should run in supervisor context
;  when the relevant interrupt is triggered.
;
; Note also that only R1 and R0 are safe to use when setting flags. Avoid R7-R2
;  as R3 and R2 are keeping track of flags and R4 through R7 aren't backed up
;------------------------------------------------------------------------------
 
;  0 = (unused)
;  1 = (unused)
;  2 = (unused)
;  3 = (unused)
;  4 = (unused)
;  5 = (unused)
;  6 = (unused)
;  7 = (unused)
;  8 = (unused)
;  9 = (unused)
; 10 = (unused)
; 11 = (unused)
; 12 = (unused)
; 13 = (unused)
; 14 = (unused)
; 15 = (unused)
 
; For 8-bit external interrupt manager, only use the _L constant
.DEFINE EXT_INTERRUPT_EN_L   $00
.DEFINE EXT_INTERRUPT_EN_H   $00
 
; These macros are valid for both the 8 and 16-bit interrupt managers
.MACRO  SET_INT0_FLAGS
.ENDM
 
.MACRO  SET_INT1_FLAGS
.ENDM
 
.MACRO  SET_INT2_FLAGS
.ENDM
 
.MACRO  SET_INT3_FLAGS
.ENDM
 
.MACRO  SET_INT4_FLAGS
.ENDM
 
.MACRO  SET_INT5_FLAGS
.ENDM
 
.MACRO  SET_INT6_FLAGS
.ENDM
 
.MACRO  SET_INT7_FLAGS
.ENDM
 
; These macros are only valid for the 16-bit interrupt manager
.MACRO  SET_INT8_FLAGS
.ENDM
 
.MACRO  SET_INT9_FLAGS
.ENDM
 
.MACRO  SET_INT10_FLAGS
.ENDM
 
.MACRO  SET_INT11_FLAGS
.ENDM
 
.MACRO  SET_INT12_FLAGS
.ENDM
 
.MACRO  SET_INT13_FLAGS
.ENDM
 
.MACRO  SET_INT14_FLAGS
.ENDM
 
.MACRO  SET_INT15_FLAGS
.ENDM
 
;------------------------------------------------------------------------------