Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 1 | /* |
| 2 | * This file is part of the flashrom project. |
| 3 | * |
| 4 | * Copyright (C) 2008 Claus Gindhart <claus.gindhart@kontron.com> |
| 5 | * |
| 6 | * This program is free software; you can redistribute it and/or modify |
| 7 | * it under the terms of the GNU General Public License as published by |
| 8 | * the Free Software Foundation; either version 2 of the License, or |
| 9 | * (at your option) any later version. |
| 10 | * |
| 11 | * This program is distributed in the hope that it will be useful, |
| 12 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 14 | * GNU General Public License for more details. |
| 15 | * |
| 16 | * You should have received a copy of the GNU General Public License |
| 17 | * along with this program; if not, write to the Free Software |
| 18 | * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 19 | */ |
| 20 | |
| 21 | /* |
| 22 | * This module is designed for supporting the devices |
| 23 | * ST M50FLW040A (not yet tested) |
| 24 | * ST M50FLW040B (not yet tested) |
| 25 | * ST M50FLW080A |
| 26 | * ST M50FLW080B (not yet tested) |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 27 | */ |
| 28 | |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 29 | #include <string.h> |
Carl-Daniel Hailfinger | 0bd2a2b | 2009-06-05 18:32:07 +0000 | [diff] [blame] | 30 | #include <stdlib.h> |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 31 | #include "flash.h" |
| 32 | |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 33 | void protect_stm50flw0x0x(chipaddr bios) |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 34 | { |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 35 | chip_writeb(0xAA, bios + 0x5555); |
| 36 | chip_writeb(0x55, bios + 0x2AAA); |
| 37 | chip_writeb(0xA0, bios + 0x5555); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 38 | |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 39 | programmer_delay(200); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 40 | } |
| 41 | |
| 42 | int probe_stm50flw0x0x(struct flashchip *flash) |
| 43 | { |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 44 | chipaddr bios = flash->virtual_memory; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 45 | uint8_t id1, id2; |
| 46 | uint32_t largeid1, largeid2; |
| 47 | |
| 48 | /* Issue JEDEC Product ID Entry command */ |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 49 | chip_writeb(0xAA, bios + 0x5555); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 50 | programmer_delay(10); |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 51 | chip_writeb(0x55, bios + 0x2AAA); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 52 | programmer_delay(10); |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 53 | chip_writeb(0x90, bios + 0x5555); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 54 | programmer_delay(40); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 55 | |
| 56 | /* Read product ID */ |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 57 | id1 = chip_readb(bios); |
| 58 | id2 = chip_readb(bios + 0x01); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 59 | largeid1 = id1; |
| 60 | largeid2 = id2; |
| 61 | |
| 62 | /* Check if it is a continuation ID, this should be a while loop. */ |
| 63 | if (id1 == 0x7F) { |
| 64 | largeid1 <<= 8; |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 65 | id1 = chip_readb(bios + 0x100); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 66 | largeid1 |= id1; |
| 67 | } |
| 68 | if (id2 == 0x7F) { |
| 69 | largeid2 <<= 8; |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 70 | id2 = chip_readb(bios + 0x101); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 71 | largeid2 |= id2; |
| 72 | } |
| 73 | |
| 74 | /* Issue JEDEC Product ID Exit command */ |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 75 | chip_writeb(0xAA, bios + 0x5555); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 76 | programmer_delay(10); |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 77 | chip_writeb(0x55, bios + 0x2AAA); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 78 | programmer_delay(10); |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 79 | chip_writeb(0xF0, bios + 0x5555); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 80 | programmer_delay(40); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 81 | |
Peter Stuge | 5cafc33 | 2009-01-25 23:52:45 +0000 | [diff] [blame] | 82 | printf_debug("%s: id1 0x%02x, id2 0x%02x\n", __FUNCTION__, largeid1, |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 83 | largeid2); |
| 84 | |
| 85 | if (largeid1 != flash->manufacture_id || largeid2 != flash->model_id) |
| 86 | return 0; |
| 87 | |
| 88 | map_flash_registers(flash); |
| 89 | |
| 90 | return 1; |
| 91 | } |
| 92 | |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 93 | static void wait_stm50flw0x0x(chipaddr bios) |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 94 | { |
| 95 | uint8_t id1; |
| 96 | // id2; |
| 97 | |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 98 | chip_writeb(0x70, bios); |
| 99 | if ((chip_readb(bios) & 0x80) == 0) { // it's busy |
| 100 | while ((chip_readb(bios) & 0x80) == 0) ; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 101 | } |
| 102 | // put another command to get out of status register mode |
| 103 | |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 104 | chip_writeb(0x90, bios); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 105 | programmer_delay(10); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 106 | |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 107 | id1 = chip_readb(bios); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 108 | |
| 109 | // this is needed to jam it out of "read id" mode |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 110 | chip_writeb(0xAA, bios + 0x5555); |
| 111 | chip_writeb(0x55, bios + 0x2AAA); |
| 112 | chip_writeb(0xF0, bios + 0x5555); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 113 | } |
| 114 | |
| 115 | /* |
| 116 | * claus.gindhart@kontron.com |
| 117 | * The ST M50FLW080B and STM50FLW080B chips have to be unlocked, |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 118 | * before you can erase them or write to them. |
| 119 | */ |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 120 | int unlock_block_stm50flw0x0x(struct flashchip *flash, int offset) |
| 121 | { |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 122 | chipaddr wrprotect = flash->virtual_registers + 2; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 123 | const uint8_t unlock_sector = 0x00; |
| 124 | int j; |
| 125 | |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 126 | /* |
| 127 | * These chips have to be unlocked before you can erase them or write |
| 128 | * to them. The size of the locking sectors depends on the type |
| 129 | * of chip. |
| 130 | * |
| 131 | * Sometimes, the BIOS does this for you; so you propably |
| 132 | * don't need to worry about that. |
| 133 | */ |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 134 | |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 135 | /* Check, if it's is a top/bottom-block with 4k-sectors. */ |
| 136 | /* TODO: What about the other types? */ |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 137 | if ((offset == 0) || |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 138 | (offset == (flash->model_id == ST_M50FLW080A ? 0xE0000 : 0x10000)) |
| 139 | || (offset == 0xF0000)) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 140 | |
| 141 | // unlock each 4k-sector |
| 142 | for (j = 0; j < 0x10000; j += 0x1000) { |
| 143 | printf_debug("unlocking at 0x%x\n", offset + j); |
Carl-Daniel Hailfinger | d13775e | 2009-05-11 20:04:30 +0000 | [diff] [blame] | 144 | chip_writeb(unlock_sector, wrprotect + offset + j); |
| 145 | if (chip_readb(wrprotect + offset + j) != unlock_sector) { |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 146 | printf("Cannot unlock sector @ 0x%x\n", |
| 147 | offset + j); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 148 | return -1; |
| 149 | } |
| 150 | } |
| 151 | } else { |
| 152 | printf_debug("unlocking at 0x%x\n", offset); |
Carl-Daniel Hailfinger | d13775e | 2009-05-11 20:04:30 +0000 | [diff] [blame] | 153 | chip_writeb(unlock_sector, wrprotect + offset); |
| 154 | if (chip_readb(wrprotect + offset) != unlock_sector) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 155 | printf("Cannot unlock sector @ 0x%x\n", offset); |
| 156 | return -1; |
| 157 | } |
| 158 | } |
| 159 | |
| 160 | return 0; |
| 161 | } |
| 162 | |
| 163 | int erase_block_stm50flw0x0x(struct flashchip *flash, int offset) |
| 164 | { |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 165 | chipaddr bios = flash->virtual_memory + offset; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 166 | int j; |
| 167 | |
| 168 | // clear status register |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 169 | chip_writeb(0x50, bios); |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 170 | printf_debug("Erase at 0x%lx\n", bios); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 171 | // now start it |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 172 | chip_writeb(0x20, bios); |
| 173 | chip_writeb(0xd0, bios); |
Carl-Daniel Hailfinger | ca8bfc6 | 2009-06-05 17:48:08 +0000 | [diff] [blame] | 174 | programmer_delay(10); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 175 | |
| 176 | wait_stm50flw0x0x(flash->virtual_memory); |
| 177 | |
| 178 | for (j = 0; j < flash->page_size; j++) { |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 179 | if (chip_readb(bios + j) != 0xFF) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 180 | printf("Erase failed at 0x%x\n", offset + j); |
| 181 | return -1; |
| 182 | } |
| 183 | } |
| 184 | |
| 185 | printf("DONE BLOCK 0x%x\n", offset); |
| 186 | |
| 187 | return 0; |
| 188 | } |
| 189 | |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 190 | int write_page_stm50flw0x0x(chipaddr bios, uint8_t *src, |
| 191 | chipaddr dst, int page_size) |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 192 | { |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 193 | int i, rc = 0; |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 194 | chipaddr d = dst; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 195 | uint8_t *s = src; |
| 196 | |
| 197 | /* transfer data from source to destination */ |
| 198 | for (i = 0; i < page_size; i++) { |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 199 | chip_writeb(0x40, dst); |
| 200 | chip_writeb(*src++, dst++); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 201 | wait_stm50flw0x0x(bios); |
| 202 | } |
| 203 | |
| 204 | /* claus.gindhart@kontron.com |
| 205 | * TODO |
| 206 | * I think, that verification is not required, but |
| 207 | * i leave it in anyway |
| 208 | */ |
| 209 | dst = d; |
| 210 | src = s; |
| 211 | for (i = 0; i < page_size; i++) { |
Carl-Daniel Hailfinger | 0472f3d | 2009-03-06 22:26:00 +0000 | [diff] [blame] | 212 | if (chip_readb(dst) != *src) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 213 | rc = -1; |
| 214 | break; |
| 215 | } |
| 216 | dst++; |
| 217 | src++; |
| 218 | } |
| 219 | |
| 220 | if (rc) { |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 221 | fprintf(stderr, " page 0x%lx failed!\n", |
| 222 | (d - bios) / page_size); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 223 | } |
| 224 | |
| 225 | return rc; |
| 226 | } |
| 227 | |
| 228 | /* I simply erase block by block |
| 229 | * I Chip This is not the fastest way, but it works |
| 230 | */ |
| 231 | int erase_stm50flw0x0x(struct flashchip *flash) |
| 232 | { |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 233 | int i, rc = 0; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 234 | int total_size = flash->total_size * 1024; |
| 235 | int page_size = flash->page_size; |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 236 | chipaddr bios = flash->virtual_memory; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 237 | |
| 238 | printf("Erasing page:\n"); |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 239 | for (i = 0; (i < total_size / page_size) && (rc == 0); i++) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 240 | printf |
| 241 | ("\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b"); |
| 242 | printf("%04d at address: 0x%08x ", i, i * page_size); |
| 243 | rc = unlock_block_stm50flw0x0x(flash, i * page_size); |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 244 | if (!rc) |
| 245 | rc = erase_block_stm50flw0x0x(flash, i * page_size); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 246 | } |
| 247 | printf("\n"); |
| 248 | protect_stm50flw0x0x(bios); |
| 249 | |
| 250 | return rc; |
| 251 | } |
| 252 | |
| 253 | int write_stm50flw0x0x(struct flashchip *flash, uint8_t * buf) |
| 254 | { |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 255 | int i, rc = 0; |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 256 | int total_size = flash->total_size * 1024; |
| 257 | int page_size = flash->page_size; |
Carl-Daniel Hailfinger | 5820f42 | 2009-05-16 21:22:56 +0000 | [diff] [blame] | 258 | chipaddr bios = flash->virtual_memory; |
Carl-Daniel Hailfinger | 0bd2a2b | 2009-06-05 18:32:07 +0000 | [diff] [blame] | 259 | uint8_t *tmpbuf = malloc(page_size); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 260 | |
Carl-Daniel Hailfinger | 0bd2a2b | 2009-06-05 18:32:07 +0000 | [diff] [blame] | 261 | if (!tmpbuf) { |
| 262 | printf("Could not allocate memory!\n"); |
| 263 | exit(1); |
| 264 | } |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 265 | printf("Programming page: \n"); |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 266 | for (i = 0; (i < total_size / page_size) && (rc == 0); i++) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 267 | printf |
| 268 | ("\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b\b"); |
| 269 | printf("%04d at address: 0x%08x ", i, i * page_size); |
| 270 | |
| 271 | /* Auto Skip Blocks, which already contain the desired data |
| 272 | * Faster, because we only write, what has changed |
| 273 | * More secure, because blocks, which are excluded |
| 274 | * (with the exclude or layout feature) |
| 275 | * are not erased and rewritten; data is retained also |
| 276 | * in sudden power off situations |
| 277 | */ |
Carl-Daniel Hailfinger | 0bd2a2b | 2009-06-05 18:32:07 +0000 | [diff] [blame] | 278 | chip_readn(tmpbuf, bios + i * page_size, page_size); |
| 279 | if (!memcmp((void *)(buf + i * page_size), tmpbuf, page_size)) { |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 280 | printf("SKIPPED\n"); |
| 281 | continue; |
| 282 | } |
| 283 | |
| 284 | rc = unlock_block_stm50flw0x0x(flash, i * page_size); |
Uwe Hermann | 394131e | 2008-10-18 21:14:13 +0000 | [diff] [blame] | 285 | if (!rc) |
| 286 | rc = erase_block_stm50flw0x0x(flash, i * page_size); |
| 287 | if (!rc) |
| 288 | write_page_stm50flw0x0x(bios, buf + i * page_size, |
| 289 | bios + i * page_size, page_size); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 290 | } |
| 291 | printf("\n"); |
| 292 | protect_stm50flw0x0x(bios); |
Carl-Daniel Hailfinger | 0bd2a2b | 2009-06-05 18:32:07 +0000 | [diff] [blame] | 293 | free(tmpbuf); |
Claus Gindhart | a7b3551 | 2008-04-28 17:51:09 +0000 | [diff] [blame] | 294 | |
| 295 | return rc; |
| 296 | } |