ssif_bmc.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * The driver for BMC side of SSIF interface
  4. *
  5. * Copyright (c) 2022, Ampere Computing LLC
  6. *
  7. */
  8. #include <linux/i2c.h>
  9. #include <linux/miscdevice.h>
  10. #include <linux/module.h>
  11. #include <linux/of.h>
  12. #include <linux/platform_device.h>
  13. #include <linux/poll.h>
  14. #include <linux/sched.h>
  15. #include <linux/mutex.h>
  16. #include <linux/spinlock.h>
  17. #include <linux/timer.h>
  18. #include <linux/jiffies.h>
  19. #include <linux/ipmi_ssif_bmc.h>
  20. #define DEVICE_NAME "ipmi-ssif-host"
  21. #define GET_8BIT_ADDR(addr_7bit) (((addr_7bit) << 1) & 0xff)
  22. /* A standard SMBus Transaction is limited to 32 data bytes */
  23. #define MAX_PAYLOAD_PER_TRANSACTION 32
  24. /* Transaction includes the address, the command, the length and the PEC byte */
  25. #define MAX_TRANSACTION (MAX_PAYLOAD_PER_TRANSACTION + 4)
  26. #define MAX_IPMI_DATA_PER_START_TRANSACTION 30
  27. #define MAX_IPMI_DATA_PER_MIDDLE_TRANSACTION 31
  28. #define SSIF_IPMI_SINGLEPART_WRITE 0x2
  29. #define SSIF_IPMI_SINGLEPART_READ 0x3
  30. #define SSIF_IPMI_MULTIPART_WRITE_START 0x6
  31. #define SSIF_IPMI_MULTIPART_WRITE_MIDDLE 0x7
  32. #define SSIF_IPMI_MULTIPART_WRITE_END 0x8
  33. #define SSIF_IPMI_MULTIPART_READ_START 0x3
  34. #define SSIF_IPMI_MULTIPART_READ_MIDDLE 0x9
  35. /*
  36. * IPMI 2.0 Spec, section 12.7 SSIF Timing,
  37. * Request-to-Response Time is T6max(250ms) - T1max(20ms) - 3ms = 227ms
  38. * Recover ssif_bmc from busy state if it takes up to 500ms
  39. */
  40. #define RESPONSE_TIMEOUT 500 /* ms */
  41. struct ssif_part_buffer {
  42. u8 address;
  43. u8 smbus_cmd;
  44. u8 length;
  45. u8 payload[MAX_PAYLOAD_PER_TRANSACTION];
  46. u8 pec;
  47. u8 index;
  48. };
  49. /*
  50. * SSIF internal states:
  51. * SSIF_READY 0x00 : Ready state
  52. * SSIF_START 0x01 : Start smbus transaction
  53. * SSIF_SMBUS_CMD 0x02 : Received SMBus command
  54. * SSIF_REQ_RECVING 0x03 : Receiving request
  55. * SSIF_RES_SENDING 0x04 : Sending response
  56. * SSIF_ABORTING 0x05 : Aborting state
  57. */
  58. enum ssif_state {
  59. SSIF_READY,
  60. SSIF_START,
  61. SSIF_SMBUS_CMD,
  62. SSIF_REQ_RECVING,
  63. SSIF_RES_SENDING,
  64. SSIF_ABORTING,
  65. SSIF_STATE_MAX
  66. };
  67. struct ssif_bmc_ctx {
  68. struct i2c_client *client;
  69. struct miscdevice miscdev;
  70. int msg_idx;
  71. bool pec_support;
  72. /* ssif bmc spinlock */
  73. spinlock_t lock;
  74. wait_queue_head_t wait_queue;
  75. u8 running;
  76. enum ssif_state state;
  77. /* Timeout waiting for response */
  78. struct timer_list response_timer;
  79. bool response_timer_inited;
  80. /* Flag to identify a Multi-part Read Transaction */
  81. bool is_singlepart_read;
  82. u8 nbytes_processed;
  83. u8 remain_len;
  84. u8 recv_len;
  85. /* Block Number of a Multi-part Read Transaction */
  86. u8 block_num;
  87. bool request_available;
  88. bool response_in_progress;
  89. bool busy;
  90. bool aborting;
  91. /* Buffer for SSIF Transaction part*/
  92. struct ssif_part_buffer part_buf;
  93. struct ipmi_ssif_msg response;
  94. struct ipmi_ssif_msg request;
  95. };
  96. static inline struct ssif_bmc_ctx *to_ssif_bmc(struct file *file)
  97. {
  98. return container_of(file->private_data, struct ssif_bmc_ctx, miscdev);
  99. }
  100. static const char *state_to_string(enum ssif_state state)
  101. {
  102. switch (state) {
  103. case SSIF_READY:
  104. return "SSIF_READY";
  105. case SSIF_START:
  106. return "SSIF_START";
  107. case SSIF_SMBUS_CMD:
  108. return "SSIF_SMBUS_CMD";
  109. case SSIF_REQ_RECVING:
  110. return "SSIF_REQ_RECVING";
  111. case SSIF_RES_SENDING:
  112. return "SSIF_RES_SENDING";
  113. case SSIF_ABORTING:
  114. return "SSIF_ABORTING";
  115. default:
  116. return "SSIF_STATE_UNKNOWN";
  117. }
  118. }
  119. /* Handle SSIF message that will be sent to user */
  120. static ssize_t ssif_bmc_read(struct file *file, char __user *buf, size_t count, loff_t *ppos)
  121. {
  122. struct ssif_bmc_ctx *ssif_bmc = to_ssif_bmc(file);
  123. struct ipmi_ssif_msg msg;
  124. unsigned long flags;
  125. ssize_t ret;
  126. spin_lock_irqsave(&ssif_bmc->lock, flags);
  127. while (!ssif_bmc->request_available) {
  128. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  129. if (file->f_flags & O_NONBLOCK)
  130. return -EAGAIN;
  131. ret = wait_event_interruptible(ssif_bmc->wait_queue,
  132. ssif_bmc->request_available);
  133. if (ret)
  134. return ret;
  135. spin_lock_irqsave(&ssif_bmc->lock, flags);
  136. }
  137. if (count < min_t(ssize_t,
  138. sizeof_field(struct ipmi_ssif_msg, len) + ssif_bmc->request.len,
  139. sizeof(struct ipmi_ssif_msg))) {
  140. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  141. ret = -EINVAL;
  142. } else {
  143. count = min_t(ssize_t,
  144. sizeof_field(struct ipmi_ssif_msg, len) + ssif_bmc->request.len,
  145. sizeof(struct ipmi_ssif_msg));
  146. memcpy(&msg, &ssif_bmc->request, count);
  147. ssif_bmc->request_available = false;
  148. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  149. ret = copy_to_user(buf, &msg, count);
  150. }
  151. return (ret < 0) ? ret : count;
  152. }
  153. /* Handle SSIF message that is written by user */
  154. static ssize_t ssif_bmc_write(struct file *file, const char __user *buf, size_t count,
  155. loff_t *ppos)
  156. {
  157. struct ssif_bmc_ctx *ssif_bmc = to_ssif_bmc(file);
  158. struct ipmi_ssif_msg msg;
  159. unsigned long flags;
  160. ssize_t ret;
  161. if (count < sizeof(msg.len) ||
  162. count > sizeof(struct ipmi_ssif_msg))
  163. return -EINVAL;
  164. if (copy_from_user(&msg, buf, count))
  165. return -EFAULT;
  166. if (!msg.len || msg.len > IPMI_SSIF_PAYLOAD_MAX ||
  167. count < sizeof_field(struct ipmi_ssif_msg, len) + msg.len)
  168. return -EINVAL;
  169. spin_lock_irqsave(&ssif_bmc->lock, flags);
  170. while (ssif_bmc->response_in_progress) {
  171. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  172. if (file->f_flags & O_NONBLOCK)
  173. return -EAGAIN;
  174. ret = wait_event_interruptible(ssif_bmc->wait_queue,
  175. !ssif_bmc->response_in_progress);
  176. if (ret)
  177. return ret;
  178. spin_lock_irqsave(&ssif_bmc->lock, flags);
  179. }
  180. /*
  181. * The write must complete before the response timeout fired, otherwise
  182. * the response is aborted and wait for next request
  183. * Return -EINVAL if the response is aborted
  184. */
  185. ret = (ssif_bmc->response_timer_inited) ? 0 : -EINVAL;
  186. if (ret)
  187. goto exit;
  188. del_timer(&ssif_bmc->response_timer);
  189. ssif_bmc->response_timer_inited = false;
  190. memcpy(&ssif_bmc->response, &msg, count);
  191. ssif_bmc->is_singlepart_read = (msg.len <= MAX_PAYLOAD_PER_TRANSACTION);
  192. ssif_bmc->response_in_progress = true;
  193. /* ssif_bmc not busy */
  194. ssif_bmc->busy = false;
  195. /* Clean old request buffer */
  196. memset(&ssif_bmc->request, 0, sizeof(struct ipmi_ssif_msg));
  197. exit:
  198. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  199. return (ret < 0) ? ret : count;
  200. }
  201. static int ssif_bmc_open(struct inode *inode, struct file *file)
  202. {
  203. struct ssif_bmc_ctx *ssif_bmc = to_ssif_bmc(file);
  204. int ret = 0;
  205. spin_lock_irq(&ssif_bmc->lock);
  206. if (!ssif_bmc->running)
  207. ssif_bmc->running = 1;
  208. else
  209. ret = -EBUSY;
  210. spin_unlock_irq(&ssif_bmc->lock);
  211. return ret;
  212. }
  213. static __poll_t ssif_bmc_poll(struct file *file, poll_table *wait)
  214. {
  215. struct ssif_bmc_ctx *ssif_bmc = to_ssif_bmc(file);
  216. __poll_t mask = 0;
  217. poll_wait(file, &ssif_bmc->wait_queue, wait);
  218. spin_lock_irq(&ssif_bmc->lock);
  219. /* The request is available, userspace application can get the request */
  220. if (ssif_bmc->request_available)
  221. mask |= EPOLLIN;
  222. spin_unlock_irq(&ssif_bmc->lock);
  223. return mask;
  224. }
  225. static int ssif_bmc_release(struct inode *inode, struct file *file)
  226. {
  227. struct ssif_bmc_ctx *ssif_bmc = to_ssif_bmc(file);
  228. spin_lock_irq(&ssif_bmc->lock);
  229. ssif_bmc->running = 0;
  230. spin_unlock_irq(&ssif_bmc->lock);
  231. return 0;
  232. }
  233. /*
  234. * System calls to device interface for user apps
  235. */
  236. static const struct file_operations ssif_bmc_fops = {
  237. .owner = THIS_MODULE,
  238. .open = ssif_bmc_open,
  239. .read = ssif_bmc_read,
  240. .write = ssif_bmc_write,
  241. .release = ssif_bmc_release,
  242. .poll = ssif_bmc_poll,
  243. };
  244. /* Called with ssif_bmc->lock held. */
  245. static void complete_response(struct ssif_bmc_ctx *ssif_bmc)
  246. {
  247. /* Invalidate response in buffer to denote it having been sent. */
  248. ssif_bmc->response.len = 0;
  249. ssif_bmc->response_in_progress = false;
  250. ssif_bmc->nbytes_processed = 0;
  251. ssif_bmc->remain_len = 0;
  252. ssif_bmc->busy = false;
  253. wake_up_all(&ssif_bmc->wait_queue);
  254. }
  255. static void response_timeout(struct timer_list *t)
  256. {
  257. struct ssif_bmc_ctx *ssif_bmc = from_timer(ssif_bmc, t, response_timer);
  258. unsigned long flags;
  259. spin_lock_irqsave(&ssif_bmc->lock, flags);
  260. /* Do nothing if the response is in progress */
  261. if (!ssif_bmc->response_in_progress) {
  262. /* Recover ssif_bmc from busy */
  263. ssif_bmc->busy = false;
  264. ssif_bmc->response_timer_inited = false;
  265. /* Set aborting flag */
  266. ssif_bmc->aborting = true;
  267. }
  268. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  269. }
  270. /* Called with ssif_bmc->lock held. */
  271. static void handle_request(struct ssif_bmc_ctx *ssif_bmc)
  272. {
  273. /* set ssif_bmc to busy waiting for response */
  274. ssif_bmc->busy = true;
  275. /* Request message is available to process */
  276. ssif_bmc->request_available = true;
  277. /* Clean old response buffer */
  278. memset(&ssif_bmc->response, 0, sizeof(struct ipmi_ssif_msg));
  279. /* This is the new READ request.*/
  280. wake_up_all(&ssif_bmc->wait_queue);
  281. /* Armed timer to recover slave from busy state in case of no response */
  282. if (!ssif_bmc->response_timer_inited) {
  283. timer_setup(&ssif_bmc->response_timer, response_timeout, 0);
  284. ssif_bmc->response_timer_inited = true;
  285. }
  286. mod_timer(&ssif_bmc->response_timer, jiffies + msecs_to_jiffies(RESPONSE_TIMEOUT));
  287. }
  288. static void calculate_response_part_pec(struct ssif_part_buffer *part)
  289. {
  290. u8 addr = part->address;
  291. /* PEC - Start Read Address */
  292. part->pec = i2c_smbus_pec(0, &addr, 1);
  293. /* PEC - SSIF Command */
  294. part->pec = i2c_smbus_pec(part->pec, &part->smbus_cmd, 1);
  295. /* PEC - Restart Write Address */
  296. addr = addr | 0x01;
  297. part->pec = i2c_smbus_pec(part->pec, &addr, 1);
  298. part->pec = i2c_smbus_pec(part->pec, &part->length, 1);
  299. if (part->length)
  300. part->pec = i2c_smbus_pec(part->pec, part->payload, part->length);
  301. }
  302. static void set_singlepart_response_buffer(struct ssif_bmc_ctx *ssif_bmc)
  303. {
  304. struct ssif_part_buffer *part = &ssif_bmc->part_buf;
  305. part->address = GET_8BIT_ADDR(ssif_bmc->client->addr);
  306. part->length = (u8)ssif_bmc->response.len;
  307. /* Clear the rest to 0 */
  308. memset(part->payload + part->length, 0, MAX_PAYLOAD_PER_TRANSACTION - part->length);
  309. memcpy(&part->payload[0], &ssif_bmc->response.payload[0], part->length);
  310. }
  311. static void set_multipart_response_buffer(struct ssif_bmc_ctx *ssif_bmc)
  312. {
  313. struct ssif_part_buffer *part = &ssif_bmc->part_buf;
  314. u8 part_len = 0;
  315. part->address = GET_8BIT_ADDR(ssif_bmc->client->addr);
  316. switch (part->smbus_cmd) {
  317. case SSIF_IPMI_MULTIPART_READ_START:
  318. /*
  319. * Read Start length is 32 bytes.
  320. * Read Start transfer first 30 bytes of IPMI response
  321. * and 2 special code 0x00, 0x01.
  322. */
  323. ssif_bmc->nbytes_processed = 0;
  324. ssif_bmc->block_num = 0;
  325. part->length = MAX_PAYLOAD_PER_TRANSACTION;
  326. part_len = MAX_IPMI_DATA_PER_START_TRANSACTION;
  327. ssif_bmc->remain_len = ssif_bmc->response.len - part_len;
  328. part->payload[0] = 0x00; /* Start Flag */
  329. part->payload[1] = 0x01; /* Start Flag */
  330. memcpy(&part->payload[2], &ssif_bmc->response.payload[0], part_len);
  331. break;
  332. case SSIF_IPMI_MULTIPART_READ_MIDDLE:
  333. /*
  334. * IPMI READ Middle or READ End messages can carry up to 31 bytes
  335. * IPMI data plus block number byte.
  336. */
  337. if (ssif_bmc->remain_len <= MAX_IPMI_DATA_PER_MIDDLE_TRANSACTION) {
  338. /*
  339. * This is READ End message
  340. * Return length is the remaining response data length
  341. * plus block number
  342. * Block number 0xFF is to indicate this is last message
  343. *
  344. */
  345. /* Clean the buffer */
  346. memset(&part->payload[0], 0, MAX_PAYLOAD_PER_TRANSACTION);
  347. part->length = ssif_bmc->remain_len + 1;
  348. part_len = ssif_bmc->remain_len;
  349. ssif_bmc->block_num = 0xFF;
  350. part->payload[0] = ssif_bmc->block_num;
  351. } else {
  352. /*
  353. * This is READ Middle message
  354. * Response length is the maximum SMBUS transfer length
  355. * Block number byte is incremented
  356. * Return length is maximum SMBUS transfer length
  357. */
  358. part->length = MAX_PAYLOAD_PER_TRANSACTION;
  359. part_len = MAX_IPMI_DATA_PER_MIDDLE_TRANSACTION;
  360. part->payload[0] = ssif_bmc->block_num;
  361. ssif_bmc->block_num++;
  362. }
  363. ssif_bmc->remain_len -= part_len;
  364. memcpy(&part->payload[1], ssif_bmc->response.payload + ssif_bmc->nbytes_processed,
  365. part_len);
  366. break;
  367. default:
  368. /* Do not expect to go to this case */
  369. dev_err(&ssif_bmc->client->dev, "%s: Unexpected SMBus command 0x%x\n",
  370. __func__, part->smbus_cmd);
  371. break;
  372. }
  373. ssif_bmc->nbytes_processed += part_len;
  374. }
  375. static bool supported_read_cmd(u8 cmd)
  376. {
  377. if (cmd == SSIF_IPMI_SINGLEPART_READ ||
  378. cmd == SSIF_IPMI_MULTIPART_READ_START ||
  379. cmd == SSIF_IPMI_MULTIPART_READ_MIDDLE)
  380. return true;
  381. return false;
  382. }
  383. static bool supported_write_cmd(u8 cmd)
  384. {
  385. if (cmd == SSIF_IPMI_SINGLEPART_WRITE ||
  386. cmd == SSIF_IPMI_MULTIPART_WRITE_START ||
  387. cmd == SSIF_IPMI_MULTIPART_WRITE_MIDDLE ||
  388. cmd == SSIF_IPMI_MULTIPART_WRITE_END)
  389. return true;
  390. return false;
  391. }
  392. /* Process the IPMI response that will be read by master */
  393. static void handle_read_processed(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  394. {
  395. struct ssif_part_buffer *part = &ssif_bmc->part_buf;
  396. /* msg_idx start from 0 */
  397. if (part->index < part->length)
  398. *val = part->payload[part->index];
  399. else if (part->index == part->length && ssif_bmc->pec_support)
  400. *val = part->pec;
  401. else
  402. *val = 0;
  403. part->index++;
  404. }
  405. static void handle_write_received(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  406. {
  407. /*
  408. * The msg_idx must be 1 when first enter SSIF_REQ_RECVING state
  409. * And it would never exceeded 36 bytes included the 32 bytes max payload +
  410. * the address + the command + the len and the PEC.
  411. */
  412. if (ssif_bmc->msg_idx < 1 || ssif_bmc->msg_idx > MAX_TRANSACTION)
  413. return;
  414. if (ssif_bmc->msg_idx == 1) {
  415. ssif_bmc->part_buf.length = *val;
  416. ssif_bmc->part_buf.index = 0;
  417. } else {
  418. ssif_bmc->part_buf.payload[ssif_bmc->part_buf.index++] = *val;
  419. }
  420. ssif_bmc->msg_idx++;
  421. }
  422. static bool validate_request_part(struct ssif_bmc_ctx *ssif_bmc)
  423. {
  424. struct ssif_part_buffer *part = &ssif_bmc->part_buf;
  425. bool ret = true;
  426. u8 cpec;
  427. u8 addr;
  428. if (part->index == part->length) {
  429. /* PEC is not included */
  430. ssif_bmc->pec_support = false;
  431. ret = true;
  432. goto exit;
  433. }
  434. if (part->index != part->length + 1) {
  435. ret = false;
  436. goto exit;
  437. }
  438. /* PEC is included */
  439. ssif_bmc->pec_support = true;
  440. part->pec = part->payload[part->length];
  441. addr = GET_8BIT_ADDR(ssif_bmc->client->addr);
  442. cpec = i2c_smbus_pec(0, &addr, 1);
  443. cpec = i2c_smbus_pec(cpec, &part->smbus_cmd, 1);
  444. cpec = i2c_smbus_pec(cpec, &part->length, 1);
  445. /*
  446. * As SMBus specification does not allow the length
  447. * (byte count) in the Write-Block protocol to be zero.
  448. * Therefore, it is illegal to have the last Middle
  449. * transaction in the sequence carry 32-byte and have
  450. * a length of ‘0’ in the End transaction.
  451. * But some users may try to use this way and we should
  452. * prevent ssif_bmc driver broken in this case.
  453. */
  454. if (part->length)
  455. cpec = i2c_smbus_pec(cpec, part->payload, part->length);
  456. if (cpec != part->pec)
  457. ret = false;
  458. exit:
  459. return ret;
  460. }
  461. static void process_request_part(struct ssif_bmc_ctx *ssif_bmc)
  462. {
  463. struct ssif_part_buffer *part = &ssif_bmc->part_buf;
  464. unsigned int len;
  465. switch (part->smbus_cmd) {
  466. case SSIF_IPMI_SINGLEPART_WRITE:
  467. /* save the whole part to request*/
  468. ssif_bmc->request.len = part->length;
  469. memcpy(ssif_bmc->request.payload, part->payload, part->length);
  470. break;
  471. case SSIF_IPMI_MULTIPART_WRITE_START:
  472. ssif_bmc->request.len = 0;
  473. fallthrough;
  474. case SSIF_IPMI_MULTIPART_WRITE_MIDDLE:
  475. case SSIF_IPMI_MULTIPART_WRITE_END:
  476. len = ssif_bmc->request.len + part->length;
  477. /* Do the bound check here, not allow the request len exceed 254 bytes */
  478. if (len > IPMI_SSIF_PAYLOAD_MAX) {
  479. dev_warn(&ssif_bmc->client->dev,
  480. "Warn: Request exceeded 254 bytes, aborting");
  481. /* Request too long, aborting */
  482. ssif_bmc->aborting = true;
  483. } else {
  484. memcpy(ssif_bmc->request.payload + ssif_bmc->request.len,
  485. part->payload, part->length);
  486. ssif_bmc->request.len += part->length;
  487. }
  488. break;
  489. default:
  490. /* Do not expect to go to this case */
  491. dev_err(&ssif_bmc->client->dev, "%s: Unexpected SMBus command 0x%x\n",
  492. __func__, part->smbus_cmd);
  493. break;
  494. }
  495. }
  496. static void process_smbus_cmd(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  497. {
  498. /* SMBUS command can vary (single or multi-part) */
  499. ssif_bmc->part_buf.smbus_cmd = *val;
  500. ssif_bmc->msg_idx = 1;
  501. memset(&ssif_bmc->part_buf.payload[0], 0, MAX_PAYLOAD_PER_TRANSACTION);
  502. if (*val == SSIF_IPMI_SINGLEPART_WRITE || *val == SSIF_IPMI_MULTIPART_WRITE_START) {
  503. /*
  504. * The response maybe not come in-time, causing host SSIF driver
  505. * to timeout and resend a new request. In such case check for
  506. * pending response and clear it
  507. */
  508. if (ssif_bmc->response_in_progress)
  509. complete_response(ssif_bmc);
  510. /* This is new request, flip aborting flag if set */
  511. if (ssif_bmc->aborting)
  512. ssif_bmc->aborting = false;
  513. }
  514. }
  515. static void on_read_requested_event(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  516. {
  517. if (ssif_bmc->state == SSIF_READY ||
  518. ssif_bmc->state == SSIF_START ||
  519. ssif_bmc->state == SSIF_REQ_RECVING ||
  520. ssif_bmc->state == SSIF_RES_SENDING) {
  521. dev_warn(&ssif_bmc->client->dev,
  522. "Warn: %s unexpected READ REQUESTED in state=%s\n",
  523. __func__, state_to_string(ssif_bmc->state));
  524. ssif_bmc->state = SSIF_ABORTING;
  525. *val = 0;
  526. return;
  527. } else if (ssif_bmc->state == SSIF_SMBUS_CMD) {
  528. if (!supported_read_cmd(ssif_bmc->part_buf.smbus_cmd)) {
  529. dev_warn(&ssif_bmc->client->dev, "Warn: Unknown SMBus read command=0x%x",
  530. ssif_bmc->part_buf.smbus_cmd);
  531. ssif_bmc->aborting = true;
  532. }
  533. if (ssif_bmc->aborting)
  534. ssif_bmc->state = SSIF_ABORTING;
  535. else
  536. ssif_bmc->state = SSIF_RES_SENDING;
  537. }
  538. ssif_bmc->msg_idx = 0;
  539. /* Send 0 if there is nothing to send */
  540. if (!ssif_bmc->response_in_progress || ssif_bmc->state == SSIF_ABORTING) {
  541. *val = 0;
  542. return;
  543. }
  544. if (ssif_bmc->is_singlepart_read)
  545. set_singlepart_response_buffer(ssif_bmc);
  546. else
  547. set_multipart_response_buffer(ssif_bmc);
  548. calculate_response_part_pec(&ssif_bmc->part_buf);
  549. ssif_bmc->part_buf.index = 0;
  550. *val = ssif_bmc->part_buf.length;
  551. }
  552. static void on_read_processed_event(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  553. {
  554. if (ssif_bmc->state == SSIF_READY ||
  555. ssif_bmc->state == SSIF_START ||
  556. ssif_bmc->state == SSIF_REQ_RECVING ||
  557. ssif_bmc->state == SSIF_SMBUS_CMD) {
  558. dev_warn(&ssif_bmc->client->dev,
  559. "Warn: %s unexpected READ PROCESSED in state=%s\n",
  560. __func__, state_to_string(ssif_bmc->state));
  561. ssif_bmc->state = SSIF_ABORTING;
  562. *val = 0;
  563. return;
  564. }
  565. /* Send 0 if there is nothing to send */
  566. if (!ssif_bmc->response_in_progress || ssif_bmc->state == SSIF_ABORTING) {
  567. *val = 0;
  568. return;
  569. }
  570. handle_read_processed(ssif_bmc, val);
  571. }
  572. static void on_write_requested_event(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  573. {
  574. if (ssif_bmc->state == SSIF_READY || ssif_bmc->state == SSIF_SMBUS_CMD) {
  575. ssif_bmc->state = SSIF_START;
  576. } else if (ssif_bmc->state == SSIF_START ||
  577. ssif_bmc->state == SSIF_REQ_RECVING ||
  578. ssif_bmc->state == SSIF_RES_SENDING) {
  579. dev_warn(&ssif_bmc->client->dev,
  580. "Warn: %s unexpected WRITE REQUEST in state=%s\n",
  581. __func__, state_to_string(ssif_bmc->state));
  582. ssif_bmc->state = SSIF_ABORTING;
  583. return;
  584. }
  585. ssif_bmc->msg_idx = 0;
  586. ssif_bmc->part_buf.address = *val;
  587. }
  588. static void on_write_received_event(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  589. {
  590. if (ssif_bmc->state == SSIF_READY ||
  591. ssif_bmc->state == SSIF_RES_SENDING) {
  592. dev_warn(&ssif_bmc->client->dev,
  593. "Warn: %s unexpected WRITE RECEIVED in state=%s\n",
  594. __func__, state_to_string(ssif_bmc->state));
  595. ssif_bmc->state = SSIF_ABORTING;
  596. } else if (ssif_bmc->state == SSIF_START) {
  597. ssif_bmc->state = SSIF_SMBUS_CMD;
  598. } else if (ssif_bmc->state == SSIF_SMBUS_CMD) {
  599. if (!supported_write_cmd(ssif_bmc->part_buf.smbus_cmd)) {
  600. dev_warn(&ssif_bmc->client->dev, "Warn: Unknown SMBus write command=0x%x",
  601. ssif_bmc->part_buf.smbus_cmd);
  602. ssif_bmc->aborting = true;
  603. }
  604. if (ssif_bmc->aborting)
  605. ssif_bmc->state = SSIF_ABORTING;
  606. else
  607. ssif_bmc->state = SSIF_REQ_RECVING;
  608. }
  609. /* This is response sending state */
  610. if (ssif_bmc->state == SSIF_REQ_RECVING)
  611. handle_write_received(ssif_bmc, val);
  612. else if (ssif_bmc->state == SSIF_SMBUS_CMD)
  613. process_smbus_cmd(ssif_bmc, val);
  614. }
  615. static void on_stop_event(struct ssif_bmc_ctx *ssif_bmc, u8 *val)
  616. {
  617. if (ssif_bmc->state == SSIF_READY ||
  618. ssif_bmc->state == SSIF_START ||
  619. ssif_bmc->state == SSIF_SMBUS_CMD ||
  620. ssif_bmc->state == SSIF_ABORTING) {
  621. dev_warn(&ssif_bmc->client->dev,
  622. "Warn: %s unexpected SLAVE STOP in state=%s\n",
  623. __func__, state_to_string(ssif_bmc->state));
  624. ssif_bmc->state = SSIF_READY;
  625. } else if (ssif_bmc->state == SSIF_REQ_RECVING) {
  626. if (validate_request_part(ssif_bmc)) {
  627. process_request_part(ssif_bmc);
  628. if (ssif_bmc->part_buf.smbus_cmd == SSIF_IPMI_SINGLEPART_WRITE ||
  629. ssif_bmc->part_buf.smbus_cmd == SSIF_IPMI_MULTIPART_WRITE_END)
  630. handle_request(ssif_bmc);
  631. ssif_bmc->state = SSIF_READY;
  632. } else {
  633. /*
  634. * A BMC that receives an invalid request drop the data for the write
  635. * transaction and any further transactions (read or write) until
  636. * the next valid read or write Start transaction is received
  637. */
  638. dev_err(&ssif_bmc->client->dev, "Error: invalid pec\n");
  639. ssif_bmc->aborting = true;
  640. }
  641. } else if (ssif_bmc->state == SSIF_RES_SENDING) {
  642. if (ssif_bmc->is_singlepart_read || ssif_bmc->block_num == 0xFF) {
  643. memset(&ssif_bmc->part_buf, 0, sizeof(struct ssif_part_buffer));
  644. /* Invalidate response buffer to denote it is sent */
  645. complete_response(ssif_bmc);
  646. }
  647. ssif_bmc->state = SSIF_READY;
  648. }
  649. /* Reset message index */
  650. ssif_bmc->msg_idx = 0;
  651. }
  652. /*
  653. * Callback function to handle I2C slave events
  654. */
  655. static int ssif_bmc_cb(struct i2c_client *client, enum i2c_slave_event event, u8 *val)
  656. {
  657. unsigned long flags;
  658. struct ssif_bmc_ctx *ssif_bmc = i2c_get_clientdata(client);
  659. int ret = 0;
  660. spin_lock_irqsave(&ssif_bmc->lock, flags);
  661. switch (event) {
  662. case I2C_SLAVE_READ_REQUESTED:
  663. on_read_requested_event(ssif_bmc, val);
  664. break;
  665. case I2C_SLAVE_WRITE_REQUESTED:
  666. on_write_requested_event(ssif_bmc, val);
  667. break;
  668. case I2C_SLAVE_READ_PROCESSED:
  669. on_read_processed_event(ssif_bmc, val);
  670. break;
  671. case I2C_SLAVE_WRITE_RECEIVED:
  672. on_write_received_event(ssif_bmc, val);
  673. break;
  674. case I2C_SLAVE_STOP:
  675. on_stop_event(ssif_bmc, val);
  676. break;
  677. default:
  678. dev_warn(&ssif_bmc->client->dev, "Warn: Unknown i2c slave event\n");
  679. break;
  680. }
  681. if (!ssif_bmc->aborting && ssif_bmc->busy)
  682. ret = -EBUSY;
  683. spin_unlock_irqrestore(&ssif_bmc->lock, flags);
  684. return ret;
  685. }
  686. static int ssif_bmc_probe(struct i2c_client *client)
  687. {
  688. struct ssif_bmc_ctx *ssif_bmc;
  689. int ret;
  690. ssif_bmc = devm_kzalloc(&client->dev, sizeof(*ssif_bmc), GFP_KERNEL);
  691. if (!ssif_bmc)
  692. return -ENOMEM;
  693. spin_lock_init(&ssif_bmc->lock);
  694. init_waitqueue_head(&ssif_bmc->wait_queue);
  695. ssif_bmc->request_available = false;
  696. ssif_bmc->response_in_progress = false;
  697. ssif_bmc->busy = false;
  698. ssif_bmc->response_timer_inited = false;
  699. /* Register misc device interface */
  700. ssif_bmc->miscdev.minor = MISC_DYNAMIC_MINOR;
  701. ssif_bmc->miscdev.name = DEVICE_NAME;
  702. ssif_bmc->miscdev.fops = &ssif_bmc_fops;
  703. ssif_bmc->miscdev.parent = &client->dev;
  704. ret = misc_register(&ssif_bmc->miscdev);
  705. if (ret)
  706. return ret;
  707. ssif_bmc->client = client;
  708. ssif_bmc->client->flags |= I2C_CLIENT_SLAVE;
  709. /* Register I2C slave */
  710. i2c_set_clientdata(client, ssif_bmc);
  711. ret = i2c_slave_register(client, ssif_bmc_cb);
  712. if (ret)
  713. misc_deregister(&ssif_bmc->miscdev);
  714. return ret;
  715. }
  716. static void ssif_bmc_remove(struct i2c_client *client)
  717. {
  718. struct ssif_bmc_ctx *ssif_bmc = i2c_get_clientdata(client);
  719. i2c_slave_unregister(client);
  720. misc_deregister(&ssif_bmc->miscdev);
  721. }
  722. static const struct of_device_id ssif_bmc_match[] = {
  723. { .compatible = "ssif-bmc" },
  724. { },
  725. };
  726. MODULE_DEVICE_TABLE(of, ssif_bmc_match);
  727. static const struct i2c_device_id ssif_bmc_id[] = {
  728. { DEVICE_NAME },
  729. { }
  730. };
  731. MODULE_DEVICE_TABLE(i2c, ssif_bmc_id);
  732. static struct i2c_driver ssif_bmc_driver = {
  733. .driver = {
  734. .name = DEVICE_NAME,
  735. .of_match_table = ssif_bmc_match,
  736. },
  737. .probe = ssif_bmc_probe,
  738. .remove = ssif_bmc_remove,
  739. .id_table = ssif_bmc_id,
  740. };
  741. module_i2c_driver(ssif_bmc_driver);
  742. MODULE_AUTHOR("Quan Nguyen <quan@os.amperecomputing.com>");
  743. MODULE_AUTHOR("Chuong Tran <chuong@os.amperecomputing.com>");
  744. MODULE_DESCRIPTION("Linux device driver of the BMC IPMI SSIF interface.");
  745. MODULE_LICENSE("GPL");