dfu: DFU backend implementation
authorLukasz Majewski <l.majewski@samsung.com>
Mon, 6 Aug 2012 12:41:07 +0000 (14:41 +0200)
committerMarek Vasut <marex@denx.de>
Sat, 1 Sep 2012 14:21:50 +0000 (16:21 +0200)
New, separate driver at ./drivers/dfu has been added. It allows platform
and storage independent operation of DFU.
It has been extended to use new MMC level of command abstraction.

Signed-off-by: Lukasz Majewski <l.majewski@samsung.com>
Signed-off-by: Kyungmin Park <kyungmin.park@samsung.com>
Cc: Marek Vasut <marex@denx.de>
Makefile
drivers/dfu/Makefile [new file with mode: 0644]
drivers/dfu/dfu.c [new file with mode: 0644]
include/dfu.h [new file with mode: 0644]

index a41b98705468627687d89787e4e7f9c58fcbd5df..cc15bfdc049f89664b9ad1ba3f9a45149c32535c 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -269,6 +269,7 @@ LIBS-y += drivers/pci/libpci.o
 LIBS-y += drivers/pcmcia/libpcmcia.o
 LIBS-y += drivers/power/libpower.o
 LIBS-y += drivers/spi/libspi.o
+LIBS-y += drivers/dfu/libdfu.o
 ifeq ($(CPU),mpc83xx)
 LIBS-y += drivers/qe/libqe.o
 LIBS-y += arch/powerpc/cpu/mpc8xxx/ddr/libddr.o
diff --git a/drivers/dfu/Makefile b/drivers/dfu/Makefile
new file mode 100644 (file)
index 0000000..7736485
--- /dev/null
@@ -0,0 +1,43 @@
+#
+# Copyright (C) 2012 Samsung Electronics
+# Lukasz Majewski <l.majewski@samsung.com>
+#
+# See file CREDITS for list of people who contributed to this
+# project.
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License as
+# published by the Free Software Foundation; either version 2 of
+# the License, or (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+# MA 02111-1307 USA
+#
+
+include $(TOPDIR)/config.mk
+
+LIB    = $(obj)libdfu.o
+
+COBJS-$(CONFIG_DFU_FUNCTION) += dfu.o
+
+SRCS    := $(COBJS-y:.o=.c)
+OBJS   := $(addprefix $(obj),$(COBJS-y))
+
+$(LIB):        $(obj).depend $(OBJS)
+       $(call cmd_link_o_target, $(OBJS))
+
+#########################################################################
+
+# defines $(obj).depend target
+include $(SRCTREE)/rules.mk
+
+sinclude $(obj).depend
+
+#########################################################################
diff --git a/drivers/dfu/dfu.c b/drivers/dfu/dfu.c
new file mode 100644 (file)
index 0000000..e8477fb
--- /dev/null
@@ -0,0 +1,238 @@
+/*
+ * dfu.c -- DFU back-end routines
+ *
+ * Copyright (C) 2012 Samsung Electronics
+ * author: Lukasz Majewski <l.majewski@samsung.com>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+#include <common.h>
+#include <malloc.h>
+#include <mmc.h>
+#include <fat.h>
+#include <dfu.h>
+#include <linux/list.h>
+#include <linux/compiler.h>
+
+static LIST_HEAD(dfu_list);
+static int dfu_alt_num;
+
+static int dfu_find_alt_num(const char *s)
+{
+       int i = 0;
+
+       for (; *s; s++)
+               if (*s == ';')
+                       i++;
+
+       return ++i;
+}
+
+static unsigned char __aligned(CONFIG_SYS_CACHELINE_SIZE)
+                                    dfu_buf[DFU_DATA_BUF_SIZE];
+
+int dfu_write(struct dfu_entity *dfu, void *buf, int size, int blk_seq_num)
+{
+       static unsigned char *i_buf;
+       static int i_blk_seq_num;
+       long w_size = 0;
+       int ret = 0;
+
+       debug("%s: name: %s buf: 0x%p size: 0x%x p_num: 0x%x i_buf: 0x%p\n",
+              __func__, dfu->name, buf, size, blk_seq_num, i_buf);
+
+       if (blk_seq_num == 0) {
+               i_buf = dfu_buf;
+               i_blk_seq_num = 0;
+       }
+
+       if (i_blk_seq_num++ != blk_seq_num) {
+               printf("%s: Wrong sequence number! [%d] [%d]\n",
+                      __func__, i_blk_seq_num, blk_seq_num);
+               return -1;
+       }
+
+       memcpy(i_buf, buf, size);
+       i_buf += size;
+
+       if (size == 0) {
+               /* Integrity check (if needed) */
+               debug("%s: %s %d [B] CRC32: 0x%x\n", __func__, dfu->name,
+                      i_buf - dfu_buf, crc32(0, dfu_buf, i_buf - dfu_buf));
+
+               w_size = i_buf - dfu_buf;
+               ret = dfu->write_medium(dfu, dfu_buf, &w_size);
+               if (ret)
+                       debug("%s: Write error!\n", __func__);
+
+               i_blk_seq_num = 0;
+               i_buf = NULL;
+               return ret;
+       }
+
+       return ret;
+}
+
+int dfu_read(struct dfu_entity *dfu, void *buf, int size, int blk_seq_num)
+{
+       static unsigned char *i_buf;
+       static int i_blk_seq_num;
+       static long r_size;
+       static u32 crc;
+       int ret = 0;
+
+       debug("%s: name: %s buf: 0x%p size: 0x%x p_num: 0x%x i_buf: 0x%p\n",
+              __func__, dfu->name, buf, size, blk_seq_num, i_buf);
+
+       if (blk_seq_num == 0) {
+               i_buf = dfu_buf;
+               ret = dfu->read_medium(dfu, i_buf, &r_size);
+               debug("%s: %s %ld [B]\n", __func__, dfu->name, r_size);
+               i_blk_seq_num = 0;
+               /* Integrity check (if needed) */
+               crc = crc32(0, dfu_buf, r_size);
+       }
+
+       if (i_blk_seq_num++ != blk_seq_num) {
+               printf("%s: Wrong sequence number! [%d] [%d]\n",
+                      __func__, i_blk_seq_num, blk_seq_num);
+               return -1;
+       }
+
+       if (r_size >= size) {
+               memcpy(buf, i_buf, size);
+               i_buf += size;
+               r_size -= size;
+               return size;
+       } else {
+               memcpy(buf, i_buf, r_size);
+               i_buf += r_size;
+               debug("%s: %s CRC32: 0x%x\n", __func__, dfu->name, crc);
+               puts("UPLOAD ... done\nCtrl+C to exit ...\n");
+
+               i_buf = NULL;
+               i_blk_seq_num = 0;
+               crc = 0;
+               return r_size;
+       }
+       return ret;
+}
+
+static int dfu_fill_entity(struct dfu_entity *dfu, char *s, int alt,
+                           char *interface, int num)
+{
+       char *st;
+
+       debug("%s: %s interface: %s num: %d\n", __func__, s, interface, num);
+       st = strsep(&s, " ");
+       strcpy(dfu->name, st);
+
+       dfu->dev_num = num;
+       dfu->alt = alt;
+
+       /* Specific for mmc device */
+       if (strcmp(interface, "mmc") == 0) {
+               if (dfu_fill_entity_mmc(dfu, s))
+                       return -1;
+       } else {
+               printf("%s: Device %s not (yet) supported!\n",
+                      __func__,  interface);
+               return -1;
+       }
+
+       return 0;
+}
+
+void dfu_free_entities(void)
+{
+       struct dfu_entity *dfu, *p, *t = NULL;
+
+       list_for_each_entry_safe_reverse(dfu, p, &dfu_list, list) {
+               list_del(&dfu->list);
+               t = dfu;
+       }
+       if (t)
+               free(t);
+       INIT_LIST_HEAD(&dfu_list);
+}
+
+int dfu_config_entities(char *env, char *interface, int num)
+{
+       struct dfu_entity *dfu;
+       int i, ret;
+       char *s;
+
+       dfu_alt_num = dfu_find_alt_num(env);
+       debug("%s: dfu_alt_num=%d\n", __func__, dfu_alt_num);
+
+       dfu = calloc(sizeof(*dfu), dfu_alt_num);
+       if (!dfu)
+               return -1;
+       for (i = 0; i < dfu_alt_num; i++) {
+
+               s = strsep(&env, ";");
+               ret = dfu_fill_entity(&dfu[i], s, i, interface, num);
+               if (ret)
+                       return -1;
+
+               list_add_tail(&dfu[i].list, &dfu_list);
+       }
+
+       return 0;
+}
+
+const char *dfu_get_dev_type(enum dfu_device_type t)
+{
+       const char *dev_t[] = {NULL, "eMMC", "OneNAND", "NAND" };
+       return dev_t[t];
+}
+
+const char *dfu_get_layout(enum dfu_layout l)
+{
+       const char *dfu_layout[] = {NULL, "RAW_ADDR", "FAT", "EXT2",
+                                          "EXT3", "EXT4" };
+       return dfu_layout[l];
+}
+
+void dfu_show_entities(void)
+{
+       struct dfu_entity *dfu;
+
+       puts("DFU alt settings list:\n");
+
+       list_for_each_entry(dfu, &dfu_list, list) {
+               printf("dev: %s alt: %d name: %s layout: %s\n",
+                      dfu_get_dev_type(dfu->dev_type), dfu->alt,
+                      dfu->name, dfu_get_layout(dfu->layout));
+       }
+}
+
+int dfu_get_alt_number(void)
+{
+       return dfu_alt_num;
+}
+
+struct dfu_entity *dfu_get_entity(int alt)
+{
+       struct dfu_entity *dfu;
+
+       list_for_each_entry(dfu, &dfu_list, list) {
+               if (dfu->alt == alt)
+                       return dfu;
+       }
+
+       return NULL;
+}
diff --git a/include/dfu.h b/include/dfu.h
new file mode 100644 (file)
index 0000000..5350d79
--- /dev/null
@@ -0,0 +1,103 @@
+/*
+ * dfu.h - DFU flashable area description
+ *
+ * Copyright (C) 2012 Samsung Electronics
+ * authors: Andrzej Pietrasiewicz <andrzej.p@samsung.com>
+ *         Lukasz Majewski <l.majewski@samsung.com>
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+#ifndef __DFU_ENTITY_H_
+#define __DFU_ENTITY_H_
+
+#include <common.h>
+#include <linux/list.h>
+#include <mmc.h>
+
+enum dfu_device_type {
+       DFU_DEV_MMC = 1,
+       DFU_DEV_ONENAND,
+       DFU_DEV_NAND,
+};
+
+enum dfu_layout {
+       DFU_RAW_ADDR = 1,
+       DFU_FS_FAT,
+       DFU_FS_EXT2,
+       DFU_FS_EXT3,
+       DFU_FS_EXT4,
+};
+
+struct mmc_internal_data {
+       /* RAW programming */
+       unsigned int lba_start;
+       unsigned int lba_size;
+       unsigned int lba_blk_size;
+
+       /* FAT/EXT */
+       unsigned int dev;
+       unsigned int part;
+};
+
+static inline unsigned int get_mmc_blk_size(int dev)
+{
+       return find_mmc_device(dev)->read_bl_len;
+}
+
+#define DFU_NAME_SIZE 32
+#define DFU_CMD_BUF_SIZE 128
+#define DFU_DATA_BUF_SIZE (1024*1024*4) /* 4 MiB */
+
+struct dfu_entity {
+       char                    name[DFU_NAME_SIZE];
+       int                     alt;
+       void                    *dev_private;
+       int                     dev_num;
+       enum dfu_device_type    dev_type;
+       enum dfu_layout         layout;
+
+       union {
+               struct mmc_internal_data mmc;
+       } data;
+
+       int (*read_medium)(struct dfu_entity *dfu, void *buf, long *len);
+       int (*write_medium)(struct dfu_entity *dfu, void *buf, long *len);
+
+       struct list_head list;
+};
+
+int dfu_config_entities(char *s, char *interface, int num);
+void dfu_free_entities(void);
+void dfu_show_entities(void);
+int dfu_get_alt_number(void);
+const char *dfu_get_dev_type(enum dfu_device_type t);
+const char *dfu_get_layout(enum dfu_layout l);
+struct dfu_entity *dfu_get_entity(int alt);
+char *dfu_extract_token(char** e, int *n);
+
+int dfu_read(struct dfu_entity *de, void *buf, int size, int blk_seq_num);
+int dfu_write(struct dfu_entity *de, void *buf, int size, int blk_seq_num);
+/* Device specific */
+#ifdef CONFIG_DFU_MMC
+extern int dfu_fill_entity_mmc(struct dfu_entity *dfu, char *s);
+#else
+static inline int dfu_fill_entity_mmc(struct dfu_entity *dfu, char *s)
+{
+       puts("MMC support not available!\n");
+       return -1;
+}
+#endif
+#endif /* __DFU_ENTITY_H_ */