FreeCalypso > hg > freecalypso-tools

comparison doc/Buzzer-melodies @ 897:cb0f61535166

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/Buzzer-melodies: update for new fc-buzplay
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 03 Apr 2022 08:53:53 +0000
parents 76cc910c508e
children
comparison
equal deleted inserted replaced
896:0a2f50c571de 897:cb0f61535166
215 buzplayer manually via fc-iram, you can use it to exercise the buzzer manually, 215 buzplayer manually via fc-iram, you can use it to exercise the buzzer manually,
216 playing any tone at any volume, in either BU or PWT mode. 216 playing any tone at any volume, in either BU or PWT mode.
217 217
218 fc-buzplay is a higher-level tool: it establishes out-of-firmware operation on 218 fc-buzplay is a higher-level tool: it establishes out-of-firmware operation on
219 a target Calypso device similarly to fc-loadtool (based on the same framework), 219 a target Calypso device similarly to fc-loadtool (based on the same framework),
220 but running buzplayer instead of loadagent. The original command of meaty 220 but running buzplayer instead of loadagent. Once you land at the buzplay>
221 action was/is 'play' - it reads a BU (not PWT) melody from an ASCII source file 221 prompt, the main command of interest is 'play': it takes one required argument,
222 in a format that was the predecessor of our current PWT format, feeds it to 222 the name of the melody file to play (ASCII BU or PWT format), and a second
223 buzplayer on the target, and commands buzplayer to actually play it on the 223 optional argument, the play volume in the [1,64] range. The current version of
224 physical buzzer. Later buzplayer (the target utility) was extended to support 224 this 'play' command intuits the melody format (BU or PWT) from the filename,
225 PWT in addition to BU, and fc-buzplay got a new 'playt' command - this new 225 which must end in .buz or .pwt, respectively. You can also issue explicit
226 command plays PWT melodies, reading melody files in the same ASCII source format 226 play-bu and play-pwt commands, in which case the filename can be anything. All
227 as fc-pwt-comp. (In actual history this ASCII source format was invented for 227 of these play command variants read the melody file in the respective format
228 fc-buzplay first, and then later we turned it into fc-pwt-comp.) 228 (ASCII in both cases, line-based), feed the melody to the target, and then
229 command buzplayer to actually play it on the physical buzzer.