rtems/src/dpmemcreate.c

0001 /* SPDX-License-Identifier: BSD-2-Clause */
0002
0003 /**
0004  * @file
0005  *
0006  * @ingroup RTEMSImplClassicDPMem
0007  *
0008  * @brief This source file contains the implementation of
0009  *   rtems_port_create() and the Dual-Ported Memory Manager system
0010  *   initialization.
0011  */
0012
0013 /*
0014  *  COPYRIGHT (c) 1989-2014.
0015  *  On-Line Applications Research Corporation (OAR).
0016  *
0017  * Redistribution and use in source and binary forms, with or without
0018  * modification, are permitted provided that the following conditions
0019  * are met:
0020  * 1. Redistributions of source code must retain the above copyright
0021  *    notice, this list of conditions and the following disclaimer.
0022  * 2. Redistributions in binary form must reproduce the above copyright
0023  *    notice, this list of conditions and the following disclaimer in the
0024  *    documentation and/or other materials provided with the distribution.
0025  *
0026  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
0027  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
0028  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
0029  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
0030  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
0031  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
0032  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
0033  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
0034  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
0035  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
0036  * POSSIBILITY OF SUCH DAMAGE.
0037  */
0038
0039 #ifdef HAVE_CONFIG_H
0040 #include "config.h"
0041 #endif
0042
0043 #include <rtems/rtems/dpmemimpl.h>
0044 #include <rtems/rtems/status.h>
0045 #include <rtems/rtems/support.h>
0046 #include <rtems/score/address.h>
0047 #include <rtems/score/thread.h>
0048 #include <rtems/sysinit.h>
0049
0050 rtems_status_code rtems_port_create(
0051   rtems_name    name,
0052   void         *internal_start,
0053   void         *external_start,
0054   uint32_t      length,
0055   rtems_id     *id
0056 )
0057 {
0058   Dual_ported_memory_Control *the_port;
0059
0060   if ( !rtems_is_name_valid( name ) )
0061     return RTEMS_INVALID_NAME;
0062
0063   if ( !id )
0064     return RTEMS_INVALID_ADDRESS;
0065
0066   if ( !_Addresses_Is_aligned( internal_start ) ||
0067        !_Addresses_Is_aligned( external_start ) )
0068     return RTEMS_INVALID_ADDRESS;
0069
0070   the_port = _Dual_ported_memory_Allocate();
0071
0072   if ( !the_port ) {
0073     _Objects_Allocator_unlock();
0074     return RTEMS_TOO_MANY;
0075   }
0076
0077   the_port->internal_base = internal_start;
0078   the_port->external_base = external_start;
0079   the_port->length        = length - 1;
0080
0081   *id = _Objects_Open_u32(
0082     &_Dual_ported_memory_Information,
0083     &the_port->Object,
0084     name
0085   );
0086   _Objects_Allocator_unlock();
0087   return RTEMS_SUCCESSFUL;
0088 }
0089
0090 static void _Dual_ported_memory_Manager_initialization( void )
0091 {
0092   _Objects_Initialize_information( &_Dual_ported_memory_Information );
0093 }
0094
0095 RTEMS_SYSINIT_ITEM(
0096   _Dual_ported_memory_Manager_initialization,
0097   RTEMS_SYSINIT_CLASSIC_DUAL_PORTED_MEMORY,
0098   RTEMS_SYSINIT_ORDER_MIDDLE
0099 );