/* * Copyright (c) 2015-2016 Intel Corporation. * * SPDX-License-Identifier: Apache-2.0 */ #include #include #include #include #include #include #include /** * @brief Initialize state for all static devices. * * The state object is always zero-initialized, but this may not be * sufficient. */ void z_device_state_init(void) { STRUCT_SECTION_FOREACH(device, dev) { z_object_init(dev); } } const struct device *z_impl_device_get_binding(const char *name) { /* A null string identifies no device. So does an empty * string. */ if ((name == NULL) || (name[0] == '\0')) { return NULL; } /* Split the search into two loops: in the common scenario, where * device names are stored in ROM (and are referenced by the user * with CONFIG_* macros), only cheap pointer comparisons will be * performed. Reserve string comparisons for a fallback. */ STRUCT_SECTION_FOREACH(device, dev) { if (z_device_is_ready(dev) && (dev->name == name)) { return dev; } } STRUCT_SECTION_FOREACH(device, dev) { if (z_device_is_ready(dev) && (strcmp(name, dev->name) == 0)) { return dev; } } return NULL; } #ifdef CONFIG_USERSPACE static inline const struct device *z_vrfy_device_get_binding(const char *name) { char name_copy[Z_DEVICE_MAX_NAME_LEN]; if (z_user_string_copy(name_copy, (char *)name, sizeof(name_copy)) != 0) { return NULL; } return z_impl_device_get_binding(name_copy); } #include static inline bool z_vrfy_device_is_ready(const struct device *dev) { Z_OOPS(Z_SYSCALL_OBJ_INIT(dev, K_OBJ_ANY)); return z_impl_device_is_ready(dev); } #include #endif /* CONFIG_USERSPACE */ size_t z_device_get_all_static(struct device const **devices) { size_t cnt; STRUCT_SECTION_GET(device, 0, devices); STRUCT_SECTION_COUNT(device, &cnt); return cnt; } bool z_device_is_ready(const struct device *dev) { /* * if an invalid device pointer is passed as argument, this call * reports the `device` as not ready for usage. */ if (dev == NULL) { return false; } return dev->state->initialized && (dev->state->init_res == 0U); } #ifdef CONFIG_DEVICE_DEPS static int device_visitor(const device_handle_t *handles, size_t handle_count, device_visitor_callback_t visitor_cb, void *context) { /* Iterate over fixed devices */ for (size_t i = 0; i < handle_count; ++i) { device_handle_t dh = handles[i]; const struct device *rdev = device_from_handle(dh); int rc = visitor_cb(rdev, context); if (rc < 0) { return rc; } } return handle_count; } int device_required_foreach(const struct device *dev, device_visitor_callback_t visitor_cb, void *context) { size_t handle_count = 0; const device_handle_t *handles = device_required_handles_get(dev, &handle_count); return device_visitor(handles, handle_count, visitor_cb, context); } int device_supported_foreach(const struct device *dev, device_visitor_callback_t visitor_cb, void *context) { size_t handle_count = 0; const device_handle_t *handles = device_supported_handles_get(dev, &handle_count); return device_visitor(handles, handle_count, visitor_cb, context); } #endif /* CONFIG_DEVICE_DEPS */