LCOV - code coverage report
Current view: top level - drivers/gpu/drm - drm_mipi_dsi.c (source / functions) Hit Total Coverage
Test: combined.info Lines: 2 315 0.6 %
Date: 2022-03-28 15:32:58 Functions: 1 49 2.0 %
Branches: 0 88 0.0 %

           Branch data     Line data    Source code
       1                 :            : /*
       2                 :            :  * MIPI DSI Bus
       3                 :            :  *
       4                 :            :  * Copyright (C) 2012-2013, Samsung Electronics, Co., Ltd.
       5                 :            :  * Andrzej Hajda <a.hajda@samsung.com>
       6                 :            :  *
       7                 :            :  * Permission is hereby granted, free of charge, to any person obtaining a
       8                 :            :  * copy of this software and associated documentation files (the
       9                 :            :  * "Software"), to deal in the Software without restriction, including
      10                 :            :  * without limitation the rights to use, copy, modify, merge, publish,
      11                 :            :  * distribute, sub license, and/or sell copies of the Software, and to
      12                 :            :  * permit persons to whom the Software is furnished to do so, subject to
      13                 :            :  * the following conditions:
      14                 :            :  *
      15                 :            :  * The above copyright notice and this permission notice (including the
      16                 :            :  * next paragraph) shall be included in all copies or substantial portions
      17                 :            :  * of the Software.
      18                 :            :  *
      19                 :            :  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
      20                 :            :  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
      21                 :            :  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
      22                 :            :  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
      23                 :            :  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
      24                 :            :  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
      25                 :            :  * USE OR OTHER DEALINGS IN THE SOFTWARE.
      26                 :            :  */
      27                 :            : 
      28                 :            : #include <drm/drm_mipi_dsi.h>
      29                 :            : 
      30                 :            : #include <linux/device.h>
      31                 :            : #include <linux/module.h>
      32                 :            : #include <linux/of_device.h>
      33                 :            : #include <linux/pm_runtime.h>
      34                 :            : #include <linux/slab.h>
      35                 :            : 
      36                 :            : #include <drm/drm_dsc.h>
      37                 :            : #include <video/mipi_display.h>
      38                 :            : 
      39                 :            : /**
      40                 :            :  * DOC: dsi helpers
      41                 :            :  *
      42                 :            :  * These functions contain some common logic and helpers to deal with MIPI DSI
      43                 :            :  * peripherals.
      44                 :            :  *
      45                 :            :  * Helpers are provided for a number of standard MIPI DSI command as well as a
      46                 :            :  * subset of the MIPI DCS command set.
      47                 :            :  */
      48                 :            : 
      49                 :          0 : static int mipi_dsi_device_match(struct device *dev, struct device_driver *drv)
      50                 :            : {
      51         [ #  # ]:          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
      52                 :            : 
      53                 :            :         /* attempt OF style match */
      54         [ #  # ]:          0 :         if (of_driver_match_device(dev, drv))
      55                 :            :                 return 1;
      56                 :            : 
      57                 :            :         /* compare DSI device and driver names */
      58         [ #  # ]:          0 :         if (!strcmp(dsi->name, drv->name))
      59                 :          0 :                 return 1;
      60                 :            : 
      61                 :            :         return 0;
      62                 :            : }
      63                 :            : 
      64                 :          0 : static int mipi_dsi_uevent(struct device *dev, struct kobj_uevent_env *env)
      65                 :            : {
      66                 :          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
      67                 :          0 :         int err;
      68                 :            : 
      69                 :          0 :         err = of_device_uevent_modalias(dev, env);
      70                 :          0 :         if (err != -ENODEV)
      71                 :            :                 return err;
      72                 :            : 
      73                 :          0 :         add_uevent_var(env, "MODALIAS=%s%s", MIPI_DSI_MODULE_PREFIX,
      74                 :          0 :                        dsi->name);
      75                 :            : 
      76                 :          0 :         return 0;
      77                 :            : }
      78                 :            : 
      79                 :            : static const struct dev_pm_ops mipi_dsi_device_pm_ops = {
      80                 :            :         .runtime_suspend = pm_generic_runtime_suspend,
      81                 :            :         .runtime_resume = pm_generic_runtime_resume,
      82                 :            :         .suspend = pm_generic_suspend,
      83                 :            :         .resume = pm_generic_resume,
      84                 :            :         .freeze = pm_generic_freeze,
      85                 :            :         .thaw = pm_generic_thaw,
      86                 :            :         .poweroff = pm_generic_poweroff,
      87                 :            :         .restore = pm_generic_restore,
      88                 :            : };
      89                 :            : 
      90                 :            : static struct bus_type mipi_dsi_bus_type = {
      91                 :            :         .name = "mipi-dsi",
      92                 :            :         .match = mipi_dsi_device_match,
      93                 :            :         .uevent = mipi_dsi_uevent,
      94                 :            :         .pm = &mipi_dsi_device_pm_ops,
      95                 :            : };
      96                 :            : 
      97                 :            : /**
      98                 :            :  * of_find_mipi_dsi_device_by_node() - find the MIPI DSI device matching a
      99                 :            :  *    device tree node
     100                 :            :  * @np: device tree node
     101                 :            :  *
     102                 :            :  * Return: A pointer to the MIPI DSI device corresponding to @np or NULL if no
     103                 :            :  *    such device exists (or has not been registered yet).
     104                 :            :  */
     105                 :          0 : struct mipi_dsi_device *of_find_mipi_dsi_device_by_node(struct device_node *np)
     106                 :            : {
     107                 :          0 :         struct device *dev;
     108                 :            : 
     109                 :          0 :         dev = bus_find_device_by_of_node(&mipi_dsi_bus_type, np);
     110                 :            : 
     111         [ #  # ]:          0 :         return dev ? to_mipi_dsi_device(dev) : NULL;
     112                 :            : }
     113                 :            : EXPORT_SYMBOL(of_find_mipi_dsi_device_by_node);
     114                 :            : 
     115                 :          0 : static void mipi_dsi_dev_release(struct device *dev)
     116                 :            : {
     117                 :          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
     118                 :            : 
     119                 :          0 :         of_node_put(dev->of_node);
     120                 :          0 :         kfree(dsi);
     121                 :          0 : }
     122                 :            : 
     123                 :            : static const struct device_type mipi_dsi_device_type = {
     124                 :            :         .release = mipi_dsi_dev_release,
     125                 :            : };
     126                 :            : 
     127                 :          0 : static struct mipi_dsi_device *mipi_dsi_device_alloc(struct mipi_dsi_host *host)
     128                 :            : {
     129                 :          0 :         struct mipi_dsi_device *dsi;
     130                 :            : 
     131                 :          0 :         dsi = kzalloc(sizeof(*dsi), GFP_KERNEL);
     132         [ #  # ]:          0 :         if (!dsi)
     133                 :            :                 return ERR_PTR(-ENOMEM);
     134                 :            : 
     135                 :          0 :         dsi->host = host;
     136                 :          0 :         dsi->dev.bus = &mipi_dsi_bus_type;
     137                 :          0 :         dsi->dev.parent = host->dev;
     138                 :          0 :         dsi->dev.type = &mipi_dsi_device_type;
     139                 :            : 
     140                 :          0 :         device_initialize(&dsi->dev);
     141                 :            : 
     142                 :          0 :         return dsi;
     143                 :            : }
     144                 :            : 
     145                 :          0 : static int mipi_dsi_device_add(struct mipi_dsi_device *dsi)
     146                 :            : {
     147                 :          0 :         struct mipi_dsi_host *host = dsi->host;
     148                 :            : 
     149         [ #  # ]:          0 :         dev_set_name(&dsi->dev, "%s.%d", dev_name(host->dev),  dsi->channel);
     150                 :            : 
     151                 :          0 :         return device_add(&dsi->dev);
     152                 :            : }
     153                 :            : 
     154                 :            : #if IS_ENABLED(CONFIG_OF)
     155                 :            : static struct mipi_dsi_device *
     156                 :            : of_mipi_dsi_device_add(struct mipi_dsi_host *host, struct device_node *node)
     157                 :            : {
     158                 :            :         struct device *dev = host->dev;
     159                 :            :         struct mipi_dsi_device_info info = { };
     160                 :            :         int ret;
     161                 :            :         u32 reg;
     162                 :            : 
     163                 :            :         if (of_modalias_node(node, info.type, sizeof(info.type)) < 0) {
     164                 :            :                 dev_err(dev, "modalias failure on %pOF\n", node);
     165                 :            :                 return ERR_PTR(-EINVAL);
     166                 :            :         }
     167                 :            : 
     168                 :            :         ret = of_property_read_u32(node, "reg", &reg);
     169                 :            :         if (ret) {
     170                 :            :                 dev_err(dev, "device node %pOF has no valid reg property: %d\n",
     171                 :            :                         node, ret);
     172                 :            :                 return ERR_PTR(-EINVAL);
     173                 :            :         }
     174                 :            : 
     175                 :            :         info.channel = reg;
     176                 :            :         info.node = of_node_get(node);
     177                 :            : 
     178                 :            :         return mipi_dsi_device_register_full(host, &info);
     179                 :            : }
     180                 :            : #else
     181                 :            : static struct mipi_dsi_device *
     182                 :            : of_mipi_dsi_device_add(struct mipi_dsi_host *host, struct device_node *node)
     183                 :            : {
     184                 :            :         return ERR_PTR(-ENODEV);
     185                 :            : }
     186                 :            : #endif
     187                 :            : 
     188                 :            : /**
     189                 :            :  * mipi_dsi_device_register_full - create a MIPI DSI device
     190                 :            :  * @host: DSI host to which this device is connected
     191                 :            :  * @info: pointer to template containing DSI device information
     192                 :            :  *
     193                 :            :  * Create a MIPI DSI device by using the device information provided by
     194                 :            :  * mipi_dsi_device_info template
     195                 :            :  *
     196                 :            :  * Returns:
     197                 :            :  * A pointer to the newly created MIPI DSI device, or, a pointer encoded
     198                 :            :  * with an error
     199                 :            :  */
     200                 :            : struct mipi_dsi_device *
     201                 :          0 : mipi_dsi_device_register_full(struct mipi_dsi_host *host,
     202                 :            :                               const struct mipi_dsi_device_info *info)
     203                 :            : {
     204                 :          0 :         struct mipi_dsi_device *dsi;
     205                 :          0 :         struct device *dev = host->dev;
     206                 :          0 :         int ret;
     207                 :            : 
     208         [ #  # ]:          0 :         if (!info) {
     209                 :          0 :                 dev_err(dev, "invalid mipi_dsi_device_info pointer\n");
     210                 :          0 :                 return ERR_PTR(-EINVAL);
     211                 :            :         }
     212                 :            : 
     213         [ #  # ]:          0 :         if (info->channel > 3) {
     214                 :          0 :                 dev_err(dev, "invalid virtual channel: %u\n", info->channel);
     215                 :          0 :                 return ERR_PTR(-EINVAL);
     216                 :            :         }
     217                 :            : 
     218                 :          0 :         dsi = mipi_dsi_device_alloc(host);
     219         [ #  # ]:          0 :         if (IS_ERR(dsi)) {
     220                 :          0 :                 dev_err(dev, "failed to allocate DSI device %ld\n",
     221                 :            :                         PTR_ERR(dsi));
     222                 :          0 :                 return dsi;
     223                 :            :         }
     224                 :            : 
     225                 :          0 :         dsi->dev.of_node = info->node;
     226                 :          0 :         dsi->channel = info->channel;
     227                 :          0 :         strlcpy(dsi->name, info->type, sizeof(dsi->name));
     228                 :            : 
     229                 :          0 :         ret = mipi_dsi_device_add(dsi);
     230         [ #  # ]:          0 :         if (ret) {
     231                 :          0 :                 dev_err(dev, "failed to add DSI device %d\n", ret);
     232                 :          0 :                 kfree(dsi);
     233                 :          0 :                 return ERR_PTR(ret);
     234                 :            :         }
     235                 :            : 
     236                 :            :         return dsi;
     237                 :            : }
     238                 :            : EXPORT_SYMBOL(mipi_dsi_device_register_full);
     239                 :            : 
     240                 :            : /**
     241                 :            :  * mipi_dsi_device_unregister - unregister MIPI DSI device
     242                 :            :  * @dsi: DSI peripheral device
     243                 :            :  */
     244                 :          0 : void mipi_dsi_device_unregister(struct mipi_dsi_device *dsi)
     245                 :            : {
     246                 :          0 :         device_unregister(&dsi->dev);
     247                 :          0 : }
     248                 :            : EXPORT_SYMBOL(mipi_dsi_device_unregister);
     249                 :            : 
     250                 :            : static DEFINE_MUTEX(host_lock);
     251                 :            : static LIST_HEAD(host_list);
     252                 :            : 
     253                 :            : /**
     254                 :            :  * of_find_mipi_dsi_host_by_node() - find the MIPI DSI host matching a
     255                 :            :  *                                   device tree node
     256                 :            :  * @node: device tree node
     257                 :            :  *
     258                 :            :  * Returns:
     259                 :            :  * A pointer to the MIPI DSI host corresponding to @node or NULL if no
     260                 :            :  * such device exists (or has not been registered yet).
     261                 :            :  */
     262                 :          0 : struct mipi_dsi_host *of_find_mipi_dsi_host_by_node(struct device_node *node)
     263                 :            : {
     264                 :          0 :         struct mipi_dsi_host *host;
     265                 :            : 
     266                 :          0 :         mutex_lock(&host_lock);
     267                 :            : 
     268         [ #  # ]:          0 :         list_for_each_entry(host, &host_list, list) {
     269         [ #  # ]:          0 :                 if (host->dev->of_node == node) {
     270                 :          0 :                         mutex_unlock(&host_lock);
     271                 :          0 :                         return host;
     272                 :            :                 }
     273                 :            :         }
     274                 :            : 
     275                 :          0 :         mutex_unlock(&host_lock);
     276                 :            : 
     277                 :          0 :         return NULL;
     278                 :            : }
     279                 :            : EXPORT_SYMBOL(of_find_mipi_dsi_host_by_node);
     280                 :            : 
     281                 :          0 : int mipi_dsi_host_register(struct mipi_dsi_host *host)
     282                 :            : {
     283                 :          0 :         struct device_node *node;
     284                 :            : 
     285                 :          0 :         for_each_available_child_of_node(host->dev->of_node, node) {
     286                 :            :                 /* skip nodes without reg property */
     287                 :            :                 if (!of_find_property(node, "reg", NULL))
     288                 :            :                         continue;
     289                 :            :                 of_mipi_dsi_device_add(host, node);
     290                 :            :         }
     291                 :            : 
     292                 :          0 :         mutex_lock(&host_lock);
     293                 :          0 :         list_add_tail(&host->list, &host_list);
     294                 :          0 :         mutex_unlock(&host_lock);
     295                 :            : 
     296                 :          0 :         return 0;
     297                 :            : }
     298                 :            : EXPORT_SYMBOL(mipi_dsi_host_register);
     299                 :            : 
     300                 :          0 : static int mipi_dsi_remove_device_fn(struct device *dev, void *priv)
     301                 :            : {
     302                 :          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
     303                 :            : 
     304                 :          0 :         mipi_dsi_device_unregister(dsi);
     305                 :            : 
     306                 :          0 :         return 0;
     307                 :            : }
     308                 :            : 
     309                 :          0 : void mipi_dsi_host_unregister(struct mipi_dsi_host *host)
     310                 :            : {
     311                 :          0 :         device_for_each_child(host->dev, NULL, mipi_dsi_remove_device_fn);
     312                 :            : 
     313                 :          0 :         mutex_lock(&host_lock);
     314                 :          0 :         list_del_init(&host->list);
     315                 :          0 :         mutex_unlock(&host_lock);
     316                 :          0 : }
     317                 :            : EXPORT_SYMBOL(mipi_dsi_host_unregister);
     318                 :            : 
     319                 :            : /**
     320                 :            :  * mipi_dsi_attach - attach a DSI device to its DSI host
     321                 :            :  * @dsi: DSI peripheral
     322                 :            :  */
     323                 :          0 : int mipi_dsi_attach(struct mipi_dsi_device *dsi)
     324                 :            : {
     325                 :          0 :         const struct mipi_dsi_host_ops *ops = dsi->host->ops;
     326                 :            : 
     327   [ #  #  #  # ]:          0 :         if (!ops || !ops->attach)
     328                 :            :                 return -ENOSYS;
     329                 :            : 
     330                 :          0 :         return ops->attach(dsi->host, dsi);
     331                 :            : }
     332                 :            : EXPORT_SYMBOL(mipi_dsi_attach);
     333                 :            : 
     334                 :            : /**
     335                 :            :  * mipi_dsi_detach - detach a DSI device from its DSI host
     336                 :            :  * @dsi: DSI peripheral
     337                 :            :  */
     338                 :          0 : int mipi_dsi_detach(struct mipi_dsi_device *dsi)
     339                 :            : {
     340                 :          0 :         const struct mipi_dsi_host_ops *ops = dsi->host->ops;
     341                 :            : 
     342   [ #  #  #  # ]:          0 :         if (!ops || !ops->detach)
     343                 :            :                 return -ENOSYS;
     344                 :            : 
     345                 :          0 :         return ops->detach(dsi->host, dsi);
     346                 :            : }
     347                 :            : EXPORT_SYMBOL(mipi_dsi_detach);
     348                 :            : 
     349                 :            : static ssize_t mipi_dsi_device_transfer(struct mipi_dsi_device *dsi,
     350                 :            :                                         struct mipi_dsi_msg *msg)
     351                 :            : {
     352                 :            :         const struct mipi_dsi_host_ops *ops = dsi->host->ops;
     353                 :            : 
     354                 :            :         if (!ops || !ops->transfer)
     355                 :            :                 return -ENOSYS;
     356                 :            : 
     357                 :            :         if (dsi->mode_flags & MIPI_DSI_MODE_LPM)
     358                 :            :                 msg->flags |= MIPI_DSI_MSG_USE_LPM;
     359                 :            : 
     360                 :            :         return ops->transfer(dsi->host, msg);
     361                 :            : }
     362                 :            : 
     363                 :            : /**
     364                 :            :  * mipi_dsi_packet_format_is_short - check if a packet is of the short format
     365                 :            :  * @type: MIPI DSI data type of the packet
     366                 :            :  *
     367                 :            :  * Return: true if the packet for the given data type is a short packet, false
     368                 :            :  * otherwise.
     369                 :            :  */
     370                 :          0 : bool mipi_dsi_packet_format_is_short(u8 type)
     371                 :            : {
     372         [ #  # ]:          0 :         switch (type) {
     373                 :            :         case MIPI_DSI_V_SYNC_START:
     374                 :            :         case MIPI_DSI_V_SYNC_END:
     375                 :            :         case MIPI_DSI_H_SYNC_START:
     376                 :            :         case MIPI_DSI_H_SYNC_END:
     377                 :            :         case MIPI_DSI_COMPRESSION_MODE:
     378                 :            :         case MIPI_DSI_END_OF_TRANSMISSION:
     379                 :            :         case MIPI_DSI_COLOR_MODE_OFF:
     380                 :            :         case MIPI_DSI_COLOR_MODE_ON:
     381                 :            :         case MIPI_DSI_SHUTDOWN_PERIPHERAL:
     382                 :            :         case MIPI_DSI_TURN_ON_PERIPHERAL:
     383                 :            :         case MIPI_DSI_GENERIC_SHORT_WRITE_0_PARAM:
     384                 :            :         case MIPI_DSI_GENERIC_SHORT_WRITE_1_PARAM:
     385                 :            :         case MIPI_DSI_GENERIC_SHORT_WRITE_2_PARAM:
     386                 :            :         case MIPI_DSI_GENERIC_READ_REQUEST_0_PARAM:
     387                 :            :         case MIPI_DSI_GENERIC_READ_REQUEST_1_PARAM:
     388                 :            :         case MIPI_DSI_GENERIC_READ_REQUEST_2_PARAM:
     389                 :            :         case MIPI_DSI_DCS_SHORT_WRITE:
     390                 :            :         case MIPI_DSI_DCS_SHORT_WRITE_PARAM:
     391                 :            :         case MIPI_DSI_DCS_READ:
     392                 :            :         case MIPI_DSI_EXECUTE_QUEUE:
     393                 :            :         case MIPI_DSI_SET_MAXIMUM_RETURN_PACKET_SIZE:
     394                 :            :                 return true;
     395                 :            :         }
     396                 :            : 
     397                 :          0 :         return false;
     398                 :            : }
     399                 :            : EXPORT_SYMBOL(mipi_dsi_packet_format_is_short);
     400                 :            : 
     401                 :            : /**
     402                 :            :  * mipi_dsi_packet_format_is_long - check if a packet is of the long format
     403                 :            :  * @type: MIPI DSI data type of the packet
     404                 :            :  *
     405                 :            :  * Return: true if the packet for the given data type is a long packet, false
     406                 :            :  * otherwise.
     407                 :            :  */
     408                 :          0 : bool mipi_dsi_packet_format_is_long(u8 type)
     409                 :            : {
     410         [ #  # ]:          0 :         switch (type) {
     411                 :            :         case MIPI_DSI_NULL_PACKET:
     412                 :            :         case MIPI_DSI_BLANKING_PACKET:
     413                 :            :         case MIPI_DSI_GENERIC_LONG_WRITE:
     414                 :            :         case MIPI_DSI_DCS_LONG_WRITE:
     415                 :            :         case MIPI_DSI_PICTURE_PARAMETER_SET:
     416                 :            :         case MIPI_DSI_COMPRESSED_PIXEL_STREAM:
     417                 :            :         case MIPI_DSI_LOOSELY_PACKED_PIXEL_STREAM_YCBCR20:
     418                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_YCBCR24:
     419                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_YCBCR16:
     420                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_30:
     421                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_36:
     422                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_YCBCR12:
     423                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_16:
     424                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_18:
     425                 :            :         case MIPI_DSI_PIXEL_STREAM_3BYTE_18:
     426                 :            :         case MIPI_DSI_PACKED_PIXEL_STREAM_24:
     427                 :            :                 return true;
     428                 :            :         }
     429                 :            : 
     430                 :          0 :         return false;
     431                 :            : }
     432                 :            : EXPORT_SYMBOL(mipi_dsi_packet_format_is_long);
     433                 :            : 
     434                 :            : /**
     435                 :            :  * mipi_dsi_create_packet - create a packet from a message according to the
     436                 :            :  *     DSI protocol
     437                 :            :  * @packet: pointer to a DSI packet structure
     438                 :            :  * @msg: message to translate into a packet
     439                 :            :  *
     440                 :            :  * Return: 0 on success or a negative error code on failure.
     441                 :            :  */
     442                 :          0 : int mipi_dsi_create_packet(struct mipi_dsi_packet *packet,
     443                 :            :                            const struct mipi_dsi_msg *msg)
     444                 :            : {
     445         [ #  # ]:          0 :         if (!packet || !msg)
     446                 :            :                 return -EINVAL;
     447                 :            : 
     448                 :            :         /* do some minimum sanity checking */
     449         [ #  # ]:          0 :         if (!mipi_dsi_packet_format_is_short(msg->type) &&
     450         [ #  # ]:          0 :             !mipi_dsi_packet_format_is_long(msg->type))
     451                 :            :                 return -EINVAL;
     452                 :            : 
     453         [ #  # ]:          0 :         if (msg->channel > 3)
     454                 :            :                 return -EINVAL;
     455                 :            : 
     456                 :          0 :         memset(packet, 0, sizeof(*packet));
     457                 :          0 :         packet->header[0] = ((msg->channel & 0x3) << 6) | (msg->type & 0x3f);
     458                 :            : 
     459                 :            :         /* TODO: compute ECC if hardware support is not available */
     460                 :            : 
     461                 :            :         /*
     462                 :            :          * Long write packets contain the word count in header bytes 1 and 2.
     463                 :            :          * The payload follows the header and is word count bytes long.
     464                 :            :          *
     465                 :            :          * Short write packets encode up to two parameters in header bytes 1
     466                 :            :          * and 2.
     467                 :            :          */
     468         [ #  # ]:          0 :         if (mipi_dsi_packet_format_is_long(msg->type)) {
     469                 :          0 :                 packet->header[1] = (msg->tx_len >> 0) & 0xff;
     470                 :          0 :                 packet->header[2] = (msg->tx_len >> 8) & 0xff;
     471                 :            : 
     472                 :          0 :                 packet->payload_length = msg->tx_len;
     473                 :          0 :                 packet->payload = msg->tx_buf;
     474                 :            :         } else {
     475                 :          0 :                 const u8 *tx = msg->tx_buf;
     476                 :            : 
     477         [ #  # ]:          0 :                 packet->header[1] = (msg->tx_len > 0) ? tx[0] : 0;
     478         [ #  # ]:          0 :                 packet->header[2] = (msg->tx_len > 1) ? tx[1] : 0;
     479                 :            :         }
     480                 :            : 
     481                 :          0 :         packet->size = sizeof(packet->header) + packet->payload_length;
     482                 :            : 
     483                 :          0 :         return 0;
     484                 :            : }
     485                 :            : EXPORT_SYMBOL(mipi_dsi_create_packet);
     486                 :            : 
     487                 :            : /**
     488                 :            :  * mipi_dsi_shutdown_peripheral() - sends a Shutdown Peripheral command
     489                 :            :  * @dsi: DSI peripheral device
     490                 :            :  *
     491                 :            :  * Return: 0 on success or a negative error code on failure.
     492                 :            :  */
     493                 :          0 : int mipi_dsi_shutdown_peripheral(struct mipi_dsi_device *dsi)
     494                 :            : {
     495                 :          0 :         struct mipi_dsi_msg msg = {
     496                 :          0 :                 .channel = dsi->channel,
     497                 :            :                 .type = MIPI_DSI_SHUTDOWN_PERIPHERAL,
     498                 :          0 :                 .tx_buf = (u8 [2]) { 0, 0 },
     499                 :            :                 .tx_len = 2,
     500                 :            :         };
     501                 :          0 :         int ret = mipi_dsi_device_transfer(dsi, &msg);
     502                 :            : 
     503                 :          0 :         return (ret < 0) ? ret : 0;
     504                 :            : }
     505                 :            : EXPORT_SYMBOL(mipi_dsi_shutdown_peripheral);
     506                 :            : 
     507                 :            : /**
     508                 :            :  * mipi_dsi_turn_on_peripheral() - sends a Turn On Peripheral command
     509                 :            :  * @dsi: DSI peripheral device
     510                 :            :  *
     511                 :            :  * Return: 0 on success or a negative error code on failure.
     512                 :            :  */
     513                 :          0 : int mipi_dsi_turn_on_peripheral(struct mipi_dsi_device *dsi)
     514                 :            : {
     515                 :          0 :         struct mipi_dsi_msg msg = {
     516                 :          0 :                 .channel = dsi->channel,
     517                 :            :                 .type = MIPI_DSI_TURN_ON_PERIPHERAL,
     518                 :          0 :                 .tx_buf = (u8 [2]) { 0, 0 },
     519                 :            :                 .tx_len = 2,
     520                 :            :         };
     521                 :          0 :         int ret = mipi_dsi_device_transfer(dsi, &msg);
     522                 :            : 
     523                 :          0 :         return (ret < 0) ? ret : 0;
     524                 :            : }
     525                 :            : EXPORT_SYMBOL(mipi_dsi_turn_on_peripheral);
     526                 :            : 
     527                 :            : /*
     528                 :            :  * mipi_dsi_set_maximum_return_packet_size() - specify the maximum size of the
     529                 :            :  *    the payload in a long packet transmitted from the peripheral back to the
     530                 :            :  *    host processor
     531                 :            :  * @dsi: DSI peripheral device
     532                 :            :  * @value: the maximum size of the payload
     533                 :            :  *
     534                 :            :  * Return: 0 on success or a negative error code on failure.
     535                 :            :  */
     536                 :          0 : int mipi_dsi_set_maximum_return_packet_size(struct mipi_dsi_device *dsi,
     537                 :            :                                             u16 value)
     538                 :            : {
     539                 :          0 :         u8 tx[2] = { value & 0xff, value >> 8 };
     540                 :          0 :         struct mipi_dsi_msg msg = {
     541                 :          0 :                 .channel = dsi->channel,
     542                 :            :                 .type = MIPI_DSI_SET_MAXIMUM_RETURN_PACKET_SIZE,
     543                 :            :                 .tx_len = sizeof(tx),
     544                 :            :                 .tx_buf = tx,
     545                 :            :         };
     546                 :          0 :         int ret = mipi_dsi_device_transfer(dsi, &msg);
     547                 :            : 
     548                 :          0 :         return (ret < 0) ? ret : 0;
     549                 :            : }
     550                 :            : EXPORT_SYMBOL(mipi_dsi_set_maximum_return_packet_size);
     551                 :            : 
     552                 :            : /**
     553                 :            :  * mipi_dsi_compression_mode() - enable/disable DSC on the peripheral
     554                 :            :  * @dsi: DSI peripheral device
     555                 :            :  * @enable: Whether to enable or disable the DSC
     556                 :            :  *
     557                 :            :  * Enable or disable Display Stream Compression on the peripheral using the
     558                 :            :  * default Picture Parameter Set and VESA DSC 1.1 algorithm.
     559                 :            :  *
     560                 :            :  * Return: 0 on success or a negative error code on failure.
     561                 :            :  */
     562                 :          0 : ssize_t mipi_dsi_compression_mode(struct mipi_dsi_device *dsi, bool enable)
     563                 :            : {
     564                 :            :         /* Note: Needs updating for non-default PPS or algorithm */
     565                 :          0 :         u8 tx[2] = { enable << 0, 0 };
     566                 :          0 :         struct mipi_dsi_msg msg = {
     567                 :          0 :                 .channel = dsi->channel,
     568                 :            :                 .type = MIPI_DSI_COMPRESSION_MODE,
     569                 :            :                 .tx_len = sizeof(tx),
     570                 :            :                 .tx_buf = tx,
     571                 :            :         };
     572                 :          0 :         int ret = mipi_dsi_device_transfer(dsi, &msg);
     573                 :            : 
     574                 :          0 :         return (ret < 0) ? ret : 0;
     575                 :            : }
     576                 :            : EXPORT_SYMBOL(mipi_dsi_compression_mode);
     577                 :            : 
     578                 :            : /**
     579                 :            :  * mipi_dsi_picture_parameter_set() - transmit the DSC PPS to the peripheral
     580                 :            :  * @dsi: DSI peripheral device
     581                 :            :  * @pps: VESA DSC 1.1 Picture Parameter Set
     582                 :            :  *
     583                 :            :  * Transmit the VESA DSC 1.1 Picture Parameter Set to the peripheral.
     584                 :            :  *
     585                 :            :  * Return: 0 on success or a negative error code on failure.
     586                 :            :  */
     587                 :          0 : ssize_t mipi_dsi_picture_parameter_set(struct mipi_dsi_device *dsi,
     588                 :            :                                        const struct drm_dsc_picture_parameter_set *pps)
     589                 :            : {
     590                 :          0 :         struct mipi_dsi_msg msg = {
     591                 :          0 :                 .channel = dsi->channel,
     592                 :            :                 .type = MIPI_DSI_PICTURE_PARAMETER_SET,
     593                 :            :                 .tx_len = sizeof(*pps),
     594                 :            :                 .tx_buf = pps,
     595                 :            :         };
     596                 :          0 :         int ret = mipi_dsi_device_transfer(dsi, &msg);
     597                 :            : 
     598                 :          0 :         return (ret < 0) ? ret : 0;
     599                 :            : }
     600                 :            : EXPORT_SYMBOL(mipi_dsi_picture_parameter_set);
     601                 :            : 
     602                 :            : /**
     603                 :            :  * mipi_dsi_generic_write() - transmit data using a generic write packet
     604                 :            :  * @dsi: DSI peripheral device
     605                 :            :  * @payload: buffer containing the payload
     606                 :            :  * @size: size of payload buffer
     607                 :            :  *
     608                 :            :  * This function will automatically choose the right data type depending on
     609                 :            :  * the payload length.
     610                 :            :  *
     611                 :            :  * Return: The number of bytes transmitted on success or a negative error code
     612                 :            :  * on failure.
     613                 :            :  */
     614                 :          0 : ssize_t mipi_dsi_generic_write(struct mipi_dsi_device *dsi, const void *payload,
     615                 :            :                                size_t size)
     616                 :            : {
     617                 :          0 :         struct mipi_dsi_msg msg = {
     618                 :          0 :                 .channel = dsi->channel,
     619                 :            :                 .tx_buf = payload,
     620                 :            :                 .tx_len = size
     621                 :            :         };
     622                 :            : 
     623   [ #  #  #  # ]:          0 :         switch (size) {
     624                 :          0 :         case 0:
     625                 :          0 :                 msg.type = MIPI_DSI_GENERIC_SHORT_WRITE_0_PARAM;
     626                 :          0 :                 break;
     627                 :            : 
     628                 :          0 :         case 1:
     629                 :          0 :                 msg.type = MIPI_DSI_GENERIC_SHORT_WRITE_1_PARAM;
     630                 :          0 :                 break;
     631                 :            : 
     632                 :          0 :         case 2:
     633                 :          0 :                 msg.type = MIPI_DSI_GENERIC_SHORT_WRITE_2_PARAM;
     634                 :          0 :                 break;
     635                 :            : 
     636                 :          0 :         default:
     637                 :          0 :                 msg.type = MIPI_DSI_GENERIC_LONG_WRITE;
     638                 :          0 :                 break;
     639                 :            :         }
     640                 :            : 
     641                 :          0 :         return mipi_dsi_device_transfer(dsi, &msg);
     642                 :            : }
     643                 :            : EXPORT_SYMBOL(mipi_dsi_generic_write);
     644                 :            : 
     645                 :            : /**
     646                 :            :  * mipi_dsi_generic_read() - receive data using a generic read packet
     647                 :            :  * @dsi: DSI peripheral device
     648                 :            :  * @params: buffer containing the request parameters
     649                 :            :  * @num_params: number of request parameters
     650                 :            :  * @data: buffer in which to return the received data
     651                 :            :  * @size: size of receive buffer
     652                 :            :  *
     653                 :            :  * This function will automatically choose the right data type depending on
     654                 :            :  * the number of parameters passed in.
     655                 :            :  *
     656                 :            :  * Return: The number of bytes successfully read or a negative error code on
     657                 :            :  * failure.
     658                 :            :  */
     659                 :          0 : ssize_t mipi_dsi_generic_read(struct mipi_dsi_device *dsi, const void *params,
     660                 :            :                               size_t num_params, void *data, size_t size)
     661                 :            : {
     662                 :          0 :         struct mipi_dsi_msg msg = {
     663                 :          0 :                 .channel = dsi->channel,
     664                 :            :                 .tx_len = num_params,
     665                 :            :                 .tx_buf = params,
     666                 :            :                 .rx_len = size,
     667                 :            :                 .rx_buf = data
     668                 :            :         };
     669                 :            : 
     670   [ #  #  #  # ]:          0 :         switch (num_params) {
     671                 :          0 :         case 0:
     672                 :          0 :                 msg.type = MIPI_DSI_GENERIC_READ_REQUEST_0_PARAM;
     673                 :          0 :                 break;
     674                 :            : 
     675                 :          0 :         case 1:
     676                 :          0 :                 msg.type = MIPI_DSI_GENERIC_READ_REQUEST_1_PARAM;
     677                 :          0 :                 break;
     678                 :            : 
     679                 :          0 :         case 2:
     680                 :          0 :                 msg.type = MIPI_DSI_GENERIC_READ_REQUEST_2_PARAM;
     681                 :          0 :                 break;
     682                 :            : 
     683                 :            :         default:
     684                 :            :                 return -EINVAL;
     685                 :            :         }
     686                 :            : 
     687                 :          0 :         return mipi_dsi_device_transfer(dsi, &msg);
     688                 :            : }
     689                 :            : EXPORT_SYMBOL(mipi_dsi_generic_read);
     690                 :            : 
     691                 :            : /**
     692                 :            :  * mipi_dsi_dcs_write_buffer() - transmit a DCS command with payload
     693                 :            :  * @dsi: DSI peripheral device
     694                 :            :  * @data: buffer containing data to be transmitted
     695                 :            :  * @len: size of transmission buffer
     696                 :            :  *
     697                 :            :  * This function will automatically choose the right data type depending on
     698                 :            :  * the command payload length.
     699                 :            :  *
     700                 :            :  * Return: The number of bytes successfully transmitted or a negative error
     701                 :            :  * code on failure.
     702                 :            :  */
     703                 :          0 : ssize_t mipi_dsi_dcs_write_buffer(struct mipi_dsi_device *dsi,
     704                 :            :                                   const void *data, size_t len)
     705                 :            : {
     706                 :          0 :         struct mipi_dsi_msg msg = {
     707                 :          0 :                 .channel = dsi->channel,
     708                 :            :                 .tx_buf = data,
     709                 :            :                 .tx_len = len
     710                 :            :         };
     711                 :            : 
     712   [ #  #  #  # ]:          0 :         switch (len) {
     713                 :            :         case 0:
     714                 :            :                 return -EINVAL;
     715                 :            : 
     716                 :          0 :         case 1:
     717                 :          0 :                 msg.type = MIPI_DSI_DCS_SHORT_WRITE;
     718                 :          0 :                 break;
     719                 :            : 
     720                 :          0 :         case 2:
     721                 :          0 :                 msg.type = MIPI_DSI_DCS_SHORT_WRITE_PARAM;
     722                 :          0 :                 break;
     723                 :            : 
     724                 :          0 :         default:
     725                 :          0 :                 msg.type = MIPI_DSI_DCS_LONG_WRITE;
     726                 :          0 :                 break;
     727                 :            :         }
     728                 :            : 
     729                 :          0 :         return mipi_dsi_device_transfer(dsi, &msg);
     730                 :            : }
     731                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_write_buffer);
     732                 :            : 
     733                 :            : /**
     734                 :            :  * mipi_dsi_dcs_write() - send DCS write command
     735                 :            :  * @dsi: DSI peripheral device
     736                 :            :  * @cmd: DCS command
     737                 :            :  * @data: buffer containing the command payload
     738                 :            :  * @len: command payload length
     739                 :            :  *
     740                 :            :  * This function will automatically choose the right data type depending on
     741                 :            :  * the command payload length.
     742                 :            :  *
     743                 :            :  * Return: The number of bytes successfully transmitted or a negative error
     744                 :            :  * code on failure.
     745                 :            :  */
     746                 :          0 : ssize_t mipi_dsi_dcs_write(struct mipi_dsi_device *dsi, u8 cmd,
     747                 :            :                            const void *data, size_t len)
     748                 :            : {
     749                 :          0 :         ssize_t err;
     750                 :          0 :         size_t size;
     751                 :          0 :         u8 *tx;
     752                 :            : 
     753         [ #  # ]:          0 :         if (len > 0) {
     754                 :          0 :                 size = 1 + len;
     755                 :            : 
     756         [ #  # ]:          0 :                 tx = kmalloc(size, GFP_KERNEL);
     757         [ #  # ]:          0 :                 if (!tx)
     758                 :            :                         return -ENOMEM;
     759                 :            : 
     760                 :            :                 /* concatenate the DCS command byte and the payload */
     761                 :          0 :                 tx[0] = cmd;
     762                 :          0 :                 memcpy(&tx[1], data, len);
     763                 :            :         } else {
     764                 :            :                 tx = &cmd;
     765                 :            :                 size = 1;
     766                 :            :         }
     767                 :            : 
     768                 :          0 :         err = mipi_dsi_dcs_write_buffer(dsi, tx, size);
     769                 :            : 
     770         [ #  # ]:          0 :         if (len > 0)
     771                 :          0 :                 kfree(tx);
     772                 :            : 
     773                 :            :         return err;
     774                 :            : }
     775                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_write);
     776                 :            : 
     777                 :            : /**
     778                 :            :  * mipi_dsi_dcs_read() - send DCS read request command
     779                 :            :  * @dsi: DSI peripheral device
     780                 :            :  * @cmd: DCS command
     781                 :            :  * @data: buffer in which to receive data
     782                 :            :  * @len: size of receive buffer
     783                 :            :  *
     784                 :            :  * Return: The number of bytes read or a negative error code on failure.
     785                 :            :  */
     786                 :          0 : ssize_t mipi_dsi_dcs_read(struct mipi_dsi_device *dsi, u8 cmd, void *data,
     787                 :            :                           size_t len)
     788                 :            : {
     789                 :          0 :         struct mipi_dsi_msg msg = {
     790                 :          0 :                 .channel = dsi->channel,
     791                 :            :                 .type = MIPI_DSI_DCS_READ,
     792                 :            :                 .tx_buf = &cmd,
     793                 :            :                 .tx_len = 1,
     794                 :            :                 .rx_buf = data,
     795                 :            :                 .rx_len = len
     796                 :            :         };
     797                 :            : 
     798                 :          0 :         return mipi_dsi_device_transfer(dsi, &msg);
     799                 :            : }
     800                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_read);
     801                 :            : 
     802                 :            : /**
     803                 :            :  * mipi_dsi_dcs_nop() - send DCS nop packet
     804                 :            :  * @dsi: DSI peripheral device
     805                 :            :  *
     806                 :            :  * Return: 0 on success or a negative error code on failure.
     807                 :            :  */
     808                 :          0 : int mipi_dsi_dcs_nop(struct mipi_dsi_device *dsi)
     809                 :            : {
     810                 :          0 :         ssize_t err;
     811                 :            : 
     812                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_NOP, NULL, 0);
     813                 :          0 :         if (err < 0)
     814                 :            :                 return err;
     815                 :            : 
     816                 :            :         return 0;
     817                 :            : }
     818                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_nop);
     819                 :            : 
     820                 :            : /**
     821                 :            :  * mipi_dsi_dcs_soft_reset() - perform a software reset of the display module
     822                 :            :  * @dsi: DSI peripheral device
     823                 :            :  *
     824                 :            :  * Return: 0 on success or a negative error code on failure.
     825                 :            :  */
     826                 :          0 : int mipi_dsi_dcs_soft_reset(struct mipi_dsi_device *dsi)
     827                 :            : {
     828                 :          0 :         ssize_t err;
     829                 :            : 
     830                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SOFT_RESET, NULL, 0);
     831                 :          0 :         if (err < 0)
     832                 :            :                 return err;
     833                 :            : 
     834                 :            :         return 0;
     835                 :            : }
     836                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_soft_reset);
     837                 :            : 
     838                 :            : /**
     839                 :            :  * mipi_dsi_dcs_get_power_mode() - query the display module's current power
     840                 :            :  *    mode
     841                 :            :  * @dsi: DSI peripheral device
     842                 :            :  * @mode: return location for the current power mode
     843                 :            :  *
     844                 :            :  * Return: 0 on success or a negative error code on failure.
     845                 :            :  */
     846                 :          0 : int mipi_dsi_dcs_get_power_mode(struct mipi_dsi_device *dsi, u8 *mode)
     847                 :            : {
     848                 :          0 :         ssize_t err;
     849                 :            : 
     850                 :          0 :         err = mipi_dsi_dcs_read(dsi, MIPI_DCS_GET_POWER_MODE, mode,
     851                 :            :                                 sizeof(*mode));
     852         [ #  # ]:          0 :         if (err <= 0) {
     853         [ #  # ]:          0 :                 if (err == 0)
     854                 :          0 :                         err = -ENODATA;
     855                 :            : 
     856                 :          0 :                 return err;
     857                 :            :         }
     858                 :            : 
     859                 :            :         return 0;
     860                 :            : }
     861                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_get_power_mode);
     862                 :            : 
     863                 :            : /**
     864                 :            :  * mipi_dsi_dcs_get_pixel_format() - gets the pixel format for the RGB image
     865                 :            :  *    data used by the interface
     866                 :            :  * @dsi: DSI peripheral device
     867                 :            :  * @format: return location for the pixel format
     868                 :            :  *
     869                 :            :  * Return: 0 on success or a negative error code on failure.
     870                 :            :  */
     871                 :          0 : int mipi_dsi_dcs_get_pixel_format(struct mipi_dsi_device *dsi, u8 *format)
     872                 :            : {
     873                 :          0 :         ssize_t err;
     874                 :            : 
     875                 :          0 :         err = mipi_dsi_dcs_read(dsi, MIPI_DCS_GET_PIXEL_FORMAT, format,
     876                 :            :                                 sizeof(*format));
     877         [ #  # ]:          0 :         if (err <= 0) {
     878         [ #  # ]:          0 :                 if (err == 0)
     879                 :          0 :                         err = -ENODATA;
     880                 :            : 
     881                 :          0 :                 return err;
     882                 :            :         }
     883                 :            : 
     884                 :            :         return 0;
     885                 :            : }
     886                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_get_pixel_format);
     887                 :            : 
     888                 :            : /**
     889                 :            :  * mipi_dsi_dcs_enter_sleep_mode() - disable all unnecessary blocks inside the
     890                 :            :  *    display module except interface communication
     891                 :            :  * @dsi: DSI peripheral device
     892                 :            :  *
     893                 :            :  * Return: 0 on success or a negative error code on failure.
     894                 :            :  */
     895                 :          0 : int mipi_dsi_dcs_enter_sleep_mode(struct mipi_dsi_device *dsi)
     896                 :            : {
     897                 :          0 :         ssize_t err;
     898                 :            : 
     899                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_ENTER_SLEEP_MODE, NULL, 0);
     900                 :          0 :         if (err < 0)
     901                 :            :                 return err;
     902                 :            : 
     903                 :            :         return 0;
     904                 :            : }
     905                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_enter_sleep_mode);
     906                 :            : 
     907                 :            : /**
     908                 :            :  * mipi_dsi_dcs_exit_sleep_mode() - enable all blocks inside the display
     909                 :            :  *    module
     910                 :            :  * @dsi: DSI peripheral device
     911                 :            :  *
     912                 :            :  * Return: 0 on success or a negative error code on failure.
     913                 :            :  */
     914                 :          0 : int mipi_dsi_dcs_exit_sleep_mode(struct mipi_dsi_device *dsi)
     915                 :            : {
     916                 :          0 :         ssize_t err;
     917                 :            : 
     918                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_EXIT_SLEEP_MODE, NULL, 0);
     919                 :          0 :         if (err < 0)
     920                 :            :                 return err;
     921                 :            : 
     922                 :            :         return 0;
     923                 :            : }
     924                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_exit_sleep_mode);
     925                 :            : 
     926                 :            : /**
     927                 :            :  * mipi_dsi_dcs_set_display_off() - stop displaying the image data on the
     928                 :            :  *    display device
     929                 :            :  * @dsi: DSI peripheral device
     930                 :            :  *
     931                 :            :  * Return: 0 on success or a negative error code on failure.
     932                 :            :  */
     933                 :          0 : int mipi_dsi_dcs_set_display_off(struct mipi_dsi_device *dsi)
     934                 :            : {
     935                 :          0 :         ssize_t err;
     936                 :            : 
     937                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_DISPLAY_OFF, NULL, 0);
     938                 :          0 :         if (err < 0)
     939                 :            :                 return err;
     940                 :            : 
     941                 :            :         return 0;
     942                 :            : }
     943                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_display_off);
     944                 :            : 
     945                 :            : /**
     946                 :            :  * mipi_dsi_dcs_set_display_on() - start displaying the image data on the
     947                 :            :  *    display device
     948                 :            :  * @dsi: DSI peripheral device
     949                 :            :  *
     950                 :            :  * Return: 0 on success or a negative error code on failure
     951                 :            :  */
     952                 :          0 : int mipi_dsi_dcs_set_display_on(struct mipi_dsi_device *dsi)
     953                 :            : {
     954                 :          0 :         ssize_t err;
     955                 :            : 
     956                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_DISPLAY_ON, NULL, 0);
     957                 :          0 :         if (err < 0)
     958                 :            :                 return err;
     959                 :            : 
     960                 :            :         return 0;
     961                 :            : }
     962                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_display_on);
     963                 :            : 
     964                 :            : /**
     965                 :            :  * mipi_dsi_dcs_set_column_address() - define the column extent of the frame
     966                 :            :  *    memory accessed by the host processor
     967                 :            :  * @dsi: DSI peripheral device
     968                 :            :  * @start: first column of frame memory
     969                 :            :  * @end: last column of frame memory
     970                 :            :  *
     971                 :            :  * Return: 0 on success or a negative error code on failure.
     972                 :            :  */
     973                 :          0 : int mipi_dsi_dcs_set_column_address(struct mipi_dsi_device *dsi, u16 start,
     974                 :            :                                     u16 end)
     975                 :            : {
     976                 :          0 :         u8 payload[4] = { start >> 8, start & 0xff, end >> 8, end & 0xff };
     977                 :          0 :         ssize_t err;
     978                 :            : 
     979                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_COLUMN_ADDRESS, payload,
     980                 :            :                                  sizeof(payload));
     981                 :          0 :         if (err < 0)
     982                 :            :                 return err;
     983                 :            : 
     984                 :            :         return 0;
     985                 :            : }
     986                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_column_address);
     987                 :            : 
     988                 :            : /**
     989                 :            :  * mipi_dsi_dcs_set_page_address() - define the page extent of the frame
     990                 :            :  *    memory accessed by the host processor
     991                 :            :  * @dsi: DSI peripheral device
     992                 :            :  * @start: first page of frame memory
     993                 :            :  * @end: last page of frame memory
     994                 :            :  *
     995                 :            :  * Return: 0 on success or a negative error code on failure.
     996                 :            :  */
     997                 :          0 : int mipi_dsi_dcs_set_page_address(struct mipi_dsi_device *dsi, u16 start,
     998                 :            :                                   u16 end)
     999                 :            : {
    1000                 :          0 :         u8 payload[4] = { start >> 8, start & 0xff, end >> 8, end & 0xff };
    1001                 :          0 :         ssize_t err;
    1002                 :            : 
    1003                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_PAGE_ADDRESS, payload,
    1004                 :            :                                  sizeof(payload));
    1005                 :          0 :         if (err < 0)
    1006                 :            :                 return err;
    1007                 :            : 
    1008                 :            :         return 0;
    1009                 :            : }
    1010                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_page_address);
    1011                 :            : 
    1012                 :            : /**
    1013                 :            :  * mipi_dsi_dcs_set_tear_off() - turn off the display module's Tearing Effect
    1014                 :            :  *    output signal on the TE signal line
    1015                 :            :  * @dsi: DSI peripheral device
    1016                 :            :  *
    1017                 :            :  * Return: 0 on success or a negative error code on failure
    1018                 :            :  */
    1019                 :          0 : int mipi_dsi_dcs_set_tear_off(struct mipi_dsi_device *dsi)
    1020                 :            : {
    1021                 :          0 :         ssize_t err;
    1022                 :            : 
    1023                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_TEAR_OFF, NULL, 0);
    1024                 :          0 :         if (err < 0)
    1025                 :            :                 return err;
    1026                 :            : 
    1027                 :            :         return 0;
    1028                 :            : }
    1029                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_tear_off);
    1030                 :            : 
    1031                 :            : /**
    1032                 :            :  * mipi_dsi_dcs_set_tear_on() - turn on the display module's Tearing Effect
    1033                 :            :  *    output signal on the TE signal line.
    1034                 :            :  * @dsi: DSI peripheral device
    1035                 :            :  * @mode: the Tearing Effect Output Line mode
    1036                 :            :  *
    1037                 :            :  * Return: 0 on success or a negative error code on failure
    1038                 :            :  */
    1039                 :          0 : int mipi_dsi_dcs_set_tear_on(struct mipi_dsi_device *dsi,
    1040                 :            :                              enum mipi_dsi_dcs_tear_mode mode)
    1041                 :            : {
    1042                 :          0 :         u8 value = mode;
    1043                 :          0 :         ssize_t err;
    1044                 :            : 
    1045                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_TEAR_ON, &value,
    1046                 :            :                                  sizeof(value));
    1047                 :          0 :         if (err < 0)
    1048                 :            :                 return err;
    1049                 :            : 
    1050                 :            :         return 0;
    1051                 :            : }
    1052                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_tear_on);
    1053                 :            : 
    1054                 :            : /**
    1055                 :            :  * mipi_dsi_dcs_set_pixel_format() - sets the pixel format for the RGB image
    1056                 :            :  *    data used by the interface
    1057                 :            :  * @dsi: DSI peripheral device
    1058                 :            :  * @format: pixel format
    1059                 :            :  *
    1060                 :            :  * Return: 0 on success or a negative error code on failure.
    1061                 :            :  */
    1062                 :          0 : int mipi_dsi_dcs_set_pixel_format(struct mipi_dsi_device *dsi, u8 format)
    1063                 :            : {
    1064                 :          0 :         ssize_t err;
    1065                 :            : 
    1066                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_PIXEL_FORMAT, &format,
    1067                 :            :                                  sizeof(format));
    1068                 :          0 :         if (err < 0)
    1069                 :            :                 return err;
    1070                 :            : 
    1071                 :            :         return 0;
    1072                 :            : }
    1073                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_pixel_format);
    1074                 :            : 
    1075                 :            : /**
    1076                 :            :  * mipi_dsi_dcs_set_tear_scanline() - set the scanline to use as trigger for
    1077                 :            :  *    the Tearing Effect output signal of the display module
    1078                 :            :  * @dsi: DSI peripheral device
    1079                 :            :  * @scanline: scanline to use as trigger
    1080                 :            :  *
    1081                 :            :  * Return: 0 on success or a negative error code on failure
    1082                 :            :  */
    1083                 :          0 : int mipi_dsi_dcs_set_tear_scanline(struct mipi_dsi_device *dsi, u16 scanline)
    1084                 :            : {
    1085                 :          0 :         u8 payload[3] = { MIPI_DCS_SET_TEAR_SCANLINE, scanline >> 8,
    1086                 :            :                           scanline & 0xff };
    1087                 :          0 :         ssize_t err;
    1088                 :            : 
    1089                 :          0 :         err = mipi_dsi_generic_write(dsi, payload, sizeof(payload));
    1090                 :          0 :         if (err < 0)
    1091                 :            :                 return err;
    1092                 :            : 
    1093                 :            :         return 0;
    1094                 :            : }
    1095                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_tear_scanline);
    1096                 :            : 
    1097                 :            : /**
    1098                 :            :  * mipi_dsi_dcs_set_display_brightness() - sets the brightness value of the
    1099                 :            :  *    display
    1100                 :            :  * @dsi: DSI peripheral device
    1101                 :            :  * @brightness: brightness value
    1102                 :            :  *
    1103                 :            :  * Return: 0 on success or a negative error code on failure.
    1104                 :            :  */
    1105                 :          0 : int mipi_dsi_dcs_set_display_brightness(struct mipi_dsi_device *dsi,
    1106                 :            :                                         u16 brightness)
    1107                 :            : {
    1108                 :          0 :         u8 payload[2] = { brightness & 0xff, brightness >> 8 };
    1109                 :          0 :         ssize_t err;
    1110                 :            : 
    1111                 :          0 :         err = mipi_dsi_dcs_write(dsi, MIPI_DCS_SET_DISPLAY_BRIGHTNESS,
    1112                 :            :                                  payload, sizeof(payload));
    1113                 :          0 :         if (err < 0)
    1114                 :            :                 return err;
    1115                 :            : 
    1116                 :            :         return 0;
    1117                 :            : }
    1118                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_set_display_brightness);
    1119                 :            : 
    1120                 :            : /**
    1121                 :            :  * mipi_dsi_dcs_get_display_brightness() - gets the current brightness value
    1122                 :            :  *    of the display
    1123                 :            :  * @dsi: DSI peripheral device
    1124                 :            :  * @brightness: brightness value
    1125                 :            :  *
    1126                 :            :  * Return: 0 on success or a negative error code on failure.
    1127                 :            :  */
    1128                 :          0 : int mipi_dsi_dcs_get_display_brightness(struct mipi_dsi_device *dsi,
    1129                 :            :                                         u16 *brightness)
    1130                 :            : {
    1131                 :          0 :         ssize_t err;
    1132                 :            : 
    1133                 :          0 :         err = mipi_dsi_dcs_read(dsi, MIPI_DCS_GET_DISPLAY_BRIGHTNESS,
    1134                 :            :                                 brightness, sizeof(*brightness));
    1135         [ #  # ]:          0 :         if (err <= 0) {
    1136         [ #  # ]:          0 :                 if (err == 0)
    1137                 :          0 :                         err = -ENODATA;
    1138                 :            : 
    1139                 :          0 :                 return err;
    1140                 :            :         }
    1141                 :            : 
    1142                 :            :         return 0;
    1143                 :            : }
    1144                 :            : EXPORT_SYMBOL(mipi_dsi_dcs_get_display_brightness);
    1145                 :            : 
    1146                 :          0 : static int mipi_dsi_drv_probe(struct device *dev)
    1147                 :            : {
    1148                 :          0 :         struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);
    1149                 :          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
    1150                 :            : 
    1151                 :          0 :         return drv->probe(dsi);
    1152                 :            : }
    1153                 :            : 
    1154                 :          0 : static int mipi_dsi_drv_remove(struct device *dev)
    1155                 :            : {
    1156                 :          0 :         struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);
    1157                 :          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
    1158                 :            : 
    1159                 :          0 :         return drv->remove(dsi);
    1160                 :            : }
    1161                 :            : 
    1162                 :          0 : static void mipi_dsi_drv_shutdown(struct device *dev)
    1163                 :            : {
    1164                 :          0 :         struct mipi_dsi_driver *drv = to_mipi_dsi_driver(dev->driver);
    1165                 :          0 :         struct mipi_dsi_device *dsi = to_mipi_dsi_device(dev);
    1166                 :            : 
    1167                 :          0 :         drv->shutdown(dsi);
    1168                 :          0 : }
    1169                 :            : 
    1170                 :            : /**
    1171                 :            :  * mipi_dsi_driver_register_full() - register a driver for DSI devices
    1172                 :            :  * @drv: DSI driver structure
    1173                 :            :  * @owner: owner module
    1174                 :            :  *
    1175                 :            :  * Return: 0 on success or a negative error code on failure.
    1176                 :            :  */
    1177                 :          0 : int mipi_dsi_driver_register_full(struct mipi_dsi_driver *drv,
    1178                 :            :                                   struct module *owner)
    1179                 :            : {
    1180                 :          0 :         drv->driver.bus = &mipi_dsi_bus_type;
    1181                 :          0 :         drv->driver.owner = owner;
    1182                 :            : 
    1183         [ #  # ]:          0 :         if (drv->probe)
    1184                 :          0 :                 drv->driver.probe = mipi_dsi_drv_probe;
    1185         [ #  # ]:          0 :         if (drv->remove)
    1186                 :          0 :                 drv->driver.remove = mipi_dsi_drv_remove;
    1187         [ #  # ]:          0 :         if (drv->shutdown)
    1188                 :          0 :                 drv->driver.shutdown = mipi_dsi_drv_shutdown;
    1189                 :            : 
    1190                 :          0 :         return driver_register(&drv->driver);
    1191                 :            : }
    1192                 :            : EXPORT_SYMBOL(mipi_dsi_driver_register_full);
    1193                 :            : 
    1194                 :            : /**
    1195                 :            :  * mipi_dsi_driver_unregister() - unregister a driver for DSI devices
    1196                 :            :  * @drv: DSI driver structure
    1197                 :            :  *
    1198                 :            :  * Return: 0 on success or a negative error code on failure.
    1199                 :            :  */
    1200                 :          0 : void mipi_dsi_driver_unregister(struct mipi_dsi_driver *drv)
    1201                 :            : {
    1202                 :          0 :         driver_unregister(&drv->driver);
    1203                 :          0 : }
    1204                 :            : EXPORT_SYMBOL(mipi_dsi_driver_unregister);
    1205                 :            : 
    1206                 :         28 : static int __init mipi_dsi_bus_init(void)
    1207                 :            : {
    1208                 :         28 :         return bus_register(&mipi_dsi_bus_type);
    1209                 :            : }
    1210                 :            : postcore_initcall(mipi_dsi_bus_init);
    1211                 :            : 
    1212                 :            : MODULE_AUTHOR("Andrzej Hajda <a.hajda@samsung.com>");
    1213                 :            : MODULE_DESCRIPTION("MIPI DSI Bus");
    1214                 :            : MODULE_LICENSE("GPL and additional rights");

Generated by: LCOV version 1.14