/src/fwupd/plugins/wacom-usb/fu-wacom-usb-firmware.c
Line | Count | Source |
1 | | /* |
2 | | * Copyright 2018 Richard Hughes <richard@hughsie.com> |
3 | | * |
4 | | * SPDX-License-Identifier: LGPL-2.1-or-later |
5 | | */ |
6 | | |
7 | | #include "config.h" |
8 | | |
9 | | #include <string.h> |
10 | | |
11 | | #include "fu-wacom-usb-firmware.h" |
12 | | #include "fu-wacom-usb-struct.h" |
13 | | |
14 | | struct _FuWacomUsbFirmware { |
15 | | FuFirmware parent_instance; |
16 | | }; |
17 | | |
18 | 2.05k | G_DEFINE_TYPE(FuWacomUsbFirmware, fu_wacom_usb_firmware, FU_TYPE_FIRMWARE) |
19 | 2.05k | |
20 | 1.84M | #define FU_WACOM_USB_FIRMWARE_TOKENS_MAX 100000 /* lines */ |
21 | 1.66k | #define FU_WACOM_USB_FIRMWARE_SECTIONS_MAX 10 |
22 | | |
23 | | typedef struct { |
24 | | guint32 addr; |
25 | | guint32 sz; |
26 | | guint32 prog_start_addr; |
27 | | } FuFirmwareWacHeaderRecord; |
28 | | |
29 | | typedef struct { |
30 | | FuFirmware *firmware; |
31 | | FuFirmwareParseFlags flags; |
32 | | GPtrArray *header_infos; |
33 | | GString *image_buffer; |
34 | | guint8 images_cnt; |
35 | | } FuWacomUsbFirmwareTokenHelper; |
36 | | |
37 | | static gboolean |
38 | | fu_wacom_usb_firmware_tokenize_cb(GString *token, |
39 | | guint token_idx, |
40 | | gpointer user_data, |
41 | | GError **error) |
42 | 1.84M | { |
43 | 1.84M | FuWacomUsbFirmwareTokenHelper *helper = (FuWacomUsbFirmwareTokenHelper *)user_data; |
44 | 1.84M | g_autofree gchar *cmd = NULL; |
45 | | |
46 | | /* sanity check */ |
47 | 1.84M | if (token_idx > FU_WACOM_USB_FIRMWARE_TOKENS_MAX) { |
48 | 1 | g_set_error_literal(error, |
49 | 1 | FWUPD_ERROR, |
50 | 1 | FWUPD_ERROR_INVALID_DATA, |
51 | 1 | "file has too many lines"); |
52 | 1 | return FALSE; |
53 | 1 | } |
54 | | |
55 | | /* remove WIN32 line endings */ |
56 | 1.84M | g_strdelimit(token->str, "\r\x1a", '\0'); |
57 | 1.84M | token->len = strlen(token->str); |
58 | | |
59 | | /* ignore blank lines */ |
60 | 1.84M | cmd = g_strndup(token->str, 2); |
61 | 1.84M | if (g_strcmp0(cmd, "") == 0) |
62 | 1.25M | return TRUE; |
63 | | |
64 | | /* custom metadata */ |
65 | 590k | if (g_strcmp0(cmd, "WA") == 0) { |
66 | | /* header info record */ |
67 | 4.51k | if (token->len > 3 && memcmp(token->str + 2, "COM", 3) == 0) { |
68 | 1.79k | guint8 header_image_cnt = 0; |
69 | 1.79k | if (token->len != 40) { |
70 | 134 | g_set_error(error, |
71 | 134 | FWUPD_ERROR, |
72 | 134 | FWUPD_ERROR_INTERNAL, |
73 | 134 | "invalid header, got %" G_GSIZE_FORMAT " bytes", |
74 | 134 | token->len); |
75 | 134 | return FALSE; |
76 | 134 | } |
77 | | |
78 | | /* sanity check */ |
79 | 1.66k | if (helper->header_infos->len > FU_WACOM_USB_FIRMWARE_SECTIONS_MAX) { |
80 | 2 | g_set_error(error, |
81 | 2 | FWUPD_ERROR, |
82 | 2 | FWUPD_ERROR_INTERNAL, |
83 | 2 | "too many metadata sections: %u", |
84 | 2 | helper->header_infos->len); |
85 | 2 | return FALSE; |
86 | 2 | } |
87 | 1.66k | if (!fu_firmware_strparse_uint4_safe(token->str, |
88 | 1.66k | token->len, |
89 | 1.66k | 5, |
90 | 1.66k | &header_image_cnt, |
91 | 1.66k | error)) |
92 | 1 | return FALSE; |
93 | 3.90k | for (guint j = 0; j < header_image_cnt; j++) { |
94 | 2.30k | g_autofree FuFirmwareWacHeaderRecord *hdr = NULL; |
95 | 2.30k | hdr = g_new0(FuFirmwareWacHeaderRecord, 1); |
96 | 2.30k | if (!fu_firmware_strparse_uint32_safe(token->str, |
97 | 2.30k | token->len, |
98 | 2.30k | (j * 16) + 6, |
99 | 2.30k | &hdr->addr, |
100 | 2.30k | error)) |
101 | 40 | return FALSE; |
102 | 2.26k | if (!fu_firmware_strparse_uint32_safe(token->str, |
103 | 2.26k | token->len, |
104 | 2.26k | (j * 16) + 14, |
105 | 2.26k | &hdr->sz, |
106 | 2.26k | error)) |
107 | 18 | return FALSE; |
108 | 2.24k | g_debug("header_fw%u_addr: 0x%x", j, hdr->addr); |
109 | 2.24k | g_debug("header_fw%u_sz: 0x%x", j, hdr->sz); |
110 | 2.24k | g_ptr_array_add(helper->header_infos, g_steal_pointer(&hdr)); |
111 | 2.24k | } |
112 | 1.60k | return TRUE; |
113 | 1.66k | } |
114 | | |
115 | | /* firmware headline record */ |
116 | 2.71k | if (token->len == 13) { |
117 | 579 | FuFirmwareWacHeaderRecord *hdr; |
118 | 579 | guint8 idx = 0; |
119 | 579 | if (!fu_firmware_strparse_uint4_safe(token->str, |
120 | 579 | token->len, |
121 | 579 | 2, |
122 | 579 | &idx, |
123 | 579 | error)) |
124 | 8 | return FALSE; |
125 | 571 | if (idx == 0) { |
126 | 1 | g_set_error(error, |
127 | 1 | FWUPD_ERROR, |
128 | 1 | FWUPD_ERROR_INTERNAL, |
129 | 1 | "headline %u invalid", |
130 | 1 | idx); |
131 | 1 | return FALSE; |
132 | 1 | } |
133 | 570 | if (idx > helper->header_infos->len) { |
134 | 4 | g_set_error(error, |
135 | 4 | FWUPD_ERROR, |
136 | 4 | FWUPD_ERROR_INTERNAL, |
137 | 4 | "headline %u exceeds header count %u", |
138 | 4 | idx, |
139 | 4 | helper->header_infos->len); |
140 | 4 | return FALSE; |
141 | 4 | } |
142 | 566 | if (idx - 1 != helper->images_cnt) { |
143 | 8 | g_set_error(error, |
144 | 8 | FWUPD_ERROR, |
145 | 8 | FWUPD_ERROR_INTERNAL, |
146 | 8 | "headline %u is not in sorted order", |
147 | 8 | idx); |
148 | 8 | return FALSE; |
149 | 8 | } |
150 | 558 | hdr = g_ptr_array_index(helper->header_infos, idx - 1); |
151 | 558 | if (!fu_firmware_strparse_uint32_safe(token->str, |
152 | 558 | token->len, |
153 | 558 | 3, |
154 | 558 | &hdr->prog_start_addr, |
155 | 558 | error)) |
156 | 1 | return FALSE; |
157 | 557 | if (hdr->prog_start_addr != hdr->addr) { |
158 | 50 | g_set_error(error, |
159 | 50 | FWUPD_ERROR, |
160 | 50 | FWUPD_ERROR_INTERNAL, |
161 | 50 | "programming address 0x%x != " |
162 | 50 | "base address 0x%0x for idx %u", |
163 | 50 | hdr->prog_start_addr, |
164 | 50 | hdr->addr, |
165 | 50 | idx); |
166 | 50 | return FALSE; |
167 | 50 | } |
168 | 507 | g_debug("programing-start-address: 0x%x", hdr->prog_start_addr); |
169 | 507 | return TRUE; |
170 | 557 | } |
171 | | |
172 | 2.14k | g_debug("unknown Wacom-specific metadata"); |
173 | 2.14k | return TRUE; |
174 | 2.71k | } |
175 | | |
176 | | /* start */ |
177 | 585k | if (g_strcmp0(cmd, "S0") == 0) { |
178 | 2.02k | if (helper->image_buffer->len > 0) { |
179 | 25 | g_set_error_literal(error, |
180 | 25 | FWUPD_ERROR, |
181 | 25 | FWUPD_ERROR_INTERNAL, |
182 | 25 | "duplicate S0 without S7"); |
183 | 25 | return FALSE; |
184 | 25 | } |
185 | 1.99k | g_string_append_printf(helper->image_buffer, "%s\n", token->str); |
186 | 1.99k | return TRUE; |
187 | 2.02k | } |
188 | | |
189 | | /* these are things we want to include in the image */ |
190 | 583k | if (g_strcmp0(cmd, "S1") == 0 || g_strcmp0(cmd, "S2") == 0 || g_strcmp0(cmd, "S3") == 0 || |
191 | 8.00k | g_strcmp0(cmd, "S5") == 0 || g_strcmp0(cmd, "S7") == 0 || g_strcmp0(cmd, "S8") == 0 || |
192 | 583k | g_strcmp0(cmd, "S9") == 0) { |
193 | 583k | if (helper->image_buffer->len == 0) { |
194 | 22 | g_set_error(error, FWUPD_ERROR, FWUPD_ERROR_INTERNAL, "%s without S0", cmd); |
195 | 22 | return FALSE; |
196 | 22 | } |
197 | 583k | g_string_append_printf(helper->image_buffer, "%s\n", token->str); |
198 | 583k | } else { |
199 | 85 | g_set_error(error, |
200 | 85 | FWUPD_ERROR, |
201 | 85 | FWUPD_ERROR_INTERNAL, |
202 | 85 | "invalid SREC command on line %u: %s", |
203 | 85 | token_idx + 1, |
204 | 85 | cmd); |
205 | 85 | return FALSE; |
206 | 85 | } |
207 | | |
208 | | /* end */ |
209 | 583k | if (g_strcmp0(cmd, "S7") == 0) { |
210 | 1.71k | g_autoptr(GBytes) blob = NULL; |
211 | 1.71k | g_autoptr(GBytes) fw_srec = NULL; |
212 | 1.71k | g_autoptr(FuFirmware) firmware_srec = fu_srec_firmware_new(); |
213 | 1.71k | g_autoptr(FuFirmware) img = fu_firmware_new(); |
214 | 1.71k | FuFirmwareWacHeaderRecord *hdr; |
215 | | |
216 | | /* get the correct relocated start address */ |
217 | 1.71k | if (helper->images_cnt >= helper->header_infos->len) { |
218 | 25 | g_set_error(error, |
219 | 25 | FWUPD_ERROR, |
220 | 25 | FWUPD_ERROR_INTERNAL, |
221 | 25 | "%s without header", |
222 | 25 | cmd); |
223 | 25 | return FALSE; |
224 | 25 | } |
225 | 1.69k | hdr = g_ptr_array_index(helper->header_infos, helper->images_cnt); |
226 | | |
227 | 1.69k | if (helper->image_buffer->len == 0) { |
228 | 0 | g_set_error(error, |
229 | 0 | FWUPD_ERROR, |
230 | 0 | FWUPD_ERROR_INTERNAL, |
231 | 0 | "%s with missing image buffer", |
232 | 0 | cmd); |
233 | 0 | return FALSE; |
234 | 0 | } |
235 | | |
236 | | /* parse SREC file and add as image */ |
237 | 1.69k | blob = g_bytes_new(helper->image_buffer->str, helper->image_buffer->len); |
238 | 1.69k | fu_srec_firmware_set_addr_min(FU_SREC_FIRMWARE(firmware_srec), hdr->addr); |
239 | 1.69k | if (!fu_firmware_parse_bytes(firmware_srec, |
240 | 1.69k | blob, |
241 | 1.69k | 0x0, |
242 | 1.69k | helper->flags | FU_FIRMWARE_PARSE_FLAG_NO_SEARCH, |
243 | 1.69k | error)) |
244 | 361 | return FALSE; |
245 | 1.33k | fw_srec = fu_firmware_get_bytes(firmware_srec, error); |
246 | 1.33k | if (fw_srec == NULL) |
247 | 0 | return FALSE; |
248 | 1.33k | fu_firmware_set_bytes(img, fw_srec); |
249 | 1.33k | fu_firmware_set_addr(img, fu_firmware_get_addr(firmware_srec)); |
250 | 1.33k | fu_firmware_set_idx(img, helper->images_cnt); |
251 | 1.33k | if (!fu_firmware_add_image(helper->firmware, img, error)) |
252 | 0 | return FALSE; |
253 | 1.33k | helper->images_cnt++; |
254 | | |
255 | | /* clear the image buffer */ |
256 | 1.33k | g_string_set_size(helper->image_buffer, 0); |
257 | 1.33k | } |
258 | | |
259 | | /* success */ |
260 | 583k | return TRUE; |
261 | 583k | } |
262 | | |
263 | | static gboolean |
264 | | fu_wacom_usb_firmware_validate(FuFirmware *firmware, |
265 | | GInputStream *stream, |
266 | | gsize offset, |
267 | | GError **error) |
268 | 289k | { |
269 | 289k | return fu_struct_wacom_usb_firmware_hdr_validate_stream(stream, offset, error); |
270 | 289k | } |
271 | | |
272 | | static gboolean |
273 | | fu_wacom_usb_firmware_parse(FuFirmware *firmware, |
274 | | GInputStream *stream, |
275 | | FuFirmwareParseFlags flags, |
276 | | GError **error) |
277 | 1.89k | { |
278 | 1.89k | g_autoptr(GPtrArray) header_infos = g_ptr_array_new_with_free_func(g_free); |
279 | 1.89k | g_autoptr(GString) image_buffer = g_string_new(NULL); |
280 | 1.89k | FuWacomUsbFirmwareTokenHelper helper = {.firmware = firmware, |
281 | 1.89k | .flags = flags, |
282 | 1.89k | .header_infos = header_infos, |
283 | 1.89k | .image_buffer = image_buffer, |
284 | 1.89k | .images_cnt = 0}; |
285 | | |
286 | | /* tokenize */ |
287 | 1.89k | if (!fu_strsplit_stream(stream, |
288 | 1.89k | 0x0, |
289 | 1.89k | "\n", |
290 | 1.89k | fu_wacom_usb_firmware_tokenize_cb, |
291 | 1.89k | &helper, |
292 | 1.89k | error)) |
293 | 786 | return FALSE; |
294 | | |
295 | | /* verify data is complete */ |
296 | 1.11k | if (helper.image_buffer->len > 0) { |
297 | 236 | g_set_error_literal(error, |
298 | 236 | FWUPD_ERROR, |
299 | 236 | FWUPD_ERROR_INTERNAL, |
300 | 236 | "truncated data: no S7"); |
301 | 236 | return FALSE; |
302 | 236 | } |
303 | | |
304 | | /* ensure this matched the header */ |
305 | 876 | if (helper.header_infos->len != helper.images_cnt) { |
306 | 65 | g_set_error(error, |
307 | 65 | FWUPD_ERROR, |
308 | 65 | FWUPD_ERROR_INTERNAL, |
309 | 65 | "not enough images %u for header count %u", |
310 | 65 | helper.images_cnt, |
311 | 65 | header_infos->len); |
312 | 65 | return FALSE; |
313 | 65 | } |
314 | | |
315 | | /* success */ |
316 | 811 | return TRUE; |
317 | 876 | } |
318 | | |
319 | | static guint8 |
320 | | fu_wacom_usb_firmware_calc_checksum(GByteArray *buf) |
321 | 867 | { |
322 | 867 | return fu_sum8(buf->data, buf->len) ^ 0xFF; |
323 | 867 | } |
324 | | |
325 | | static GByteArray * |
326 | | fu_wacom_usb_firmware_write(FuFirmware *firmware, GError **error) |
327 | 811 | { |
328 | 811 | g_autoptr(GPtrArray) images = fu_firmware_get_images(firmware); |
329 | 811 | g_autoptr(GString) str = g_string_new(NULL); |
330 | 811 | g_autoptr(GByteArray) buf = g_byte_array_new(); |
331 | 811 | g_autoptr(GByteArray) buf_hdr = g_byte_array_new(); |
332 | | |
333 | | /* fw header */ |
334 | 811 | if (images->len == 0) { |
335 | 542 | g_set_error_literal(error, |
336 | 542 | FWUPD_ERROR, |
337 | 542 | FWUPD_ERROR_NOT_SUPPORTED, |
338 | 542 | "no firmware images found"); |
339 | 542 | return NULL; |
340 | 542 | } |
341 | 867 | for (guint i = 0; i < images->len; i++) { |
342 | 598 | FuFirmware *img = g_ptr_array_index(images, i); |
343 | 598 | fu_byte_array_append_uint32(buf_hdr, fu_firmware_get_addr(img), G_BIG_ENDIAN); |
344 | 598 | fu_byte_array_append_uint32(buf_hdr, fu_firmware_get_size(img), G_BIG_ENDIAN); |
345 | 598 | } |
346 | 269 | g_string_append_printf(str, "WACOM%u", images->len); |
347 | 5.05k | for (guint i = 0; i < buf_hdr->len; i++) |
348 | 4.78k | g_string_append_printf(str, "%02X", buf_hdr->data[i]); |
349 | 269 | g_string_append_printf(str, "%02X\n", fu_wacom_usb_firmware_calc_checksum(buf_hdr)); |
350 | | |
351 | | /* payload */ |
352 | 867 | for (guint i = 0; i < images->len; i++) { |
353 | 598 | FuFirmware *img = g_ptr_array_index(images, i); |
354 | 598 | g_autoptr(GBytes) img_blob = NULL; |
355 | 598 | g_autoptr(GByteArray) buf_img = g_byte_array_new(); |
356 | | |
357 | | /* img header */ |
358 | 598 | g_string_append_printf(str, "WA%u", (guint)fu_firmware_get_idx(img) + 1); |
359 | 598 | fu_byte_array_append_uint32(buf_img, fu_firmware_get_addr(img), G_BIG_ENDIAN); |
360 | 2.99k | for (guint j = 0; j < buf_img->len; j++) |
361 | 2.39k | g_string_append_printf(str, "%02X", buf_img->data[j]); |
362 | 598 | g_string_append_printf(str, "%02X\n", fu_wacom_usb_firmware_calc_checksum(buf_img)); |
363 | | |
364 | | /* srec */ |
365 | 598 | img_blob = fu_firmware_write(img, error); |
366 | 598 | if (img_blob == NULL) |
367 | 0 | return NULL; |
368 | 598 | g_string_append_len(str, |
369 | 598 | (const gchar *)g_bytes_get_data(img_blob, NULL), |
370 | 598 | g_bytes_get_size(img_blob)); |
371 | 598 | } |
372 | | |
373 | | /* success */ |
374 | 269 | g_byte_array_append(buf, (const guint8 *)str->str, str->len); |
375 | 269 | return g_steal_pointer(&buf); |
376 | 269 | } |
377 | | |
378 | | static void |
379 | | fu_wacom_usb_firmware_init(FuWacomUsbFirmware *self) |
380 | 2.05k | { |
381 | 2.05k | fu_firmware_set_images_max(FU_FIRMWARE(self), 1024); |
382 | 2.05k | fu_firmware_add_image_gtype(FU_FIRMWARE(self), FU_TYPE_FIRMWARE); |
383 | 2.05k | fu_firmware_add_image_gtype(FU_FIRMWARE(self), FU_TYPE_SREC_FIRMWARE); |
384 | 2.05k | } |
385 | | |
386 | | static void |
387 | | fu_wacom_usb_firmware_class_init(FuWacomUsbFirmwareClass *klass) |
388 | 1 | { |
389 | 1 | FuFirmwareClass *firmware_class = FU_FIRMWARE_CLASS(klass); |
390 | 1 | firmware_class->validate = fu_wacom_usb_firmware_validate; |
391 | 1 | firmware_class->parse = fu_wacom_usb_firmware_parse; |
392 | 1 | firmware_class->write = fu_wacom_usb_firmware_write; |
393 | 1 | } |
394 | | |
395 | | FuFirmware * |
396 | | fu_wacom_usb_firmware_new(void) |
397 | 0 | { |
398 | 0 | return FU_FIRMWARE(g_object_new(FU_TYPE_WACOM_USB_FIRMWARE, NULL)); |
399 | 0 | } |