[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [Xen-devel] [PATCH V1 09/29] xen/dts: Add new helpers to use the device tree



On Wed, 2013-08-28 at 15:47 +0100, Julien Grall wrote:
> List of new helpers taken from linux (commit 74b9272):
>     - dt_property_read_string
>     - dt_match_node
>     - dt_find_maching_node
>     - dt_device_is_available
>     - dt_prop_cmp
> 
> Other new helpers:
>     - dt_set_cell
>     - for_each_child

This seems too generic. Perhaps dt_for_each_child or for_each_dt_child?

>     - dt_set_range
>     - dt_cells_to_size
>     - dt_next_cell
>     - dt_get_range
>     - dt_node_name_is_equal
>     - dt_node_path_is_equal
>     - dt_property_name_is_equal
> 
> Signed-off-by: Julien Grall <julien.grall@xxxxxxxxxx>
> 
> ---
>     Changes in v2:
>         - Update commit message
>         - Add for_each_child
>         - Add dt_get_range
>         - Update documentation
>         - Typoes
> ---
>  xen/common/device_tree.c      |  109 +++++++++++++++++++++++++++--
>  xen/include/xen/device_tree.h |  151 
> ++++++++++++++++++++++++++++++++++++++++-
>  2 files changed, 252 insertions(+), 8 deletions(-)
> 
> diff --git a/xen/common/device_tree.c b/xen/common/device_tree.c
> index 07a19ac..833d67d 100644
> --- a/xen/common/device_tree.c
> +++ b/xen/common/device_tree.c
> @@ -182,23 +182,38 @@ void __init device_tree_get_reg(const u32 **cell, u32 
> address_cells,
>      get_val(cell, size_cells, size);
>  }
>  
> -static void __init set_val(u32 **cell, u32 cells, u64 val)
> +void dt_get_range(const __be32 **cell, const struct dt_device_node *np,
> +                  u64 *address, u64 *size)
>  {
> -    u32 c = cells;
> +    *address = dt_next_cell(dt_n_addr_cells(np), cell);
> +    *size = dt_next_cell(dt_n_size_cells(np), cell);
> +}
> +
> +void dt_set_cell(__be32 **cellp, int size, u64 val)
> +{
> +    int cells = size;
>  
> -    while ( c-- )
> +    while ( size-- )
>      {
> -        (*cell)[c] = cpu_to_fdt32(val);
> +        (*cellp)[size] = cpu_to_fdt32(val);
>          val >>= 32;
>      }
> -    (*cell) += cells;
> +
> +    (*cellp) += cells;
>  }
>  
>  void __init device_tree_set_reg(u32 **cell, u32 address_cells, u32 
> size_cells,
>                                  u64 start, u64 size)
>  {
> -    set_val(cell, address_cells, start);
> -    set_val(cell, size_cells, size);
> +    dt_set_cell(cell, address_cells, start);
> +    dt_set_cell(cell, size_cells, size);
> +}
> +
> +void dt_set_range(__be32 **cellp, const struct dt_device_node *np,
> +                  u64 address, u64 size)
> +{
> +    dt_set_cell(cellp, dt_n_addr_cells(np), address);
> +    dt_set_cell(cellp, dt_n_size_cells(np), size);
>  }
>  
>  u32 __init device_tree_get_u32(const void *fdt, int node, const char 
> *prop_name,
> @@ -583,6 +598,23 @@ bool_t dt_property_read_u32(const struct dt_device_node 
> *np,
>      return 1;
>  }
>  
> +int dt_property_read_string(const struct dt_device_node *np,
> +                            const char *propname, const char **out_string)
> +{
> +    const struct dt_property *pp = dt_find_property(np, propname, NULL);
> +
> +    if ( !pp )
> +        return -EINVAL;
> +    if ( !pp->value )
> +        return -ENODATA;
> +    if ( strnlen(pp->value, pp->length) >= pp->length )
> +        return -EILSEQ;
> +
> +    *out_string = pp->value;
> +
> +    return 0;
> +}
> +
>  bool_t dt_device_is_compatible(const struct dt_device_node *device,
>                                 const char *compat)
>  {
> @@ -655,6 +687,34 @@ struct dt_device_node *dt_find_node_by_alias(const char 
> *alias)
>      return NULL;
>  }
>  
> +bool_t dt_match_node(const struct dt_device_match *matches,
> +                     const struct dt_device_node *node)
> +{
> +    if ( !matches )
> +        return 0;
> +
> +    while ( matches->path || matches->type || matches->compatible )
> +    {
> +        bool_t match = 1;
> +
> +        if ( matches->path )
> +            match &= dt_node_path_is_equal(node, matches->path);
> +
> +        if ( matches->type )
> +            match &= dt_device_type_is_equal(node, matches->type);
> +
> +        if ( matches->compatible )
> +            match &= dt_device_is_compatible(node, matches->compatible);
> +
> +        if ( match )
> +            return match;
> +
> +        matches++;
> +    }
> +
> +    return 0;
> +}
> +
>  const struct dt_device_node *dt_get_parent(const struct dt_device_node *node)
>  {
>      if ( !node )
> @@ -684,6 +744,23 @@ dt_find_compatible_node(struct dt_device_node *from,
>      return np;
>  }
>  
> +struct dt_device_node *
> +dt_find_matching_node(struct dt_device_node *from,
> +                      const struct dt_device_match *matches)
> +{
> +    struct dt_device_node *np;
> +    struct dt_device_node *dt;
> +
> +    dt = from ? from->allnext : dt_host;
> +    for_each_device_node(dt, np)
> +    {
> +        if ( dt_match_node(matches, np) )
> +            return np;
> +    }
> +
> +    return NULL;
> +}
> +
>  int dt_n_addr_cells(const struct dt_device_node *np)
>  {
>      const __be32 *ip;
> @@ -1372,6 +1449,24 @@ int dt_device_get_irq(const struct dt_device_node 
> *device, int index,
>      return dt_irq_translate(&raw, out_irq);
>  }
>  
> +bool_t dt_device_is_available(const struct dt_device_node *device)
> +{
> +    const char *status;
> +    u32 statlen;
> +
> +    status = dt_get_property(device, "status", &statlen);
> +    if ( status == NULL )
> +        return 1;
> +
> +    if ( statlen > 0 )
> +    {
> +        if ( !strcmp(status, "okay") || !strcmp(status, "ok") )
> +            return 1;
> +    }
> +
> +    return 0;
> +}
> +
>  /**
>   * unflatten_dt_node - Alloc and populate a device_node from the flat tree
>   * @fdt: The parent device tree blob
> diff --git a/xen/include/xen/device_tree.h b/xen/include/xen/device_tree.h
> index 7cbf736..fa4f314 100644
> --- a/xen/include/xen/device_tree.h
> +++ b/xen/include/xen/device_tree.h
> @@ -54,6 +54,19 @@ struct dt_early_info {
>      struct dt_module_info modules;
>  };
>  
> +/*
> + * Struct used for matching a device
> + */
> +struct dt_device_match {
> +    const char *path;
> +    const char *type;
> +    const char *compatible;
> +};
> +
> +#define DT_MATCH_PATH(p)                { .path = p }
> +#define DT_MATCH_TYPE(typ)              { .type = typ }
> +#define DT_MATCH_COMPATIBLE(compat)     { .compatible = compat }
> +
>  typedef u32 dt_phandle;
>  
>  /**
> @@ -229,6 +242,7 @@ extern const struct dt_device_node 
> *dt_interrupt_controller;
>   */
>  struct dt_device_node * __init dt_find_interrupt_controller(const char 
> *compat);
>  
> +#define dt_prop_cmp(s1, s2) strcmp((s1), (s2))
>  #define dt_node_cmp(s1, s2) strcasecmp((s1), (s2))
>  #define dt_compat_cmp(s1, s2) strcasecmp((s1), (s2))
>  
> @@ -242,6 +256,9 @@ struct dt_device_node * __init 
> dt_find_interrupt_controller(const char *compat);
>  #define for_each_device_node(dt, dn)                         \
>      for ( dn = dt; dn != NULL; dn = dn->allnext )
>  
> +#define for_each_child_node(dt, dn)                         \
> +    for ( dn = dt->child; dn != NULL; dn = dn->sibling )
> +
>  /* Helper to read a big number; size is in cells (not bytes) */
>  static inline u64 dt_read_number(const __be32 *cell, int size)
>  {
> @@ -252,6 +269,20 @@ static inline u64 dt_read_number(const __be32 *cell, int 
> size)
>      return r;
>  }
>  
> +/* Helper to convert a number of cells in bytes */
> +static inline int dt_cells_to_size(int size)
> +{
> +    return (size * sizeof (u32));
> +}
> +
> +static inline u64 dt_next_cell(int s, const __be32 **cellp)
> +{
> +    const __be32 *p = *cellp;
> +
> +    *cellp = p + s;
> +    return dt_read_number(p, s);
> +}
> +
>  static inline const char *dt_node_full_name(const struct dt_device_node *np)
>  {
>      return (np && np->full_name) ? np->full_name : "<no-node>";
> @@ -262,6 +293,18 @@ static inline const char *dt_node_name(const struct 
> dt_device_node *np)
>      return (np && np->name) ? np->name : "<no-node>";
>  }
>  
> +static inline bool_t dt_node_name_is_equal(const struct dt_device_node *np,
> +                                           const char *name)
> +{
> +    return !dt_node_cmp(np->name, name);
> +}
> +
> +static inline bool_t dt_node_path_is_equal(const struct dt_device_node *np,
> +                                           const char *path)
> +{
> +    return !dt_node_cmp(np->full_name, path);
> +}
> +
>  static inline bool_t
>  dt_device_type_is_equal(const struct dt_device_node *device,
>                          const char *type)
> @@ -281,6 +324,12 @@ static inline domid_t dt_device_used_by(const struct 
> dt_device_node *device)
>      return device->used_by;
>  }
>  
> +static inline bool_t dt_property_name_is_equal(const struct dt_property *pp,
> +                                               const char *name)
> +{
> +    return !dt_prop_cmp(pp->name, name);
> +}
> +
>  /**
>   * dt_find_compatible_node - Find a node based on type and one of the
>   *                           tokens in its "compatible" property
> @@ -315,6 +364,23 @@ const void *dt_get_property(const struct dt_device_node 
> *np,
>   */
>  bool_t dt_property_read_u32(const struct dt_device_node *np,
>                              const char *name, u32 *out_value);
> +/**
> + * dt_property_read_string - Find and read a string from a property
> + * @np:         Device node from which the property value is to be read
> + * @propname:   Name of the property to be searched
> + * @out_string: Pointer to null terminated return string, modified only
> + *              if return value if 0.
> + *
> + * Search for a property in a device tree node and retrieve a null
> + * terminated string value (pointer to data, not a copy). Returns 0 on
> + * success, -EINVAL if the property does not exist, -ENODATA if property
> + * doest not have value, and -EILSEQ if the string is not
> + * null-terminated with the length of the property data.
> + *
> + * The out_string pointer is modified only if a valid string can be decoded.
> + */
> +int dt_property_read_string(const struct dt_device_node *np,
> +                            const char *propname, const char **out_string);
>  
>  /**
>   * Checks if the given "compat" string matches one of the strings in
> @@ -450,4 +516,87 @@ int dt_n_size_cells(const struct dt_device_node *np);
>   */
>  int dt_n_addr_cells(const struct dt_device_node *np);
>  
> -#endif
> +/**
> + * dt_device_is_available - Check if a device is available for use
> + *
> + * @device: Node to check for availability
> + *
> + * Returns true if the status property is absent or set to "okay" or "ok",
> + * false otherwise.
> + */
> +bool_t dt_device_is_available(const struct dt_device_node *device);
> +
> +/**
> + * dt_match_node - Tell if a device_node has a matching of dt_device_match
> + * @matches: array of dt_device_match structures to search in
> + * @node: the dt_device_node structure to match against
> + *
> + * Returns true if the device node match one of dt_device_match.
> + */
> +bool_t dt_match_node(const struct dt_device_match *matches,
> +                     const struct dt_device_node *node);
> +
> +/**
> + * dt_find_matching_node - Find a node based on an dt_device_match match 
> table
> + * @from: The node to start searching from or NULL, the node you pass
> + *        will not be searched, only the next one will; typically, you pass
> + *        what the returned call returned
> + * @matches: array of dt_device_match structures to search in
> + *
> + * Returns a node pointer.
> + */
> +struct dt_device_node *
> +dt_find_matching_node(struct dt_device_node *from,
> +                      const struct dt_device_match *matches);
> +
> +/**
> + * dt_set_cell - Write a value into a series of cells
> + *
> + * @cellp: Pointer to cells
> + * @size: number of cells to write the value
> + * @value: number to write
> + *
> + * Write a value into a series of cells and update cellp to point to the
> + * cell just after.
> + */
> +void dt_set_cell(__be32 **cellp, int size, u64 val);
> +
> +/**
> + * dt_set_range - Write range into a series of cells
> + *
> + * @cellp: Pointer to cells
> + * @np: Node which contains the encoding for the address and the size
> + * @address: Start of range
> + * @size: Size of the range
> + *
> + * Write a range into a series of cells and update cellp to point to the
> + * cell just after.
> + */
> +void dt_set_range(__be32 **cellp, const struct dt_device_node *np,
> +                  u64 address, u64 size);
> +
> +/**
> + * dt_get_range - Read a range (address/size) from a series of cells
> + *
> + * @cellp: Pointer to cells
> + * @np Node which  contains the encoding for the addresss and the size
> + * @address: Address filled by this function
> + * @size: Size filled by this function
> + *
> + * WARNING: This function should not be used to decode an address
> + * This function reads a range (address/size) from a series of cells and
> + * update cellp to point to the cell just after.
> + */
> +void dt_get_range(const __be32 **cellp, const struct dt_device_node *np,
> +                  u64 *address, u64 *size);
> +
> +#endif /* __XEN_DEVICE_TREE_H */
> +
> +/*
> + * Local variables:
> + * mode: C
> + * c-file-style: "BSD"
> + * c-basic-offset: 4
> + * indent-tabs-mode: nil
> + * End:
> + */



_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
http://lists.xen.org/xen-devel


 


Rackspace

Lists.xenproject.org is hosted with RackSpace, monitoring our
servers 24x7x365 and backed by RackSpace's Fanatical Support®.