sigmadsp.c 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  1. /*
  2. * Load Analog Devices SigmaStudio firmware files
  3. *
  4. * Copyright 2009-2011 Analog Devices Inc.
  5. *
  6. * Licensed under the GPL-2 or later.
  7. */
  8. #include <linux/crc32.h>
  9. #include <linux/delay.h>
  10. #include <linux/firmware.h>
  11. #include <linux/kernel.h>
  12. #include <linux/i2c.h>
  13. #include <linux/regmap.h>
  14. #include <linux/module.h>
  15. #include "sigmadsp.h"
  16. #define SIGMA_MAGIC "ADISIGM"
  17. struct sigma_firmware_header {
  18. unsigned char magic[7];
  19. u8 version;
  20. __le32 crc;
  21. } __packed;
  22. enum {
  23. SIGMA_ACTION_WRITEXBYTES = 0,
  24. SIGMA_ACTION_WRITESINGLE,
  25. SIGMA_ACTION_WRITESAFELOAD,
  26. SIGMA_ACTION_DELAY,
  27. SIGMA_ACTION_PLLWAIT,
  28. SIGMA_ACTION_NOOP,
  29. SIGMA_ACTION_END,
  30. };
  31. static inline u32 sigma_action_len(struct sigma_action *sa)
  32. {
  33. return (sa->len_hi << 16) | le16_to_cpu(sa->len);
  34. }
  35. static size_t sigma_action_size(struct sigma_action *sa)
  36. {
  37. size_t payload = 0;
  38. switch (sa->instr) {
  39. case SIGMA_ACTION_WRITEXBYTES:
  40. case SIGMA_ACTION_WRITESINGLE:
  41. case SIGMA_ACTION_WRITESAFELOAD:
  42. payload = sigma_action_len(sa);
  43. break;
  44. default:
  45. break;
  46. }
  47. payload = ALIGN(payload, 2);
  48. return payload + sizeof(struct sigma_action);
  49. }
  50. /*
  51. * Returns a negative error value in case of an error, 0 if processing of
  52. * the firmware should be stopped after this action, 1 otherwise.
  53. */
  54. static int
  55. process_sigma_action(struct sigma_firmware *ssfw, struct sigma_action *sa)
  56. {
  57. size_t len = sigma_action_len(sa);
  58. int ret;
  59. pr_debug("%s: instr:%i addr:%#x len:%zu\n", __func__,
  60. sa->instr, sa->addr, len);
  61. switch (sa->instr) {
  62. case SIGMA_ACTION_WRITEXBYTES:
  63. case SIGMA_ACTION_WRITESINGLE:
  64. case SIGMA_ACTION_WRITESAFELOAD:
  65. ret = ssfw->write(ssfw->control_data, sa, len);
  66. if (ret < 0)
  67. return -EINVAL;
  68. break;
  69. case SIGMA_ACTION_DELAY:
  70. udelay(len);
  71. len = 0;
  72. break;
  73. case SIGMA_ACTION_END:
  74. return 0;
  75. default:
  76. return -EINVAL;
  77. }
  78. return 1;
  79. }
  80. static int
  81. process_sigma_actions(struct sigma_firmware *ssfw)
  82. {
  83. struct sigma_action *sa;
  84. size_t size;
  85. int ret;
  86. while (ssfw->pos + sizeof(*sa) <= ssfw->fw->size) {
  87. sa = (struct sigma_action *)(ssfw->fw->data + ssfw->pos);
  88. size = sigma_action_size(sa);
  89. ssfw->pos += size;
  90. if (ssfw->pos > ssfw->fw->size || size == 0)
  91. break;
  92. ret = process_sigma_action(ssfw, sa);
  93. pr_debug("%s: action returned %i\n", __func__, ret);
  94. if (ret <= 0)
  95. return ret;
  96. }
  97. if (ssfw->pos != ssfw->fw->size)
  98. return -EINVAL;
  99. return 0;
  100. }
  101. int _process_sigma_firmware(struct device *dev,
  102. struct sigma_firmware *ssfw, const char *name)
  103. {
  104. int ret;
  105. struct sigma_firmware_header *ssfw_head;
  106. const struct firmware *fw;
  107. u32 crc;
  108. pr_debug("%s: loading firmware %s\n", __func__, name);
  109. /* first load the blob */
  110. ret = request_firmware(&fw, name, dev);
  111. if (ret) {
  112. pr_debug("%s: request_firmware() failed with %i\n", __func__, ret);
  113. return ret;
  114. }
  115. ssfw->fw = fw;
  116. /* then verify the header */
  117. ret = -EINVAL;
  118. /*
  119. * Reject too small or unreasonable large files. The upper limit has been
  120. * chosen a bit arbitrarily, but it should be enough for all practical
  121. * purposes and having the limit makes it easier to avoid integer
  122. * overflows later in the loading process.
  123. */
  124. if (fw->size < sizeof(*ssfw_head) || fw->size >= 0x4000000) {
  125. dev_err(dev, "Failed to load firmware: Invalid size\n");
  126. goto done;
  127. }
  128. ssfw_head = (void *)fw->data;
  129. if (memcmp(ssfw_head->magic, SIGMA_MAGIC, ARRAY_SIZE(ssfw_head->magic))) {
  130. dev_err(dev, "Failed to load firmware: Invalid magic\n");
  131. goto done;
  132. }
  133. if (ssfw_head->version != 1) {
  134. dev_err(dev,
  135. "Failed to load firmware: Invalid version %d. Supported firmware versions: 1\n",
  136. ssfw_head->version);
  137. goto done;
  138. }
  139. crc = crc32(0, fw->data + sizeof(*ssfw_head),
  140. fw->size - sizeof(*ssfw_head));
  141. pr_debug("%s: crc=%x\n", __func__, crc);
  142. if (crc != le32_to_cpu(ssfw_head->crc)) {
  143. dev_err(dev, "Failed to load firmware: Wrong crc checksum: expected %x got %x\n",
  144. le32_to_cpu(ssfw_head->crc), crc);
  145. goto done;
  146. }
  147. ssfw->pos = sizeof(*ssfw_head);
  148. /* finally process all of the actions */
  149. ret = process_sigma_actions(ssfw);
  150. done:
  151. release_firmware(fw);
  152. pr_debug("%s: loaded %s\n", __func__, name);
  153. return ret;
  154. }
  155. EXPORT_SYMBOL_GPL(_process_sigma_firmware);
  156. MODULE_LICENSE("GPL");