/* * Copyright (C) 2009 Francisco Jerez. * All Rights Reserved. * * Permission is hereby granted, free of charge, to any person obtaining * a copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, sublicense, and/or sell copies of the Software, and to * permit persons to whom the Software is furnished to do so, subject to * the following conditions: * * The above copyright notice and this permission notice (including the * next paragraph) shall be included in all copies or substantial * portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. * IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * */ #include <linux/module.h> #include <drm/drm_encoder_slave.h> /** * drm_i2c_encoder_init - Initialize an I2C slave encoder * @dev: DRM device. * @encoder: Encoder to be attached to the I2C device. You aren't * required to have called drm_encoder_init() before. * @adap: I2C adapter that will be used to communicate with * the device. * @info: Information that will be used to create the I2C device. * Required fields are @addr and @type. * * Create an I2C device on the specified bus (the module containing its * driver is transparently loaded) and attach it to the specified * &drm_encoder_slave. The @slave_funcs field will be initialized with * the hooks provided by the slave driver. * * If @info.platform_data is non-NULL it will be used as the initial * slave config. * * Returns 0 on success or a negative errno on failure, in particular, * -ENODEV is returned when no matching driver is found. */ int drm_i2c_encoder_init(struct drm_device *dev, struct drm_encoder_slave *encoder, struct i2c_adapter *adap, const struct i2c_board_info *info) { struct module *module = NULL; struct i2c_client *client; struct drm_i2c_encoder_driver *encoder_drv; int err = 0; request_module("%s%s", I2C_MODULE_PREFIX, info->type); client = i2c_new_device(adap, info); if (!client) { err = -ENOMEM; goto fail; } if (!client->dev.driver) { err = -ENODEV; goto fail_unregister; } module = client->dev.driver->owner; if (!try_module_get(module)) { err = -ENODEV; goto fail_unregister; } encoder->bus_priv = client; encoder_drv = to_drm_i2c_encoder_driver(to_i2c_driver(client->dev.driver)); err = encoder_drv->encoder_init(client, dev, encoder); if (err) goto fail_unregister; if (info->platform_data) encoder->slave_funcs->set_config(&encoder->base, info->platform_data); return 0; fail_unregister: i2c_unregister_device(client); module_put(module); fail: return err; } EXPORT_SYMBOL(drm_i2c_encoder_init); /** * drm_i2c_encoder_destroy - Unregister the I2C device backing an encoder * @drm_encoder: Encoder to be unregistered. * * This should be called from the @destroy method of an I2C slave * encoder driver once I2C access is no longer needed. */ void drm_i2c_encoder_destroy(struct drm_encoder *drm_encoder) { struct drm_encoder_slave *encoder = to_encoder_slave(drm_encoder); struct i2c_client *client = drm_i2c_encoder_get_client(drm_encoder); struct module *module = client->dev.driver->owner; i2c_unregister_device(client); encoder->bus_priv = NULL; module_put(module); } EXPORT_SYMBOL(drm_i2c_encoder_destroy); /* * Wrapper fxns which can be plugged in to drm_encoder_helper_funcs: */ static inline const struct drm_encoder_slave_funcs * get_slave_funcs(struct drm_encoder *enc) { return to_encoder_slave(enc)->slave_funcs; } void drm_i2c_encoder_dpms(struct drm_encoder *encoder, int mode) { get_slave_funcs(encoder)->dpms(encoder, mode); } EXPORT_SYMBOL(drm_i2c_encoder_dpms); bool drm_i2c_encoder_mode_fixup(struct drm_encoder *encoder, const struct drm_display_mode *mode, struct drm_display_mode *adjusted_mode) { if (!get_slave_funcs(encoder)->mode_fixup) return true; return get_slave_funcs(encoder)->mode_fixup(encoder, mode, adjusted_mode); } EXPORT_SYMBOL(drm_i2c_encoder_mode_fixup); void drm_i2c_encoder_prepare(struct drm_encoder *encoder) { drm_i2c_encoder_dpms(encoder, DRM_MODE_DPMS_OFF); } EXPORT_SYMBOL(drm_i2c_encoder_prepare); void drm_i2c_encoder_commit(struct drm_encoder *encoder) { drm_i2c_encoder_dpms(encoder, DRM_MODE_DPMS_ON); } EXPORT_SYMBOL(drm_i2c_encoder_commit); void drm_i2c_encoder_mode_set(struct drm_encoder *encoder, struct drm_display_mode *mode, struct drm_display_mode *adjusted_mode) { get_slave_funcs(encoder)->mode_set(encoder, mode, adjusted_mode); } EXPORT_SYMBOL(drm_i2c_encoder_mode_set); enum drm_connector_status drm_i2c_encoder_detect(struct drm_encoder *encoder, struct drm_connector *connector) { return get_slave_funcs(encoder)->detect(encoder, connector); } EXPORT_SYMBOL(drm_i2c_encoder_detect); void drm_i2c_encoder_save(struct drm_encoder *encoder) { get_slave_funcs(encoder)->save(encoder); } EXPORT_SYMBOL(drm_i2c_encoder_save); void drm_i2c_encoder_restore(struct drm_encoder *encoder) { get_slave_funcs(encoder)->restore(encoder); } EXPORT_SYMBOL(drm_i2c_encoder_restore);