Show a cover letter.

GET /api/1.2/covers/2234557/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 2234557,
    "url": "http://patchwork.ozlabs.org/api/1.2/covers/2234557/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/linux-i2c/cover/20260507-dw-i2c-v4-0-9a447b23bfdf@wkennington.com/",
    "project": {
        "id": 35,
        "url": "http://patchwork.ozlabs.org/api/1.2/projects/35/?format=api",
        "name": "Linux I2C development",
        "link_name": "linux-i2c",
        "list_id": "linux-i2c.vger.kernel.org",
        "list_email": "linux-i2c@vger.kernel.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20260507-dw-i2c-v4-0-9a447b23bfdf@wkennington.com>",
    "list_archive_url": null,
    "date": "2026-05-07T20:05:14",
    "name": "[v4,0/4] i2c: designware: Improve device disable handling",
    "submitter": {
        "id": 87247,
        "url": "http://patchwork.ozlabs.org/api/1.2/people/87247/?format=api",
        "name": "William A. Kennington III",
        "email": "william@wkennington.com"
    },
    "mbox": "http://patchwork.ozlabs.org/project/linux-i2c/cover/20260507-dw-i2c-v4-0-9a447b23bfdf@wkennington.com/mbox/",
    "series": [
        {
            "id": 503262,
            "url": "http://patchwork.ozlabs.org/api/1.2/series/503262/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/linux-i2c/list/?series=503262",
            "date": "2026-05-07T20:05:14",
            "name": "i2c: designware: Improve device disable handling",
            "version": 4,
            "mbox": "http://patchwork.ozlabs.org/series/503262/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/2234557/comments/",
    "headers": {
        "Return-Path": "\n <linux-i2c+bounces-17298-incoming=patchwork.ozlabs.org@vger.kernel.org>",
        "X-Original-To": [
            "incoming@patchwork.ozlabs.org",
            "linux-i2c@vger.kernel.org"
        ],
        "Delivered-To": "patchwork-incoming@legolas.ozlabs.org",
        "Authentication-Results": [
            "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=wkennington-com.20251104.gappssmtp.com\n header.i=@wkennington-com.20251104.gappssmtp.com header.a=rsa-sha256\n header.s=20251104 header.b=NfPVmQQC;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=172.234.253.10; helo=sea.lore.kernel.org;\n envelope-from=linux-i2c+bounces-17298-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)",
            "smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=wkennington-com.20251104.gappssmtp.com\n header.i=@wkennington-com.20251104.gappssmtp.com header.b=\"NfPVmQQC\"",
            "smtp.subspace.kernel.org;\n arc=none smtp.client-ip=209.85.215.181",
            "smtp.subspace.kernel.org;\n dmarc=none (p=none dis=none) header.from=wkennington.com",
            "smtp.subspace.kernel.org;\n spf=none smtp.mailfrom=wkennington.com"
        ],
        "Received": [
            "from sea.lore.kernel.org (sea.lore.kernel.org [172.234.253.10])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4gBNXt2TK8z1y04\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 08 May 2026 06:05:50 +1000 (AEST)",
            "from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby sea.lore.kernel.org (Postfix) with ESMTP id 330D4301E3F9\n\tfor <incoming@patchwork.ozlabs.org>; Thu,  7 May 2026 20:05:26 +0000 (UTC)",
            "from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 75EC8365A18;\n\tThu,  7 May 2026 20:05:25 +0000 (UTC)",
            "from mail-pg1-f181.google.com (mail-pg1-f181.google.com\n [209.85.215.181])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id B5E8C33A9E9\n\tfor <linux-i2c@vger.kernel.org>; Thu,  7 May 2026 20:05:23 +0000 (UTC)",
            "by mail-pg1-f181.google.com with SMTP id\n 41be03b00d2f7-c6dd5b01e14so545507a12.0\n        for <linux-i2c@vger.kernel.org>; Thu, 07 May 2026 13:05:23 -0700 (PDT)",
            "from wakbuild.c.googlers.com\n (123.143.125.34.bc.googleusercontent.com. [34.125.143.123])\n        by smtp.gmail.com with ESMTPSA id\n 41be03b00d2f7-c8263ff29c2sm443200a12.12.2026.05.07.13.05.22\n        (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n        Thu, 07 May 2026 13:05:22 -0700 (PDT)"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1778184325; cv=none;\n b=E4ijnKAWzWgWYWG00olmNu09WtG5UwBlGJPODcrcOWZWvt1Y1Of2nIiCgDRIUh+lt7iC4WVuRwdz3ySY31ThTigurqKpCB5lAiubGdejpyl+KEQZOFVUHZVBJdpGrghAeuMvttpVHNva83bqlqbuYEgwBF+a7FJ5Z1tlzQUaNBs=",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1778184325; c=relaxed/simple;\n\tbh=XiBF8qOTSINpTP10QsEcktQ96KgiUVOZ6UAXE2NIqVM=;\n\th=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc;\n b=WdxpRo5w4NObu+QPipoF96eGSODYPWlvJ8VwIOJyW7f6JG3Ve+Pr700qLl0A4fXtVNXsNkKnKECTC0N9sTIYMW5Z32KFgQyCLG/x5EgEmp76rNJMFiylFvgMXpIdMEyQatc/CmJd1jP3PhXNvoCK+RsU9vc0sZIUtD+fl/nEdDM=",
        "ARC-Authentication-Results": "i=1; smtp.subspace.kernel.org;\n dmarc=none (p=none dis=none) header.from=wkennington.com;\n spf=none smtp.mailfrom=wkennington.com;\n dkim=pass (2048-bit key) header.d=wkennington-com.20251104.gappssmtp.com\n header.i=@wkennington-com.20251104.gappssmtp.com header.b=NfPVmQQC;\n arc=none smtp.client-ip=209.85.215.181",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n        d=wkennington-com.20251104.gappssmtp.com; s=20251104; t=1778184323;\n x=1778789123; darn=vger.kernel.org;\n        h=cc:to:content-transfer-encoding:mime-version:message-id:date\n         :subject:from:from:to:cc:subject:date:message-id:reply-to;\n        bh=Ip/5HPUHE2OHKD7QbPNg1xe8gn9QIP8/OvSeHN5LWDY=;\n        b=NfPVmQQC2YeNju9iOd4031yoCbgRdUT2wk45WHwwTLFti8Eo1k9RFsdOqw63LV2Vfj\n         lFSRkYhYoBu8FsyirMXeSjKVHNxmRc5Ul7fyKxaCUVmgk3qMUmyJQV4QmB/TzZSxrT3w\n         v/VJ9pOjfug5qNgisG6iWu85iVHo9x//E7eNpQKIgeWM/E36rAPZn6HhVsxDLC2wPuOz\n         Mj342xOklmZzNMv7b53g8xGKR6Nt17Yr/zYaLkFAEJgqBnY2MwcS+pYmqpy/AfU0oZFL\n         zjlBjfcCXSELng0GxxtMOrMaH9tFSVJV1SHnViafVJxO4i0BdonwiVHJCjhah/JSGzsS\n         zq9A==",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n        d=1e100.net; s=20251104; t=1778184323; x=1778789123;\n        h=cc:to:content-transfer-encoding:mime-version:message-id:date\n         :subject:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date\n         :message-id:reply-to;\n        bh=Ip/5HPUHE2OHKD7QbPNg1xe8gn9QIP8/OvSeHN5LWDY=;\n        b=XVTa5bYDYXM+lxbnOelMySiVmOqkbh0QBkjZQ6mvOSDkul6IFV19urNZy/v6qf+NhC\n         F8akTgoQji3i9BPrsjVWp4OHwkkZsZqUlR16NaPQL+620yDmziPEgsOSPYurf2sPxQ+Z\n         hUS96F4AoPIf0MveNL7HKQNT2UH/krVaVYVN4v8G9hxIU261atyZdDVyoM4kbDaP0cgA\n         13CtjowOF5pAbklKTTRTZuDJUaWc/yj5c+Uo5+vCszbHFq4pff6VjbPUYgJDQOv/bpvu\n         VLXhVw/nD9Df8DXyp9C/vV6mhtTp6Tdxlp1jbOaPhVSggSRXZup02xCqdT6Ae7FU5zKw\n         ybwg==",
        "X-Gm-Message-State": "AOJu0Ywy8KTXLQzELQtxJxUdmvxgzm+iWbdrTWxPSXkTlWk9ElyUS5sX\n\tdcGcMRrH53XbEPetDjypKwQFBdwLDqCLEEXToJHsf7LawtnqiAp70smYXn6iVXhO8+I=",
        "X-Gm-Gg": "AeBDiesJnULJlJefJptE1VAAo0PHrV7dMTPsvaYU8YpP7iagU8qPT2hbMax80UDtfJG\n\tmmrPL4mW709vUGn0TRIEdgpC28AIE1GkVUglZHuYdbwUUUqEwPoATVwpTdLvbHV+4mVH6Pxb0/r\n\t+Qe0wXgfUVfe9mzmp3BZHhxfaXCv2hs7SM7NukEkcxLBxoaXsiAYt6vqaoXAsw4u0QOpsbyOO/P\n\tag7Cl0Uf9MWNeb9kMoQbrv1j7l6+RJfuaX/o2sf1cDDVTq8v6JDUaSjLncmYtpslhavzFuksokl\n\taM+ZjV/gYXY1k6ziS+2LzRYFqIoKFyDgjOWtuPD4c9ItGMatyB+1CgW8eZoQzSBHmuUkgYxAC7G\n\tEQ2aYmqza/FZ5wH+eh162tfH6Yt6Dqzha4j24duTbnsdloAaAJ91UJQVceYuPlbIPb8Ge7gbTZo\n\tm5ILuXSSjD7igKhgLMY8np9doAEA2RaNQnzwLYLEVSlpAdB6eOnVO/3zmU/9jmqWBbuhm3Myum0\n\tFT1FcfCksoZtTQ=",
        "X-Received": "by 2002:a05:6a20:2594:b0:3a2:d316:de52 with SMTP id\n adf61e73a8af0-3aa5a9b0a31mr9602121637.31.1778184322983;\n        Thu, 07 May 2026 13:05:22 -0700 (PDT)",
        "From": "\"William A. Kennington III\" <william@wkennington.com>",
        "Subject": "[PATCH v4 0/4] i2c: designware: Improve device disable handling",
        "Date": "Thu, 07 May 2026 20:05:14 +0000",
        "Message-Id": "<20260507-dw-i2c-v4-0-9a447b23bfdf@wkennington.com>",
        "Precedence": "bulk",
        "X-Mailing-List": "linux-i2c@vger.kernel.org",
        "List-Id": "<linux-i2c.vger.kernel.org>",
        "List-Subscribe": "<mailto:linux-i2c+subscribe@vger.kernel.org>",
        "List-Unsubscribe": "<mailto:linux-i2c+unsubscribe@vger.kernel.org>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "7bit",
        "X-B4-Tracking": "v=1; b=H4sIAHrw/GkC/2WOOw6DMBAFr4JcZ9H6m0+Ve0QUDjawCtiRQZAIc\n fcATQrKkd4bzcx6n8j37JbNLPmReophBXXKWNnYUHsgtzITKAxqVOAmIFGC05Y/uUWUxrJ1/E6\n +os8uehQrVyl2MDTJ2/9dCYmoheL55YpaAYeJ2pZsd59ePgQK9RBDXsZuEzbUDzF997BRbtpDw\n ygBQZ+9NlxqZ1AcPMWyLD9UFuff4wAAAA==",
        "X-Change-ID": "20260504-dw-i2c-d5a1b1a0036a",
        "To": "Mika Westerberg <mika.westerberg@linux.intel.com>,\n Andy Shevchenko <andriy.shevchenko@linux.intel.com>,\n Jan Dabros <jsd@semihalf.com>, Andi Shyti <andi.shyti@kernel.org>",
        "Cc": "linux-i2c@vger.kernel.org, linux-kernel@vger.kernel.org,\n \"William A. Kennington III\" <william@wkennington.com>",
        "X-Mailer": "b4 0.14.3"
    },
    "content": "When the I2C controller attempts a new transaction while the target\ncontroller is shutting down or restarting, it can lead to bus lockups\nand system bootloops if the hardware enters an inconsistent state.\n\nThis patch series addresses this by ensuring that the internal state\nmachines are properly cleared when disabling the controller if target\nactivity is detected.\n\nAdditionally, it adds a shutdown hook that gracefully sets the target\ndisable bit before disabling the controller. This guarantees that any\nincoming requests from the controller are immediately NACKed during\nshutdown, preventing the bus from hanging.\n\nSigned-off-by: William A. Kennington III <william@wkennington.com>\n---\nChanges in v4:\n- Updated language to use inclusive terms\n- Refactored some minor comment / code nits\n- Link to v3: https://lore.kernel.org/r/20260504-dw-i2c-v3-0-57e56135d602@wkennington.com\nChanges in v3:\n- Split the monolithic patch into 4 logical patches\n- Reverted stray formatting change in the PCI driver's dw_i2c_driver struct.\nChanges in v2:\n- Fix description footers\n- Fix emails\n\n---\nWilliam A. Kennington III (4):\n      i2c: designware: Introduce shutdown exported function\n      i2c: designware: Convert PCI driver to use shutdown hook\n      i2c: designware: Convert platform driver to use shutdown hook\n      i2c: designware: Handle active target cleanly\n\n drivers/i2c/busses/i2c-designware-common.c  | 32 +++++++++++++++++++++++++++++\n drivers/i2c/busses/i2c-designware-core.h    |  1 +\n drivers/i2c/busses/i2c-designware-master.c  | 31 +++++++++++++++++-----------\n drivers/i2c/busses/i2c-designware-pcidrv.c  | 14 +++++++++++++\n drivers/i2c/busses/i2c-designware-platdrv.c | 14 +++++++++++++\n 5 files changed, 80 insertions(+), 12 deletions(-)\n---\nbase-commit: 5862221fddede6bb15566ab3c1f23a3c353da5e1\nchange-id: 20260504-dw-i2c-d5a1b1a0036a\n\nBest regards,"
}