linux/drivers/hwtracing/coresight/coresight.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 * Copyright (c) 2012, The Linux Foundation. All rights reserved.
   4 */
   5
   6#include <linux/kernel.h>
   7#include <linux/init.h>
   8#include <linux/types.h>
   9#include <linux/device.h>
  10#include <linux/io.h>
  11#include <linux/err.h>
  12#include <linux/export.h>
  13#include <linux/slab.h>
  14#include <linux/stringhash.h>
  15#include <linux/mutex.h>
  16#include <linux/clk.h>
  17#include <linux/coresight.h>
  18#include <linux/of_platform.h>
  19#include <linux/delay.h>
  20#include <linux/pm_runtime.h>
  21
  22#include "coresight-etm-perf.h"
  23#include "coresight-priv.h"
  24
  25static DEFINE_MUTEX(coresight_mutex);
  26
  27/**
  28 * struct coresight_node - elements of a path, from source to sink
  29 * @csdev:      Address of an element.
  30 * @link:       hook to the list.
  31 */
  32struct coresight_node {
  33        struct coresight_device *csdev;
  34        struct list_head link;
  35};
  36
  37/*
  38 * When operating Coresight drivers from the sysFS interface, only a single
  39 * path can exist from a tracer (associated to a CPU) to a sink.
  40 */
  41static DEFINE_PER_CPU(struct list_head *, tracer_path);
  42
  43/*
  44 * As of this writing only a single STM can be found in CS topologies.  Since
  45 * there is no way to know if we'll ever see more and what kind of
  46 * configuration they will enact, for the time being only define a single path
  47 * for STM.
  48 */
  49static struct list_head *stm_path;
  50
  51/*
  52 * When losing synchronisation a new barrier packet needs to be inserted at the
  53 * beginning of the data collected in a buffer.  That way the decoder knows that
  54 * it needs to look for another sync sequence.
  55 */
  56const u32 barrier_pkt[4] = {0x7fffffff, 0x7fffffff, 0x7fffffff, 0x7fffffff};
  57
  58static int coresight_id_match(struct device *dev, void *data)
  59{
  60        int trace_id, i_trace_id;
  61        struct coresight_device *csdev, *i_csdev;
  62
  63        csdev = data;
  64        i_csdev = to_coresight_device(dev);
  65
  66        /*
  67         * No need to care about oneself and components that are not
  68         * sources or not enabled
  69         */
  70        if (i_csdev == csdev || !i_csdev->enable ||
  71            i_csdev->type != CORESIGHT_DEV_TYPE_SOURCE)
  72                return 0;
  73
  74        /* Get the source ID for both compoment */
  75        trace_id = source_ops(csdev)->trace_id(csdev);
  76        i_trace_id = source_ops(i_csdev)->trace_id(i_csdev);
  77
  78        /* All you need is one */
  79        if (trace_id == i_trace_id)
  80                return 1;
  81
  82        return 0;
  83}
  84
  85static int coresight_source_is_unique(struct coresight_device *csdev)
  86{
  87        int trace_id = source_ops(csdev)->trace_id(csdev);
  88
  89        /* this shouldn't happen */
  90        if (trace_id < 0)
  91                return 0;
  92
  93        return !bus_for_each_dev(&coresight_bustype, NULL,
  94                                 csdev, coresight_id_match);
  95}
  96
  97static int coresight_find_link_inport(struct coresight_device *csdev,
  98                                      struct coresight_device *parent)
  99{
 100        int i;
 101        struct coresight_connection *conn;
 102
 103        for (i = 0; i < parent->pdata->nr_outport; i++) {
 104                conn = &parent->pdata->conns[i];
 105                if (conn->child_dev == csdev)
 106                        return conn->child_port;
 107        }
 108
 109        dev_err(&csdev->dev, "couldn't find inport, parent: %s, child: %s\n",
 110                dev_name(&parent->dev), dev_name(&csdev->dev));
 111
 112        return -ENODEV;
 113}
 114
 115static int coresight_find_link_outport(struct coresight_device *csdev,
 116                                       struct coresight_device *child)
 117{
 118        int i;
 119        struct coresight_connection *conn;
 120
 121        for (i = 0; i < csdev->pdata->nr_outport; i++) {
 122                conn = &csdev->pdata->conns[i];
 123                if (conn->child_dev == child)
 124                        return conn->outport;
 125        }
 126
 127        dev_err(&csdev->dev, "couldn't find outport, parent: %s, child: %s\n",
 128                dev_name(&csdev->dev), dev_name(&child->dev));
 129
 130        return -ENODEV;
 131}
 132
 133static inline u32 coresight_read_claim_tags(void __iomem *base)
 134{
 135        return readl_relaxed(base + CORESIGHT_CLAIMCLR);
 136}
 137
 138static inline bool coresight_is_claimed_self_hosted(void __iomem *base)
 139{
 140        return coresight_read_claim_tags(base) == CORESIGHT_CLAIM_SELF_HOSTED;
 141}
 142
 143static inline bool coresight_is_claimed_any(void __iomem *base)
 144{
 145        return coresight_read_claim_tags(base) != 0;
 146}
 147
 148static inline void coresight_set_claim_tags(void __iomem *base)
 149{
 150        writel_relaxed(CORESIGHT_CLAIM_SELF_HOSTED, base + CORESIGHT_CLAIMSET);
 151        isb();
 152}
 153
 154static inline void coresight_clear_claim_tags(void __iomem *base)
 155{
 156        writel_relaxed(CORESIGHT_CLAIM_SELF_HOSTED, base + CORESIGHT_CLAIMCLR);
 157        isb();
 158}
 159
 160/*
 161 * coresight_claim_device_unlocked : Claim the device for self-hosted usage
 162 * to prevent an external tool from touching this device. As per PSCI
 163 * standards, section "Preserving the execution context" => "Debug and Trace
 164 * save and Restore", DBGCLAIM[1] is reserved for Self-hosted debug/trace and
 165 * DBGCLAIM[0] is reserved for external tools.
 166 *
 167 * Called with CS_UNLOCKed for the component.
 168 * Returns : 0 on success
 169 */
 170int coresight_claim_device_unlocked(void __iomem *base)
 171{
 172        if (coresight_is_claimed_any(base))
 173                return -EBUSY;
 174
 175        coresight_set_claim_tags(base);
 176        if (coresight_is_claimed_self_hosted(base))
 177                return 0;
 178        /* There was a race setting the tags, clean up and fail */
 179        coresight_clear_claim_tags(base);
 180        return -EBUSY;
 181}
 182
 183int coresight_claim_device(void __iomem *base)
 184{
 185        int rc;
 186
 187        CS_UNLOCK(base);
 188        rc = coresight_claim_device_unlocked(base);
 189        CS_LOCK(base);
 190
 191        return rc;
 192}
 193
 194/*
 195 * coresight_disclaim_device_unlocked : Clear the claim tags for the device.
 196 * Called with CS_UNLOCKed for the component.
 197 */
 198void coresight_disclaim_device_unlocked(void __iomem *base)
 199{
 200
 201        if (coresight_is_claimed_self_hosted(base))
 202                coresight_clear_claim_tags(base);
 203        else
 204                /*
 205                 * The external agent may have not honoured our claim
 206                 * and has manipulated it. Or something else has seriously
 207                 * gone wrong in our driver.
 208                 */
 209                WARN_ON_ONCE(1);
 210}
 211
 212void coresight_disclaim_device(void __iomem *base)
 213{
 214        CS_UNLOCK(base);
 215        coresight_disclaim_device_unlocked(base);
 216        CS_LOCK(base);
 217}
 218
 219static int coresight_enable_sink(struct coresight_device *csdev,
 220                                 u32 mode, void *data)
 221{
 222        int ret;
 223
 224        /*
 225         * We need to make sure the "new" session is compatible with the
 226         * existing "mode" of operation.
 227         */
 228        if (!sink_ops(csdev)->enable)
 229                return -EINVAL;
 230
 231        ret = sink_ops(csdev)->enable(csdev, mode, data);
 232        if (ret)
 233                return ret;
 234        csdev->enable = true;
 235
 236        return 0;
 237}
 238
 239static void coresight_disable_sink(struct coresight_device *csdev)
 240{
 241        int ret;
 242
 243        if (!sink_ops(csdev)->disable)
 244                return;
 245
 246        ret = sink_ops(csdev)->disable(csdev);
 247        if (ret)
 248                return;
 249        csdev->enable = false;
 250}
 251
 252static int coresight_enable_link(struct coresight_device *csdev,
 253                                 struct coresight_device *parent,
 254                                 struct coresight_device *child)
 255{
 256        int ret;
 257        int link_subtype;
 258        int refport, inport, outport;
 259
 260        if (!parent || !child)
 261                return -EINVAL;
 262
 263        inport = coresight_find_link_inport(csdev, parent);
 264        outport = coresight_find_link_outport(csdev, child);
 265        link_subtype = csdev->subtype.link_subtype;
 266
 267        if (link_subtype == CORESIGHT_DEV_SUBTYPE_LINK_MERG)
 268                refport = inport;
 269        else if (link_subtype == CORESIGHT_DEV_SUBTYPE_LINK_SPLIT)
 270                refport = outport;
 271        else
 272                refport = 0;
 273
 274        if (refport < 0)
 275                return refport;
 276
 277        if (atomic_inc_return(&csdev->refcnt[refport]) == 1) {
 278                if (link_ops(csdev)->enable) {
 279                        ret = link_ops(csdev)->enable(csdev, inport, outport);
 280                        if (ret) {
 281                                atomic_dec(&csdev->refcnt[refport]);
 282                                return ret;
 283                        }
 284                }
 285        }
 286
 287        csdev->enable = true;
 288
 289        return 0;
 290}
 291
 292static void coresight_disable_link(struct coresight_device *csdev,
 293                                   struct coresight_device *parent,
 294                                   struct coresight_device *child)
 295{
 296        int i, nr_conns;
 297        int link_subtype;
 298        int refport, inport, outport;
 299
 300        if (!parent || !child)
 301                return;
 302
 303        inport = coresight_find_link_inport(csdev, parent);
 304        outport = coresight_find_link_outport(csdev, child);
 305        link_subtype = csdev->subtype.link_subtype;
 306
 307        if (link_subtype == CORESIGHT_DEV_SUBTYPE_LINK_MERG) {
 308                refport = inport;
 309                nr_conns = csdev->pdata->nr_inport;
 310        } else if (link_subtype == CORESIGHT_DEV_SUBTYPE_LINK_SPLIT) {
 311                refport = outport;
 312                nr_conns = csdev->pdata->nr_outport;
 313        } else {
 314                refport = 0;
 315                nr_conns = 1;
 316        }
 317
 318        if (atomic_dec_return(&csdev->refcnt[refport]) == 0) {
 319                if (link_ops(csdev)->disable)
 320                        link_ops(csdev)->disable(csdev, inport, outport);
 321        }
 322
 323        for (i = 0; i < nr_conns; i++)
 324                if (atomic_read(&csdev->refcnt[i]) != 0)
 325                        return;
 326
 327        csdev->enable = false;
 328}
 329
 330static int coresight_enable_source(struct coresight_device *csdev, u32 mode)
 331{
 332        int ret;
 333
 334        if (!coresight_source_is_unique(csdev)) {
 335                dev_warn(&csdev->dev, "traceID %d not unique\n",
 336                         source_ops(csdev)->trace_id(csdev));
 337                return -EINVAL;
 338        }
 339
 340        if (!csdev->enable) {
 341                if (source_ops(csdev)->enable) {
 342                        ret = source_ops(csdev)->enable(csdev, NULL, mode);
 343                        if (ret)
 344                                return ret;
 345                }
 346                csdev->enable = true;
 347        }
 348
 349        atomic_inc(csdev->refcnt);
 350
 351        return 0;
 352}
 353
 354/**
 355 *  coresight_disable_source - Drop the reference count by 1 and disable
 356 *  the device if there are no users left.
 357 *
 358 *  @csdev - The coresight device to disable
 359 *
 360 *  Returns true if the device has been disabled.
 361 */
 362static bool coresight_disable_source(struct coresight_device *csdev)
 363{
 364        if (atomic_dec_return(csdev->refcnt) == 0) {
 365                if (source_ops(csdev)->disable)
 366                        source_ops(csdev)->disable(csdev, NULL);
 367                csdev->enable = false;
 368        }
 369        return !csdev->enable;
 370}
 371
 372/*
 373 * coresight_disable_path_from : Disable components in the given path beyond
 374 * @nd in the list. If @nd is NULL, all the components, except the SOURCE are
 375 * disabled.
 376 */
 377static void coresight_disable_path_from(struct list_head *path,
 378                                        struct coresight_node *nd)
 379{
 380        u32 type;
 381        struct coresight_device *csdev, *parent, *child;
 382
 383        if (!nd)
 384                nd = list_first_entry(path, struct coresight_node, link);
 385
 386        list_for_each_entry_continue(nd, path, link) {
 387                csdev = nd->csdev;
 388                type = csdev->type;
 389
 390                /*
 391                 * ETF devices are tricky... They can be a link or a sink,
 392                 * depending on how they are configured.  If an ETF has been
 393                 * "activated" it will be configured as a sink, otherwise
 394                 * go ahead with the link configuration.
 395                 */
 396                if (type == CORESIGHT_DEV_TYPE_LINKSINK)
 397                        type = (csdev == coresight_get_sink(path)) ?
 398                                                CORESIGHT_DEV_TYPE_SINK :
 399                                                CORESIGHT_DEV_TYPE_LINK;
 400
 401                switch (type) {
 402                case CORESIGHT_DEV_TYPE_SINK:
 403                        coresight_disable_sink(csdev);
 404                        break;
 405                case CORESIGHT_DEV_TYPE_SOURCE:
 406                        /*
 407                         * We skip the first node in the path assuming that it
 408                         * is the source. So we don't expect a source device in
 409                         * the middle of a path.
 410                         */
 411                        WARN_ON(1);
 412                        break;
 413                case CORESIGHT_DEV_TYPE_LINK:
 414                        parent = list_prev_entry(nd, link)->csdev;
 415                        child = list_next_entry(nd, link)->csdev;
 416                        coresight_disable_link(csdev, parent, child);
 417                        break;
 418                default:
 419                        break;
 420                }
 421        }
 422}
 423
 424void coresight_disable_path(struct list_head *path)
 425{
 426        coresight_disable_path_from(path, NULL);
 427}
 428
 429int coresight_enable_path(struct list_head *path, u32 mode, void *sink_data)
 430{
 431
 432        int ret = 0;
 433        u32 type;
 434        struct coresight_node *nd;
 435        struct coresight_device *csdev, *parent, *child;
 436
 437        list_for_each_entry_reverse(nd, path, link) {
 438                csdev = nd->csdev;
 439                type = csdev->type;
 440
 441                /*
 442                 * ETF devices are tricky... They can be a link or a sink,
 443                 * depending on how they are configured.  If an ETF has been
 444                 * "activated" it will be configured as a sink, otherwise
 445                 * go ahead with the link configuration.
 446                 */
 447                if (type == CORESIGHT_DEV_TYPE_LINKSINK)
 448                        type = (csdev == coresight_get_sink(path)) ?
 449                                                CORESIGHT_DEV_TYPE_SINK :
 450                                                CORESIGHT_DEV_TYPE_LINK;
 451
 452                switch (type) {
 453                case CORESIGHT_DEV_TYPE_SINK:
 454                        ret = coresight_enable_sink(csdev, mode, sink_data);
 455                        /*
 456                         * Sink is the first component turned on. If we
 457                         * failed to enable the sink, there are no components
 458                         * that need disabling. Disabling the path here
 459                         * would mean we could disrupt an existing session.
 460                         */
 461                        if (ret)
 462                                goto out;
 463                        break;
 464                case CORESIGHT_DEV_TYPE_SOURCE:
 465                        /* sources are enabled from either sysFS or Perf */
 466                        break;
 467                case CORESIGHT_DEV_TYPE_LINK:
 468                        parent = list_prev_entry(nd, link)->csdev;
 469                        child = list_next_entry(nd, link)->csdev;
 470                        ret = coresight_enable_link(csdev, parent, child);
 471                        if (ret)
 472                                goto err;
 473                        break;
 474                default:
 475                        goto err;
 476                }
 477        }
 478
 479out:
 480        return ret;
 481err:
 482        coresight_disable_path_from(path, nd);
 483        goto out;
 484}
 485
 486struct coresight_device *coresight_get_sink(struct list_head *path)
 487{
 488        struct coresight_device *csdev;
 489
 490        if (!path)
 491                return NULL;
 492
 493        csdev = list_last_entry(path, struct coresight_node, link)->csdev;
 494        if (csdev->type != CORESIGHT_DEV_TYPE_SINK &&
 495            csdev->type != CORESIGHT_DEV_TYPE_LINKSINK)
 496                return NULL;
 497
 498        return csdev;
 499}
 500
 501static int coresight_enabled_sink(struct device *dev, const void *data)
 502{
 503        const bool *reset = data;
 504        struct coresight_device *csdev = to_coresight_device(dev);
 505
 506        if ((csdev->type == CORESIGHT_DEV_TYPE_SINK ||
 507             csdev->type == CORESIGHT_DEV_TYPE_LINKSINK) &&
 508             csdev->activated) {
 509                /*
 510                 * Now that we have a handle on the sink for this session,
 511                 * disable the sysFS "enable_sink" flag so that possible
 512                 * concurrent perf session that wish to use another sink don't
 513                 * trip on it.  Doing so has no ramification for the current
 514                 * session.
 515                 */
 516                if (*reset)
 517                        csdev->activated = false;
 518
 519                return 1;
 520        }
 521
 522        return 0;
 523}
 524
 525/**
 526 * coresight_get_enabled_sink - returns the first enabled sink found on the bus
 527 * @deactivate: Whether the 'enable_sink' flag should be reset
 528 *
 529 * When operated from perf the deactivate parameter should be set to 'true'.
 530 * That way the "enabled_sink" flag of the sink that was selected can be reset,
 531 * allowing for other concurrent perf sessions to choose a different sink.
 532 *
 533 * When operated from sysFS users have full control and as such the deactivate
 534 * parameter should be set to 'false', hence mandating users to explicitly
 535 * clear the flag.
 536 */
 537struct coresight_device *coresight_get_enabled_sink(bool deactivate)
 538{
 539        struct device *dev = NULL;
 540
 541        dev = bus_find_device(&coresight_bustype, NULL, &deactivate,
 542                              coresight_enabled_sink);
 543
 544        return dev ? to_coresight_device(dev) : NULL;
 545}
 546
 547static int coresight_sink_by_id(struct device *dev, const void *data)
 548{
 549        struct coresight_device *csdev = to_coresight_device(dev);
 550        unsigned long hash;
 551
 552        if (csdev->type == CORESIGHT_DEV_TYPE_SINK ||
 553             csdev->type == CORESIGHT_DEV_TYPE_LINKSINK) {
 554
 555                if (!csdev->ea)
 556                        return 0;
 557                /*
 558                 * See function etm_perf_add_symlink_sink() to know where
 559                 * this comes from.
 560                 */
 561                hash = (unsigned long)csdev->ea->var;
 562
 563                if ((u32)hash == *(u32 *)data)
 564                        return 1;
 565        }
 566
 567        return 0;
 568}
 569
 570/**
 571 * coresight_get_sink_by_id - returns the sink that matches the id
 572 * @id: Id of the sink to match
 573 *
 574 * The name of a sink is unique, whether it is found on the AMBA bus or
 575 * otherwise.  As such the hash of that name can easily be used to identify
 576 * a sink.
 577 */
 578struct coresight_device *coresight_get_sink_by_id(u32 id)
 579{
 580        struct device *dev = NULL;
 581
 582        dev = bus_find_device(&coresight_bustype, NULL, &id,
 583                              coresight_sink_by_id);
 584
 585        return dev ? to_coresight_device(dev) : NULL;
 586}
 587
 588/*
 589 * coresight_grab_device - Power up this device and any of the helper
 590 * devices connected to it for trace operation. Since the helper devices
 591 * don't appear on the trace path, they should be handled along with the
 592 * the master device.
 593 */
 594static void coresight_grab_device(struct coresight_device *csdev)
 595{
 596        int i;
 597
 598        for (i = 0; i < csdev->pdata->nr_outport; i++) {
 599                struct coresight_device *child;
 600
 601                child  = csdev->pdata->conns[i].child_dev;
 602                if (child && child->type == CORESIGHT_DEV_TYPE_HELPER)
 603                        pm_runtime_get_sync(child->dev.parent);
 604        }
 605        pm_runtime_get_sync(csdev->dev.parent);
 606}
 607
 608/*
 609 * coresight_drop_device - Release this device and any of the helper
 610 * devices connected to it.
 611 */
 612static void coresight_drop_device(struct coresight_device *csdev)
 613{
 614        int i;
 615
 616        pm_runtime_put(csdev->dev.parent);
 617        for (i = 0; i < csdev->pdata->nr_outport; i++) {
 618                struct coresight_device *child;
 619
 620                child  = csdev->pdata->conns[i].child_dev;
 621                if (child && child->type == CORESIGHT_DEV_TYPE_HELPER)
 622                        pm_runtime_put(child->dev.parent);
 623        }
 624}
 625
 626/**
 627 * _coresight_build_path - recursively build a path from a @csdev to a sink.
 628 * @csdev:      The device to start from.
 629 * @path:       The list to add devices to.
 630 *
 631 * The tree of Coresight device is traversed until an activated sink is
 632 * found.  From there the sink is added to the list along with all the
 633 * devices that led to that point - the end result is a list from source
 634 * to sink. In that list the source is the first device and the sink the
 635 * last one.
 636 */
 637static int _coresight_build_path(struct coresight_device *csdev,
 638                                 struct coresight_device *sink,
 639                                 struct list_head *path)
 640{
 641        int i;
 642        bool found = false;
 643        struct coresight_node *node;
 644
 645        /* An activated sink has been found.  Enqueue the element */
 646        if (csdev == sink)
 647                goto out;
 648
 649        /* Not a sink - recursively explore each port found on this element */
 650        for (i = 0; i < csdev->pdata->nr_outport; i++) {
 651                struct coresight_device *child_dev;
 652
 653                child_dev = csdev->pdata->conns[i].child_dev;
 654                if (child_dev &&
 655                    _coresight_build_path(child_dev, sink, path) == 0) {
 656                        found = true;
 657                        break;
 658                }
 659        }
 660
 661        if (!found)
 662                return -ENODEV;
 663
 664out:
 665        /*
 666         * A path from this element to a sink has been found.  The elements
 667         * leading to the sink are already enqueued, all that is left to do
 668         * is tell the PM runtime core we need this element and add a node
 669         * for it.
 670         */
 671        node = kzalloc(sizeof(struct coresight_node), GFP_KERNEL);
 672        if (!node)
 673                return -ENOMEM;
 674
 675        coresight_grab_device(csdev);
 676        node->csdev = csdev;
 677        list_add(&node->link, path);
 678
 679        return 0;
 680}
 681
 682struct list_head *coresight_build_path(struct coresight_device *source,
 683                                       struct coresight_device *sink)
 684{
 685        struct list_head *path;
 686        int rc;
 687
 688        if (!sink)
 689                return ERR_PTR(-EINVAL);
 690
 691        path = kzalloc(sizeof(struct list_head), GFP_KERNEL);
 692        if (!path)
 693                return ERR_PTR(-ENOMEM);
 694
 695        INIT_LIST_HEAD(path);
 696
 697        rc = _coresight_build_path(source, sink, path);
 698        if (rc) {
 699                kfree(path);
 700                return ERR_PTR(rc);
 701        }
 702
 703        return path;
 704}
 705
 706/**
 707 * coresight_release_path - release a previously built path.
 708 * @path:       the path to release.
 709 *
 710 * Go through all the elements of a path and 1) removed it from the list and
 711 * 2) free the memory allocated for each node.
 712 */
 713void coresight_release_path(struct list_head *path)
 714{
 715        struct coresight_device *csdev;
 716        struct coresight_node *nd, *next;
 717
 718        list_for_each_entry_safe(nd, next, path, link) {
 719                csdev = nd->csdev;
 720
 721                coresight_drop_device(csdev);
 722                list_del(&nd->link);
 723                kfree(nd);
 724        }
 725
 726        kfree(path);
 727        path = NULL;
 728}
 729
 730/** coresight_validate_source - make sure a source has the right credentials
 731 *  @csdev:     the device structure for a source.
 732 *  @function:  the function this was called from.
 733 *
 734 * Assumes the coresight_mutex is held.
 735 */
 736static int coresight_validate_source(struct coresight_device *csdev,
 737                                     const char *function)
 738{
 739        u32 type, subtype;
 740
 741        type = csdev->type;
 742        subtype = csdev->subtype.source_subtype;
 743
 744        if (type != CORESIGHT_DEV_TYPE_SOURCE) {
 745                dev_err(&csdev->dev, "wrong device type in %s\n", function);
 746                return -EINVAL;
 747        }
 748
 749        if (subtype != CORESIGHT_DEV_SUBTYPE_SOURCE_PROC &&
 750            subtype != CORESIGHT_DEV_SUBTYPE_SOURCE_SOFTWARE) {
 751                dev_err(&csdev->dev, "wrong device subtype in %s\n", function);
 752                return -EINVAL;
 753        }
 754
 755        return 0;
 756}
 757
 758int coresight_enable(struct coresight_device *csdev)
 759{
 760        int cpu, ret = 0;
 761        struct coresight_device *sink;
 762        struct list_head *path;
 763        enum coresight_dev_subtype_source subtype;
 764
 765        subtype = csdev->subtype.source_subtype;
 766
 767        mutex_lock(&coresight_mutex);
 768
 769        ret = coresight_validate_source(csdev, __func__);
 770        if (ret)
 771                goto out;
 772
 773        if (csdev->enable) {
 774                /*
 775                 * There could be multiple applications driving the software
 776                 * source. So keep the refcount for each such user when the
 777                 * source is already enabled.
 778                 */
 779                if (subtype == CORESIGHT_DEV_SUBTYPE_SOURCE_SOFTWARE)
 780                        atomic_inc(csdev->refcnt);
 781                goto out;
 782        }
 783
 784        /*
 785         * Search for a valid sink for this session but don't reset the
 786         * "enable_sink" flag in sysFS.  Users get to do that explicitly.
 787         */
 788        sink = coresight_get_enabled_sink(false);
 789        if (!sink) {
 790                ret = -EINVAL;
 791                goto out;
 792        }
 793
 794        path = coresight_build_path(csdev, sink);
 795        if (IS_ERR(path)) {
 796                pr_err("building path(s) failed\n");
 797                ret = PTR_ERR(path);
 798                goto out;
 799        }
 800
 801        ret = coresight_enable_path(path, CS_MODE_SYSFS, NULL);
 802        if (ret)
 803                goto err_path;
 804
 805        ret = coresight_enable_source(csdev, CS_MODE_SYSFS);
 806        if (ret)
 807                goto err_source;
 808
 809        switch (subtype) {
 810        case CORESIGHT_DEV_SUBTYPE_SOURCE_PROC:
 811                /*
 812                 * When working from sysFS it is important to keep track
 813                 * of the paths that were created so that they can be
 814                 * undone in 'coresight_disable()'.  Since there can only
 815                 * be a single session per tracer (when working from sysFS)
 816                 * a per-cpu variable will do just fine.
 817                 */
 818                cpu = source_ops(csdev)->cpu_id(csdev);
 819                per_cpu(tracer_path, cpu) = path;
 820                break;
 821        case CORESIGHT_DEV_SUBTYPE_SOURCE_SOFTWARE:
 822                stm_path = path;
 823                break;
 824        default:
 825                /* We can't be here */
 826                break;
 827        }
 828
 829out:
 830        mutex_unlock(&coresight_mutex);
 831        return ret;
 832
 833err_source:
 834        coresight_disable_path(path);
 835
 836err_path:
 837        coresight_release_path(path);
 838        goto out;
 839}
 840EXPORT_SYMBOL_GPL(coresight_enable);
 841
 842void coresight_disable(struct coresight_device *csdev)
 843{
 844        int cpu, ret;
 845        struct list_head *path = NULL;
 846
 847        mutex_lock(&coresight_mutex);
 848
 849        ret = coresight_validate_source(csdev, __func__);
 850        if (ret)
 851                goto out;
 852
 853        if (!csdev->enable || !coresight_disable_source(csdev))
 854                goto out;
 855
 856        switch (csdev->subtype.source_subtype) {
 857        case CORESIGHT_DEV_SUBTYPE_SOURCE_PROC:
 858                cpu = source_ops(csdev)->cpu_id(csdev);
 859                path = per_cpu(tracer_path, cpu);
 860                per_cpu(tracer_path, cpu) = NULL;
 861                break;
 862        case CORESIGHT_DEV_SUBTYPE_SOURCE_SOFTWARE:
 863                path = stm_path;
 864                stm_path = NULL;
 865                break;
 866        default:
 867                /* We can't be here */
 868                break;
 869        }
 870
 871        coresight_disable_path(path);
 872        coresight_release_path(path);
 873
 874out:
 875        mutex_unlock(&coresight_mutex);
 876}
 877EXPORT_SYMBOL_GPL(coresight_disable);
 878
 879static ssize_t enable_sink_show(struct device *dev,
 880                                struct device_attribute *attr, char *buf)
 881{
 882        struct coresight_device *csdev = to_coresight_device(dev);
 883
 884        return scnprintf(buf, PAGE_SIZE, "%u\n", csdev->activated);
 885}
 886
 887static ssize_t enable_sink_store(struct device *dev,
 888                                 struct device_attribute *attr,
 889                                 const char *buf, size_t size)
 890{
 891        int ret;
 892        unsigned long val;
 893        struct coresight_device *csdev = to_coresight_device(dev);
 894
 895        ret = kstrtoul(buf, 10, &val);
 896        if (ret)
 897                return ret;
 898
 899        if (val)
 900                csdev->activated = true;
 901        else
 902                csdev->activated = false;
 903
 904        return size;
 905
 906}
 907static DEVICE_ATTR_RW(enable_sink);
 908
 909static ssize_t enable_source_show(struct device *dev,
 910                                  struct device_attribute *attr, char *buf)
 911{
 912        struct coresight_device *csdev = to_coresight_device(dev);
 913
 914        return scnprintf(buf, PAGE_SIZE, "%u\n", csdev->enable);
 915}
 916
 917static ssize_t enable_source_store(struct device *dev,
 918                                   struct device_attribute *attr,
 919                                   const char *buf, size_t size)
 920{
 921        int ret = 0;
 922        unsigned long val;
 923        struct coresight_device *csdev = to_coresight_device(dev);
 924
 925        ret = kstrtoul(buf, 10, &val);
 926        if (ret)
 927                return ret;
 928
 929        if (val) {
 930                ret = coresight_enable(csdev);
 931                if (ret)
 932                        return ret;
 933        } else {
 934                coresight_disable(csdev);
 935        }
 936
 937        return size;
 938}
 939static DEVICE_ATTR_RW(enable_source);
 940
 941static struct attribute *coresight_sink_attrs[] = {
 942        &dev_attr_enable_sink.attr,
 943        NULL,
 944};
 945ATTRIBUTE_GROUPS(coresight_sink);
 946
 947static struct attribute *coresight_source_attrs[] = {
 948        &dev_attr_enable_source.attr,
 949        NULL,
 950};
 951ATTRIBUTE_GROUPS(coresight_source);
 952
 953static struct device_type coresight_dev_type[] = {
 954        {
 955                .name = "none",
 956        },
 957        {
 958                .name = "sink",
 959                .groups = coresight_sink_groups,
 960        },
 961        {
 962                .name = "link",
 963        },
 964        {
 965                .name = "linksink",
 966                .groups = coresight_sink_groups,
 967        },
 968        {
 969                .name = "source",
 970                .groups = coresight_source_groups,
 971        },
 972        {
 973                .name = "helper",
 974        },
 975};
 976
 977static void coresight_device_release(struct device *dev)
 978{
 979        struct coresight_device *csdev = to_coresight_device(dev);
 980
 981        fwnode_handle_put(csdev->dev.fwnode);
 982        kfree(csdev->refcnt);
 983        kfree(csdev);
 984}
 985
 986static int coresight_orphan_match(struct device *dev, void *data)
 987{
 988        int i;
 989        bool still_orphan = false;
 990        struct coresight_device *csdev, *i_csdev;
 991        struct coresight_connection *conn;
 992
 993        csdev = data;
 994        i_csdev = to_coresight_device(dev);
 995
 996        /* No need to check oneself */
 997        if (csdev == i_csdev)
 998                return 0;
 999
1000        /* Move on to another component if no connection is orphan */
1001        if (!i_csdev->orphan)
1002                return 0;
1003        /*
1004         * Circle throuch all the connection of that component.  If we find
1005         * an orphan connection whose name matches @csdev, link it.
1006         */
1007        for (i = 0; i < i_csdev->pdata->nr_outport; i++) {
1008                conn = &i_csdev->pdata->conns[i];
1009
1010                /* We have found at least one orphan connection */
1011                if (conn->child_dev == NULL) {
1012                        /* Does it match this newly added device? */
1013                        if (conn->child_fwnode == csdev->dev.fwnode)
1014                                conn->child_dev = csdev;
1015                        else
1016                                /* This component still has an orphan */
1017                                still_orphan = true;
1018                }
1019        }
1020
1021        i_csdev->orphan = still_orphan;
1022
1023        /*
1024         * Returning '0' ensures that all known component on the
1025         * bus will be checked.
1026         */
1027        return 0;
1028}
1029
1030static void coresight_fixup_orphan_conns(struct coresight_device *csdev)
1031{
1032        /*
1033         * No need to check for a return value as orphan connection(s)
1034         * are hooked-up with each newly added component.
1035         */
1036        bus_for_each_dev(&coresight_bustype, NULL,
1037                         csdev, coresight_orphan_match);
1038}
1039
1040
1041static void coresight_fixup_device_conns(struct coresight_device *csdev)
1042{
1043        int i;
1044
1045        for (i = 0; i < csdev->pdata->nr_outport; i++) {
1046                struct coresight_connection *conn = &csdev->pdata->conns[i];
1047                struct device *dev = NULL;
1048
1049                dev = bus_find_device(&coresight_bustype, NULL,
1050                                      (void *)conn->child_fwnode,
1051                                      coresight_device_fwnode_match);
1052                if (dev) {
1053                        conn->child_dev = to_coresight_device(dev);
1054                        /* and put reference from 'bus_find_device()' */
1055                        put_device(dev);
1056                } else {
1057                        csdev->orphan = true;
1058                        conn->child_dev = NULL;
1059                }
1060        }
1061}
1062
1063static int coresight_remove_match(struct device *dev, void *data)
1064{
1065        int i;
1066        struct coresight_device *csdev, *iterator;
1067        struct coresight_connection *conn;
1068
1069        csdev = data;
1070        iterator = to_coresight_device(dev);
1071
1072        /* No need to check oneself */
1073        if (csdev == iterator)
1074                return 0;
1075
1076        /*
1077         * Circle throuch all the connection of that component.  If we find
1078         * a connection whose name matches @csdev, remove it.
1079         */
1080        for (i = 0; i < iterator->pdata->nr_outport; i++) {
1081                conn = &iterator->pdata->conns[i];
1082
1083                if (conn->child_dev == NULL)
1084                        continue;
1085
1086                if (csdev->dev.fwnode == conn->child_fwnode) {
1087                        iterator->orphan = true;
1088                        conn->child_dev = NULL;
1089                        /*
1090                         * Drop the reference to the handle for the remote
1091                         * device acquired in parsing the connections from
1092                         * platform data.
1093                         */
1094                        fwnode_handle_put(conn->child_fwnode);
1095                        /* No need to continue */
1096                        break;
1097                }
1098        }
1099
1100        /*
1101         * Returning '0' ensures that all known component on the
1102         * bus will be checked.
1103         */
1104        return 0;
1105}
1106
1107/*
1108 * coresight_remove_conns - Remove references to this given devices
1109 * from the connections of other devices.
1110 */
1111static void coresight_remove_conns(struct coresight_device *csdev)
1112{
1113        /*
1114         * Another device will point to this device only if there is
1115         * an output port connected to this one. i.e, if the device
1116         * doesn't have at least one input port, there is no point
1117         * in searching all the devices.
1118         */
1119        if (csdev->pdata->nr_inport)
1120                bus_for_each_dev(&coresight_bustype, NULL,
1121                                 csdev, coresight_remove_match);
1122}
1123
1124/**
1125 * coresight_timeout - loop until a bit has changed to a specific state.
1126 * @addr: base address of the area of interest.
1127 * @offset: address of a register, starting from @addr.
1128 * @position: the position of the bit of interest.
1129 * @value: the value the bit should have.
1130 *
1131 * Return: 0 as soon as the bit has taken the desired state or -EAGAIN if
1132 * TIMEOUT_US has elapsed, which ever happens first.
1133 */
1134
1135int coresight_timeout(void __iomem *addr, u32 offset, int position, int value)
1136{
1137        int i;
1138        u32 val;
1139
1140        for (i = TIMEOUT_US; i > 0; i--) {
1141                val = __raw_readl(addr + offset);
1142                /* waiting on the bit to go from 0 to 1 */
1143                if (value) {
1144                        if (val & BIT(position))
1145                                return 0;
1146                /* waiting on the bit to go from 1 to 0 */
1147                } else {
1148                        if (!(val & BIT(position)))
1149                                return 0;
1150                }
1151
1152                /*
1153                 * Delay is arbitrary - the specification doesn't say how long
1154                 * we are expected to wait.  Extra check required to make sure
1155                 * we don't wait needlessly on the last iteration.
1156                 */
1157                if (i - 1)
1158                        udelay(1);
1159        }
1160
1161        return -EAGAIN;
1162}
1163
1164struct bus_type coresight_bustype = {
1165        .name   = "coresight",
1166};
1167
1168static int __init coresight_init(void)
1169{
1170        return bus_register(&coresight_bustype);
1171}
1172postcore_initcall(coresight_init);
1173
1174/*
1175 * coresight_release_platform_data: Release references to the devices connected
1176 * to the output port of this device.
1177 */
1178void coresight_release_platform_data(struct coresight_platform_data *pdata)
1179{
1180        int i;
1181
1182        for (i = 0; i < pdata->nr_outport; i++) {
1183                if (pdata->conns[i].child_fwnode) {
1184                        fwnode_handle_put(pdata->conns[i].child_fwnode);
1185                        pdata->conns[i].child_fwnode = NULL;
1186                }
1187        }
1188}
1189
1190struct coresight_device *coresight_register(struct coresight_desc *desc)
1191{
1192        int ret;
1193        int link_subtype;
1194        int nr_refcnts = 1;
1195        atomic_t *refcnts = NULL;
1196        struct coresight_device *csdev;
1197
1198        csdev = kzalloc(sizeof(*csdev), GFP_KERNEL);
1199        if (!csdev) {
1200                ret = -ENOMEM;
1201                goto err_out;
1202        }
1203
1204        if (desc->type == CORESIGHT_DEV_TYPE_LINK ||
1205            desc->type == CORESIGHT_DEV_TYPE_LINKSINK) {
1206                link_subtype = desc->subtype.link_subtype;
1207
1208                if (link_subtype == CORESIGHT_DEV_SUBTYPE_LINK_MERG)
1209                        nr_refcnts = desc->pdata->nr_inport;
1210                else if (link_subtype == CORESIGHT_DEV_SUBTYPE_LINK_SPLIT)
1211                        nr_refcnts = desc->pdata->nr_outport;
1212        }
1213
1214        refcnts = kcalloc(nr_refcnts, sizeof(*refcnts), GFP_KERNEL);
1215        if (!refcnts) {
1216                ret = -ENOMEM;
1217                goto err_free_csdev;
1218        }
1219
1220        csdev->refcnt = refcnts;
1221
1222        csdev->pdata = desc->pdata;
1223
1224        csdev->type = desc->type;
1225        csdev->subtype = desc->subtype;
1226        csdev->ops = desc->ops;
1227        csdev->orphan = false;
1228
1229        csdev->dev.type = &coresight_dev_type[desc->type];
1230        csdev->dev.groups = desc->groups;
1231        csdev->dev.parent = desc->dev;
1232        csdev->dev.release = coresight_device_release;
1233        csdev->dev.bus = &coresight_bustype;
1234        /*
1235         * Hold the reference to our parent device. This will be
1236         * dropped only in coresight_device_release().
1237         */
1238        csdev->dev.fwnode = fwnode_handle_get(dev_fwnode(desc->dev));
1239        dev_set_name(&csdev->dev, "%s", desc->name);
1240
1241        ret = device_register(&csdev->dev);
1242        if (ret) {
1243                put_device(&csdev->dev);
1244                /*
1245                 * All resources are free'd explicitly via
1246                 * coresight_device_release(), triggered from put_device().
1247                 */
1248                goto err_out;
1249        }
1250
1251        if (csdev->type == CORESIGHT_DEV_TYPE_SINK ||
1252            csdev->type == CORESIGHT_DEV_TYPE_LINKSINK) {
1253                ret = etm_perf_add_symlink_sink(csdev);
1254
1255                if (ret) {
1256                        device_unregister(&csdev->dev);
1257                        /*
1258                         * As with the above, all resources are free'd
1259                         * explicitly via coresight_device_release() triggered
1260                         * from put_device(), which is in turn called from
1261                         * function device_unregister().
1262                         */
1263                        goto err_out;
1264                }
1265        }
1266
1267        mutex_lock(&coresight_mutex);
1268
1269        coresight_fixup_device_conns(csdev);
1270        coresight_fixup_orphan_conns(csdev);
1271
1272        mutex_unlock(&coresight_mutex);
1273
1274        return csdev;
1275
1276err_free_csdev:
1277        kfree(csdev);
1278err_out:
1279        /* Cleanup the connection information */
1280        coresight_release_platform_data(desc->pdata);
1281        return ERR_PTR(ret);
1282}
1283EXPORT_SYMBOL_GPL(coresight_register);
1284
1285void coresight_unregister(struct coresight_device *csdev)
1286{
1287        etm_perf_del_symlink_sink(csdev);
1288        /* Remove references of that device in the topology */
1289        coresight_remove_conns(csdev);
1290        coresight_release_platform_data(csdev->pdata);
1291        device_unregister(&csdev->dev);
1292}
1293EXPORT_SYMBOL_GPL(coresight_unregister);
1294
1295
1296/*
1297 * coresight_search_device_idx - Search the fwnode handle of a device
1298 * in the given dev_idx list. Must be called with the coresight_mutex held.
1299 *
1300 * Returns the index of the entry, when found. Otherwise, -ENOENT.
1301 */
1302static inline int coresight_search_device_idx(struct coresight_dev_list *dict,
1303                                              struct fwnode_handle *fwnode)
1304{
1305        int i;
1306
1307        for (i = 0; i < dict->nr_idx; i++)
1308                if (dict->fwnode_list[i] == fwnode)
1309                        return i;
1310        return -ENOENT;
1311}
1312
1313/*
1314 * coresight_alloc_device_name - Get an index for a given device in the
1315 * device index list specific to a driver. An index is allocated for a
1316 * device and is tracked with the fwnode_handle to prevent allocating
1317 * duplicate indices for the same device (e.g, if we defer probing of
1318 * a device due to dependencies), in case the index is requested again.
1319 */
1320char *coresight_alloc_device_name(struct coresight_dev_list *dict,
1321                                  struct device *dev)
1322{
1323        int idx;
1324        char *name = NULL;
1325        struct fwnode_handle **list;
1326
1327        mutex_lock(&coresight_mutex);
1328
1329        idx = coresight_search_device_idx(dict, dev_fwnode(dev));
1330        if (idx < 0) {
1331                /* Make space for the new entry */
1332                idx = dict->nr_idx;
1333                list = krealloc(dict->fwnode_list,
1334                                (idx + 1) * sizeof(*dict->fwnode_list),
1335                                GFP_KERNEL);
1336                if (ZERO_OR_NULL_PTR(list)) {
1337                        idx = -ENOMEM;
1338                        goto done;
1339                }
1340
1341                list[idx] = dev_fwnode(dev);
1342                dict->fwnode_list = list;
1343                dict->nr_idx = idx + 1;
1344        }
1345
1346        name = devm_kasprintf(dev, GFP_KERNEL, "%s%d", dict->pfx, idx);
1347done:
1348        mutex_unlock(&coresight_mutex);
1349        return name;
1350}
1351EXPORT_SYMBOL_GPL(coresight_alloc_device_name);
1352