FreeCalypso > hg > freecalypso-tools
comparison doc/Buzzer-melodies @ 897:cb0f61535166
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. |