Linux Audio

Check our new training course

Linux debugging, profiling, tracing and performance analysis training

Apr 14-17, 2025
Register
Loading...
v4.6
  1
  2/*
  3 * drm_sysfs.c - Modifications to drm_sysfs_class.c to support
  4 *               extra sysfs attribute from DRM. Normal drm_sysfs_class
  5 *               does not allow adding attributes.
  6 *
  7 * Copyright (c) 2004 Jon Smirl <jonsmirl@gmail.com>
  8 * Copyright (c) 2003-2004 Greg Kroah-Hartman <greg@kroah.com>
  9 * Copyright (c) 2003-2004 IBM Corp.
 10 *
 11 * This file is released under the GPLv2
 12 *
 13 */
 14
 15#include <linux/device.h>
 16#include <linux/kdev_t.h>
 17#include <linux/gfp.h>
 18#include <linux/err.h>
 19#include <linux/export.h>
 20
 21#include <drm/drm_sysfs.h>
 22#include <drm/drm_core.h>
 23#include <drm/drmP.h>
 24#include "drm_internal.h"
 25
 26#define to_drm_minor(d) dev_get_drvdata(d)
 27#define to_drm_connector(d) dev_get_drvdata(d)
 28
 29static struct device_type drm_sysfs_device_minor = {
 30	.name = "drm_minor"
 31};
 32
 33struct class *drm_class;
 34
 35/**
 36 * __drm_class_suspend - internal DRM class suspend routine
 37 * @dev: Linux device to suspend
 38 * @state: power state to enter
 39 *
 40 * Just figures out what the actual struct drm_device associated with
 41 * @dev is and calls its suspend hook, if present.
 42 */
 43static int __drm_class_suspend(struct device *dev, pm_message_t state)
 44{
 45	if (dev->type == &drm_sysfs_device_minor) {
 46		struct drm_minor *drm_minor = to_drm_minor(dev);
 47		struct drm_device *drm_dev = drm_minor->dev;
 48
 49		if (drm_minor->type == DRM_MINOR_LEGACY &&
 50		    !drm_core_check_feature(drm_dev, DRIVER_MODESET) &&
 51		    drm_dev->driver->suspend)
 52			return drm_dev->driver->suspend(drm_dev, state);
 53	}
 54	return 0;
 55}
 56
 57/**
 58 * drm_class_suspend - internal DRM class suspend hook. Simply calls
 59 * __drm_class_suspend() with the correct pm state.
 60 * @dev: Linux device to suspend
 61 */
 62static int drm_class_suspend(struct device *dev)
 63{
 64	return __drm_class_suspend(dev, PMSG_SUSPEND);
 65}
 66
 67/**
 68 * drm_class_freeze - internal DRM class freeze hook. Simply calls
 69 * __drm_class_suspend() with the correct pm state.
 70 * @dev: Linux device to freeze
 71 */
 72static int drm_class_freeze(struct device *dev)
 73{
 74	return __drm_class_suspend(dev, PMSG_FREEZE);
 75}
 76
 77/**
 78 * drm_class_resume - DRM class resume hook
 79 * @dev: Linux device to resume
 80 *
 81 * Just figures out what the actual struct drm_device associated with
 82 * @dev is and calls its resume hook, if present.
 83 */
 84static int drm_class_resume(struct device *dev)
 85{
 86	if (dev->type == &drm_sysfs_device_minor) {
 87		struct drm_minor *drm_minor = to_drm_minor(dev);
 88		struct drm_device *drm_dev = drm_minor->dev;
 89
 90		if (drm_minor->type == DRM_MINOR_LEGACY &&
 91		    !drm_core_check_feature(drm_dev, DRIVER_MODESET) &&
 92		    drm_dev->driver->resume)
 93			return drm_dev->driver->resume(drm_dev);
 94	}
 95	return 0;
 96}
 97
 98static const struct dev_pm_ops drm_class_dev_pm_ops = {
 99	.suspend	= drm_class_suspend,
100	.resume		= drm_class_resume,
101	.freeze		= drm_class_freeze,
102};
103
104static char *drm_devnode(struct device *dev, umode_t *mode)
105{
106	return kasprintf(GFP_KERNEL, "dri/%s", dev_name(dev));
107}
108
109static CLASS_ATTR_STRING(version, S_IRUGO,
110		CORE_NAME " "
111		__stringify(CORE_MAJOR) "."
112		__stringify(CORE_MINOR) "."
113		__stringify(CORE_PATCHLEVEL) " "
114		CORE_DATE);
115
116/**
117 * drm_sysfs_init - initialize sysfs helpers
118 *
119 * This is used to create the DRM class, which is the implicit parent of any
120 * other top-level DRM sysfs objects.
121 *
122 * You must call drm_sysfs_destroy() to release the allocated resources.
 
123 *
124 * Return: 0 on success, negative error code on failure.
 
125 */
126int drm_sysfs_init(void)
127{
 
128	int err;
129
130	drm_class = class_create(THIS_MODULE, "drm");
131	if (IS_ERR(drm_class))
132		return PTR_ERR(drm_class);
 
 
133
134	drm_class->pm = &drm_class_dev_pm_ops;
 
135
136	err = class_create_file(drm_class, &class_attr_version.attr);
137	if (err) {
138		class_destroy(drm_class);
139		drm_class = NULL;
140		return err;
141	}
142
143	drm_class->devnode = drm_devnode;
144	return 0;
 
 
 
 
 
 
145}
146
147/**
148 * drm_sysfs_destroy - destroys DRM class
149 *
150 * Destroy the DRM device class.
151 */
152void drm_sysfs_destroy(void)
153{
154	if (IS_ERR_OR_NULL(drm_class))
155		return;
156	class_remove_file(drm_class, &class_attr_version.attr);
157	class_destroy(drm_class);
158	drm_class = NULL;
 
 
 
 
 
 
 
 
 
 
 
 
 
159}
160
161/*
162 * Connector properties
163 */
164static ssize_t status_store(struct device *device,
165			   struct device_attribute *attr,
166			   const char *buf, size_t count)
167{
168	struct drm_connector *connector = to_drm_connector(device);
169	struct drm_device *dev = connector->dev;
170	enum drm_connector_force old_force;
171	int ret;
172
173	ret = mutex_lock_interruptible(&dev->mode_config.mutex);
174	if (ret)
175		return ret;
176
177	old_force = connector->force;
178
179	if (sysfs_streq(buf, "detect"))
180		connector->force = 0;
181	else if (sysfs_streq(buf, "on"))
182		connector->force = DRM_FORCE_ON;
183	else if (sysfs_streq(buf, "on-digital"))
184		connector->force = DRM_FORCE_ON_DIGITAL;
185	else if (sysfs_streq(buf, "off"))
186		connector->force = DRM_FORCE_OFF;
187	else
188		ret = -EINVAL;
189
190	if (old_force != connector->force || !connector->force) {
191		DRM_DEBUG_KMS("[CONNECTOR:%d:%s] force updated from %d to %d or reprobing\n",
192			      connector->base.id,
193			      connector->name,
194			      old_force, connector->force);
195
196		connector->funcs->fill_modes(connector,
197					     dev->mode_config.max_width,
198					     dev->mode_config.max_height);
199	}
200
201	mutex_unlock(&dev->mode_config.mutex);
202
203	return ret ? ret : count;
204}
205
206static ssize_t status_show(struct device *device,
207			   struct device_attribute *attr,
208			   char *buf)
209{
210	struct drm_connector *connector = to_drm_connector(device);
211
212	return snprintf(buf, PAGE_SIZE, "%s\n",
213			drm_get_connector_status_name(connector->status));
214}
215
216static ssize_t dpms_show(struct device *device,
217			   struct device_attribute *attr,
218			   char *buf)
219{
220	struct drm_connector *connector = to_drm_connector(device);
221	int dpms;
 
 
222
223	dpms = READ_ONCE(connector->dpms);
 
 
 
 
224
225	return snprintf(buf, PAGE_SIZE, "%s\n",
226			drm_get_dpms_name(dpms));
227}
228
229static ssize_t enabled_show(struct device *device,
230			    struct device_attribute *attr,
231			   char *buf)
232{
233	struct drm_connector *connector = to_drm_connector(device);
234
235	return snprintf(buf, PAGE_SIZE, "%s\n", connector->encoder ? "enabled" :
236			"disabled");
237}
238
239static ssize_t edid_show(struct file *filp, struct kobject *kobj,
240			 struct bin_attribute *attr, char *buf, loff_t off,
241			 size_t count)
242{
243	struct device *connector_dev = kobj_to_dev(kobj);
244	struct drm_connector *connector = to_drm_connector(connector_dev);
245	unsigned char *edid;
246	size_t size;
247	ssize_t ret = 0;
248
249	mutex_lock(&connector->dev->mode_config.mutex);
250	if (!connector->edid_blob_ptr)
251		goto unlock;
252
253	edid = connector->edid_blob_ptr->data;
254	size = connector->edid_blob_ptr->length;
255	if (!edid)
256		goto unlock;
257
258	if (off >= size)
259		goto unlock;
260
261	if (off + count > size)
262		count = size - off;
263	memcpy(buf, edid + off, count);
264
265	ret = count;
266unlock:
267	mutex_unlock(&connector->dev->mode_config.mutex);
268
269	return ret;
270}
271
272static ssize_t modes_show(struct device *device,
273			   struct device_attribute *attr,
274			   char *buf)
275{
276	struct drm_connector *connector = to_drm_connector(device);
277	struct drm_display_mode *mode;
278	int written = 0;
279
280	mutex_lock(&connector->dev->mode_config.mutex);
281	list_for_each_entry(mode, &connector->modes, head) {
282		written += snprintf(buf + written, PAGE_SIZE - written, "%s\n",
283				    mode->name);
284	}
285	mutex_unlock(&connector->dev->mode_config.mutex);
286
287	return written;
288}
289
290static ssize_t tv_subconnector_show(struct device *device,
291				    struct device_attribute *attr,
292				    char *buf)
293{
294	struct drm_connector *connector = to_drm_connector(device);
295	struct drm_device *dev = connector->dev;
296	struct drm_property *prop;
297	uint64_t subconnector;
 
298	int ret;
299
300	prop = dev->mode_config.tv_subconnector_property;
301	if (!prop) {
302		DRM_ERROR("Unable to find subconnector property\n");
303		return 0;
 
 
 
 
 
 
 
 
 
 
304	}
305
306	ret = drm_object_property_get_value(&connector->base, prop, &subconnector);
307	if (ret)
308		return 0;
309
310	return snprintf(buf, PAGE_SIZE, "%s",
311			drm_get_tv_subconnector_name((int)subconnector));
312}
313
314static ssize_t tv_select_subconnector_show(struct device *device,
315					   struct device_attribute *attr,
316					   char *buf)
317{
318	struct drm_connector *connector = to_drm_connector(device);
319	struct drm_device *dev = connector->dev;
320	struct drm_property *prop;
321	uint64_t subconnector;
322	int ret;
323
324	prop = dev->mode_config.tv_select_subconnector_property;
325	if (!prop) {
326		DRM_ERROR("Unable to find select subconnector property\n");
327		return 0;
328	}
329
330	ret = drm_object_property_get_value(&connector->base, prop, &subconnector);
331	if (ret)
332		return 0;
333
334	return snprintf(buf, PAGE_SIZE, "%s",
335			drm_get_tv_select_name((int)subconnector));
336}
337
338static ssize_t dvii_subconnector_show(struct device *device,
339				      struct device_attribute *attr,
340				      char *buf)
341{
342	struct drm_connector *connector = to_drm_connector(device);
343	struct drm_device *dev = connector->dev;
344	struct drm_property *prop;
345	uint64_t subconnector;
346	int ret;
347
348	prop = dev->mode_config.dvi_i_subconnector_property;
349	if (!prop) {
350		DRM_ERROR("Unable to find subconnector property\n");
351		return 0;
352	}
353
354	ret = drm_object_property_get_value(&connector->base, prop, &subconnector);
355	if (ret)
356		return 0;
357
358	return snprintf(buf, PAGE_SIZE, "%s",
 
359			drm_get_dvi_i_subconnector_name((int)subconnector));
360}
361
362static ssize_t dvii_select_subconnector_show(struct device *device,
363					     struct device_attribute *attr,
364					     char *buf)
365{
366	struct drm_connector *connector = to_drm_connector(device);
367	struct drm_device *dev = connector->dev;
368	struct drm_property *prop;
369	uint64_t subconnector;
 
370	int ret;
371
372	prop = dev->mode_config.dvi_i_select_subconnector_property;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
373	if (!prop) {
374		DRM_ERROR("Unable to find select subconnector property\n");
375		return 0;
376	}
377
378	ret = drm_object_property_get_value(&connector->base, prop, &subconnector);
379	if (ret)
380		return 0;
381
382	return snprintf(buf, PAGE_SIZE, "%s",
 
383			drm_get_dvi_i_select_name((int)subconnector));
384}
385
386static DEVICE_ATTR_RW(status);
387static DEVICE_ATTR_RO(enabled);
388static DEVICE_ATTR_RO(dpms);
389static DEVICE_ATTR_RO(modes);
390
391static struct attribute *connector_dev_attrs[] = {
392	&dev_attr_status.attr,
393	&dev_attr_enabled.attr,
394	&dev_attr_dpms.attr,
395	&dev_attr_modes.attr,
396	NULL
397};
398
399static DEVICE_ATTR_RO(tv_subconnector);
400static DEVICE_ATTR_RO(tv_select_subconnector);
401
402static struct attribute *connector_tv_dev_attrs[] = {
403	&dev_attr_tv_subconnector.attr,
404	&dev_attr_tv_select_subconnector.attr,
405	NULL
406};
407
408static DEVICE_ATTR_RO(dvii_subconnector);
409static DEVICE_ATTR_RO(dvii_select_subconnector);
410
411static struct attribute *connector_dvii_dev_attrs[] = {
412	&dev_attr_dvii_subconnector.attr,
413	&dev_attr_dvii_select_subconnector.attr,
414	NULL
415};
416
417/* Connector type related helpers */
418static int kobj_connector_type(struct kobject *kobj)
419{
420	struct device *dev = kobj_to_dev(kobj);
421	struct drm_connector *connector = to_drm_connector(dev);
422
423	return connector->connector_type;
424}
425
426static umode_t connector_is_dvii(struct kobject *kobj,
427				 struct attribute *attr, int idx)
428{
429	return kobj_connector_type(kobj) == DRM_MODE_CONNECTOR_DVII ?
430		attr->mode : 0;
431}
432
433static umode_t connector_is_tv(struct kobject *kobj,
434			       struct attribute *attr, int idx)
435{
436	switch (kobj_connector_type(kobj)) {
437	case DRM_MODE_CONNECTOR_Composite:
438	case DRM_MODE_CONNECTOR_SVIDEO:
439	case DRM_MODE_CONNECTOR_Component:
440	case DRM_MODE_CONNECTOR_TV:
441		return attr->mode;
442	}
443
444	return 0;
445}
446
447static struct bin_attribute edid_attr = {
448	.attr.name = "edid",
449	.attr.mode = 0444,
450	.size = 0,
451	.read = edid_show,
452};
453
454static struct bin_attribute *connector_bin_attrs[] = {
455	&edid_attr,
456	NULL
457};
458
459static const struct attribute_group connector_dev_group = {
460	.attrs = connector_dev_attrs,
461	.bin_attrs = connector_bin_attrs,
462};
463
464static const struct attribute_group connector_tv_dev_group = {
465	.attrs = connector_tv_dev_attrs,
466	.is_visible = connector_is_tv,
467};
468
469static const struct attribute_group connector_dvii_dev_group = {
470	.attrs = connector_dvii_dev_attrs,
471	.is_visible = connector_is_dvii,
472};
473
474static const struct attribute_group *connector_dev_groups[] = {
475	&connector_dev_group,
476	&connector_tv_dev_group,
477	&connector_dvii_dev_group,
478	NULL
479};
480
481/**
482 * drm_sysfs_connector_add - add a connector to sysfs
483 * @connector: connector to add
484 *
485 * Create a connector device in sysfs, along with its associated connector
486 * properties (so far, connection status, dpms, mode list & edid) and
487 * generate a hotplug event so userspace knows there's a new connector
488 * available.
 
 
 
 
 
489 */
490int drm_sysfs_connector_add(struct drm_connector *connector)
491{
492	struct drm_device *dev = connector->dev;
 
 
 
 
 
 
 
 
 
 
 
493
494	if (connector->kdev)
495		return 0;
496
497	connector->kdev =
498		device_create_with_groups(drm_class, dev->primary->kdev, 0,
499					  connector, connector_dev_groups,
500					  "card%d-%s", dev->primary->index,
501					  connector->name);
502	DRM_DEBUG("adding \"%s\" to sysfs\n",
503		  connector->name);
504
505	if (IS_ERR(connector->kdev)) {
506		DRM_ERROR("failed to register connector device: %ld\n", PTR_ERR(connector->kdev));
507		return PTR_ERR(connector->kdev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
508	}
509
 
 
 
 
510	/* Let userspace know we have a new connector */
511	drm_sysfs_hotplug_event(dev);
512
513	return 0;
 
 
 
 
 
 
 
 
 
 
514}
 
515
516/**
517 * drm_sysfs_connector_remove - remove an connector device from sysfs
518 * @connector: connector to remove
519 *
520 * Remove @connector and its associated attributes from sysfs.  Note that
521 * the device model core will take care of sending the "remove" uevent
522 * at this time, so we don't need to do it.
523 *
524 * Note:
525 * This routine should only be called if the connector was previously
526 * successfully registered.  If @connector hasn't been registered yet,
527 * you'll likely see a panic somewhere deep in sysfs code when called.
528 */
529void drm_sysfs_connector_remove(struct drm_connector *connector)
530{
531	if (!connector->kdev)
532		return;
533	DRM_DEBUG("removing \"%s\" from sysfs\n",
534		  connector->name);
535
536	device_unregister(connector->kdev);
537	connector->kdev = NULL;
 
 
538}
 
539
540/**
541 * drm_sysfs_hotplug_event - generate a DRM uevent
542 * @dev: DRM device
543 *
544 * Send a uevent for the DRM device specified by @dev.  Currently we only
545 * set HOTPLUG=1 in the uevent environment, but this could be expanded to
546 * deal with other types of events.
547 */
548void drm_sysfs_hotplug_event(struct drm_device *dev)
549{
550	char *event_string = "HOTPLUG=1";
551	char *envp[] = { event_string, NULL };
552
553	DRM_DEBUG("generating hotplug event\n");
554
555	kobject_uevent_env(&dev->primary->kdev->kobj, KOBJ_CHANGE, envp);
556}
557EXPORT_SYMBOL(drm_sysfs_hotplug_event);
558
559static void drm_sysfs_release(struct device *dev)
 
 
 
 
 
 
 
 
 
560{
561	kfree(dev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
562}
563
564/**
565 * drm_sysfs_minor_alloc() - Allocate sysfs device for given minor
566 * @minor: minor to allocate sysfs device for
567 *
568 * This allocates a new sysfs device for @minor and returns it. The device is
569 * not registered nor linked. The caller has to use device_add() and
570 * device_del() to register and unregister it.
571 *
572 * Note that dev_get_drvdata() on the new device will return the minor.
573 * However, the device does not hold a ref-count to the minor nor to the
574 * underlying drm_device. This is unproblematic as long as you access the
575 * private data only in sysfs callbacks. device_del() disables those
576 * synchronously, so they cannot be called after you cleanup a minor.
577 */
578struct device *drm_sysfs_minor_alloc(struct drm_minor *minor)
579{
580	const char *minor_str;
581	struct device *kdev;
582	int r;
583
584	if (minor->type == DRM_MINOR_CONTROL)
585		minor_str = "controlD%d";
586	else if (minor->type == DRM_MINOR_RENDER)
587		minor_str = "renderD%d";
588	else
589		minor_str = "card%d";
590
591	kdev = kzalloc(sizeof(*kdev), GFP_KERNEL);
592	if (!kdev)
593		return ERR_PTR(-ENOMEM);
594
595	device_initialize(kdev);
596	kdev->devt = MKDEV(DRM_MAJOR, minor->index);
597	kdev->class = drm_class;
598	kdev->type = &drm_sysfs_device_minor;
599	kdev->parent = minor->dev->dev;
600	kdev->release = drm_sysfs_release;
601	dev_set_drvdata(kdev, minor);
602
603	r = dev_set_name(kdev, minor_str, minor->index);
604	if (r < 0)
605		goto err_free;
606
607	return kdev;
608
609err_free:
610	put_device(kdev);
611	return ERR_PTR(r);
612}
613
 
614/**
615 * drm_class_device_register - Register a struct device in the drm class.
616 *
617 * @dev: pointer to struct device to register.
618 *
619 * @dev should have all relevant members pre-filled with the exception
620 * of the class member. In particular, the device_type member must
621 * be set.
622 */
623
624int drm_class_device_register(struct device *dev)
625{
626	if (!drm_class || IS_ERR(drm_class))
627		return -ENOENT;
628
629	dev->class = drm_class;
630	return device_register(dev);
631}
632EXPORT_SYMBOL_GPL(drm_class_device_register);
633
634void drm_class_device_unregister(struct device *dev)
635{
636	return device_unregister(dev);
637}
638EXPORT_SYMBOL_GPL(drm_class_device_unregister);
v3.1
  1
  2/*
  3 * drm_sysfs.c - Modifications to drm_sysfs_class.c to support
  4 *               extra sysfs attribute from DRM. Normal drm_sysfs_class
  5 *               does not allow adding attributes.
  6 *
  7 * Copyright (c) 2004 Jon Smirl <jonsmirl@gmail.com>
  8 * Copyright (c) 2003-2004 Greg Kroah-Hartman <greg@kroah.com>
  9 * Copyright (c) 2003-2004 IBM Corp.
 10 *
 11 * This file is released under the GPLv2
 12 *
 13 */
 14
 15#include <linux/device.h>
 16#include <linux/kdev_t.h>
 17#include <linux/gfp.h>
 18#include <linux/err.h>
 
 19
 20#include "drm_sysfs.h"
 21#include "drm_core.h"
 22#include "drmP.h"
 
 23
 24#define to_drm_minor(d) container_of(d, struct drm_minor, kdev)
 25#define to_drm_connector(d) container_of(d, struct drm_connector, kdev)
 26
 27static struct device_type drm_sysfs_device_minor = {
 28	.name = "drm_minor"
 29};
 30
 
 
 31/**
 32 * drm_class_suspend - DRM class suspend hook
 33 * @dev: Linux device to suspend
 34 * @state: power state to enter
 35 *
 36 * Just figures out what the actual struct drm_device associated with
 37 * @dev is and calls its suspend hook, if present.
 38 */
 39static int drm_class_suspend(struct device *dev, pm_message_t state)
 40{
 41	if (dev->type == &drm_sysfs_device_minor) {
 42		struct drm_minor *drm_minor = to_drm_minor(dev);
 43		struct drm_device *drm_dev = drm_minor->dev;
 44
 45		if (drm_minor->type == DRM_MINOR_LEGACY &&
 46		    !drm_core_check_feature(drm_dev, DRIVER_MODESET) &&
 47		    drm_dev->driver->suspend)
 48			return drm_dev->driver->suspend(drm_dev, state);
 49	}
 50	return 0;
 51}
 52
 53/**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 54 * drm_class_resume - DRM class resume hook
 55 * @dev: Linux device to resume
 56 *
 57 * Just figures out what the actual struct drm_device associated with
 58 * @dev is and calls its resume hook, if present.
 59 */
 60static int drm_class_resume(struct device *dev)
 61{
 62	if (dev->type == &drm_sysfs_device_minor) {
 63		struct drm_minor *drm_minor = to_drm_minor(dev);
 64		struct drm_device *drm_dev = drm_minor->dev;
 65
 66		if (drm_minor->type == DRM_MINOR_LEGACY &&
 67		    !drm_core_check_feature(drm_dev, DRIVER_MODESET) &&
 68		    drm_dev->driver->resume)
 69			return drm_dev->driver->resume(drm_dev);
 70	}
 71	return 0;
 72}
 73
 74static char *drm_devnode(struct device *dev, mode_t *mode)
 
 
 
 
 
 
 75{
 76	return kasprintf(GFP_KERNEL, "dri/%s", dev_name(dev));
 77}
 78
 79static CLASS_ATTR_STRING(version, S_IRUGO,
 80		CORE_NAME " "
 81		__stringify(CORE_MAJOR) "."
 82		__stringify(CORE_MINOR) "."
 83		__stringify(CORE_PATCHLEVEL) " "
 84		CORE_DATE);
 85
 86/**
 87 * drm_sysfs_create - create a struct drm_sysfs_class structure
 88 * @owner: pointer to the module that is to "own" this struct drm_sysfs_class
 89 * @name: pointer to a string for the name of this class.
 
 90 *
 91 * This is used to create DRM class pointer that can then be used
 92 * in calls to drm_sysfs_device_add().
 93 *
 94 * Note, the pointer created here is to be destroyed when finished by making a
 95 * call to drm_sysfs_destroy().
 96 */
 97struct class *drm_sysfs_create(struct module *owner, char *name)
 98{
 99	struct class *class;
100	int err;
101
102	class = class_create(owner, name);
103	if (IS_ERR(class)) {
104		err = PTR_ERR(class);
105		goto err_out;
106	}
107
108	class->suspend = drm_class_suspend;
109	class->resume = drm_class_resume;
110
111	err = class_create_file(class, &class_attr_version.attr);
112	if (err)
113		goto err_out_class;
 
 
 
114
115	class->devnode = drm_devnode;
116
117	return class;
118
119err_out_class:
120	class_destroy(class);
121err_out:
122	return ERR_PTR(err);
123}
124
125/**
126 * drm_sysfs_destroy - destroys DRM class
127 *
128 * Destroy the DRM device class.
129 */
130void drm_sysfs_destroy(void)
131{
132	if ((drm_class == NULL) || (IS_ERR(drm_class)))
133		return;
134	class_remove_file(drm_class, &class_attr_version.attr);
135	class_destroy(drm_class);
136}
137
138/**
139 * drm_sysfs_device_release - do nothing
140 * @dev: Linux device
141 *
142 * Normally, this would free the DRM device associated with @dev, along
143 * with cleaning up any other stuff.  But we do that in the DRM core, so
144 * this function can just return and hope that the core does its job.
145 */
146static void drm_sysfs_device_release(struct device *dev)
147{
148	memset(dev, 0, sizeof(struct device));
149	return;
150}
151
152/*
153 * Connector properties
154 */
155static ssize_t status_show(struct device *device,
156			   struct device_attribute *attr,
157			   char *buf)
158{
159	struct drm_connector *connector = to_drm_connector(device);
160	enum drm_connector_status status;
 
161	int ret;
162
163	ret = mutex_lock_interruptible(&connector->dev->mode_config.mutex);
164	if (ret)
165		return ret;
166
167	status = connector->funcs->detect(connector, true);
168	mutex_unlock(&connector->dev->mode_config.mutex);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
169
170	return snprintf(buf, PAGE_SIZE, "%s\n",
171			drm_get_connector_status_name(status));
172}
173
174static ssize_t dpms_show(struct device *device,
175			   struct device_attribute *attr,
176			   char *buf)
177{
178	struct drm_connector *connector = to_drm_connector(device);
179	struct drm_device *dev = connector->dev;
180	uint64_t dpms_status;
181	int ret;
182
183	ret = drm_connector_property_get_value(connector,
184					    dev->mode_config.dpms_property,
185					    &dpms_status);
186	if (ret)
187		return 0;
188
189	return snprintf(buf, PAGE_SIZE, "%s\n",
190			drm_get_dpms_name((int)dpms_status));
191}
192
193static ssize_t enabled_show(struct device *device,
194			    struct device_attribute *attr,
195			   char *buf)
196{
197	struct drm_connector *connector = to_drm_connector(device);
198
199	return snprintf(buf, PAGE_SIZE, "%s\n", connector->encoder ? "enabled" :
200			"disabled");
201}
202
203static ssize_t edid_show(struct file *filp, struct kobject *kobj,
204			 struct bin_attribute *attr, char *buf, loff_t off,
205			 size_t count)
206{
207	struct device *connector_dev = container_of(kobj, struct device, kobj);
208	struct drm_connector *connector = to_drm_connector(connector_dev);
209	unsigned char *edid;
210	size_t size;
 
211
 
212	if (!connector->edid_blob_ptr)
213		return 0;
214
215	edid = connector->edid_blob_ptr->data;
216	size = connector->edid_blob_ptr->length;
217	if (!edid)
218		return 0;
219
220	if (off >= size)
221		return 0;
222
223	if (off + count > size)
224		count = size - off;
225	memcpy(buf, edid + off, count);
226
227	return count;
 
 
 
 
228}
229
230static ssize_t modes_show(struct device *device,
231			   struct device_attribute *attr,
232			   char *buf)
233{
234	struct drm_connector *connector = to_drm_connector(device);
235	struct drm_display_mode *mode;
236	int written = 0;
237
 
238	list_for_each_entry(mode, &connector->modes, head) {
239		written += snprintf(buf + written, PAGE_SIZE - written, "%s\n",
240				    mode->name);
241	}
 
242
243	return written;
244}
245
246static ssize_t subconnector_show(struct device *device,
247			   struct device_attribute *attr,
248			   char *buf)
249{
250	struct drm_connector *connector = to_drm_connector(device);
251	struct drm_device *dev = connector->dev;
252	struct drm_property *prop = NULL;
253	uint64_t subconnector;
254	int is_tv = 0;
255	int ret;
256
257	switch (connector->connector_type) {
258		case DRM_MODE_CONNECTOR_DVII:
259			prop = dev->mode_config.dvi_i_subconnector_property;
260			break;
261		case DRM_MODE_CONNECTOR_Composite:
262		case DRM_MODE_CONNECTOR_SVIDEO:
263		case DRM_MODE_CONNECTOR_Component:
264		case DRM_MODE_CONNECTOR_TV:
265			prop = dev->mode_config.tv_subconnector_property;
266			is_tv = 1;
267			break;
268		default:
269			DRM_ERROR("Wrong connector type for this property\n");
270			return 0;
271	}
272
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
273	if (!prop) {
274		DRM_ERROR("Unable to find subconnector property\n");
275		return 0;
276	}
277
278	ret = drm_connector_property_get_value(connector, prop, &subconnector);
279	if (ret)
280		return 0;
281
282	return snprintf(buf, PAGE_SIZE, "%s", is_tv ?
283			drm_get_tv_subconnector_name((int)subconnector) :
284			drm_get_dvi_i_subconnector_name((int)subconnector));
285}
286
287static ssize_t select_subconnector_show(struct device *device,
288			   struct device_attribute *attr,
289			   char *buf)
290{
291	struct drm_connector *connector = to_drm_connector(device);
292	struct drm_device *dev = connector->dev;
293	struct drm_property *prop = NULL;
294	uint64_t subconnector;
295	int is_tv = 0;
296	int ret;
297
298	switch (connector->connector_type) {
299		case DRM_MODE_CONNECTOR_DVII:
300			prop = dev->mode_config.dvi_i_select_subconnector_property;
301			break;
302		case DRM_MODE_CONNECTOR_Composite:
303		case DRM_MODE_CONNECTOR_SVIDEO:
304		case DRM_MODE_CONNECTOR_Component:
305		case DRM_MODE_CONNECTOR_TV:
306			prop = dev->mode_config.tv_select_subconnector_property;
307			is_tv = 1;
308			break;
309		default:
310			DRM_ERROR("Wrong connector type for this property\n");
311			return 0;
312	}
313
314	if (!prop) {
315		DRM_ERROR("Unable to find select subconnector property\n");
316		return 0;
317	}
318
319	ret = drm_connector_property_get_value(connector, prop, &subconnector);
320	if (ret)
321		return 0;
322
323	return snprintf(buf, PAGE_SIZE, "%s", is_tv ?
324			drm_get_tv_select_name((int)subconnector) :
325			drm_get_dvi_i_select_name((int)subconnector));
326}
327
328static struct device_attribute connector_attrs[] = {
329	__ATTR_RO(status),
330	__ATTR_RO(enabled),
331	__ATTR_RO(dpms),
332	__ATTR_RO(modes),
 
 
 
 
 
 
333};
334
335/* These attributes are for both DVI-I connectors and all types of tv-out. */
336static struct device_attribute connector_attrs_opt1[] = {
337	__ATTR_RO(subconnector),
338	__ATTR_RO(select_subconnector),
 
 
 
 
 
 
 
 
 
 
 
 
339};
340
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
341static struct bin_attribute edid_attr = {
342	.attr.name = "edid",
343	.attr.mode = 0444,
344	.size = 0,
345	.read = edid_show,
346};
347
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
348/**
349 * drm_sysfs_connector_add - add an connector to sysfs
350 * @connector: connector to add
351 *
352 * Create an connector device in sysfs, along with its associated connector
353 * properties (so far, connection status, dpms, mode list & edid) and
354 * generate a hotplug event so userspace knows there's a new connector
355 * available.
356 *
357 * Note:
358 * This routine should only be called *once* for each DRM minor registered.
359 * A second call for an already registered device will trigger the BUG_ON
360 * below.
361 */
362int drm_sysfs_connector_add(struct drm_connector *connector)
363{
364	struct drm_device *dev = connector->dev;
365	int attr_cnt = 0;
366	int opt_cnt = 0;
367	int i;
368	int ret = 0;
369
370	/* We shouldn't get called more than once for the same connector */
371	BUG_ON(device_is_registered(&connector->kdev));
372
373	connector->kdev.parent = &dev->primary->kdev;
374	connector->kdev.class = drm_class;
375	connector->kdev.release = drm_sysfs_device_release;
376
 
 
 
 
 
 
 
 
377	DRM_DEBUG("adding \"%s\" to sysfs\n",
378		  drm_get_connector_name(connector));
379
380	dev_set_name(&connector->kdev, "card%d-%s",
381		     dev->primary->index, drm_get_connector_name(connector));
382	ret = device_register(&connector->kdev);
383
384	if (ret) {
385		DRM_ERROR("failed to register connector device: %d\n", ret);
386		goto out;
387	}
388
389	/* Standard attributes */
390
391	for (attr_cnt = 0; attr_cnt < ARRAY_SIZE(connector_attrs); attr_cnt++) {
392		ret = device_create_file(&connector->kdev, &connector_attrs[attr_cnt]);
393		if (ret)
394			goto err_out_files;
395	}
396
397	/* Optional attributes */
398	/*
399	 * In the long run it maybe a good idea to make one set of
400	 * optionals per connector type.
401	 */
402	switch (connector->connector_type) {
403		case DRM_MODE_CONNECTOR_DVII:
404		case DRM_MODE_CONNECTOR_Composite:
405		case DRM_MODE_CONNECTOR_SVIDEO:
406		case DRM_MODE_CONNECTOR_Component:
407		case DRM_MODE_CONNECTOR_TV:
408			for (opt_cnt = 0; opt_cnt < ARRAY_SIZE(connector_attrs_opt1); opt_cnt++) {
409				ret = device_create_file(&connector->kdev, &connector_attrs_opt1[opt_cnt]);
410				if (ret)
411					goto err_out_files;
412			}
413			break;
414		default:
415			break;
416	}
417
418	ret = sysfs_create_bin_file(&connector->kdev.kobj, &edid_attr);
419	if (ret)
420		goto err_out_files;
421
422	/* Let userspace know we have a new connector */
423	drm_sysfs_hotplug_event(dev);
424
425	return 0;
426
427err_out_files:
428	for (i = 0; i < opt_cnt; i++)
429		device_remove_file(&connector->kdev, &connector_attrs_opt1[i]);
430	for (i = 0; i < attr_cnt; i++)
431		device_remove_file(&connector->kdev, &connector_attrs[i]);
432	device_unregister(&connector->kdev);
433
434out:
435	return ret;
436}
437EXPORT_SYMBOL(drm_sysfs_connector_add);
438
439/**
440 * drm_sysfs_connector_remove - remove an connector device from sysfs
441 * @connector: connector to remove
442 *
443 * Remove @connector and its associated attributes from sysfs.  Note that
444 * the device model core will take care of sending the "remove" uevent
445 * at this time, so we don't need to do it.
446 *
447 * Note:
448 * This routine should only be called if the connector was previously
449 * successfully registered.  If @connector hasn't been registered yet,
450 * you'll likely see a panic somewhere deep in sysfs code when called.
451 */
452void drm_sysfs_connector_remove(struct drm_connector *connector)
453{
454	int i;
455
456	DRM_DEBUG("removing \"%s\" from sysfs\n",
457		  drm_get_connector_name(connector));
458
459	for (i = 0; i < ARRAY_SIZE(connector_attrs); i++)
460		device_remove_file(&connector->kdev, &connector_attrs[i]);
461	sysfs_remove_bin_file(&connector->kdev.kobj, &edid_attr);
462	device_unregister(&connector->kdev);
463}
464EXPORT_SYMBOL(drm_sysfs_connector_remove);
465
466/**
467 * drm_sysfs_hotplug_event - generate a DRM uevent
468 * @dev: DRM device
469 *
470 * Send a uevent for the DRM device specified by @dev.  Currently we only
471 * set HOTPLUG=1 in the uevent environment, but this could be expanded to
472 * deal with other types of events.
473 */
474void drm_sysfs_hotplug_event(struct drm_device *dev)
475{
476	char *event_string = "HOTPLUG=1";
477	char *envp[] = { event_string, NULL };
478
479	DRM_DEBUG("generating hotplug event\n");
480
481	kobject_uevent_env(&dev->primary->kdev.kobj, KOBJ_CHANGE, envp);
482}
483EXPORT_SYMBOL(drm_sysfs_hotplug_event);
484
485/**
486 * drm_sysfs_device_add - adds a class device to sysfs for a character driver
487 * @dev: DRM device to be added
488 * @head: DRM head in question
489 *
490 * Add a DRM device to the DRM's device model class.  We use @dev's PCI device
491 * as the parent for the Linux device, and make sure it has a file containing
492 * the driver we're using (for userspace compatibility).
493 */
494int drm_sysfs_device_add(struct drm_minor *minor)
495{
496	int err;
497	char *minor_str;
498
499	minor->kdev.parent = minor->dev->dev;
500
501	minor->kdev.class = drm_class;
502	minor->kdev.release = drm_sysfs_device_release;
503	minor->kdev.devt = minor->device;
504	minor->kdev.type = &drm_sysfs_device_minor;
505	if (minor->type == DRM_MINOR_CONTROL)
506		minor_str = "controlD%d";
507        else if (minor->type == DRM_MINOR_RENDER)
508                minor_str = "renderD%d";
509        else
510                minor_str = "card%d";
511
512	dev_set_name(&minor->kdev, minor_str, minor->index);
513
514	err = device_register(&minor->kdev);
515	if (err) {
516		DRM_ERROR("device add failed: %d\n", err);
517		goto err_out;
518	}
519
520	return 0;
521
522err_out:
523	return err;
524}
525
526/**
527 * drm_sysfs_device_remove - remove DRM device
528 * @dev: DRM device to remove
529 *
530 * This call unregisters and cleans up a class device that was created with a
531 * call to drm_sysfs_device_add()
 
 
 
 
 
 
 
532 */
533void drm_sysfs_device_remove(struct drm_minor *minor)
534{
535	device_unregister(&minor->kdev);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
536}
537
538
539/**
540 * drm_class_device_register - Register a struct device in the drm class.
541 *
542 * @dev: pointer to struct device to register.
543 *
544 * @dev should have all relevant members pre-filled with the exception
545 * of the class member. In particular, the device_type member must
546 * be set.
547 */
548
549int drm_class_device_register(struct device *dev)
550{
 
 
 
551	dev->class = drm_class;
552	return device_register(dev);
553}
554EXPORT_SYMBOL_GPL(drm_class_device_register);
555
556void drm_class_device_unregister(struct device *dev)
557{
558	return device_unregister(dev);
559}
560EXPORT_SYMBOL_GPL(drm_class_device_unregister);