]> sigrok.org Git - libsigrok.git/blame - session_file.c
Centralise duplicated logging helper defines.
[libsigrok.git] / session_file.c
CommitLineData
7d658874 1/*
50985c20 2 * This file is part of the libsigrok project.
7d658874 3 *
13d8e03c 4 * Copyright (C) 2013 Bert Vermeulen <bert@biot.com>
7d658874
BV
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 3 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, see <http://www.gnu.org/licenses/>.
18 */
19
20#include <string.h>
21#include <stdlib.h>
22#include <unistd.h>
23#include <zip.h>
5f9c4c8a
BV
24#include <sys/types.h>
25#include <sys/stat.h>
26#include <errno.h>
7d658874 27#include <glib.h>
3bbd9849 28#include <glib/gstdio.h>
545f9786 29#include "config.h" /* Needed for PACKAGE_VERSION and others. */
45c59c8b
BV
30#include "libsigrok.h"
31#include "libsigrok-internal.h"
7d658874 32
3544f848 33#define LOG_PREFIX "session-file"
a885ce3e 34
393fb9cb
UH
35/**
36 * @file
37 *
38 * Loading and saving libsigrok session files.
39 */
40
7b870c38 41/**
777e2035 42 * @addtogroup grp_session
7b870c38
UH
43 *
44 * @{
45 */
46
2872d21e 47extern struct sr_session *session;
c09f0b57 48extern SR_PRIV struct sr_dev_driver session_driver;
7d658874 49
72a08bcc 50/** @private */
f438e0c9 51SR_PRIV int sr_sessionfile_check(const char *filename)
7d658874 52{
5f9c4c8a 53 struct stat st;
7d658874
BV
54 struct zip *archive;
55 struct zip_file *zf;
56 struct zip_stat zs;
f438e0c9
BV
57 int version, ret;
58 char s[11];
7d658874 59
f438e0c9 60 if (!filename)
9f45fb3a 61 return SR_ERR_ARG;
9f45fb3a 62
5f9c4c8a
BV
63 if (stat(filename, &st) == -1) {
64 sr_err("Couldn't stat %s: %s", filename, strerror(errno));
65 return SR_ERR;
66 }
67
f438e0c9
BV
68 if (!(archive = zip_open(filename, 0, &ret)))
69 /* No logging: this can be used just to check if it's
70 * a sigrok session file or not. */
7d658874 71 return SR_ERR;
7d658874
BV
72
73 /* check "version" */
c1864d55 74 version = 0;
7d658874 75 if (!(zf = zip_fopen(archive, "version", 0))) {
f438e0c9 76 sr_dbg("Not a sigrok session file: no version found.");
7d658874
BV
77 return SR_ERR;
78 }
f438e0c9 79 if ((ret = zip_fread(zf, s, 10)) == -1)
7d658874 80 return SR_ERR;
7d658874 81 zip_fclose(zf);
c1864d55
BV
82 s[ret] = 0;
83 version = strtoull(s, NULL, 10);
84 if (version != 1) {
f438e0c9 85 sr_dbg("Cannot handle sigrok session file version %d.", version);
c1864d55
BV
86 return SR_ERR;
87 }
7d658874
BV
88
89 /* read "metadata" */
90 if (zip_stat(archive, "metadata", 0, &zs) == -1) {
a885ce3e 91 sr_dbg("Not a valid sigrok session file.");
7d658874
BV
92 return SR_ERR;
93 }
b53738ba 94
f438e0c9
BV
95 return SR_OK;
96}
97
98/**
99 * Load the session from the specified filename.
100 *
101 * @param filename The name of the session file to load. Must not be NULL.
102 *
103 * @return SR_OK upon success, SR_ERR_ARG upon invalid arguments,
104 * SR_ERR_MALLOC upon memory allocation errors, or SR_ERR upon
105 * other errors.
106 */
107SR_API int sr_session_load(const char *filename)
108{
109 GKeyFile *kf;
110 GPtrArray *capturefiles;
111 struct zip *archive;
112 struct zip_file *zf;
113 struct zip_stat zs;
114 struct sr_dev_inst *sdi;
115 struct sr_probe *probe;
116 int ret, probenum, devcnt, i, j;
117 uint64_t tmp_u64, total_probes, enabled_probes, p;
118 char **sections, **keys, *metafile, *val;
119 char probename[SR_MAX_PROBENAME_LEN + 1];
120
121 if ((ret = sr_sessionfile_check(filename)) != SR_OK)
122 return ret;
123
124 if (!(archive = zip_open(filename, 0, &ret)))
125 return SR_ERR;
126
127 if (zip_stat(archive, "metadata", 0, &zs) == -1)
128 return SR_ERR;
129
b53738ba 130 if (!(metafile = g_try_malloc(zs.size))) {
a885ce3e 131 sr_err("%s: metafile malloc failed", __func__);
b53738ba
UH
132 return SR_ERR_MALLOC;
133 }
134
7d658874
BV
135 zf = zip_fopen_index(archive, zs.index, 0);
136 zip_fread(zf, metafile, zs.size);
137 zip_fclose(zf);
138
139 kf = g_key_file_new();
140 if (!g_key_file_load_from_data(kf, metafile, zs.size, 0, NULL)) {
a885ce3e 141 sr_dbg("Failed to parse metadata.");
7d658874
BV
142 return SR_ERR;
143 }
144
2285cf9b 145 sr_session_new();
7d658874
BV
146
147 devcnt = 0;
148 capturefiles = g_ptr_array_new_with_free_func(g_free);
149 sections = g_key_file_get_groups(kf, NULL);
150 for (i = 0; sections[i]; i++) {
151 if (!strcmp(sections[i], "global"))
152 /* nothing really interesting in here yet */
153 continue;
154 if (!strncmp(sections[i], "device ", 7)) {
155 /* device section */
4d684427 156 sdi = NULL;
003595ac 157 enabled_probes = total_probes = 0;
7d658874
BV
158 keys = g_key_file_get_keys(kf, sections[i], NULL, NULL);
159 for (j = 0; keys[j]; j++) {
160 val = g_key_file_get_string(kf, sections[i], keys[j], NULL);
161 if (!strcmp(keys[j], "capturefile")) {
4d684427
BV
162 sdi = sr_dev_inst_new(devcnt, SR_ST_ACTIVE, NULL, NULL, NULL);
163 sdi->driver = &session_driver;
7d658874 164 if (devcnt == 0)
c09f0b57 165 /* first device, init the driver */
44fc870c 166 sdi->driver->init(NULL);
bd7bfe8c 167 sr_dev_open(sdi);
4d684427 168 sr_session_dev_add(sdi);
003595ac 169 sdi->driver->config_set(SR_CONF_SESSIONFILE,
8f996b89 170 g_variant_new_string(filename), sdi, NULL);
003595ac 171 sdi->driver->config_set(SR_CONF_CAPTUREFILE,
8f996b89 172 g_variant_new_string(val), sdi, NULL);
7d658874
BV
173 g_ptr_array_add(capturefiles, val);
174 } else if (!strcmp(keys[j], "samplerate")) {
f64c1414 175 sr_parse_sizestring(val, &tmp_u64);
003595ac 176 sdi->driver->config_set(SR_CONF_SAMPLERATE,
8f996b89 177 g_variant_new_uint64(tmp_u64), sdi, NULL);
7d658874
BV
178 } else if (!strcmp(keys[j], "unitsize")) {
179 tmp_u64 = strtoull(val, NULL, 10);
003595ac 180 sdi->driver->config_set(SR_CONF_CAPTURE_UNITSIZE,
8f996b89 181 g_variant_new_uint64(tmp_u64), sdi, NULL);
7d658874
BV
182 } else if (!strcmp(keys[j], "total probes")) {
183 total_probes = strtoull(val, NULL, 10);
003595ac 184 sdi->driver->config_set(SR_CONF_CAPTURE_NUM_PROBES,
8f996b89 185 g_variant_new_uint64(total_probes), sdi, NULL);
464d12c7
KS
186 for (p = 0; p < total_probes; p++) {
187 snprintf(probename, SR_MAX_PROBENAME_LEN, "%" PRIu64, p);
fb381e4d 188 if (!(probe = sr_probe_new(p, SR_PROBE_LOGIC, TRUE,
4d684427
BV
189 probename)))
190 return SR_ERR;
191 sdi->probes = g_slist_append(sdi->probes, probe);
464d12c7 192 }
7d658874 193 } else if (!strncmp(keys[j], "probe", 5)) {
4d684427 194 if (!sdi)
7d658874
BV
195 continue;
196 enabled_probes++;
197 tmp_u64 = strtoul(keys[j]+5, NULL, 10);
fb381e4d
BV
198 /* sr_session_save() */
199 sr_dev_probe_name_set(sdi, tmp_u64 - 1, val);
7d658874
BV
200 } else if (!strncmp(keys[j], "trigger", 7)) {
201 probenum = strtoul(keys[j]+7, NULL, 10);
4d684427 202 sr_dev_trigger_set(sdi, probenum, val);
7d658874
BV
203 }
204 }
205 g_strfreev(keys);
fb381e4d 206 /* Disable probes not specifically listed. */
003595ac
BV
207 if (total_probes)
208 for (p = enabled_probes; p < total_probes; p++)
209 sr_dev_probe_enable(sdi, p, FALSE);
7d658874 210 }
4d684427 211 devcnt++;
7d658874
BV
212 }
213 g_strfreev(sections);
214 g_key_file_free(kf);
215
216 return SR_OK;
217}
218
9f45fb3a
UH
219/**
220 * Save the current session to the specified file.
221 *
18bc2704 222 * @param filename The name of the filename to save the current session as.
9f45fb3a 223 * Must not be NULL.
056be071 224 * @param sdi The device instance from which the data was captured.
18bc2704
BV
225 * @param buf The data to be saved.
226 * @param unitsize The number of bytes per sample.
227 * @param units The number of samples.
9f45fb3a
UH
228 *
229 * @return SR_OK upon success, SR_ERR_ARG upon invalid arguments, or SR_ERR
230 * upon other errors.
231 */
18bc2704
BV
232SR_API int sr_session_save(const char *filename, const struct sr_dev_inst *sdi,
233 unsigned char *buf, int unitsize, int units)
7d658874 234{
18bc2704 235 GSList *l;
003595ac 236 GVariant *gvar;
7d658874 237 FILE *meta;
1afe8989 238 struct sr_probe *probe;
7d658874
BV
239 struct zip *zipfile;
240 struct zip_source *versrc, *metasrc, *logicsrc;
18bc2704 241 int tmpfile, ret, probecnt;
003595ac 242 uint64_t samplerate;
18bc2704 243 char version[1], rawname[16], metafile[32], *s;
7d658874 244
9f45fb3a 245 if (!filename) {
a885ce3e 246 sr_err("%s: filename was NULL", __func__);
9f45fb3a
UH
247 return SR_ERR_ARG;
248 }
249
7d658874 250 /* Quietly delete it first, libzip wants replace ops otherwise. */
4a1b18f8 251 unlink(filename);
ebc34738 252 if (!(zipfile = zip_open(filename, ZIP_CREATE, &ret)))
7d658874 253 return SR_ERR;
7d658874
BV
254
255 /* "version" */
256 version[0] = '1';
257 if (!(versrc = zip_source_buffer(zipfile, version, 1, 0)))
258 return SR_ERR;
259 if (zip_add(zipfile, "version", versrc) == -1) {
a885ce3e 260 sr_info("error saving version into zipfile: %s",
b08024a8 261 zip_strerror(zipfile));
7d658874
BV
262 return SR_ERR;
263 }
264
265 /* init "metadata" */
266 strcpy(metafile, "sigrok-meta-XXXXXX");
267 if ((tmpfile = g_mkstemp(metafile)) == -1)
268 return SR_ERR;
269 close(tmpfile);
868d8cef 270 meta = g_fopen(metafile, "wb");
7d658874
BV
271 fprintf(meta, "[global]\n");
272 fprintf(meta, "sigrok version = %s\n", PACKAGE_VERSION);
7d658874 273
056be071
BV
274 /* metadata */
275 fprintf(meta, "[device 1]\n");
276 if (sdi->driver)
277 fprintf(meta, "driver = %s\n", sdi->driver->name);
7d658874 278
056be071
BV
279 /* metadata */
280 fprintf(meta, "capturefile = logic-1\n");
18bc2704 281 fprintf(meta, "unitsize = %d\n", unitsize);
056be071 282 fprintf(meta, "total probes = %d\n", g_slist_length(sdi->probes));
4d15e5c9 283 if (sr_dev_has_option(sdi, SR_CONF_SAMPLERATE)) {
8f996b89
ML
284 if (sr_config_get(sdi->driver, sdi, NULL,
285 SR_CONF_SAMPLERATE, &gvar) == SR_OK) {
003595ac
BV
286 samplerate = g_variant_get_uint64(gvar);
287 s = sr_samplerate_string(samplerate);
056be071
BV
288 fprintf(meta, "samplerate = %s\n", s);
289 g_free(s);
003595ac 290 g_variant_unref(gvar);
056be071
BV
291 }
292 }
293 probecnt = 1;
294 for (l = sdi->probes; l; l = l->next) {
295 probe = l->data;
296 if (probe->enabled) {
297 if (probe->name)
298 fprintf(meta, "probe%d = %s\n", probecnt, probe->name);
299 if (probe->trigger)
300 fprintf(meta, " trigger%d = %s\n", probecnt, probe->trigger);
301 probecnt++;
302 }
303 }
7d658874 304
056be071 305 if (!(logicsrc = zip_source_buffer(zipfile, buf,
18bc2704 306 units * unitsize, FALSE)))
056be071
BV
307 return SR_ERR;
308 snprintf(rawname, 15, "logic-1");
309 if (zip_add(zipfile, rawname, logicsrc) == -1)
310 return SR_ERR;
7d658874
BV
311 fclose(meta);
312
313 if (!(metasrc = zip_source_file(zipfile, metafile, 0, -1)))
314 return SR_ERR;
315 if (zip_add(zipfile, "metadata", metasrc) == -1)
316 return SR_ERR;
317
318 if ((ret = zip_close(zipfile)) == -1) {
a885ce3e 319 sr_info("error saving zipfile: %s", zip_strerror(zipfile));
7d658874
BV
320 return SR_ERR;
321 }
322
323 unlink(metafile);
324
325 return SR_OK;
326}
7b870c38 327
f438e0c9
BV
328/**
329 * Append data to an existing session file.
330 *
331 * @param filename The name of the filename to append to. Must not be NULL.
332 * @param buf The data to be appended.
333 * @param unitsize The number of bytes per sample.
334 * @param units The number of samples.
335 *
336 * @return SR_OK upon success, SR_ERR_ARG upon invalid arguments, or SR_ERR
337 * upon other errors.
338 */
339SR_API int sr_session_append(const char *filename, unsigned char *buf,
340 int unitsize, int units)
341{
342 struct zip *archive;
343 struct zip_source *logicsrc;
344 zip_int64_t num_files;
345 int chunk_num, next_chunk_num, ret, i;
346 const char *entry_name;
347 char chunkname[16];
348
349 if ((ret = sr_sessionfile_check(filename)) != SR_OK)
350 return ret;
351
352 if (!(archive = zip_open(filename, 0, &ret)))
353 return SR_ERR;
354
355 next_chunk_num = 1;
356 num_files = zip_get_num_entries(archive, 0);
357 for (i = 0; i < num_files; i++) {
358 entry_name = zip_get_name(archive, i, 0);
359 if (strncmp(entry_name, "logic-1", 7))
360 continue;
361 if (strlen(entry_name) == 7) {
362 /* This file has no extra chunks, just a single "logic-1".
363 * Rename it to "logic-1-1" * and continue with chunk 2. */
364 if (zip_rename(archive, i, "logic-1-1") == -1) {
365 sr_err("Failed to rename 'logic-1' to 'logic-1-1'.");
366 return SR_ERR;
367 }
368 next_chunk_num = 2;
369 break;
370 } else if (strlen(entry_name) > 8 && entry_name[7] == '-') {
371 chunk_num = strtoull(entry_name + 8, NULL, 10);
372 if (chunk_num >= next_chunk_num)
373 next_chunk_num = chunk_num + 1;
374 }
375 }
376 snprintf(chunkname, 15, "logic-1-%d", next_chunk_num);
377 if (!(logicsrc = zip_source_buffer(archive, buf, units * unitsize, FALSE)))
378 return SR_ERR;
379 if (zip_add(archive, chunkname, logicsrc) == -1)
380 return SR_ERR;
381 if ((ret = zip_close(archive)) == -1) {
382 sr_info("error saving session file: %s", zip_strerror(archive));
383 return SR_ERR;
384 }
385
386 return SR_OK;
387}
388
7b870c38 389/** @} */