drivers/soc/qcom/wcnss_ctrl.c

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  * Copyright (c) 2016, Linaro Ltd.
   4  * Copyright (c) 2015, Sony Mobile Communications Inc.
   5  */
   6 #include <linux/firmware.h>
   7 #include <linux/module.h>
   8 #include <linux/slab.h>
   9 #include <linux/io.h>
  10 #include <linux/of_platform.h>
  11 #include <linux/platform_device.h>
  12 #include <linux/rpmsg.h>
  13 #include <linux/soc/qcom/wcnss_ctrl.h>
  14
  15 #define WCNSS_REQUEST_TIMEOUT   (5 * HZ)
  16 #define WCNSS_CBC_TIMEOUT       (10 * HZ)
  17
  18 #define WCNSS_ACK_DONE_BOOTING  1
  19 #define WCNSS_ACK_COLD_BOOTING  2
  20
  21 #define NV_FRAGMENT_SIZE        3072
  22 #define NVBIN_FILE              "wlan/prima/WCNSS_qcom_wlan_nv.bin"
  23
  24 /**
  25  * struct wcnss_ctrl - driver context
  26  * @dev:        device handle
  27  * @channel:    SMD channel handle
  28  * @ack:        completion for outstanding requests
  29  * @cbc:        completion for cbc complete indication
  30  * @ack_status: status of the outstanding request
  31  * @probe_work: worker for uploading nv binary
  32  */
  33 struct wcnss_ctrl {
  34         struct device *dev;
  35         struct rpmsg_endpoint *channel;
  36
  37         struct completion ack;
  38         struct completion cbc;
  39         int ack_status;
  40
  41         struct work_struct probe_work;
  42 };
  43
  44 /* message types */
  45 enum {
  46         WCNSS_VERSION_REQ = 0x01000000,
  47         WCNSS_VERSION_RESP,
  48         WCNSS_DOWNLOAD_NV_REQ,
  49         WCNSS_DOWNLOAD_NV_RESP,
  50         WCNSS_UPLOAD_CAL_REQ,
  51         WCNSS_UPLOAD_CAL_RESP,
  52         WCNSS_DOWNLOAD_CAL_REQ,
  53         WCNSS_DOWNLOAD_CAL_RESP,
  54         WCNSS_VBAT_LEVEL_IND,
  55         WCNSS_BUILD_VERSION_REQ,
  56         WCNSS_BUILD_VERSION_RESP,
  57         WCNSS_PM_CONFIG_REQ,
  58         WCNSS_CBC_COMPLETE_IND,
  59 };
  60
  61 /**
  62  * struct wcnss_msg_hdr - common packet header for requests and responses
  63  * @type:       packet message type
  64  * @len:        total length of the packet, including this header
  65  */
  66 struct wcnss_msg_hdr {
  67         u32 type;
  68         u32 len;
  69 } __packed;
  70
  71 /*
  72  * struct wcnss_version_resp - version request response
  73  */
  74 struct wcnss_version_resp {
  75         struct wcnss_msg_hdr hdr;
  76         u8 major;
  77         u8 minor;
  78         u8 version;
  79         u8 revision;
  80 } __packed;
  81
  82 /**
  83  * struct wcnss_download_nv_req - firmware fragment request
  84  * @hdr:        common packet wcnss_msg_hdr header
  85  * @seq:        sequence number of this fragment
  86  * @last:       boolean indicator of this being the last fragment of the binary
  87  * @frag_size:  length of this fragment
  88  * @fragment:   fragment data
  89  */
  90 struct wcnss_download_nv_req {
  91         struct wcnss_msg_hdr hdr;
  92         u16 seq;
  93         u16 last;
  94         u32 frag_size;
  95         u8 fragment[];
  96 } __packed;
  97
  98 /**
  99  * struct wcnss_download_nv_resp - firmware download response
 100  * @hdr:        common packet wcnss_msg_hdr header
 101  * @status:     boolean to indicate success of the download
 102  */
 103 struct wcnss_download_nv_resp {
 104         struct wcnss_msg_hdr hdr;
 105         u8 status;
 106 } __packed;
 107
 108 /**
 109  * wcnss_ctrl_smd_callback() - handler from SMD responses
 110  * @rpdev:      remote processor message device pointer
 111  * @data:       pointer to the incoming data packet
 112  * @count:      size of the incoming data packet
 113  * @priv:       unused
 114  * @addr:       unused
 115  *
 116  * Handles any incoming packets from the remote WCNSS_CTRL service.
 117  */
 118 static int wcnss_ctrl_smd_callback(struct rpmsg_device *rpdev,
 119                                    void *data,
 120                                    int count,
 121                                    void *priv,
 122                                    u32 addr)
 123 {
 124         struct wcnss_ctrl *wcnss = dev_get_drvdata(&rpdev->dev);
 125         const struct wcnss_download_nv_resp *nvresp;
 126         const struct wcnss_version_resp *version;
 127         const struct wcnss_msg_hdr *hdr = data;
 128
 129         switch (hdr->type) {
 130         case WCNSS_VERSION_RESP:
 131                 if (count != sizeof(*version)) {
 132                         dev_err(wcnss->dev,
 133                                 "invalid size of version response\n");
 134                         break;
 135                 }
 136
 137                 version = data;
 138                 dev_info(wcnss->dev, "WCNSS Version %d.%d %d.%d\n",
 139                          version->major, version->minor,
 140                          version->version, version->revision);
 141
 142                 complete(&wcnss->ack);
 143                 break;
 144         case WCNSS_DOWNLOAD_NV_RESP:
 145                 if (count != sizeof(*nvresp)) {
 146                         dev_err(wcnss->dev,
 147                                 "invalid size of download response\n");
 148                         break;
 149                 }
 150
 151                 nvresp = data;
 152                 wcnss->ack_status = nvresp->status;
 153                 complete(&wcnss->ack);
 154                 break;
 155         case WCNSS_CBC_COMPLETE_IND:
 156                 dev_dbg(wcnss->dev, "cold boot complete\n");
 157                 complete(&wcnss->cbc);
 158                 break;
 159         default:
 160                 dev_info(wcnss->dev, "unknown message type %d\n", hdr->type);
 161                 break;
 162         }
 163
 164         return 0;
 165 }
 166
 167 /**
 168  * wcnss_request_version() - send a version request to WCNSS
 169  * @wcnss:      wcnss ctrl driver context
 170  */
 171 static int wcnss_request_version(struct wcnss_ctrl *wcnss)
 172 {
 173         struct wcnss_msg_hdr msg;
 174         int ret;
 175
 176         msg.type = WCNSS_VERSION_REQ;
 177         msg.len = sizeof(msg);
 178         ret = rpmsg_send(wcnss->channel, &msg, sizeof(msg));
 179         if (ret < 0)
 180                 return ret;
 181
 182         ret = wait_for_completion_timeout(&wcnss->ack, WCNSS_CBC_TIMEOUT);
 183         if (!ret) {
 184                 dev_err(wcnss->dev, "timeout waiting for version response\n");
 185                 return -ETIMEDOUT;
 186         }
 187
 188         return 0;
 189 }
 190
 191 /**
 192  * wcnss_download_nv() - send nv binary to WCNSS
 193  * @wcnss:      wcnss_ctrl state handle
 194  * @expect_cbc: indicator to caller that an cbc event is expected
 195  *
 196  * Returns 0 on success. Negative errno on failure.
 197  */
 198 static int wcnss_download_nv(struct wcnss_ctrl *wcnss, bool *expect_cbc)
 199 {
 200         struct wcnss_download_nv_req *req;
 201         const struct firmware *fw;
 202         const void *data;
 203         ssize_t left;
 204         int ret;
 205
 206         req = kzalloc(sizeof(*req) + NV_FRAGMENT_SIZE, GFP_KERNEL);
 207         if (!req)
 208                 return -ENOMEM;
 209
 210         ret = request_firmware(&fw, NVBIN_FILE, wcnss->dev);
 211         if (ret < 0) {
 212                 dev_err(wcnss->dev, "Failed to load nv file %s: %d\n",
 213                         NVBIN_FILE, ret);
 214                 goto free_req;
 215         }
 216
 217         data = fw->data;
 218         left = fw->size;
 219
 220         req->hdr.type = WCNSS_DOWNLOAD_NV_REQ;
 221         req->hdr.len = sizeof(*req) + NV_FRAGMENT_SIZE;
 222
 223         req->last = 0;
 224         req->frag_size = NV_FRAGMENT_SIZE;
 225
 226         req->seq = 0;
 227         do {
 228                 if (left <= NV_FRAGMENT_SIZE) {
 229                         req->last = 1;
 230                         req->frag_size = left;
 231                         req->hdr.len = sizeof(*req) + left;
 232                 }
 233
 234                 memcpy(req->fragment, data, req->frag_size);
 235
 236                 ret = rpmsg_send(wcnss->channel, req, req->hdr.len);
 237                 if (ret < 0) {
 238                         dev_err(wcnss->dev, "failed to send smd packet\n");
 239                         goto release_fw;
 240                 }
 241
 242                 /* Increment for next fragment */
 243                 req->seq++;
 244
 245                 data += NV_FRAGMENT_SIZE;
 246                 left -= NV_FRAGMENT_SIZE;
 247         } while (left > 0);
 248
 249         ret = wait_for_completion_timeout(&wcnss->ack, WCNSS_REQUEST_TIMEOUT);
 250         if (!ret) {
 251                 dev_err(wcnss->dev, "timeout waiting for nv upload ack\n");
 252                 ret = -ETIMEDOUT;
 253         } else {
 254                 *expect_cbc = wcnss->ack_status == WCNSS_ACK_COLD_BOOTING;
 255                 ret = 0;
 256         }
 257
 258 release_fw:
 259         release_firmware(fw);
 260 free_req:
 261         kfree(req);
 262
 263         return ret;
 264 }
 265
 266 /**
 267  * qcom_wcnss_open_channel() - open additional SMD channel to WCNSS
 268  * @wcnss:      wcnss handle, retrieved from drvdata
 269  * @name:       SMD channel name
 270  * @cb:         callback to handle incoming data on the channel
 271  * @priv:       private data for use in the call-back
 272  */
 273 struct rpmsg_endpoint *qcom_wcnss_open_channel(void *wcnss, const char *name, rpmsg_rx_cb_t cb, void *priv)
 274 {
 275         struct rpmsg_channel_info chinfo;
 276         struct wcnss_ctrl *_wcnss = wcnss;
 277
 278         strscpy(chinfo.name, name, sizeof(chinfo.name));
 279         chinfo.src = RPMSG_ADDR_ANY;
 280         chinfo.dst = RPMSG_ADDR_ANY;
 281
 282         return rpmsg_create_ept(_wcnss->channel->rpdev, cb, priv, chinfo);
 283 }
 284 EXPORT_SYMBOL(qcom_wcnss_open_channel);
 285
 286 static void wcnss_async_probe(struct work_struct *work)
 287 {
 288         struct wcnss_ctrl *wcnss = container_of(work, struct wcnss_ctrl, probe_work);
 289         bool expect_cbc;
 290         int ret;
 291
 292         ret = wcnss_request_version(wcnss);
 293         if (ret < 0)
 294                 return;
 295
 296         ret = wcnss_download_nv(wcnss, &expect_cbc);
 297         if (ret < 0)
 298                 return;
 299
 300         /* Wait for pending cold boot completion if indicated by the nv downloader */
 301         if (expect_cbc) {
 302                 ret = wait_for_completion_timeout(&wcnss->cbc, WCNSS_REQUEST_TIMEOUT);
 303                 if (!ret)
 304                         dev_err(wcnss->dev, "expected cold boot completion\n");
 305         }
 306
 307         of_platform_populate(wcnss->dev->of_node, NULL, NULL, wcnss->dev);
 308 }
 309
 310 static int wcnss_ctrl_probe(struct rpmsg_device *rpdev)
 311 {
 312         struct wcnss_ctrl *wcnss;
 313
 314         wcnss = devm_kzalloc(&rpdev->dev, sizeof(*wcnss), GFP_KERNEL);
 315         if (!wcnss)
 316                 return -ENOMEM;
 317
 318         wcnss->dev = &rpdev->dev;
 319         wcnss->channel = rpdev->ept;
 320
 321         init_completion(&wcnss->ack);
 322         init_completion(&wcnss->cbc);
 323         INIT_WORK(&wcnss->probe_work, wcnss_async_probe);
 324
 325         dev_set_drvdata(&rpdev->dev, wcnss);
 326
 327         schedule_work(&wcnss->probe_work);
 328
 329         return 0;
 330 }
 331
 332 static void wcnss_ctrl_remove(struct rpmsg_device *rpdev)
 333 {
 334         struct wcnss_ctrl *wcnss = dev_get_drvdata(&rpdev->dev);
 335
 336         cancel_work_sync(&wcnss->probe_work);
 337         of_platform_depopulate(&rpdev->dev);
 338 }
 339
 340 static const struct of_device_id wcnss_ctrl_of_match[] = {
 341         { .compatible = "qcom,wcnss", },
 342         {}
 343 };
 344 MODULE_DEVICE_TABLE(of, wcnss_ctrl_of_match);
 345
 346 static struct rpmsg_driver wcnss_ctrl_driver = {
 347         .probe = wcnss_ctrl_probe,
 348         .remove = wcnss_ctrl_remove,
 349         .callback = wcnss_ctrl_smd_callback,
 350         .drv  = {
 351                 .name  = "qcom_wcnss_ctrl",
 352                 .owner = THIS_MODULE,
 353                 .of_match_table = wcnss_ctrl_of_match,
 354         },
 355 };
 356
 357 module_rpmsg_driver(wcnss_ctrl_driver);
 358
 359 MODULE_DESCRIPTION("Qualcomm WCNSS control driver");
 360 MODULE_LICENSE("GPL v2");