summaryrefslogtreecommitdiff
path: root/gpsflash.h
blob: 3ca09584041b7456340694958cbcbf095a23cde1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
/*
 * Copyright (c) 2005 Chris Kuethe <chris.kuethe@gmail.com>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef _GPSFLASH_H_
#define _GPSFLASH_H_

#include <sys/types.h>
#include <sys/ioctl.h>
#include <sys/stat.h>

#include <netinet/in.h>	/* for htonl() under Linux */

#include <ctype.h>
#include <err.h>
#include <errno.h>
#include <fcntl.h>
#include <signal.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <termios.h>
#include <unistd.h>

/*
 * I can't imagine a GPS firmware less than 256KB / 2Mbit. The latest build
 * that I have (2.3.2) is 296KB. So 256KB is probably low enough to allow
 * really old firmwares to load.
 *
 * As far as I know, USB receivers have 512KB / 4Mbit of flash. Application
 * note APNT00016 (Alternate Flash Programming Algorithms) says that the S2AR
 * reference design supports 4, 8 or 16 Mbit flash memories, but with current
 * firmwares not even using 60% of a 4Mbit flash on a commercial receiver,
 * I'm not going to stress over loading huge images. The define below is
 * 524288 bytes, but that blows up nearly 3 times as S-records.
 * 928K srec -> 296K binary
 */
#define MIN_FW_SIZE 262144
#define MAX_FW_SIZE 1572864

/* a reasonable loader is probably 15K - 20K */
#define MIN_LD_SIZE 15440
#define MAX_LD_SIZE 20480

/* From the SiRF protocol manual... may as well be consistent */
#define PROTO_SIRF 0
#define PROTO_NMEA 1

#define BOOST_38400 0
#define BOOST_57600 1
#define BOOST_115200 2

/* block size when writing to the serial port. related to FIFO size */
#define WRBLK 128

/* Prototypes */
/* gpsflash.c */
int		main(int, char **);
void		usage(void);

/* utils.c */
int		serialConfig(int, struct termios *, int);
int		serialSpeed(int, struct termios *, int);
int		sirfSetProto(int, struct termios *, int, int);
int		sirfSendUpdateCmd(int);
int		sirfSendLoader(int, struct termios *, char *, int);
int		sirfSendFirmware(int, char *, int);
int		sirfWrite(int, unsigned char *);
unsigned char	nmea_checksum(unsigned char *);

#endif /* _GPSFLASH_H_ */