Revert "unicode: Don't special case ignorable code points"
[linux.git] / drivers / crypto / atmel-i2c.c
bloba895e4289efa0c89b0554883334b585be046d7ba
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 * Microchip / Atmel ECC (I2C) driver.
5 * Copyright (c) 2017, Microchip Technology Inc.
6 * Author: Tudor Ambarus
7 */
9 #include <linux/bitrev.h>
10 #include <linux/crc16.h>
11 #include <linux/delay.h>
12 #include <linux/device.h>
13 #include <linux/err.h>
14 #include <linux/errno.h>
15 #include <linux/i2c.h>
16 #include <linux/init.h>
17 #include <linux/kernel.h>
18 #include <linux/module.h>
19 #include <linux/scatterlist.h>
20 #include <linux/slab.h>
21 #include <linux/workqueue.h>
22 #include "atmel-i2c.h"
24 static const struct {
25 u8 value;
26 const char *error_text;
27 } error_list[] = {
28 { 0x01, "CheckMac or Verify miscompare" },
29 { 0x03, "Parse Error" },
30 { 0x05, "ECC Fault" },
31 { 0x0F, "Execution Error" },
32 { 0xEE, "Watchdog about to expire" },
33 { 0xFF, "CRC or other communication error" },
36 /**
37 * atmel_i2c_checksum() - Generate 16-bit CRC as required by ATMEL ECC.
38 * CRC16 verification of the count, opcode, param1, param2 and data bytes.
39 * The checksum is saved in little-endian format in the least significant
40 * two bytes of the command. CRC polynomial is 0x8005 and the initial register
41 * value should be zero.
43 * @cmd : structure used for communicating with the device.
45 static void atmel_i2c_checksum(struct atmel_i2c_cmd *cmd)
47 u8 *data = &cmd->count;
48 size_t len = cmd->count - CRC_SIZE;
49 __le16 *__crc16 = (__le16 *)(data + len);
51 *__crc16 = cpu_to_le16(bitrev16(crc16(0, data, len)));
54 void atmel_i2c_init_read_config_cmd(struct atmel_i2c_cmd *cmd)
56 cmd->word_addr = COMMAND;
57 cmd->opcode = OPCODE_READ;
59 * Read the word from Configuration zone that contains the lock bytes
60 * (UserExtra, Selector, LockValue, LockConfig).
62 cmd->param1 = CONFIGURATION_ZONE;
63 cmd->param2 = cpu_to_le16(DEVICE_LOCK_ADDR);
64 cmd->count = READ_COUNT;
66 atmel_i2c_checksum(cmd);
68 cmd->msecs = MAX_EXEC_TIME_READ;
69 cmd->rxsize = READ_RSP_SIZE;
71 EXPORT_SYMBOL(atmel_i2c_init_read_config_cmd);
73 int atmel_i2c_init_read_otp_cmd(struct atmel_i2c_cmd *cmd, u16 addr)
75 if (addr < 0 || addr > OTP_ZONE_SIZE)
76 return -1;
78 cmd->word_addr = COMMAND;
79 cmd->opcode = OPCODE_READ;
81 * Read the word from OTP zone that may contain e.g. serial
82 * numbers or similar if persistently pre-initialized and locked
84 cmd->param1 = OTP_ZONE;
85 cmd->param2 = cpu_to_le16(addr);
86 cmd->count = READ_COUNT;
88 atmel_i2c_checksum(cmd);
90 cmd->msecs = MAX_EXEC_TIME_READ;
91 cmd->rxsize = READ_RSP_SIZE;
93 return 0;
95 EXPORT_SYMBOL(atmel_i2c_init_read_otp_cmd);
97 void atmel_i2c_init_random_cmd(struct atmel_i2c_cmd *cmd)
99 cmd->word_addr = COMMAND;
100 cmd->opcode = OPCODE_RANDOM;
101 cmd->param1 = 0;
102 cmd->param2 = 0;
103 cmd->count = RANDOM_COUNT;
105 atmel_i2c_checksum(cmd);
107 cmd->msecs = MAX_EXEC_TIME_RANDOM;
108 cmd->rxsize = RANDOM_RSP_SIZE;
110 EXPORT_SYMBOL(atmel_i2c_init_random_cmd);
112 void atmel_i2c_init_genkey_cmd(struct atmel_i2c_cmd *cmd, u16 keyid)
114 cmd->word_addr = COMMAND;
115 cmd->count = GENKEY_COUNT;
116 cmd->opcode = OPCODE_GENKEY;
117 cmd->param1 = GENKEY_MODE_PRIVATE;
118 /* a random private key will be generated and stored in slot keyID */
119 cmd->param2 = cpu_to_le16(keyid);
121 atmel_i2c_checksum(cmd);
123 cmd->msecs = MAX_EXEC_TIME_GENKEY;
124 cmd->rxsize = GENKEY_RSP_SIZE;
126 EXPORT_SYMBOL(atmel_i2c_init_genkey_cmd);
128 int atmel_i2c_init_ecdh_cmd(struct atmel_i2c_cmd *cmd,
129 struct scatterlist *pubkey)
131 size_t copied;
133 cmd->word_addr = COMMAND;
134 cmd->count = ECDH_COUNT;
135 cmd->opcode = OPCODE_ECDH;
136 cmd->param1 = ECDH_PREFIX_MODE;
137 /* private key slot */
138 cmd->param2 = cpu_to_le16(DATA_SLOT_2);
141 * The device only supports NIST P256 ECC keys. The public key size will
142 * always be the same. Use a macro for the key size to avoid unnecessary
143 * computations.
145 copied = sg_copy_to_buffer(pubkey,
146 sg_nents_for_len(pubkey,
147 ATMEL_ECC_PUBKEY_SIZE),
148 cmd->data, ATMEL_ECC_PUBKEY_SIZE);
149 if (copied != ATMEL_ECC_PUBKEY_SIZE)
150 return -EINVAL;
152 atmel_i2c_checksum(cmd);
154 cmd->msecs = MAX_EXEC_TIME_ECDH;
155 cmd->rxsize = ECDH_RSP_SIZE;
157 return 0;
159 EXPORT_SYMBOL(atmel_i2c_init_ecdh_cmd);
162 * After wake and after execution of a command, there will be error, status, or
163 * result bytes in the device's output register that can be retrieved by the
164 * system. When the length of that group is four bytes, the codes returned are
165 * detailed in error_list.
167 static int atmel_i2c_status(struct device *dev, u8 *status)
169 size_t err_list_len = ARRAY_SIZE(error_list);
170 int i;
171 u8 err_id = status[1];
173 if (*status != STATUS_SIZE)
174 return 0;
176 if (err_id == STATUS_WAKE_SUCCESSFUL || err_id == STATUS_NOERR)
177 return 0;
179 for (i = 0; i < err_list_len; i++)
180 if (error_list[i].value == err_id)
181 break;
183 /* if err_id is not in the error_list then ignore it */
184 if (i != err_list_len) {
185 dev_err(dev, "%02x: %s:\n", err_id, error_list[i].error_text);
186 return err_id;
189 return 0;
192 static int atmel_i2c_wakeup(struct i2c_client *client)
194 struct atmel_i2c_client_priv *i2c_priv = i2c_get_clientdata(client);
195 u8 status[STATUS_RSP_SIZE];
196 int ret;
199 * The device ignores any levels or transitions on the SCL pin when the
200 * device is idle, asleep or during waking up. Don't check for error
201 * when waking up the device.
203 i2c_transfer_buffer_flags(client, i2c_priv->wake_token,
204 i2c_priv->wake_token_sz, I2C_M_IGNORE_NAK);
207 * Wait to wake the device. Typical execution times for ecdh and genkey
208 * are around tens of milliseconds. Delta is chosen to 50 microseconds.
210 usleep_range(TWHI_MIN, TWHI_MAX);
212 ret = i2c_master_recv(client, status, STATUS_SIZE);
213 if (ret < 0)
214 return ret;
216 return atmel_i2c_status(&client->dev, status);
219 static int atmel_i2c_sleep(struct i2c_client *client)
221 u8 sleep = SLEEP_TOKEN;
223 return i2c_master_send(client, &sleep, 1);
227 * atmel_i2c_send_receive() - send a command to the device and receive its
228 * response.
229 * @client: i2c client device
230 * @cmd : structure used to communicate with the device
232 * After the device receives a Wake token, a watchdog counter starts within the
233 * device. After the watchdog timer expires, the device enters sleep mode
234 * regardless of whether some I/O transmission or command execution is in
235 * progress. If a command is attempted when insufficient time remains prior to
236 * watchdog timer execution, the device will return the watchdog timeout error
237 * code without attempting to execute the command. There is no way to reset the
238 * counter other than to put the device into sleep or idle mode and then
239 * wake it up again.
241 int atmel_i2c_send_receive(struct i2c_client *client, struct atmel_i2c_cmd *cmd)
243 struct atmel_i2c_client_priv *i2c_priv = i2c_get_clientdata(client);
244 int ret;
246 mutex_lock(&i2c_priv->lock);
248 ret = atmel_i2c_wakeup(client);
249 if (ret)
250 goto err;
252 /* send the command */
253 ret = i2c_master_send(client, (u8 *)cmd, cmd->count + WORD_ADDR_SIZE);
254 if (ret < 0)
255 goto err;
257 /* delay the appropriate amount of time for command to execute */
258 msleep(cmd->msecs);
260 /* receive the response */
261 ret = i2c_master_recv(client, cmd->data, cmd->rxsize);
262 if (ret < 0)
263 goto err;
265 /* put the device into low-power mode */
266 ret = atmel_i2c_sleep(client);
267 if (ret < 0)
268 goto err;
270 mutex_unlock(&i2c_priv->lock);
271 return atmel_i2c_status(&client->dev, cmd->data);
272 err:
273 mutex_unlock(&i2c_priv->lock);
274 return ret;
276 EXPORT_SYMBOL(atmel_i2c_send_receive);
278 static void atmel_i2c_work_handler(struct work_struct *work)
280 struct atmel_i2c_work_data *work_data =
281 container_of(work, struct atmel_i2c_work_data, work);
282 struct atmel_i2c_cmd *cmd = &work_data->cmd;
283 struct i2c_client *client = work_data->client;
284 int status;
286 status = atmel_i2c_send_receive(client, cmd);
287 work_data->cbk(work_data, work_data->areq, status);
290 static struct workqueue_struct *atmel_wq;
292 void atmel_i2c_enqueue(struct atmel_i2c_work_data *work_data,
293 void (*cbk)(struct atmel_i2c_work_data *work_data,
294 void *areq, int status),
295 void *areq)
297 work_data->cbk = (void *)cbk;
298 work_data->areq = areq;
300 INIT_WORK(&work_data->work, atmel_i2c_work_handler);
301 queue_work(atmel_wq, &work_data->work);
303 EXPORT_SYMBOL(atmel_i2c_enqueue);
305 void atmel_i2c_flush_queue(void)
307 flush_workqueue(atmel_wq);
309 EXPORT_SYMBOL(atmel_i2c_flush_queue);
311 static inline size_t atmel_i2c_wake_token_sz(u32 bus_clk_rate)
313 u32 no_of_bits = DIV_ROUND_UP(TWLO_USEC * bus_clk_rate, USEC_PER_SEC);
315 /* return the size of the wake_token in bytes */
316 return DIV_ROUND_UP(no_of_bits, 8);
319 static int device_sanity_check(struct i2c_client *client)
321 struct atmel_i2c_cmd *cmd;
322 int ret;
324 cmd = kmalloc(sizeof(*cmd), GFP_KERNEL);
325 if (!cmd)
326 return -ENOMEM;
328 atmel_i2c_init_read_config_cmd(cmd);
330 ret = atmel_i2c_send_receive(client, cmd);
331 if (ret)
332 goto free_cmd;
335 * It is vital that the Configuration, Data and OTP zones be locked
336 * prior to release into the field of the system containing the device.
337 * Failure to lock these zones may permit modification of any secret
338 * keys and may lead to other security problems.
340 if (cmd->data[LOCK_CONFIG_IDX] || cmd->data[LOCK_VALUE_IDX]) {
341 dev_err(&client->dev, "Configuration or Data and OTP zones are unlocked!\n");
342 ret = -ENOTSUPP;
345 /* fall through */
346 free_cmd:
347 kfree(cmd);
348 return ret;
351 int atmel_i2c_probe(struct i2c_client *client)
353 struct atmel_i2c_client_priv *i2c_priv;
354 struct device *dev = &client->dev;
355 int ret;
356 u32 bus_clk_rate;
358 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
359 dev_err(dev, "I2C_FUNC_I2C not supported\n");
360 return -ENODEV;
363 bus_clk_rate = i2c_acpi_find_bus_speed(&client->adapter->dev);
364 if (!bus_clk_rate) {
365 ret = device_property_read_u32(&client->adapter->dev,
366 "clock-frequency", &bus_clk_rate);
367 if (ret) {
368 dev_err(dev, "failed to read clock-frequency property\n");
369 return ret;
373 if (bus_clk_rate > 1000000L) {
374 dev_err(dev, "%u exceeds maximum supported clock frequency (1MHz)\n",
375 bus_clk_rate);
376 return -EINVAL;
379 i2c_priv = devm_kmalloc(dev, sizeof(*i2c_priv), GFP_KERNEL);
380 if (!i2c_priv)
381 return -ENOMEM;
383 i2c_priv->client = client;
384 mutex_init(&i2c_priv->lock);
387 * WAKE_TOKEN_MAX_SIZE was calculated for the maximum bus_clk_rate -
388 * 1MHz. The previous bus_clk_rate check ensures us that wake_token_sz
389 * will always be smaller than or equal to WAKE_TOKEN_MAX_SIZE.
391 i2c_priv->wake_token_sz = atmel_i2c_wake_token_sz(bus_clk_rate);
393 memset(i2c_priv->wake_token, 0, sizeof(i2c_priv->wake_token));
395 atomic_set(&i2c_priv->tfm_count, 0);
397 i2c_set_clientdata(client, i2c_priv);
399 return device_sanity_check(client);
401 EXPORT_SYMBOL(atmel_i2c_probe);
403 static int __init atmel_i2c_init(void)
405 atmel_wq = alloc_workqueue("atmel_wq", 0, 0);
406 return atmel_wq ? 0 : -ENOMEM;
409 static void __exit atmel_i2c_exit(void)
411 destroy_workqueue(atmel_wq);
414 module_init(atmel_i2c_init);
415 module_exit(atmel_i2c_exit);
417 MODULE_AUTHOR("Tudor Ambarus");
418 MODULE_DESCRIPTION("Microchip / Atmel ECC (I2C) driver");
419 MODULE_LICENSE("GPL v2");