srmcmd(1)

1SRMCMD(1)                     Version 0.1.1~git1                     SRMCMD(1)
2
3
4

NAME

6       srmcmd - download/access for SRM PowerControl
7
8

SYNOPSIS

10       srmcmd [options] path
11
12

DESCRIPTION

14       srmcmd implements the serial protocols for SRM's PowerControl V, VI and
15       7.  It allows you to adjust the most important settings.
16
17

OPTIONS

19       Options available for the srmcmd command:
20
21       -b, --baud=rate
22              Use specified baudrate, only. By default all supported baudrates
23              are  probed.  PCV  factory  setting  is  9600 baud. PCVI and PV7
24              always use 38400.
25
26       -c, --clear
27              Delete data on PC. Well,  actually  just  mark  it  as  deleted.
28              You're still able to get it with --get=all on PCV.
29
30       -d, --date
31              Print  start  date of recorded data as seconds since 1970-01-01.
32              This is useful for creating srmwin compatible filenames.
33
34       -x, --fixup
35              Try to fix time glitches in retrieved data.  The  PCV  sends  11
36              Tuples in one 64Byte block. Timestamps are only sent per Block -
37              with a granularity of 1 sec - so they're always off with recints
38              <  1sec.  In  addition  these timestamps often mismatch the time
39              covered by the tuples. With  this  option  set,  timestamps  are
40              adjusted to fit the recint and gaps at block boundaries of up to
41              2sec are filled with averaged data. That's what srmwin is doing,
42              It  seems  wko doesn't ... The protocol for PCVI and PC7 doesn't
43              have this problem.
44
45       -f, --ftdi
46              use ftdi serial driver and open device by the given description.
47
48       -g, --get[=all]
49              Download newly recorded data from PC. With  all  specified,  the
50              "deletion"  on  the  PCV is ignored and all data (that's not yet
51              overwritten) is retrieved from the PCV (PCVI and PC7 don't  seem
52              to  support  getting "deleted" data). By default data is written
53              to stdout as tab-separated list.
54
55       -h, --help
56              A brief message.
57
58       -i, --int=recint
59              Set recording interval. Interval is specified *10. so "10" means
60              1 sec.  Supported values: 1 to 9 and 10 to 150 in steps of 10.
61
62       -n, --name
63              Show athlete name (initials) stored on the PC.
64
65       -p, --pc=type
66              Type of PowerControl protocol to use. Supported are PowerControl
67              5, 6, and 7.  Default is "5".
68
69
70       -r, --read
71              instead of accessing the PC, the specified file is  read.
72              By  default  data is written to stdout as with --get. See
73              below for supported file formats.
74
75       -R, --read-type=type
76              specify format of file to read. See below  for  supported
77              file formats.  Defaults to srm7.
78
79       -s, --split=time
80              Split  data  on gaps of specified minimum length. Time is
81              given as 10*seconds - same as --recint. With  a  non-zero
82              time,  the argument given to --write will be used as tem‐
83              plate for mkstemps. So it has to have printed to stdout.
84
85       -t, --time
86              Set the PCs time to the current system time.
87
88       -v, --verbose
89              Enable verbose status messages.
90
91       -V, --version
92              show srmcmd version number and exit.
93
94       -w, --write=destination
95              Write data retrieved from PC (or with --read  from  file)
96              to the specified destination file.
97
98       -W, --write-type=type
99              specify  format of file to write. See below for supported
100              file formats.  Defaults to srm7.
101
102

FILE FORMATS

104       srm5   Binary format written by ancient  srmwin  versions.  Sup‐
105              ports same fields as srm6. Only reading is implemented.
106
107       srm6   Binary  format as written by srmwin until PCVI was intro‐
108              duced. Supports power, heartrate,  speed,  cadence.  Only
109              reading is implemented.
110
111       srm7   Binary  format  as  written by srmwin that supports PCVI.
112              Supports power,  heartrate,  speed,  cadence,  elevation,
113              temperature.  For  reading,  the  srm  file  sub-type  is
114              autodetected.
115
116       wkt    custom text-based format that has a lot less restrictions
117              than  both SRM formats. Supports all fields. Only writing
118              is implemented.
119
120

EXAMPLES

122       Show name configured in PC:
123
124        srmcmd -n /dev/ttyUSB0       # linux
125        srmcmd -n -p 7 /dev/ttyUSB0  # linux, PowerControl 7
126        srmcmd -n /dev/ttyS1         # cygwin, com1
127        srmcmd -n /dev/cu.usbserial* # Mac OS X, prolific driver  (good
128       luck)
129        srmcmd  -n  /dev/cu.PL2303-*   #  Mac  OS  X  with  http://osx-
130       pl2303.sourceforge.net/
131        srmcmd -n -p 7 -f "POWERCONTROL 7" # ftdi, PowerControl 7
132
133       Download data to out.srm, delete data on PC,  adjust  clock  and
134       set recint to 1sec:
135
136        srmcmd -g -t -i 10 -w out.srm /dev/ttyUSB0
137
138       Auto-split on 2h gaps and save to files named foo*.srm
139
140        srmcmd -g -s 72000 -w fooXXXXXX.srm /dev/ttyUSB0
141
142       Dump file contents as tab-seperated list:
143
144        srmcmd -r foo.srm
145
146

BUGS

153       Yes. For sure. Just keep in mind, that protocol and file formats
154       are reverse engineered...
155
156

AUTHORS

158       Rainer Clasen
159
160
161
162SRM access tool                   9 Mar 2011                         SRMCMD(1)