Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 1 | /* |
Rob Clark | 8bb0daf | 2013-02-11 12:43:09 -0500 | [diff] [blame] | 2 | * drivers/gpu/drm/omapdrm/omap_irq.c |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 3 | * |
| 4 | * Copyright (C) 2012 Texas Instruments |
| 5 | * Author: Rob Clark <rob.clark@linaro.org> |
| 6 | * |
| 7 | * This program is free software; you can redistribute it and/or modify it |
| 8 | * under the terms of the GNU General Public License version 2 as published by |
| 9 | * the Free Software Foundation. |
| 10 | * |
| 11 | * This program is distributed in the hope that it will be useful, but WITHOUT |
| 12 | * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| 13 | * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for |
| 14 | * more details. |
| 15 | * |
| 16 | * You should have received a copy of the GNU General Public License along with |
| 17 | * this program. If not, see <http://www.gnu.org/licenses/>. |
| 18 | */ |
| 19 | |
| 20 | #include "omap_drv.h" |
| 21 | |
| 22 | static DEFINE_SPINLOCK(list_lock); |
| 23 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 24 | /* call with list_lock and dispc runtime held */ |
| 25 | static void omap_irq_update(struct drm_device *dev) |
| 26 | { |
| 27 | struct omap_drm_private *priv = dev->dev_private; |
| 28 | struct omap_drm_irq *irq; |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 29 | uint32_t irqmask = priv->irq_mask; |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 30 | |
Tomi Valkeinen | 8519c62 | 2014-11-28 14:34:16 +0200 | [diff] [blame] | 31 | assert_spin_locked(&list_lock); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 32 | |
| 33 | list_for_each_entry(irq, &priv->irq_list, node) |
| 34 | irqmask |= irq->irqmask; |
| 35 | |
| 36 | DBG("irqmask=%08x", irqmask); |
| 37 | |
| 38 | dispc_write_irqenable(irqmask); |
| 39 | dispc_read_irqenable(); /* flush posted write */ |
| 40 | } |
| 41 | |
Tomi Valkeinen | 6da9f89 | 2013-10-24 09:50:50 +0300 | [diff] [blame] | 42 | void __omap_irq_register(struct drm_device *dev, struct omap_drm_irq *irq) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 43 | { |
| 44 | struct omap_drm_private *priv = dev->dev_private; |
| 45 | unsigned long flags; |
| 46 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 47 | spin_lock_irqsave(&list_lock, flags); |
| 48 | |
| 49 | if (!WARN_ON(irq->registered)) { |
| 50 | irq->registered = true; |
| 51 | list_add(&irq->node, &priv->irq_list); |
| 52 | omap_irq_update(dev); |
| 53 | } |
| 54 | |
| 55 | spin_unlock_irqrestore(&list_lock, flags); |
Tomi Valkeinen | 6da9f89 | 2013-10-24 09:50:50 +0300 | [diff] [blame] | 56 | } |
| 57 | |
| 58 | void omap_irq_register(struct drm_device *dev, struct omap_drm_irq *irq) |
| 59 | { |
| 60 | dispc_runtime_get(); |
| 61 | |
| 62 | __omap_irq_register(dev, irq); |
| 63 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 64 | dispc_runtime_put(); |
| 65 | } |
| 66 | |
Tomi Valkeinen | 6da9f89 | 2013-10-24 09:50:50 +0300 | [diff] [blame] | 67 | void __omap_irq_unregister(struct drm_device *dev, struct omap_drm_irq *irq) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 68 | { |
| 69 | unsigned long flags; |
| 70 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 71 | spin_lock_irqsave(&list_lock, flags); |
| 72 | |
| 73 | if (!WARN_ON(!irq->registered)) { |
| 74 | irq->registered = false; |
| 75 | list_del(&irq->node); |
| 76 | omap_irq_update(dev); |
| 77 | } |
| 78 | |
| 79 | spin_unlock_irqrestore(&list_lock, flags); |
Tomi Valkeinen | 6da9f89 | 2013-10-24 09:50:50 +0300 | [diff] [blame] | 80 | } |
| 81 | |
| 82 | void omap_irq_unregister(struct drm_device *dev, struct omap_drm_irq *irq) |
| 83 | { |
| 84 | dispc_runtime_get(); |
| 85 | |
| 86 | __omap_irq_unregister(dev, irq); |
| 87 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 88 | dispc_runtime_put(); |
| 89 | } |
| 90 | |
| 91 | struct omap_irq_wait { |
| 92 | struct omap_drm_irq irq; |
| 93 | int count; |
| 94 | }; |
| 95 | |
| 96 | static DECLARE_WAIT_QUEUE_HEAD(wait_event); |
| 97 | |
| 98 | static void wait_irq(struct omap_drm_irq *irq, uint32_t irqstatus) |
| 99 | { |
| 100 | struct omap_irq_wait *wait = |
| 101 | container_of(irq, struct omap_irq_wait, irq); |
| 102 | wait->count--; |
| 103 | wake_up_all(&wait_event); |
| 104 | } |
| 105 | |
| 106 | struct omap_irq_wait * omap_irq_wait_init(struct drm_device *dev, |
| 107 | uint32_t irqmask, int count) |
| 108 | { |
| 109 | struct omap_irq_wait *wait = kzalloc(sizeof(*wait), GFP_KERNEL); |
| 110 | wait->irq.irq = wait_irq; |
| 111 | wait->irq.irqmask = irqmask; |
| 112 | wait->count = count; |
| 113 | omap_irq_register(dev, &wait->irq); |
| 114 | return wait; |
| 115 | } |
| 116 | |
| 117 | int omap_irq_wait(struct drm_device *dev, struct omap_irq_wait *wait, |
| 118 | unsigned long timeout) |
| 119 | { |
| 120 | int ret = wait_event_timeout(wait_event, (wait->count <= 0), timeout); |
| 121 | omap_irq_unregister(dev, &wait->irq); |
| 122 | kfree(wait); |
| 123 | if (ret == 0) |
| 124 | return -1; |
| 125 | return 0; |
| 126 | } |
| 127 | |
| 128 | /** |
| 129 | * enable_vblank - enable vblank interrupt events |
| 130 | * @dev: DRM device |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 131 | * @pipe: which irq to enable |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 132 | * |
| 133 | * Enable vblank interrupts for @crtc. If the device doesn't have |
| 134 | * a hardware vblank counter, this routine should be a no-op, since |
| 135 | * interrupts will have to stay on to keep the count accurate. |
| 136 | * |
| 137 | * RETURNS |
| 138 | * Zero on success, appropriate errno if the given @crtc's vblank |
| 139 | * interrupt cannot be enabled. |
| 140 | */ |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 141 | int omap_irq_enable_vblank(struct drm_device *dev, unsigned int pipe) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 142 | { |
| 143 | struct omap_drm_private *priv = dev->dev_private; |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 144 | struct drm_crtc *crtc = priv->crtcs[pipe]; |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 145 | unsigned long flags; |
| 146 | |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 147 | DBG("dev=%p, crtc=%u", dev, pipe); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 148 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 149 | spin_lock_irqsave(&list_lock, flags); |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 150 | priv->irq_mask |= pipe2vbl(crtc); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 151 | omap_irq_update(dev); |
| 152 | spin_unlock_irqrestore(&list_lock, flags); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 153 | |
| 154 | return 0; |
| 155 | } |
| 156 | |
| 157 | /** |
| 158 | * disable_vblank - disable vblank interrupt events |
| 159 | * @dev: DRM device |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 160 | * @pipe: which irq to enable |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 161 | * |
| 162 | * Disable vblank interrupts for @crtc. If the device doesn't have |
| 163 | * a hardware vblank counter, this routine should be a no-op, since |
| 164 | * interrupts will have to stay on to keep the count accurate. |
| 165 | */ |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 166 | void omap_irq_disable_vblank(struct drm_device *dev, unsigned int pipe) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 167 | { |
| 168 | struct omap_drm_private *priv = dev->dev_private; |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 169 | struct drm_crtc *crtc = priv->crtcs[pipe]; |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 170 | unsigned long flags; |
| 171 | |
Thierry Reding | 88e7271 | 2015-09-24 18:35:31 +0200 | [diff] [blame] | 172 | DBG("dev=%p, crtc=%u", dev, pipe); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 173 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 174 | spin_lock_irqsave(&list_lock, flags); |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 175 | priv->irq_mask &= ~pipe2vbl(crtc); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 176 | omap_irq_update(dev); |
| 177 | spin_unlock_irqrestore(&list_lock, flags); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 178 | } |
| 179 | |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 180 | static void omap_irq_fifo_underflow(struct omap_drm_private *priv, |
| 181 | u32 irqstatus) |
| 182 | { |
| 183 | static DEFINE_RATELIMIT_STATE(_rs, DEFAULT_RATELIMIT_INTERVAL, |
| 184 | DEFAULT_RATELIMIT_BURST); |
| 185 | static const struct { |
| 186 | const char *name; |
| 187 | u32 mask; |
| 188 | } sources[] = { |
| 189 | { "gfx", DISPC_IRQ_GFX_FIFO_UNDERFLOW }, |
| 190 | { "vid1", DISPC_IRQ_VID1_FIFO_UNDERFLOW }, |
| 191 | { "vid2", DISPC_IRQ_VID2_FIFO_UNDERFLOW }, |
| 192 | { "vid3", DISPC_IRQ_VID3_FIFO_UNDERFLOW }, |
| 193 | }; |
| 194 | |
| 195 | const u32 mask = DISPC_IRQ_GFX_FIFO_UNDERFLOW |
| 196 | | DISPC_IRQ_VID1_FIFO_UNDERFLOW |
| 197 | | DISPC_IRQ_VID2_FIFO_UNDERFLOW |
| 198 | | DISPC_IRQ_VID3_FIFO_UNDERFLOW; |
| 199 | unsigned int i; |
| 200 | |
| 201 | spin_lock(&list_lock); |
| 202 | irqstatus &= priv->irq_mask & mask; |
| 203 | spin_unlock(&list_lock); |
| 204 | |
| 205 | if (!irqstatus) |
| 206 | return; |
| 207 | |
| 208 | if (!__ratelimit(&_rs)) |
| 209 | return; |
| 210 | |
| 211 | DRM_ERROR("FIFO underflow on "); |
| 212 | |
| 213 | for (i = 0; i < ARRAY_SIZE(sources); ++i) { |
| 214 | if (sources[i].mask & irqstatus) |
| 215 | pr_cont("%s ", sources[i].name); |
| 216 | } |
| 217 | |
| 218 | pr_cont("(0x%08x)\n", irqstatus); |
| 219 | } |
| 220 | |
Laurent Pinchart | 6b5538d | 2015-05-28 01:05:20 +0300 | [diff] [blame] | 221 | static void omap_irq_ocp_error_handler(u32 irqstatus) |
| 222 | { |
| 223 | if (!(irqstatus & DISPC_IRQ_OCP_ERR)) |
| 224 | return; |
| 225 | |
| 226 | DRM_ERROR("OCP error\n"); |
| 227 | } |
| 228 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 229 | static irqreturn_t omap_irq_handler(int irq, void *arg) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 230 | { |
| 231 | struct drm_device *dev = (struct drm_device *) arg; |
| 232 | struct omap_drm_private *priv = dev->dev_private; |
| 233 | struct omap_drm_irq *handler, *n; |
| 234 | unsigned long flags; |
| 235 | unsigned int id; |
| 236 | u32 irqstatus; |
| 237 | |
| 238 | irqstatus = dispc_read_irqstatus(); |
| 239 | dispc_clear_irqstatus(irqstatus); |
| 240 | dispc_read_irqstatus(); /* flush posted write */ |
| 241 | |
| 242 | VERB("irqs: %08x", irqstatus); |
| 243 | |
Archit Taneja | 0d8f371 | 2013-03-26 19:15:19 +0530 | [diff] [blame] | 244 | for (id = 0; id < priv->num_crtcs; id++) { |
| 245 | struct drm_crtc *crtc = priv->crtcs[id]; |
Laurent Pinchart | e0519af | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 246 | enum omap_channel channel = omap_crtc_channel(crtc); |
Archit Taneja | 0d8f371 | 2013-03-26 19:15:19 +0530 | [diff] [blame] | 247 | |
Laurent Pinchart | 14389a3 | 2016-04-19 01:43:03 +0300 | [diff] [blame^] | 248 | if (irqstatus & pipe2vbl(crtc)) { |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 249 | drm_handle_vblank(dev, id); |
Laurent Pinchart | 14389a3 | 2016-04-19 01:43:03 +0300 | [diff] [blame^] | 250 | omap_crtc_vblank_irq(crtc); |
| 251 | } |
Laurent Pinchart | e0519af | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 252 | |
| 253 | if (irqstatus & dispc_mgr_get_sync_lost_irq(channel)) |
| 254 | omap_crtc_error_irq(crtc, irqstatus); |
Archit Taneja | 0d8f371 | 2013-03-26 19:15:19 +0530 | [diff] [blame] | 255 | } |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 256 | |
Laurent Pinchart | 6b5538d | 2015-05-28 01:05:20 +0300 | [diff] [blame] | 257 | omap_irq_ocp_error_handler(irqstatus); |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 258 | omap_irq_fifo_underflow(priv, irqstatus); |
| 259 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 260 | spin_lock_irqsave(&list_lock, flags); |
| 261 | list_for_each_entry_safe(handler, n, &priv->irq_list, node) { |
| 262 | if (handler->irqmask & irqstatus) { |
| 263 | spin_unlock_irqrestore(&list_lock, flags); |
| 264 | handler->irq(handler, handler->irqmask & irqstatus); |
| 265 | spin_lock_irqsave(&list_lock, flags); |
| 266 | } |
| 267 | } |
| 268 | spin_unlock_irqrestore(&list_lock, flags); |
| 269 | |
| 270 | return IRQ_HANDLED; |
| 271 | } |
| 272 | |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 273 | static const u32 omap_underflow_irqs[] = { |
| 274 | [OMAP_DSS_GFX] = DISPC_IRQ_GFX_FIFO_UNDERFLOW, |
| 275 | [OMAP_DSS_VIDEO1] = DISPC_IRQ_VID1_FIFO_UNDERFLOW, |
| 276 | [OMAP_DSS_VIDEO2] = DISPC_IRQ_VID2_FIFO_UNDERFLOW, |
| 277 | [OMAP_DSS_VIDEO3] = DISPC_IRQ_VID3_FIFO_UNDERFLOW, |
| 278 | }; |
| 279 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 280 | /* |
| 281 | * We need a special version, instead of just using drm_irq_install(), |
| 282 | * because we need to register the irq via omapdss. Once omapdss and |
| 283 | * omapdrm are merged together we can assign the dispc hwmod data to |
| 284 | * ourselves and drop these and just use drm_irq_{install,uninstall}() |
| 285 | */ |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 286 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 287 | int omap_drm_irq_install(struct drm_device *dev) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 288 | { |
| 289 | struct omap_drm_private *priv = dev->dev_private; |
Laurent Pinchart | e0519af | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 290 | unsigned int num_mgrs = dss_feat_get_num_mgrs(); |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 291 | unsigned int max_planes; |
| 292 | unsigned int i; |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 293 | int ret; |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 294 | |
| 295 | INIT_LIST_HEAD(&priv->irq_list); |
| 296 | |
Laurent Pinchart | 6b5538d | 2015-05-28 01:05:20 +0300 | [diff] [blame] | 297 | priv->irq_mask = DISPC_IRQ_OCP_ERR; |
Laurent Pinchart | 728ae8d | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 298 | |
| 299 | max_planes = min(ARRAY_SIZE(priv->planes), |
| 300 | ARRAY_SIZE(omap_underflow_irqs)); |
| 301 | for (i = 0; i < max_planes; ++i) { |
| 302 | if (priv->planes[i]) |
| 303 | priv->irq_mask |= omap_underflow_irqs[i]; |
| 304 | } |
| 305 | |
Laurent Pinchart | e0519af | 2015-05-28 00:21:29 +0300 | [diff] [blame] | 306 | for (i = 0; i < num_mgrs; ++i) |
| 307 | priv->irq_mask |= dispc_mgr_get_sync_lost_irq(i); |
| 308 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 309 | dispc_runtime_get(); |
| 310 | dispc_clear_irqstatus(0xffffffff); |
| 311 | dispc_runtime_put(); |
| 312 | |
| 313 | ret = dispc_request_irq(omap_irq_handler, dev); |
| 314 | if (ret < 0) |
| 315 | return ret; |
| 316 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 317 | dev->irq_enabled = true; |
| 318 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 319 | return 0; |
| 320 | } |
| 321 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 322 | void omap_drm_irq_uninstall(struct drm_device *dev) |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 323 | { |
| 324 | unsigned long irqflags; |
Ville Syrjälä | 4423843 | 2013-10-04 14:53:37 +0300 | [diff] [blame] | 325 | int i; |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 326 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 327 | if (!dev->irq_enabled) |
| 328 | return; |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 329 | |
Laurent Pinchart | f13ab00 | 2015-01-25 22:06:45 +0200 | [diff] [blame] | 330 | dev->irq_enabled = false; |
| 331 | |
| 332 | /* Wake up any waiters so they don't hang. */ |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 333 | if (dev->num_crtcs) { |
| 334 | spin_lock_irqsave(&dev->vbl_lock, irqflags); |
| 335 | for (i = 0; i < dev->num_crtcs; i++) { |
Daniel Vetter | 57ed0f7 | 2013-12-11 11:34:43 +0100 | [diff] [blame] | 336 | wake_up(&dev->vblank[i].queue); |
Ville Syrjälä | 5380e92 | 2013-10-04 14:53:36 +0300 | [diff] [blame] | 337 | dev->vblank[i].enabled = false; |
| 338 | dev->vblank[i].last = |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 339 | dev->driver->get_vblank_counter(dev, i); |
| 340 | } |
| 341 | spin_unlock_irqrestore(&dev->vbl_lock, irqflags); |
| 342 | } |
| 343 | |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 344 | dispc_free_irq(dev); |
Rob Clark | f5f9454 | 2012-12-04 13:59:12 -0600 | [diff] [blame] | 345 | } |