validation/bsps/tr-fatal-sparc-leon3-cache-snooping-disabled-boot.c

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002
0003 /**
0004  * @file
0005  *
0006  * @ingroup BspSparcLeon3ValFatalCacheSnoopingDisabledBoot
0007  */
0008
0009 /*
0010  * Copyright (C) 2021 embedded brains GmbH & Co. KG
0011  *
0012  * Redistribution and use in source and binary forms, with or without
0013  * modification, are permitted provided that the following conditions
0014  * are met:
0015  * 1. Redistributions of source code must retain the above copyright
0016  *    notice, this list of conditions and the following disclaimer.
0017  * 2. Redistributions in binary form must reproduce the above copyright
0018  *    notice, this list of conditions and the following disclaimer in the
0019  *    documentation and/or other materials provided with the distribution.
0020  *
0021  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0022  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0023  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0024  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0025  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0026  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0027  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0028  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0029  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0030  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0031  * POSSIBILITY OF SUCH DAMAGE.
0032  */
0033
0034 /*
0035  * This file is part of the RTEMS quality process and was automatically
0036  * generated.  If you find something that needs to be fixed or
0037  * worded better please post a report or patch to an RTEMS mailing list
0038  * or raise a bug report:
0039  *
0040  * https://www.rtems.org/bugs.html
0041  *
0042  * For information on updating and regenerating please refer to the How-To
0043  * section in the Software Requirements Engineering chapter of the
0044  * RTEMS Software Engineering manual.  The manual is provided as a part of
0045  * a release.  For development sources please refer to the online
0046  * documentation at:
0047  *
0048  * https://docs.rtems.org
0049  */
0050
0051 #ifdef HAVE_CONFIG_H
0052 #include "config.h"
0053 #endif
0054
0055 #include <bsp/fatal.h>
0056 #include <bsp/leon3.h>
0057 #include <rtems/sysinit.h>
0058
0059 #include "tr-fatal-sparc-leon3-cache-snooping-disabled-boot.h"
0060
0061 #include <rtems/test.h>
0062
0063 /**
0064  * @defgroup BspSparcLeon3ValFatalCacheSnoopingDisabledBoot \
0065  *   spec:/bsp/sparc/leon3/val/fatal-cache-snooping-disabled-boot
0066  *
0067  * @ingroup TestsuitesBspsFatalSparcLeon3CacheSnoopingDisabledBoot
0068  *
0069  * @brief Tests a fatal error.
0070  *
0071  * This test case performs the following actions:
0072  *
0073  * - The test action is carried out by the DisableCacheSnooping() system
0074  *   initialization handler.
0075  *
0076  *   - Check that the expected fatal source is present.
0077  *
0078  *   - Check that the expected fatal code is present.
0079  *
0080  * @{
0081  */
0082
0083 /**
0084  * @brief Test context for
0085  *   spec:/bsp/sparc/leon3/val/fatal-cache-snooping-disabled-boot test case.
0086  */
0087 typedef struct {
0088   /**
0089    * @brief This member contains a copy of the corresponding
0090    *   BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Run() parameter.
0091    */
0092   rtems_fatal_source source;
0093
0094   /**
0095    * @brief This member contains a copy of the corresponding
0096    *   BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Run() parameter.
0097    */
0098   rtems_fatal_code code;
0099 } BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Context;
0100
0101 static BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Context
0102   BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Instance;
0103
0104 static void DisableCacheSnooping( void )
0105 {
0106   uint32_t control;
0107
0108   control = leon3_get_cache_control_register();
0109   control &= ~LEON3_REG_CACHE_CTRL_DS;
0110   leon3_set_cache_control_register( control );
0111 }
0112
0113 RTEMS_SYSINIT_ITEM(
0114   DisableCacheSnooping,
0115   RTEMS_SYSINIT_BSP_EARLY,
0116   RTEMS_SYSINIT_ORDER_FIRST
0117 );
0118
0119 static T_fixture BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Fixture = {
0120   .setup = NULL,
0121   .stop = NULL,
0122   .teardown = NULL,
0123   .scope = NULL,
0124   .initial_context = &BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Instance
0125 };
0126
0127 /**
0128  * @brief The test action is carried out by the DisableCacheSnooping() system
0129  *   initialization handler.
0130  */
0131 static void BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Action_0(
0132   BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Context *ctx
0133 )
0134 {
0135   /* Nothing to do */
0136
0137   /*
0138    * Check that the expected fatal source is present.
0139    */
0140   T_step_eq_int( 0, ctx->source, RTEMS_FATAL_SOURCE_BSP );
0141
0142   /*
0143    * Check that the expected fatal code is present.
0144    */
0145   T_step_eq_ulong(
0146     1,
0147     ctx->code,
0148     LEON3_FATAL_INVALID_CACHE_CONFIG_BOOT_PROCESSOR
0149   );
0150 }
0151
0152 void BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Run(
0153   rtems_fatal_source source,
0154   rtems_fatal_code   code
0155 )
0156 {
0157   BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Context *ctx;
0158
0159   ctx = &BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Instance;
0160   ctx->source = source;
0161   ctx->code = code;
0162
0163   ctx = T_case_begin(
0164     "BspSparcLeon3ValFatalCacheSnoopingDisabledBoot",
0165     &BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Fixture
0166   );
0167
0168   T_plan( 2 );
0169
0170   BspSparcLeon3ValFatalCacheSnoopingDisabledBoot_Action_0( ctx );
0171
0172   T_case_end();
0173 }
0174
0175 /** @} */