[PATCH v1 1/2] bsps/shared/ofw: Implement RTEMS OFW interface
Niteesh G. S.
niteesh.gs at gmail.com
Tue Nov 3 02:42:19 UTC 2020
Hello Christian,
On Tue, Nov 3, 2020 at 12:43 AM Christian Mauderer <oss at c-mauderer.de>
wrote:
> Hello Niteesh,
>
> On 02/11/2020 18:06, Niteesh G. S. wrote:
> > ping.
>
> Yes, of course you are right that it would be time to integrate it. The
> nasty part why I haven't started to do something into that direction is
> that we currently still have the old build system and the new in
> parallel. But I think we should start to integrate your code anyway.
>
> Please correct me if I'm wrong: Currently there are two parts:
>
> 1. Adding the OFW interface.
>
> 2. Using in in BBB.
>
> Is that correct?
>
There is also the FreeBSD structures to make porting of drivers easy.
I guess merging this after a thorough inspection should also not be
an issue.
> I think the first one should be not too hard. There are already some
> parts that use only the new build system. Wouldn't be a problem to do
> that with OFW too. So to all participating at the discussion: Is there
> any blocker left why we wouldn't integrate an updated version of the
> patches?
>
The only blocker seen during the development was the license issue.
But that is now resolved since we figured out that all the referenced
code comes under the BSD 2 license.
> The second part is a bit harder. BBB is one of the BSPs that are quite
> entry friendly and therefore it should currently build with old and new
> build system till the old system is removed.
>
OK. I'll wait until the old system gets removed, I still have some work left
to do on the drivers.
Thanks,
Niteesh
Best regards
>
> Christian
>
> >
> > On Thu, Sep 24, 2020 at 9:00 AM Niteesh G. S. <niteesh.gs at gmail.com
> > <mailto:niteesh.gs at gmail.com>> wrote:
> >
> > Hello,
> >
> > On Sat, Sep 19, 2020 at 4:13 PM Christian Mauderer
> > <oss at c-mauderer.de <mailto:oss at c-mauderer.de>> wrote:
> >
> > Hello Niteesh,
> >
> > sorry for adding another delay: I think the new build system
> > needs a bit
> > of time to settle. As soon as there are some more PASS in the
> > table that
> > Sebastian created [1] (especially for beagle) we should try to
> > get these
> > patches merged. Before that I would like to avoid big changes
> > because it
> > might get hard to distinguish new bugs from build system bugs.
> >
> >
> > No problem. Currently, I have my university exams going on and also
> I am
> > waiting for my logic analyzer. As soon as it arrives I'll start
> > verifying the previous
> > drivers and finish refactoring the other ones.
> >
> > Thanks,
> > Niteesh.
> >
> >
> >
> >
> > Best regards
> >
> > Christian
> >
> > [1] https://devel.rtems.org/wiki/Release/6/Waf%20BSP%20Checklist
> >
> > On 16/09/2020 19:05, Niteesh G. S. wrote:
> > > Hello,
> > >
> > > Sorry for the delay, I was a bit occupied with my university
> work.
> > > Now since the new build system is merged I would like to get my
> > > GSoC work merged too.
> > >
> > > The goal of this series patches is to implement the OFW API
> > into RTEMS
> > > and modify libBSD to use this RTEMS API instead of its own.
> > >
> > > Thanks,
> > > Niteesh.
> > >
> > > On Wed, Sep 16, 2020 at 10:33 PM G S Niteesh Babu
> > <niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com>
> > > <mailto:niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com>>>
> > wrote:
> > >
> > > RTEMS OFW is a FDT only implementation of the OpenFirmWare
> > > interface. This API is created to be compatible with
> FreeBSD
> > > OpenFirmWare interface. The main intention is to make
> > > porting of FreeBSD drivers to RTEMS easier.
> > >
> > > Most functions implemented have an direct one-one mapping
> > > with the original OFW API and some extra auxiliary
> functions
> > > were implemented to make working with device trees easier
> in
> > > RTEMS.
> > >
> > > Update #3784
> > > ---
> > > bsps/include/ofw/ofw.h | 548
> > +++++++++++++++++++++++++++
> > > bsps/include/ofw/ofw_compat.h | 74 ++++
> > > bsps/shared/ofw/ofw.c | 682
> > ++++++++++++++++++++++++++++++++++
> > > spec/build/bsps/obj.yml | 5 +
> > > 4 files changed, 1309 insertions(+)
> > > create mode 100644 bsps/include/ofw/ofw.h
> > > create mode 100644 bsps/include/ofw/ofw_compat.h
> > > create mode 100644 bsps/shared/ofw/ofw.c
> > >
> > > diff --git a/bsps/include/ofw/ofw.h
> b/bsps/include/ofw/ofw.h
> > > new file mode 100644
> > > index 0000000000..411010be89
> > > --- /dev/null
> > > +++ b/bsps/include/ofw/ofw.h
> > > @@ -0,0 +1,548 @@
> > > +/* SPDX-License-Identifier: BSD-2-Clause */
> > > +
> > > +/**
> > > + * @file
> > > + *
> > > + * @ingroup ofw
> > > + *
> > > + * RTEMS FDT implementation of OpenFirmWare Interface.
> > > + *
> > > + * RTEMS OFW is a FDT only implementation of the
> OpenFirmWare
> > > interface.
> > > + * This API is created to be compatible with FreeBSD
> > OpenFirmWare
> > > interface.
> > > + * The main intention is to make porting of FreeBSD
> > drivers to
> > > RTEMS easier.
> > > + */
> > > +
> > > +/*
> > > + * Copyright (C) 2020 Niteesh Babu G S
> > <niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com>
> > > <mailto:niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com
> >>>
> > > + *
> > > + * Redistribution and use in source and binary forms,
> > with or without
> > > + * modification, are permitted provided that the
> > following conditions
> > > + * are met:
> > > + * 1. Redistributions of source code must retain the
> > above copyright
> > > + * notice, this list of conditions and the following
> > disclaimer.
> > > + * 2. 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.
> > > + *
> > > + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
> > > CONTRIBUTORS "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 THE COPYRIGHT OWNER
> OR
> > > CONTRIBUTORS 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.
> > > + */
> > > +
> > > +#ifndef _OFW_H
> > > +#define _OFW_H
> > > +
> > > +#ifdef __cplusplus
> > > +extern "C" {
> > > +#endif
> > > +
> > > +#include <rtems.h>
> > > +#include <stdint.h>
> > > +#include <sys/types.h>
> > > +
> > > +/**
> > > + * Represents a node in the device tree. The offset from
> > fdtp to
> > > node is used
> > > + * instead of fdt offset to make sure this is compatible
> > with OF
> > > interface in
> > > + * FreeBSD.
> > > + */
> > > +typedef uint32_t phandle_t;
> > > +/**
> > > + * Represents the effective phandle of the node.
> > > + */
> > > +typedef uint32_t ihandle_t;
> > > +/**
> > > + * Represents the data type of the buffer.
> > > + */
> > > +typedef uint32_t pcell_t;
> > > +
> > > +/**
> > > + * @struct rtems_ofw_memory_area
> > > + *
> > > + * This is used to represent elements(FDT properties)
> > that define
> > > + * region of memory address.
> > > + */
> > > +typedef struct {
> > > + /** The start address of the memory region. */
> > > + uint32_t start;
> > > + /** The size of the memory region. */
> > > + uint32_t size;
> > > +} rtems_ofw_memory_area;
> > > +
> > > +/**
> > > + * @struct rtems_ofw_ranges
> > > + *
> > > + * This is used to represent the ranges property in the
> > device tree.
> > > + */
> > > +typedef struct {
> > > + /** The physical address within the child bus address
> > space */
> > > + uint32_t child_bus;
> > > + /** The physical address within the parent bus address
> > space */
> > > + uint32_t parent_bus;
> > > + /** The size of the range in the child’s address space
> */
> > > + uint32_t size;
> > > +} rtems_ofw_ranges;
> > > +
> > > +/**
> > > + * @brief Gets the node that is next to @a node.
> > > + *
> > > + * @param[in] node Node offset
> > > + *
> > > + * @retval Peer node offset Successful operation.
> > > + * @retval 0 No peer node or invalid node handle
> > > + */
> > > +phandle_t rtems_ofw_peer(
> > > + phandle_t node
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the node that is the child of @a node.
> > > + *
> > > + * @param[in] node Node offset
> > > + *
> > > + * @retval child node offset Successful operation.
> > > + * @retval 0 No child node or invalid node handle
> > > + */
> > > +phandle_t rtems_ofw_child(
> > > + phandle_t node
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the node that is the parent of @a node.
> > > + *
> > > + * @param[in] node Node offset
> > > + *
> > > + * @retval child node offset Successful operation.
> > > + * @retval 0 No child node or invalid node handle
> > > + */
> > > +phandle_t rtems_ofw_parent(
> > > + phandle_t node
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the length of the property mentioned in @a
> > propname.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] prop Property name
> > > + *
> > > + * @retval -1 Invalid node or property
> > > + * @retval Length of property on successful operation
> > > + */
> > > +ssize_t rtems_ofw_get_prop_len(
> > > + phandle_t node,
> > > + const char *propname
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the value of property mentioned in @a
> > propname.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] prop Property name
> > > + * @param[out] buf The property value gets stored in this
> > buffer
> > > (Pre-allocated)
> > > + * @param[in] len Length of the buffer
> > > +
> > > + * @retval -1 Invalid node or property
> > > + * @retval Length of property on successful operation
> > > + */
> > > +ssize_t rtems_ofw_get_prop(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the value of property mentioned in @a prop.
> > > + *
> > > + * Gets the value of property of @a node and converts the
> > value
> > > into the host's
> > > + * endianness.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] prop Property name
> > > + * @param[out] buf The property value gets stored in this
> > > buffer(Pre-allocated)
> > > + * after converted to the host's endianness
> > > + * @param[in] len Length of the buffer
> > > + *
> > > + * @retval -1 Invalid node or property
> > > + * @retval Length of property on successful operation
> > > + */
> > > +ssize_t rtems_ofw_get_enc_prop(
> > > + phandle_t node,
> > > + const char *prop,
> > > + pcell_t *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Checks if the property @a propname is present
> > in @a node.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + *
> > > + * @retval 0 Property not present.
> > > + * @retval 1 Property is present.
> > > + */
> > > +int rtems_ofw_has_prop(
> > > + phandle_t node,
> > > + const char *propname
> > > +);
> > > +
> > > +/**
> > > + * @brief Searches for property @a propname in @a node.
> > > + *
> > > + * Searches the node and its parent recursively for the
> > property
> > > and fills the
> > > + * buffer with the first found value.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + * @param[out] buf The property value gets stored in this
> > buffer
> > > (Pre-allocated)
> > > + * @param[in] len Length of the buffer
> > > + *
> > > + * @retval Length of the property if property is found.
> > > + * @retval -1 Property is not found.
> > > + */
> > > +ssize_t rtems_ofw_search_prop(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Searches for property @a propname in @a node.
> > > + *
> > > + * Searches the node and its parent recursively for the
> > property
> > > and fills the
> > > + * buffer with the first value found after converting it
> > to the
> > > endianness of
> > > + * the host.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + * @param[out] buf The property value gets stored in this
> > > buffer(Pre-allocated)
> > > + * after converted to the host's endianness
> > > + * @param[in] len Length of the buffer
> > > + *
> > > + * @retval Length of the property if property is found.
> > > + * @retval -1 Property is not found.
> > > + */
> > > +ssize_t rtems_ofw_search_enc_prop(
> > > + phandle_t node,
> > > + const char *propname,
> > > + pcell_t *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the value of property mentioned in @a
> > propname.
> > > + *
> > > + * Same as rtems_ofw_getprop, but the @a buf is allocated
> > in this
> > > routine and
> > > + * the user is responsible for freeing it.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + * @param[out] buf The buffer is allocated in this
> > routine and user is
> > > + * responsible for freeing.
> > > + *
> > > + * @retval -1 Property is not found.
> > > + * @retval Length of the property if property is found.
> > > + */
> > > +ssize_t rtems_ofw_get_prop_alloc(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void **buf
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets multiple values of the property @a
> propname.
> > > + *
> > > + * Same as rtems_ofw_getprop_alloc but it can read
> > properties with
> > > multiple
> > > + * values.
> > > + * For eg: reg = <0x1000 0x10 0x2000 0x20>
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + * @param[in] elsz Size of the single value
> > > + * @param[out] buf The buffer is allocated in this
> > routine and user is
> > > + * responsible for freeing.
> > > + *
> > > + * @retval -1 Property is not found.
> > > + * @retval Number of values read.
> > > + */
> > > +ssize_t rtems_ofw_get_prop_alloc_multi(
> > > + phandle_t node,
> > > + const char *propname,
> > > + int elsz,
> > > + void **buf
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets the value of property mentioned in @a
> > propname.
> > > + *
> > > + * Same as rtems_ofw_getprop_alloc but the value stored
> > in the
> > > buffer is
> > > + * converted into the host's endianness.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + * @param[out] buf The buffer is allocated in this
> > routine and user is
> > > + * responsible for freeing.
> > > + *
> > > + * @retval -1 Property is not found.
> > > + * @retval Length of the property if property is found.
> > > + */
> > > +ssize_t rtems_ofw_get_enc_prop_alloc(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void **buf
> > > +);
> > > +
> > > +/**
> > > + * @brief Gets multiple values of the property @a
> propname.
> > > + *
> > > + * Same as rtems_ofw_getprop_alloc_multi but the values
> > stored in
> > > the buffer
> > > + * are converted to the host's endianness.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] propname Property name
> > > + * @param[in] elsz Size of the single value
> > > + * @param[out] buf The buffer is allocated in this
> > routine and user is
> > > + * responsible for freeing.
> > > + *
> > > + * @retval -1 Property is not found.
> > > + * @retval Number of values read.
> > > + */
> > > +ssize_t rtems_ofw_get_enc_prop_alloc_multi(
> > > + phandle_t node,
> > > + const char *propname,
> > > + int elsz,
> > > + void **buf
> > > +);
> > > +
> > > +/**
> > > + * @brief Free's the buffers allocated by the
> > rtems_ofw_*_alloc
> > > functions.
> > > + *
> > > + * @param[in] buf Buffer to be freed
> > > + */
> > > +void rtems_ofw_free(
> > > + void *buf
> > > +);
> > > +
> > > +/**
> > > + * @brief Finds the next property of @a node.
> > > + *
> > > + * Finds the next property of the node and when @a
> > propname is NULL
> > > it returns
> > > + * the value in the first property.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] previous Previous property name
> > > + * @param[out] buf The value of the next property gets
> > stored in
> > > this buffer
> > > + * (Pre-allocated)
> > > + * @param[in] len Length of the buffer
> > > + *
> > > + * @retval -1 node or previous property does not exist
> > > + * @retval 0 no more properties
> > > + * @retval 1 success
> > > + */
> > > +int rtems_ofw_next_prop(
> > > + phandle_t node,
> > > + const char *previous,
> > > + char *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Sets the property @name of @a node to @a buf.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[in] name Property name
> > > + * @param[in] buf Buffer contains the value to be set.
> > > + * @param[in] len Length of the buffer
> > > + *
> > > + * @retval -1 node does not exist
> > > + * @retval 0 on success
> > > + * @retval libFDT error codes on unsuccessful setting
> > operation
> > > + */
> > > +int rtems_ofw_set_prop(
> > > + phandle_t node,
> > > + const char *name,
> > > + const void *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Converts a device specifier to a fully
> > qualified path name.
> > > + *
> > > + * @param[in] dev device specifier
> > > + * @param[out] buf The path is filled into the
> > buffer(Pre-allocated)
> > > + * @param[in] length of the buffer
> > > + *
> > > + * @retval -1 always. Unimplemented.
> > > + */
> > > +ssize_t rtems_ofw_canon(
> > > + const char *dev,
> > > + char *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Finds the node at the given path
> > > + *
> > > + * @param[in] path to the node from root
> > > + *
> > > + * @retval -1 node does not exist
> > > + * @retval node handle on success
> > > + */
> > > +phandle_t rtems_ofw_find_device(
> > > + const char *path
> > > +);
> > > +
> > > +/**
> > > + * @brief This routine converts effective phandle @a xref
> > to node
> > > offset.
> > > + *
> > > + * @param[in] xref Node phandle
> > > + *
> > > + * @retval Node offset on success
> > > + * @retval Node phandle on failure
> > > + */
> > > +phandle_t rtems_ofw_node_from_xref(
> > > + phandle_t xref
> > > +);
> > > +
> > > +/**
> > > + * @brief This routine converts node offset to effective
> > phandle of
> > > @a node.
> > > + *
> > > + * @retval Node phandle on success
> > > + * @retval Node offset on failure
> > > + */
> > > +phandle_t rtems_ofw_xref_from_node(
> > > + phandle_t node
> > > +);
> > > +
> > > +/*
> > > + * instance handles(ihandle_t) as same as phandles in the
> FDT
> > > implementation
> > > + * of OF interface.
> > > + */
> > > +
> > > +/**
> > > + * @brief Converts @a instance handle to phandle.
> > > + *
> > > + * instance are same as node offsets in FDT.
> > > + *
> > > + * @param[in] instance Node offset
> > > + *
> > > + * @retval phandle of node on success.
> > > + * @retval instance of node on failure.
> > > + */
> > > +phandle_t rtems_ofw_instance_to_package(
> > > + ihandle_t instance
> > > +);
> > > +
> > > +/**
> > > + * @brief Find the node's path from phandle.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[out] buf Path is filled into this
> > buffer(Pre-allocated).
> > > + * @param[in] len Length of the buffer.
> > > + *
> > > + * @retval -1 always. Unimplemented.
> > > + */
> > > +ssize_t rtems_ofw_package_to_path(
> > > + phandle_t node,
> > > + char *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Find the node's path from ihandle.
> > > + *
> > > + * @param[in] instance Node offset
> > > + * @param[out] buf Path is filled into this
> > buffer(Pre-allocated).
> > > + * @param[in] len Length of the buffer.
> > > + *
> > > + * @retval -1 always. Unimplemented.
> > > + */
> > > +ssize_t rtems_ofw_instance_to_path(
> > > + ihandle_t instance,
> > > + char *buf,
> > > + size_t len
> > > +);
> > > +
> > > +/**
> > > + * @brief Queries the node's reg value.
> > > + *
> > > + * This routine fills the buffer @a buf with the values
> > in reg
> > > property of node
> > > + * @a node. It reads all the values of the property and
> > fills the
> > > buffer to max
> > > + * size.
> > > + * This routine is local to RTEMS OFW and does not have an
> > > corresponding
> > > + * FreeBSD OFW pair.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[out] buf Register values are stored in this
> > > buffer(Pre-allocated).
> > > + * @param[in] size Length of the buffer.
> > > + *
> > > + * @retval -1 If reg property is missing.
> > > + * @retval Length of the reg property in bytes.
> > > + */
> > > +int rtems_ofw_get_reg(
> > > + phandle_t node,
> > > + rtems_ofw_memory_area *buf,
> > > + size_t size
> > > +);
> > > +
> > > +/**
> > > + * @brief Queries the node's interrupt value.
> > > + *
> > > + * This routine fills the buffer @a buf with the
> > interrupt number.
> > > In case of
> > > + * multiple numbers it fills the buffer to its full
> extent.
> > > + * This routine is local to RTEMS OFW and does not have an
> > > corresponding
> > > + * FreeBSD OFW pair.
> > > + *
> > > + * @param[in] node Node offset
> > > + * @param[out] buf Interrupt values are stored in this
> > > buffer(Pre-allocated).
> > > + * @param[in] size Length of the buffer.
> > > + *
> > > + * @retval -1 If interrupts property is missing.
> > > + * @retval The number of interrupt numbers read.
> > > + */
> > > +int rtems_ofw_get_interrupts(
> > > + phandle_t node,
> > > + rtems_vector_number *buf,
> > > + size_t size
> > > +);
> > > +
> > > +/**
> > > + * @brief Queries the node's status.
> > > + *
> > > + * This routine is local to RTEMS OFW and does not have an
> > > corresponding
> > > + * FreeBSD OFW pair.
> > > + *
> > > + * @param[in] node Node offset
> > > + *
> > > + * @retval true Status is OK or empty.
> > > + * @retval false Status is not OK or missing.
> > > + */
> > > +bool rtems_ofw_node_status( phandle_t node );
> > > +
> > > +/**
> > > + * @brief Gets node phandle from compatible property.
> > > + *
> > > + * This routine is local to RTEMS OFW and does not have an
> > > corresponding
> > > + * FreeBSD OFW pair.
> > > + *
> > > + * @param[in] compat Compatible string
> > > + *
> > > + * @retval 0 Node with @a compat as compatible string not
> > found
> > > + * @retval Node phandle on success.
> > > + */
> > > +phandle_t rtems_ofw_find_device_by_compat( const char
> > *compat );
> > > +
> > > +#ifdef __cplusplus
> > > +}
> > > +#endif
> > > +
> > > +#endif /* _OFW_H */
> > > diff --git a/bsps/include/ofw/ofw_compat.h
> > > b/bsps/include/ofw/ofw_compat.h
> > > new file mode 100644
> > > index 0000000000..be4a5ea3ce
> > > --- /dev/null
> > > +++ b/bsps/include/ofw/ofw_compat.h
> > > @@ -0,0 +1,74 @@
> > > +/* SPDX-License-Identifier: BSD-2-Clause */
> > > +
> > > +/**
> > > + * @file
> > > + *
> > > + * @ingroup ofw
> > > + *
> > > + * This file defines necessary symbols to make the RTEMS
> > OFW API
> > > compatible
> > > + * with FreeBSD OFW.
> > > + */
> > > +
> > > +/*
> > > + * Copyright (C) 2020 Niteesh Babu G S
> > <niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com>
> > > <mailto:niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com
> >>>
> > > + *
> > > + * Redistribution and use in source and binary forms,
> > with or without
> > > + * modification, are permitted provided that the
> > following conditions
> > > + * are met:
> > > + * 1. Redistributions of source code must retain the
> > above copyright
> > > + * notice, this list of conditions and the following
> > disclaimer.
> > > + * 2. 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.
> > > + *
> > > + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
> > > CONTRIBUTORS "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 THE COPYRIGHT OWNER
> OR
> > > CONTRIBUTORS 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.
> > > + */
> > > +
> > > +#ifndef _OFW_COMPAT_H
> > > +#define _OFW_COMPAT_H
> > > +
> > > +#ifdef __cplusplus
> > > +extern "C" {
> > > +#endif
> > > +
> > > +#include <ofw/ofw.h>
> > > +
> > > +#define OF_peer rtems_ofw_peer
> > > +#define OF_child rtems_ofw_child
> > > +#define OF_parent rtems_ofw_parent
> > > +#define OF_getproplen rtems_ofw_get_prop_len
> > > +#define OF_getprop rtems_ofw_get_prop
> > > +#define OF_getencprop rtems_ofw_get_enc_prop
> > > +#define OF_hasprop rtems_ofw_has_prop
> > > +#define OF_searchprop rtems_ofw_search_prop
> > > +#define OF_searchencprop
> rtems_ofw_search_enc_prop
> > > +#define OF_getprop_alloc rtems_ofw_get_prop_alloc
> > > +#define OF_getprop_alloc_multi
> > rtems_ofw_get_prop_alloc_multi
> > > +#define OF_getencprop_alloc_multi
> > rtems_ofw_get_enc_prop_alloc_multi
> > > +#define OF_getencprop_alloc
> > rtems_ofw_get_enc_prop_alloc
> > > +#define OF_prop_free rtems_ofw_free
> > > +#define OF_nextprop rtems_ofw_next_prop
> > > +#define OF_setprop rtems_ofw_set_prop
> > > +#define OF_canon rtems_ofw_canon
> > > +#define OF_finddevice rtems_ofw_find_device
> > > +#define OF_package_to_path
> rtems_ofw_package_to_path
> > > +#define OF_node_from_xref rtems_ofw_node_from_xref
> > > +#define OF_xref_from_node rtems_ofw_xref_from_node
> > > +#define OF_instance_to_package
> > rtems_ofw_instance_to_package
> > > +#define OF_instance_to_path
> rtems_ofw_instance_to_path
> > > +
> > > +#ifdef __cplusplus
> > > +}
> > > +#endif
> > > +
> > > +#endif /* _OFW_COMPAT_H */
> > > diff --git a/bsps/shared/ofw/ofw.c b/bsps/shared/ofw/ofw.c
> > > new file mode 100644
> > > index 0000000000..2b1dff8bf8
> > > --- /dev/null
> > > +++ b/bsps/shared/ofw/ofw.c
> > > @@ -0,0 +1,682 @@
> > > +/* SPDX-License-Identifier: BSD-2-Clause */
> > > +
> > > +/**
> > > + * @file
> > > + *
> > > + * @ingroup ofw
> > > + */
> > > +
> > > +/*
> > > + * Copyright (C) 2020 Niteesh Babu G S
> > <niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com>
> > > <mailto:niteesh.gs at gmail.com <mailto:niteesh.gs at gmail.com
> >>>
> > > + *
> > > + * Redistribution and use in source and binary forms,
> > with or without
> > > + * modification, are permitted provided that the
> > following conditions
> > > + * are met:
> > > + * 1. Redistributions of source code must retain the
> > above copyright
> > > + * notice, this list of conditions and the following
> > disclaimer.
> > > + * 2. 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.
> > > + *
> > > + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
> > > CONTRIBUTORS "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 THE COPYRIGHT OWNER
> OR
> > > CONTRIBUTORS 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.
> > > + */
> > > +
> > > +#ifdef HAVE_CONFIG_H
> > > +#include "config.h"
> > > +#endif
> > > +
> > > +#include <bsp/fdt.h>
> > > +#include <sys/param.h>
> > > +#include <ofw/ofw.h>
> > > +#include <libfdt.h>
> > > +#include <assert.h>
> > > +#include <rtems/sysinit.h>
> > > +
> > > +const void *fdtp = NULL;
> > > +
> > > +static phandle_t rtems_fdt_offset_to_phandle( int offset )
> > > +{
> > > + if (offset < 0) {
> > > + return 0;
> > > + }
> > > +
> > > + return (phandle_t)offset + fdt_off_dt_struct(fdtp);
> > > +}
> > > +
> > > +static int rtems_fdt_phandle_to_offset( phandle_t handle )
> > > +{
> > > + int off;
> > > + int fdt_off;
> > > +
> > > + off = (int) handle;
> > > + fdt_off = fdt_off_dt_struct(fdtp);
> > > +
> > > + if (off < fdt_off) {
> > > + return -1;
> > > +
> > > + }
> > > +
> > > + return off - fdt_off;
> > > +}
> > > +
> > > +static void rtems_ofw_init( void ) {
> > > + int rv;
> > > + const void *fdt;
> > > +
> > > + fdt = bsp_fdt_get();
> > > +
> > > + rv = fdt_check_header(fdt);
> > > +
> > > + /*
> > > + * If the FDT is invalid exit through fatal.
> > > + */
> > > + if (rv != 0) {
> > > + rtems_fatal_error_occurred(RTEMS_NOT_CONFIGURED);
> > > + }
> > > +
> > > + fdtp = fdt;
> > > +}
> > > +
> > > +RTEMS_SYSINIT_ITEM(
> > > + rtems_ofw_init,
> > > + RTEMS_SYSINIT_BSP_PRE_DRIVERS,
> > > + RTEMS_SYSINIT_ORDER_FIRST
> > > +);
> > > +
> > > +phandle_t rtems_ofw_peer( phandle_t node )
> > > +{
> > > + int offset;
> > > +
> > > + if (node == 0) {
> > > + int root = fdt_path_offset(fdtp, "/");
> > > + return rtems_fdt_offset_to_phandle(root);
> > > + }
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > + if (offset < 0) {
> > > + return 0;
> > > + }
> > > +
> > > + offset = fdt_next_subnode(fdtp, offset);
> > > + return rtems_fdt_offset_to_phandle(offset);
> > > +}
> > > +
> > > +phandle_t rtems_ofw_child( phandle_t node )
> > > +{
> > > + int offset;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + if (offset < 0) {
> > > + return 0;
> > > + }
> > > +
> > > + offset = fdt_first_subnode(fdtp, offset);
> > > + return rtems_fdt_offset_to_phandle(offset);
> > > +}
> > > +
> > > +phandle_t rtems_ofw_parent( phandle_t node )
> > > +{
> > > + int offset;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + if (offset < 0) {
> > > + return 0;
> > > + }
> > > +
> > > + offset = fdt_parent_offset(fdtp, offset);
> > > + return rtems_fdt_offset_to_phandle(offset);
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_prop_len(
> > > + phandle_t node,
> > > + const char *propname
> > > +)
> > > +{
> > > + int offset;
> > > + int len;
> > > + const void *prop;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + if (offset < 0) {
> > > + return -1;
> > > + }
> > > +
> > > + prop = fdt_getprop(fdtp, offset, propname, &len);
> > > +
> > > + if (prop == NULL && strcmp(propname, "name") == 0) {
> > > + fdt_get_name(fdtp, offset, &len);
> > > + return len + 1;
> > > + }
> > > +
> > > + if (prop == NULL && strcmp(propname, "/chosen") == 0) {
> > > + if (strcmp(propname, "fdtbootcpu") == 0)
> > > + return sizeof(pcell_t);
> > > + if (strcmp(propname, "fdtmemreserv") == 0)
> > > + return 2 * sizeof(uint64_t) * fdt_num_mem_rsv(fdtp);
> > > + }
> > > +
> > > + if (prop == NULL) {
> > > + return -1;
> > > + }
> > > +
> > > + return len;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_prop(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void *buf,
> > > + size_t bufsize
> > > +)
> > > +{
> > > + const void *prop;
> > > + int offset;
> > > + int len;
> > > + uint32_t cpuid;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + if (offset < 0) {
> > > + return -1;
> > > + }
> > > +
> > > + prop = fdt_getprop(fdtp, offset, propname, &len);
> > > +
> > > + if (prop == NULL && strcmp(propname, "name") == 0) {
> > > + prop = fdt_get_name(fdtp, offset, &len);
> > > + strncpy(buf, prop, bufsize);
> > > + return len + 1;
> > > + }
> > > +
> > > + if (prop == NULL && strcmp(propname, "/chosen") == 0) {
> > > + if (strcmp(propname, "fdtbootcpu") == 0) {
> > > + cpuid = cpu_to_fdt32(fdt_boot_cpuid_phys(fdtp));
> > > + len = sizeof(cpuid);
> > > + prop = &cpuid;
> > > + }
> > > + if (strcmp(propname, "fdtmemreserv") == 0) {
> > > + prop = (char *)fdtp + fdt_off_mem_rsvmap(fdtp);
> > > + len = sizeof(uint64_t)*2*fdt_num_mem_rsv(fdtp);
> > > + }
> > > + }
> > > +
> > > + if (prop == NULL) {
> > > + return -1;
> > > + }
> > > +
> > > + bcopy(prop, buf, MIN(len, bufsize));
> > > +
> > > + return len;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_enc_prop(
> > > + phandle_t node,
> > > + const char *prop,
> > > + pcell_t *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + ssize_t rv;
> > > +
> > > + assert(len % 4 == 0);
> > > + rv = rtems_ofw_get_prop(node, prop, buf, len);
> > > +
> > > + if (rv < 0) {
> > > + return rv;
> > > + }
> > > +
> > > + for (int i = 0; i < (len / 4); i++) {
> > > + buf[i] = fdt32_to_cpu(buf[i]);
> > > + }
> > > +
> > > + return rv;
> > > +}
> > > +
> > > +int rtems_ofw_has_prop(
> > > + phandle_t node,
> > > + const char *propname
> > > +)
> > > +{
> > > + ssize_t rv;
> > > +
> > > + rv = rtems_ofw_get_prop_len(node, propname);
> > > + return rv >= 0 ? 1 : 0;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_search_prop(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + ssize_t rv;
> > > +
> > > + for (; node != 0; node = rtems_ofw_parent(node)) {
> > > + if ((rv = rtems_ofw_get_prop(node, propname, buf,
> > len) != -1)) {
> > > + return rv;
> > > + }
> > > + }
> > > +
> > > + return -1;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_search_enc_prop(
> > > + phandle_t node,
> > > + const char *propname,
> > > + pcell_t *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + ssize_t rv;
> > > +
> > > + for (; node != 0; node = rtems_ofw_parent(node)) {
> > > + if ((rv = rtems_ofw_get_enc_prop(node, propname, buf,
> > len) !=
> > > -1)) {
> > > + return rv;
> > > + }
> > > + }
> > > +
> > > + return -1;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_prop_alloc(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void **buf
> > > +)
> > > +{
> > > + ssize_t len;
> > > +
> > > + *buf = NULL;
> > > + if ((len = rtems_ofw_get_prop_len(node, propname)) ==
> -1) {
> > > + return -1;
> > > + }
> > > +
> > > + if (len > 0) {
> > > + *buf = malloc(len);
> > > + if (*buf == NULL) {
> > > + return -1;
> > > + }
> > > +
> > > + if (rtems_ofw_get_prop(node, propname, *buf, len) ==
> > -1) {
> > > + rtems_ofw_free(buf);
> > > + *buf = NULL;
> > > + return -1;
> > > + }
> > > + }
> > > +
> > > + return len;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_prop_alloc_multi(
> > > + phandle_t node,
> > > + const char *propname,
> > > + int elsz,
> > > + void **buf
> > > +)
> > > +{
> > > + ssize_t len;
> > > +
> > > + *buf = NULL;
> > > + if ((len = rtems_ofw_get_prop_len(node, propname)) ==
> -1 ||
> > > + (len % elsz != 0)) {
> > > + return -1;
> > > + }
> > > +
> > > + if (len > 0) {
> > > + *buf = malloc(len);
> > > + if (*buf == NULL) {
> > > + return -1;
> > > + }
> > > +
> > > + if (rtems_ofw_get_prop(node, propname, *buf, len) ==
> > -1) {
> > > + rtems_ofw_free(buf);
> > > + *buf = NULL;
> > > + return -1;
> > > + }
> > > + }
> > > +
> > > + return (len / elsz);
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_enc_prop_alloc(
> > > + phandle_t node,
> > > + const char *propname,
> > > + void **buf
> > > +)
> > > +{
> > > + ssize_t len;
> > > +
> > > + *buf = NULL;
> > > + if ((len = rtems_ofw_get_prop_len(node, propname)) ==
> -1) {
> > > + return -1;
> > > + }
> > > +
> > > + if (len > 0) {
> > > + *buf = malloc(len);
> > > + if (*buf == NULL) {
> > > + return -1;
> > > + }
> > > +
> > > + if (rtems_ofw_get_enc_prop(node, propname, *buf, len)
> > == -1) {
> > > + rtems_ofw_free(buf);
> > > + *buf = NULL;
> > > + return -1;
> > > + }
> > > + }
> > > +
> > > + return len;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_get_enc_prop_alloc_multi(
> > > + phandle_t node,
> > > + const char *propname,
> > > + int elsz,
> > > + void **buf
> > > +)
> > > +{
> > > + ssize_t len;
> > > +
> > > + *buf = NULL;
> > > + if ((len = rtems_ofw_get_prop_len(node, propname)) ==
> -1 ||
> > > + (len % elsz != 0)) {
> > > + return -1;
> > > + }
> > > +
> > > + if (len > 0) {
> > > + *buf = malloc(len);
> > > + if (*buf == NULL) {
> > > + return -1;
> > > + }
> > > +
> > > + if (rtems_ofw_get_enc_prop(node, propname, *buf, len)
> > == -1) {
> > > + rtems_ofw_free(buf);
> > > + *buf = NULL;
> > > + return -1;
> > > + }
> > > + }
> > > +
> > > + return (len / elsz);
> > > +}
> > > +
> > > +void rtems_ofw_free( void *buf )
> > > +{
> > > + free(buf);
> > > +}
> > > +
> > > +int rtems_ofw_next_prop(
> > > + phandle_t node,
> > > + const char *previous,
> > > + char *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + const void *name;
> > > + const void *prop;
> > > + int offset;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + if (offset < 0) {
> > > + return -1;
> > > + }
> > > +
> > > + if (previous == NULL) {
> > > + offset = fdt_first_property_offset(fdtp, offset);
> > > + } else {
> > > + fdt_for_each_property_offset(offset, fdtp, offset) {
> > > + prop = fdt_getprop_by_offset(fdtp, offset, (const
> char
> > > **)&name, NULL);
> > > + if (prop == NULL)
> > > + return -1;
> > > +
> > > + if (strcmp(previous, name) != 0)
> > > + continue;
> > > +
> > > + offset = fdt_next_property_offset(fdtp, offset);
> > > + break;
> > > + }
> > > + }
> > > +
> > > + if (offset < 0)
> > > + return 0;
> > > +
> > > + prop = fdt_getprop_by_offset(fdtp, offset, (const char
> > **)&name,
> > > &offset);
> > > + if (prop == NULL)
> > > + return -1;
> > > +
> > > + strncpy(buf, name, len);
> > > +
> > > + return 1;
> > > +}
> > > +
> > > +int rtems_ofw_set_prop(
> > > + phandle_t node,
> > > + const char *name,
> > > + const void *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + int offset;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + if (offset < 0)
> > > + return -1;
> > > +
> > > + if (fdt_setprop_inplace(fdtp, offset, name, buf, len)
> != 0)
> > > + return (fdt_setprop(fdtp, offset, name, buf, len));
> > > +
> > > + return 0;
> > > +}
> > > +
> > > +phandle_t rtems_ofw_find_device( const char *path )
> > > +{
> > > + int offset;
> > > +
> > > + offset = fdt_path_offset(fdtp, path);
> > > + if (offset < 0)
> > > + return -1;
> > > +
> > > + return rtems_fdt_offset_to_phandle(offset);
> > > +}
> > > +
> > > +static phandle_t rtems_ofw_get_effective_phandle(
> > > + phandle_t node,
> > > + phandle_t xref
> > > +)
> > > +{
> > > + phandle_t child;
> > > + phandle_t ref;
> > > +
> > > + for (child = rtems_ofw_child(node); child != 0; child =
> > > rtems_ofw_peer(child)) {
> > > + ref = rtems_ofw_get_effective_phandle(child, xref);
> > > + if (ref != -1)
> > > + return ref;
> > > +
> > > + if (rtems_ofw_get_enc_prop(child, "phandle", &ref,
> > sizeof(ref))
> > > == -1 &&
> > > + rtems_ofw_get_enc_prop(child, "ibm,phandle", &ref,
> > > sizeof(ref)) == -1 &&
> > > + rtems_ofw_get_enc_prop(child, "linux,phandle",
> &ref,
> > > sizeof(ref)) == -1
> > > + ) {
> > > + continue;
> > > + }
> > > +
> > > + if (ref == xref)
> > > + return child;
> > > + }
> > > +
> > > + return -1;
> > > +}
> > > +
> > > +phandle_t rtems_ofw_node_from_xref( phandle_t xref )
> > > +{
> > > + phandle_t node;
> > > +
> > > + if ((node =
> > rtems_ofw_get_effective_phandle(rtems_ofw_peer(0),
> > > xref)) == -1)
> > > + return xref;
> > > +
> > > + return node;
> > > +}
> > > +
> > > +phandle_t rtems_ofw_xref_from_node( phandle_t node )
> > > +{
> > > + phandle_t ref;
> > > +
> > > + if (rtems_ofw_get_enc_prop(node, "phandle", &ref,
> > sizeof(ref))
> > > == -1 &&
> > > + rtems_ofw_get_enc_prop(node, "ibm,phandle", &ref,
> > > sizeof(ref)) == -1 &&
> > > + rtems_ofw_get_enc_prop(node, "linux,phandle",
> &ref,
> > > sizeof(ref)) == -1)
> > > + {
> > > + return node;
> > > + }
> > > +
> > > + return ref;
> > > +}
> > > +
> > > +phandle_t rtems_ofw_instance_to_package( ihandle_t
> instance )
> > > +{
> > > + return rtems_ofw_node_from_xref(instance);
> > > +}
> > > +
> > > +ssize_t rtems_ofw_package_to_path(
> > > + phandle_t node,
> > > + char *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + int offset;
> > > + int rv;
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(node);
> > > +
> > > + rv = fdt_get_path(fdtp, offset, buf, len);
> > > + if (rv != 0)
> > > + return -1;
> > > +
> > > + return rv;
> > > +}
> > > +
> > > +ssize_t rtems_ofw_instance_to_path(
> > > + ihandle_t instance,
> > > + char *buf,
> > > + size_t len
> > > +)
> > > +{
> > > + int offset;
> > > + int rv;
> > > +
> > > + offset = rtems_ofw_instance_to_package(instance);
> > > + offset = rtems_fdt_phandle_to_offset(offset);
> > > +
> > > + rv = fdt_get_path(fdtp, offset, buf, len);
> > > + if (rv != 0)
> > > + return -1;
> > > +
> > > + return rv;
> > > +}
> > > +
> > > +int rtems_ofw_get_reg(
> > > + phandle_t node,
> > > + rtems_ofw_memory_area *buf,
> > > + size_t size
> > > +)
> > > +{
> > > + int len;
> > > + int offset;
> > > + int nranges;
> > > + int nregs;
> > > + phandle_t parent;
> > > + rtems_ofw_ranges range;
> > > + const rtems_ofw_ranges *ptr;
> > > +
> > > + len = rtems_ofw_get_enc_prop(node, "reg", (pcell_t
> > *)buf, size);
> > > + if (len <= 0) {
> > > + return len;
> > > + }
> > > +
> > > + nregs = MIN(len, size) / sizeof(rtems_ofw_memory_area);
> > > +
> > > + for (parent = rtems_ofw_parent(node); parent > 0;
> > > + parent = rtems_ofw_parent(parent)) {
> > > +
> > > + offset = rtems_fdt_phandle_to_offset(parent);
> > > + ptr = fdt_getprop(fdtp, offset, "ranges", &len);
> > > +
> > > + if (len < 0) {
> > > + break;
> > > + }
> > > +
> > > + nranges = len / sizeof(rtems_ofw_ranges);
> > > +
> > > + offset = 0;
> > > + for (int i=0; i < nregs; i++) {
> > > + for (int j=0; j < nranges; j++) {
> > > +
> > > + range.parent_bus =
> fdt32_to_cpu(ptr[j].parent_bus);
> > > + range.child_bus = fdt32_to_cpu(ptr[j].child_bus);
> > > + range.size = fdt32_to_cpu(ptr[j].size);
> > > +
> > > + if (buf[i].start >= range.child_bus &&
> > > + buf[i].start < range.child_bus + range.size) {
> > > + offset = range.parent_bus - range.child_bus;
> > > + break;
> > > + }
> > > +
> > > + }
> > > + buf[i].start += offset;
> > > + }
> > > + }
> > > +
> > > + return nregs;
> > > +}
> > > +
> > > +int rtems_ofw_get_interrupts(
> > > + phandle_t node,
> > > + rtems_vector_number *buf,
> > > + size_t size
> > > +)
> > > +{
> > > + int rv;
> > > +
> > > + rv = rtems_ofw_get_enc_prop(node, "interrupts", buf,
> size);
> > > +
> > > + if (rv <= 0) {
> > > + return rv;
> > > + }
> > > +
> > > + return MIN(size, rv) / sizeof(rtems_vector_number);
> > > +}
> > > +
> > > +bool rtems_ofw_node_status( phandle_t node )
> > > +{
> > > + int len;
> > > + const char buf[10];
> > > +
> > > + len = rtems_ofw_get_prop(node, "status", &buf[0],
> > sizeof(buf));
> > > + if ((len == -1) ||
> > > + (strncmp(buf, "okay", MIN(5, len)) == 0) ||
> > > + (strncmp(buf, "ok", MIN(3, len)) == 0)) {
> > > + return true;
> > > + }
> > > +
> > > + return false;
> > > +}
> > > +
> > > +phandle_t rtems_ofw_find_device_by_compat( const char
> > *compat )
> > > +{
> > > + int offset;
> > > +
> > > + offset = fdt_node_offset_by_compatible(fdtp, -1,
> compat);
> > > + return rtems_fdt_offset_to_phandle(offset);
> > > +}
> > > diff --git a/spec/build/bsps/obj.yml
> b/spec/build/bsps/obj.yml
> > > index 8809238057..0ea07fc83d 100644
> > > --- a/spec/build/bsps/obj.yml
> > > +++ b/spec/build/bsps/obj.yml
> > > @@ -24,6 +24,10 @@ install:
> > > - bsps/include/bsp/u-boot.h
> > > - bsps/include/bsp/uart-output-char.h
> > > - bsps/include/bsp/utility.h
> > > +- destination: ${BSP_INCLUDEDIR}/ofw
> > > + source:
> > > + - bsps/include/ofw/ofw.h
> > > + - bsps/include/ofw/ofw_compat.h
> > > - destination: ${BSP_INCLUDEDIR}/libchip
> > > source:
> > > - bsps/include/libchip/am29lv160.h
> > > @@ -104,4 +108,5 @@ source:
> > > - bsps/shared/dev/serial/z85c30_reg.c
> > > - bsps/shared/start/bootcard.c
> > > - bsps/shared/rtems-version.c
> > > +- bsps/shared/ofw/ofw.c
> > > type: build
> > > --
> > > 2.17.1
> > >
> > >
> > > _______________________________________________
> > > devel mailing list
> > > devel at rtems.org <mailto:devel at rtems.org>
> > > http://lists.rtems.org/mailman/listinfo/devel
> > >
> >
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20201103/d768b2bf/attachment-0001.html>
More information about the devel
mailing list