File : system-xi-cortexm4-full.ads


   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                        GNAT RUN-TIME COMPONENTS                          --
   4 --                                                                          --
   5 --                               S Y S T E M                                --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                          (ARM Cortex M4 Version)                         --
   9 --                                                                          --
  10 --             Copyright (C) 2015, Free Software Foundation, Inc.           --
  11 --                                                                          --
  12 -- This specification is derived from the Ada Reference Manual for use with --
  13 -- GNAT. The copyright notice above, and the license provisions that follow --
  14 -- apply solely to the  contents of the part following the private keyword. --
  15 --                                                                          --
  16 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  17 -- terms of the  GNU General Public License as published  by the Free Soft- --
  18 -- ware  Foundation;  either version 3,  or (at your option) any later ver- --
  19 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  20 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  21 -- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
  22 --                                                                          --
  23 --                                                                          --
  24 --                                                                          --
  25 --                                                                          --
  26 --                                                                          --
  27 -- You should have received a copy of the GNU General Public License and    --
  28 -- a copy of the GCC Runtime Library Exception along with this program;     --
  29 -- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
  30 -- <http://www.gnu.org/licenses/>.                                          --
  31 --                                                                          --
  32 -- GNAT was originally developed  by the GNAT team at  New York University. --
  33 -- Extensive contributions were provided by Ada Core Technologies Inc.      --
  34 --                                                                          --
  35 ------------------------------------------------------------------------------
  36 
  37 pragma Restrictions (No_Exception_Registration);
  38 --  Disable exception name registration. This capability is not used because
  39 --  it is only required by exception stream attributes which are not supported
  40 --  in this run time.
  41 
  42 pragma Profile (GNAT_Extended_Ravenscar);
  43 --  This is a Ravenscar run time
  44 
  45 pragma Restrictions (No_Task_At_Interrupt_Priority);
  46 --  On Cortex-M, it is not possible to have tasks at Interrupt_Priority, as
  47 --  the context switch is triggered by the Pend_SV interrupt, which is at
  48 --  lowest priority.
  49 
  50 package System is
  51    pragma Pure;
  52    --  Note that we take advantage of the implementation permission to make
  53    --  this unit Pure instead of Preelaborable; see RM 13.7.1(15). In Ada
  54    --  2005, this is Pure in any case (AI-362).
  55 
  56    pragma No_Elaboration_Code_All;
  57    --  Allow the use of that restriction in units that WITH this unit
  58 
  59    type Name is (SYSTEM_NAME_GNAT);
  60    System_Name : constant Name := SYSTEM_NAME_GNAT;
  61 
  62    --  System-Dependent Named Numbers
  63 
  64    Min_Int               : constant := Long_Long_Integer'First;
  65    Max_Int               : constant := Long_Long_Integer'Last;
  66 
  67    Max_Binary_Modulus    : constant := 2 ** Long_Long_Integer'Size;
  68    Max_Nonbinary_Modulus : constant := 2 ** Integer'Size - 1;
  69 
  70    Max_Base_Digits       : constant := Long_Long_Float'Digits;
  71    Max_Digits            : constant := Long_Long_Float'Digits;
  72 
  73    Max_Mantissa          : constant := 63;
  74    Fine_Delta            : constant := 2.0 ** (-Max_Mantissa);
  75 
  76    Tick                  : constant := 0.000_001;
  77 
  78    --  Storage-related Declarations
  79 
  80    type Address is private;
  81    pragma Preelaborable_Initialization (Address);
  82    Null_Address : constant Address;
  83 
  84    Storage_Unit : constant := 8;
  85    Word_Size    : constant := 32;
  86    Memory_Size  : constant := 2 ** 32;
  87 
  88    --  Address comparison
  89 
  90    function "<"  (Left, Right : Address) return Boolean;
  91    function "<=" (Left, Right : Address) return Boolean;
  92    function ">"  (Left, Right : Address) return Boolean;
  93    function ">=" (Left, Right : Address) return Boolean;
  94    function "="  (Left, Right : Address) return Boolean;
  95 
  96    pragma Import (Intrinsic, "<");
  97    pragma Import (Intrinsic, "<=");
  98    pragma Import (Intrinsic, ">");
  99    pragma Import (Intrinsic, ">=");
 100    pragma Import (Intrinsic, "=");
 101 
 102    --  Other System-Dependent Declarations
 103 
 104    type Bit_Order is (High_Order_First, Low_Order_First);
 105    Default_Bit_Order : constant Bit_Order :=
 106                          Bit_Order'Val (Standard'Default_Bit_Order);
 107    pragma Warnings (Off, Default_Bit_Order); -- kill constant condition warning
 108 
 109    --  Priority-related Declarations (RM D.1)
 110 
 111    --  241 .. 255 corresponds to priority level 15 .. 1
 112 
 113    Max_Interrupt_Priority   : constant Positive := 255;
 114    Max_Priority             : constant Positive := 240;
 115 
 116    subtype Any_Priority       is Integer range         0 .. 255;
 117    subtype Priority           is Any_Priority range    0 .. 240;
 118    subtype Interrupt_Priority is Any_Priority range  241 .. 255;
 119 
 120    Default_Priority : constant Priority := 120;
 121 
 122 private
 123 
 124    type Address is mod Memory_Size;
 125    Null_Address : constant Address := 0;
 126 
 127    --------------------------------------
 128    -- System Implementation Parameters --
 129    --------------------------------------
 130 
 131    --  These parameters provide information about the target that is used by
 132    --  the compiler. They are in the private part of System, where they can be
 133    --  accessed using the special circuitry in the Targparm unit whose source
 134    --  should be consulted for more detailed descriptions of the individual
 135    --  switch values.
 136 
 137    Atomic_Sync_Default       : constant Boolean := False;
 138    Backend_Divide_Checks     : constant Boolean := False;
 139    Backend_Overflow_Checks   : constant Boolean := True;
 140    Command_Line_Args         : constant Boolean := False;
 141    Configurable_Run_Time     : constant Boolean := True;
 142    Denorm                    : constant Boolean := False;
 143    Duration_32_Bits          : constant Boolean := False;
 144    Exit_Status_Supported     : constant Boolean := False;
 145    Fractional_Fixed_Ops      : constant Boolean := False;
 146    Frontend_Layout           : constant Boolean := False;
 147    Machine_Overflows         : constant Boolean := False;
 148    Machine_Rounds            : constant Boolean := True;
 149    Preallocated_Stacks       : constant Boolean := True;
 150    Signed_Zeros              : constant Boolean := True;
 151    Stack_Check_Default       : constant Boolean := False;
 152    Stack_Check_Probes        : constant Boolean := False;
 153    Stack_Check_Limits        : constant Boolean := False;
 154    Support_Aggregates        : constant Boolean := True;
 155    Support_Composite_Assign  : constant Boolean := True;
 156    Support_Composite_Compare : constant Boolean := True;
 157    Support_Long_Shifts       : constant Boolean := True;
 158    Always_Compatible_Rep     : constant Boolean := True;
 159    Suppress_Standard_Library : constant Boolean := False;
 160    Use_Ada_Main_Program_Name : constant Boolean := False;
 161    Frontend_Exceptions       : constant Boolean := False;
 162    ZCX_By_Default            : constant Boolean := True;
 163 
 164 end System;