linux/drivers/usb/host/ohci-s3c2410.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-1.0+
   2/*
   3 * OHCI HCD (Host Controller Driver) for USB.
   4 *
   5 * (C) Copyright 1999 Roman Weissgaerber <weissg@vienna.at>
   6 * (C) Copyright 2000-2002 David Brownell <dbrownell@users.sourceforge.net>
   7 * (C) Copyright 2002 Hewlett-Packard Company
   8 *
   9 * USB Bus Glue for Samsung S3C2410
  10 *
  11 * Written by Christopher Hoover <ch@hpl.hp.com>
  12 * Based on fragments of previous driver by Russell King et al.
  13 *
  14 * Modified for S3C2410 from ohci-sa1111.c, ohci-omap.c and ohci-lh7a40.c
  15 *      by Ben Dooks, <ben@simtec.co.uk>
  16 *      Copyright (C) 2004 Simtec Electronics
  17 *
  18 * Thanks to basprog@mail.ru for updates to newer kernels
  19 *
  20 * This file is licenced under the GPL.
  21*/
  22
  23#include <linux/clk.h>
  24#include <linux/io.h>
  25#include <linux/kernel.h>
  26#include <linux/module.h>
  27#include <linux/platform_device.h>
  28#include <linux/platform_data/usb-ohci-s3c2410.h>
  29#include <linux/usb.h>
  30#include <linux/usb/hcd.h>
  31
  32#include "ohci.h"
  33
  34
  35#define valid_port(idx) ((idx) == 1 || (idx) == 2)
  36
  37/* clock device associated with the hcd */
  38
  39
  40#define DRIVER_DESC "OHCI S3C2410 driver"
  41
  42static const char hcd_name[] = "ohci-s3c2410";
  43
  44static struct clk *clk;
  45static struct clk *usb_clk;
  46
  47static struct hc_driver __read_mostly ohci_s3c2410_hc_driver;
  48
  49/* forward definitions */
  50
  51static void s3c2410_hcd_oc(struct s3c2410_hcd_info *info, int port_oc);
  52
  53/* conversion functions */
  54
  55static struct s3c2410_hcd_info *to_s3c2410_info(struct usb_hcd *hcd)
  56{
  57        return dev_get_platdata(hcd->self.controller);
  58}
  59
  60static void s3c2410_start_hc(struct platform_device *dev, struct usb_hcd *hcd)
  61{
  62        struct s3c2410_hcd_info *info = dev_get_platdata(&dev->dev);
  63
  64        dev_dbg(&dev->dev, "s3c2410_start_hc:\n");
  65
  66        clk_prepare_enable(usb_clk);
  67        mdelay(2);                      /* let the bus clock stabilise */
  68
  69        clk_prepare_enable(clk);
  70
  71        if (info != NULL) {
  72                info->hcd       = hcd;
  73                info->report_oc = s3c2410_hcd_oc;
  74
  75                if (info->enable_oc != NULL)
  76                        (info->enable_oc)(info, 1);
  77        }
  78}
  79
  80static void s3c2410_stop_hc(struct platform_device *dev)
  81{
  82        struct s3c2410_hcd_info *info = dev_get_platdata(&dev->dev);
  83
  84        dev_dbg(&dev->dev, "s3c2410_stop_hc:\n");
  85
  86        if (info != NULL) {
  87                info->report_oc = NULL;
  88                info->hcd       = NULL;
  89
  90                if (info->enable_oc != NULL)
  91                        (info->enable_oc)(info, 0);
  92        }
  93
  94        clk_disable_unprepare(clk);
  95        clk_disable_unprepare(usb_clk);
  96}
  97
  98/* ohci_s3c2410_hub_status_data
  99 *
 100 * update the status data from the hub with anything that
 101 * has been detected by our system
 102*/
 103
 104static int
 105ohci_s3c2410_hub_status_data(struct usb_hcd *hcd, char *buf)
 106{
 107        struct s3c2410_hcd_info *info = to_s3c2410_info(hcd);
 108        struct s3c2410_hcd_port *port;
 109        int orig;
 110        int portno;
 111
 112        orig = ohci_hub_status_data(hcd, buf);
 113
 114        if (info == NULL)
 115                return orig;
 116
 117        port = &info->port[0];
 118
 119        /* mark any changed port as changed */
 120
 121        for (portno = 0; portno < 2; port++, portno++) {
 122                if (port->oc_changed == 1 &&
 123                    port->flags & S3C_HCDFLG_USED) {
 124                        dev_dbg(hcd->self.controller,
 125                                "oc change on port %d\n", portno);
 126
 127                        if (orig < 1)
 128                                orig = 1;
 129
 130                        buf[0] |= 1<<(portno+1);
 131                }
 132        }
 133
 134        return orig;
 135}
 136
 137/* s3c2410_usb_set_power
 138 *
 139 * configure the power on a port, by calling the platform device
 140 * routine registered with the platform device
 141*/
 142
 143static void s3c2410_usb_set_power(struct s3c2410_hcd_info *info,
 144                                  int port, int to)
 145{
 146        if (info == NULL)
 147                return;
 148
 149        if (info->power_control != NULL) {
 150                info->port[port-1].power = to;
 151                (info->power_control)(port-1, to);
 152        }
 153}
 154
 155/* ohci_s3c2410_hub_control
 156 *
 157 * look at control requests to the hub, and see if we need
 158 * to take any action or over-ride the results from the
 159 * request.
 160*/
 161
 162static int ohci_s3c2410_hub_control(
 163        struct usb_hcd  *hcd,
 164        u16             typeReq,
 165        u16             wValue,
 166        u16             wIndex,
 167        char            *buf,
 168        u16             wLength)
 169{
 170        struct s3c2410_hcd_info *info = to_s3c2410_info(hcd);
 171        struct usb_hub_descriptor *desc;
 172        int ret = -EINVAL;
 173        u32 *data = (u32 *)buf;
 174
 175        dev_dbg(hcd->self.controller,
 176                "s3c2410_hub_control(%p,0x%04x,0x%04x,0x%04x,%p,%04x)\n",
 177                hcd, typeReq, wValue, wIndex, buf, wLength);
 178
 179        /* if we are only an humble host without any special capabilities
 180         * process the request straight away and exit */
 181
 182        if (info == NULL) {
 183                ret = ohci_hub_control(hcd, typeReq, wValue,
 184                                       wIndex, buf, wLength);
 185                goto out;
 186        }
 187
 188        /* check the request to see if it needs handling */
 189
 190        switch (typeReq) {
 191        case SetPortFeature:
 192                if (wValue == USB_PORT_FEAT_POWER) {
 193                        dev_dbg(hcd->self.controller, "SetPortFeat: POWER\n");
 194                        s3c2410_usb_set_power(info, wIndex, 1);
 195                        goto out;
 196                }
 197                break;
 198
 199        case ClearPortFeature:
 200                switch (wValue) {
 201                case USB_PORT_FEAT_C_OVER_CURRENT:
 202                        dev_dbg(hcd->self.controller,
 203                                "ClearPortFeature: C_OVER_CURRENT\n");
 204
 205                        if (valid_port(wIndex)) {
 206                                info->port[wIndex-1].oc_changed = 0;
 207                                info->port[wIndex-1].oc_status = 0;
 208                        }
 209
 210                        goto out;
 211
 212                case USB_PORT_FEAT_OVER_CURRENT:
 213                        dev_dbg(hcd->self.controller,
 214                                "ClearPortFeature: OVER_CURRENT\n");
 215
 216                        if (valid_port(wIndex))
 217                                info->port[wIndex-1].oc_status = 0;
 218
 219                        goto out;
 220
 221                case USB_PORT_FEAT_POWER:
 222                        dev_dbg(hcd->self.controller,
 223                                "ClearPortFeature: POWER\n");
 224
 225                        if (valid_port(wIndex)) {
 226                                s3c2410_usb_set_power(info, wIndex, 0);
 227                                return 0;
 228                        }
 229                }
 230                break;
 231        }
 232
 233        ret = ohci_hub_control(hcd, typeReq, wValue, wIndex, buf, wLength);
 234        if (ret)
 235                goto out;
 236
 237        switch (typeReq) {
 238        case GetHubDescriptor:
 239
 240                /* update the hub's descriptor */
 241
 242                desc = (struct usb_hub_descriptor *)buf;
 243
 244                if (info->power_control == NULL)
 245                        return ret;
 246
 247                dev_dbg(hcd->self.controller, "wHubCharacteristics 0x%04x\n",
 248                        desc->wHubCharacteristics);
 249
 250                /* remove the old configurations for power-switching, and
 251                 * over-current protection, and insert our new configuration
 252                 */
 253
 254                desc->wHubCharacteristics &= ~cpu_to_le16(HUB_CHAR_LPSM);
 255                desc->wHubCharacteristics |= cpu_to_le16(
 256                        HUB_CHAR_INDV_PORT_LPSM);
 257
 258                if (info->enable_oc) {
 259                        desc->wHubCharacteristics &= ~cpu_to_le16(
 260                                HUB_CHAR_OCPM);
 261                        desc->wHubCharacteristics |=  cpu_to_le16(
 262                                HUB_CHAR_INDV_PORT_OCPM);
 263                }
 264
 265                dev_dbg(hcd->self.controller, "wHubCharacteristics after 0x%04x\n",
 266                        desc->wHubCharacteristics);
 267
 268                return ret;
 269
 270        case GetPortStatus:
 271                /* check port status */
 272
 273                dev_dbg(hcd->self.controller, "GetPortStatus(%d)\n", wIndex);
 274
 275                if (valid_port(wIndex)) {
 276                        if (info->port[wIndex-1].oc_changed)
 277                                *data |= cpu_to_le32(RH_PS_OCIC);
 278
 279                        if (info->port[wIndex-1].oc_status)
 280                                *data |= cpu_to_le32(RH_PS_POCI);
 281                }
 282        }
 283
 284 out:
 285        return ret;
 286}
 287
 288/* s3c2410_hcd_oc
 289 *
 290 * handle an over-current report
 291*/
 292
 293static void s3c2410_hcd_oc(struct s3c2410_hcd_info *info, int port_oc)
 294{
 295        struct s3c2410_hcd_port *port;
 296        unsigned long flags;
 297        int portno;
 298
 299        if (info == NULL)
 300                return;
 301
 302        port = &info->port[0];
 303
 304        local_irq_save(flags);
 305
 306        for (portno = 0; portno < 2; port++, portno++) {
 307                if (port_oc & (1<<portno) &&
 308                    port->flags & S3C_HCDFLG_USED) {
 309                        port->oc_status = 1;
 310                        port->oc_changed = 1;
 311
 312                        /* ok, once over-current is detected,
 313                           the port needs to be powered down */
 314                        s3c2410_usb_set_power(info, portno+1, 0);
 315                }
 316        }
 317
 318        local_irq_restore(flags);
 319}
 320
 321/* may be called without controller electrically present */
 322/* may be called with controller, bus, and devices active */
 323
 324/*
 325 * ohci_hcd_s3c2410_remove - shutdown processing for HCD
 326 * @dev: USB Host Controller being removed
 327 * Context: !in_interrupt()
 328 *
 329 * Reverses the effect of ohci_hcd_3c2410_probe(), first invoking
 330 * the HCD's stop() method.  It is always called from a thread
 331 * context, normally "rmmod", "apmd", or something similar.
 332 *
 333*/
 334
 335static int
 336ohci_hcd_s3c2410_remove(struct platform_device *dev)
 337{
 338        struct usb_hcd *hcd = platform_get_drvdata(dev);
 339
 340        usb_remove_hcd(hcd);
 341        s3c2410_stop_hc(dev);
 342        usb_put_hcd(hcd);
 343        return 0;
 344}
 345
 346/**
 347 * ohci_hcd_s3c2410_probe - initialize S3C2410-based HCDs
 348 * Context: !in_interrupt()
 349 *
 350 * Allocates basic resources for this USB host controller, and
 351 * then invokes the start() method for the HCD associated with it
 352 * through the hotplug entry's driver_data.
 353 *
 354 */
 355static int ohci_hcd_s3c2410_probe(struct platform_device *dev)
 356{
 357        struct usb_hcd *hcd = NULL;
 358        struct s3c2410_hcd_info *info = dev_get_platdata(&dev->dev);
 359        int retval;
 360
 361        s3c2410_usb_set_power(info, 1, 1);
 362        s3c2410_usb_set_power(info, 2, 1);
 363
 364        hcd = usb_create_hcd(&ohci_s3c2410_hc_driver, &dev->dev, "s3c24xx");
 365        if (hcd == NULL)
 366                return -ENOMEM;
 367
 368        hcd->rsrc_start = dev->resource[0].start;
 369        hcd->rsrc_len   = resource_size(&dev->resource[0]);
 370
 371        hcd->regs = devm_ioremap_resource(&dev->dev, &dev->resource[0]);
 372        if (IS_ERR(hcd->regs)) {
 373                retval = PTR_ERR(hcd->regs);
 374                goto err_put;
 375        }
 376
 377        clk = devm_clk_get(&dev->dev, "usb-host");
 378        if (IS_ERR(clk)) {
 379                dev_err(&dev->dev, "cannot get usb-host clock\n");
 380                retval = PTR_ERR(clk);
 381                goto err_put;
 382        }
 383
 384        usb_clk = devm_clk_get(&dev->dev, "usb-bus-host");
 385        if (IS_ERR(usb_clk)) {
 386                dev_err(&dev->dev, "cannot get usb-bus-host clock\n");
 387                retval = PTR_ERR(usb_clk);
 388                goto err_put;
 389        }
 390
 391        s3c2410_start_hc(dev, hcd);
 392
 393        retval = usb_add_hcd(hcd, dev->resource[1].start, 0);
 394        if (retval != 0)
 395                goto err_ioremap;
 396
 397        device_wakeup_enable(hcd->self.controller);
 398        return 0;
 399
 400 err_ioremap:
 401        s3c2410_stop_hc(dev);
 402
 403 err_put:
 404        usb_put_hcd(hcd);
 405        return retval;
 406}
 407
 408/*-------------------------------------------------------------------------*/
 409
 410#ifdef CONFIG_PM
 411static int ohci_hcd_s3c2410_drv_suspend(struct device *dev)
 412{
 413        struct usb_hcd *hcd = dev_get_drvdata(dev);
 414        struct platform_device *pdev = to_platform_device(dev);
 415        bool do_wakeup = device_may_wakeup(dev);
 416        int rc = 0;
 417
 418        rc = ohci_suspend(hcd, do_wakeup);
 419        if (rc)
 420                return rc;
 421
 422        s3c2410_stop_hc(pdev);
 423
 424        return rc;
 425}
 426
 427static int ohci_hcd_s3c2410_drv_resume(struct device *dev)
 428{
 429        struct usb_hcd *hcd = dev_get_drvdata(dev);
 430        struct platform_device *pdev = to_platform_device(dev);
 431
 432        s3c2410_start_hc(pdev, hcd);
 433
 434        ohci_resume(hcd, false);
 435
 436        return 0;
 437}
 438#else
 439#define ohci_hcd_s3c2410_drv_suspend    NULL
 440#define ohci_hcd_s3c2410_drv_resume     NULL
 441#endif
 442
 443static const struct dev_pm_ops ohci_hcd_s3c2410_pm_ops = {
 444        .suspend        = ohci_hcd_s3c2410_drv_suspend,
 445        .resume         = ohci_hcd_s3c2410_drv_resume,
 446};
 447
 448static const struct of_device_id ohci_hcd_s3c2410_dt_ids[] = {
 449        { .compatible = "samsung,s3c2410-ohci" },
 450        { /* sentinel */ }
 451};
 452
 453MODULE_DEVICE_TABLE(of, ohci_hcd_s3c2410_dt_ids);
 454
 455static struct platform_driver ohci_hcd_s3c2410_driver = {
 456        .probe          = ohci_hcd_s3c2410_probe,
 457        .remove         = ohci_hcd_s3c2410_remove,
 458        .shutdown       = usb_hcd_platform_shutdown,
 459        .driver         = {
 460                .name   = "s3c2410-ohci",
 461                .pm     = &ohci_hcd_s3c2410_pm_ops,
 462                .of_match_table = ohci_hcd_s3c2410_dt_ids,
 463        },
 464};
 465
 466static int __init ohci_s3c2410_init(void)
 467{
 468        if (usb_disabled())
 469                return -ENODEV;
 470
 471        pr_info("%s: " DRIVER_DESC "\n", hcd_name);
 472        ohci_init_driver(&ohci_s3c2410_hc_driver, NULL);
 473
 474        /*
 475         * The Samsung HW has some unusual quirks, which require
 476         * Sumsung-specific workarounds. We override certain hc_driver
 477         * functions here to achieve that. We explicitly do not enhance
 478         * ohci_driver_overrides to allow this more easily, since this
 479         * is an unusual case, and we don't want to encourage others to
 480         * override these functions by making it too easy.
 481         */
 482
 483        ohci_s3c2410_hc_driver.hub_status_data  = ohci_s3c2410_hub_status_data;
 484        ohci_s3c2410_hc_driver.hub_control      = ohci_s3c2410_hub_control;
 485
 486        return platform_driver_register(&ohci_hcd_s3c2410_driver);
 487}
 488module_init(ohci_s3c2410_init);
 489
 490static void __exit ohci_s3c2410_cleanup(void)
 491{
 492        platform_driver_unregister(&ohci_hcd_s3c2410_driver);
 493}
 494module_exit(ohci_s3c2410_cleanup);
 495
 496MODULE_DESCRIPTION(DRIVER_DESC);
 497MODULE_LICENSE("GPL");
 498MODULE_ALIAS("platform:s3c2410-ohci");
 499