206 lines
4.8 KiB
TypeScript
206 lines
4.8 KiB
TypeScript
enum Notes {
|
|
//% enumval=262
|
|
C,
|
|
//% enumval=277 blockId=C#
|
|
CSharp,
|
|
//% enumval=294
|
|
D,
|
|
//% enumval=311
|
|
Eb,
|
|
//% enumval=330
|
|
E,
|
|
//% enumval=349
|
|
F,
|
|
//% enumval=370 blockId=F#
|
|
FSharp,
|
|
//% enumval=392
|
|
G,
|
|
//% enumval=415 blockId=G#
|
|
GSharp,
|
|
//% enumval=440
|
|
A,
|
|
//% enumval=466
|
|
Bb,
|
|
//% enumval=494
|
|
B,
|
|
//% enumval=131
|
|
C3,
|
|
//% enumval=139 blockId=C#3
|
|
CSharp3,
|
|
//% enumval=147
|
|
D3,
|
|
//% enumval=156
|
|
Eb3,
|
|
//% enumval=165
|
|
E3,
|
|
//% enumval=175
|
|
F3,
|
|
//% enumval=185 blockId=F#3
|
|
FSharp3,
|
|
//% enumval=196
|
|
G3,
|
|
//% enumval=208 blockId=G#3
|
|
GSharp3,
|
|
//% enumval=220
|
|
A3,
|
|
//% enumval=233
|
|
Bb3,
|
|
//% enumval=247
|
|
B3,
|
|
//% enumval=262
|
|
C4,
|
|
//% enumval=277 blockId=C#4
|
|
CSharp4,
|
|
//% enumval=294
|
|
D4,
|
|
//% enumval=311
|
|
Eb4,
|
|
//% enumval=330
|
|
E4,
|
|
//% enumval=349
|
|
F4,
|
|
//% enumval=370 blockId=F#3
|
|
FSharp4,
|
|
//% enumval=392
|
|
G4,
|
|
//% enumval=415 blockId=G#3
|
|
GSharp4,
|
|
//% enumval=440
|
|
A4,
|
|
//% enumval=466
|
|
Bb4,
|
|
//% enumval=494
|
|
B4,
|
|
//% enumval=523
|
|
C5,
|
|
//% enumval=555 blockId=C#5
|
|
CSharp5,
|
|
//% enumval=587
|
|
D5,
|
|
//% enumval=622
|
|
Eb5,
|
|
//% enumval=659
|
|
E5,
|
|
//% enumval=698
|
|
F5,
|
|
//% enumval=740 blockId=F#5
|
|
FSharp5,
|
|
//% enumval=784
|
|
G5,
|
|
//% enumval=831 blockId=G#5
|
|
GSharp5,
|
|
//% enumval=880
|
|
A5,
|
|
//% enumval=932
|
|
Bb5,
|
|
//% enumval=989
|
|
B5,
|
|
}
|
|
|
|
enum BeatFraction {
|
|
//% enumval=1 blockId=1
|
|
Whole = 1,
|
|
//% enumval=2 blockId="1/2"
|
|
Half = 2,
|
|
//% enumval=4 blockId="1/4"
|
|
Quater = 4,
|
|
//% enumval=8 blockId="1/8"
|
|
Eighth = 8,
|
|
//% enumval=16 blockId="1/16"
|
|
Sixteenth = 16
|
|
}
|
|
|
|
//% color=52 weight=33
|
|
namespace music {
|
|
var beatsPerMinute: number = 120;
|
|
|
|
/**
|
|
* Plays a tone through pin ``P0`` for the given duration.
|
|
* @param frequency TODO
|
|
* @param ms TODO
|
|
*/
|
|
//% help=functions/play-tone weight=90
|
|
//% blockId=device_play_note block="play|tone (Hz) %note=device_note|for (ms) %duration=device_beat" icon="\uf025" blockGap=8
|
|
export function playTone(frequency: number, ms: number): void {
|
|
pins.analogSetPitchPin(AnalogPins.P0);
|
|
pins.analogPitch(frequency, ms);
|
|
}
|
|
|
|
/**
|
|
* Plays a tone through pin ``P0``.
|
|
* @param frequency TODO
|
|
*/
|
|
//% help=functions/ring-tone weight=80
|
|
//% blockId=device_ring block="ring tone (Hz)|%note=device_note" icon="\uf025" blockGap=8
|
|
export function ringTone(frequency: number): void {
|
|
pins.analogSetPitchPin(AnalogPins.P0);
|
|
pins.analogPitch(frequency, 0);
|
|
}
|
|
|
|
/**
|
|
* Rests (plays nothing) for a specified time through pin ``P0``.
|
|
* @param ms TODO
|
|
*/
|
|
//% help=functions/rest weight=79
|
|
//% blockId=device_rest block="rest(ms)|%duration=device_beat"
|
|
export function rest(ms: number): void {
|
|
playTone(0, ms);
|
|
}
|
|
|
|
|
|
/**
|
|
* Gets the frequency of a note.
|
|
* @param name TODO
|
|
*/
|
|
//% shim=TD_ID weight=50 help=functions/note-frequency
|
|
//% blockId=device_note block="%note"
|
|
export function noteFrequency(name: Notes): number {
|
|
return name;
|
|
}
|
|
|
|
/**
|
|
* Returns the duration of a beat in milli-seconds
|
|
*/
|
|
//% help=/functions/beat weight=49
|
|
//% blockId=device_beat block="%fraction|beat"
|
|
export function beat(fraction : BeatFraction = BeatFraction.Whole): number {
|
|
let beat = 60000 / beatsPerMinute;
|
|
if (fraction == BeatFraction.Whole) return beat;
|
|
else if (fraction == BeatFraction.Half) return beat / 2;
|
|
else if (fraction == BeatFraction.Quater) return beat / 4
|
|
else if (fraction == BeatFraction.Eighth) return beat / 8;
|
|
else return beat / 16;
|
|
}
|
|
|
|
/**
|
|
* Returns the tempo in beats per minute. Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.
|
|
*/
|
|
//% help=/functions/tempo weight=40
|
|
//% blockId=device_tempo block="tempo (bpm)" blockGap=8
|
|
export function tempo(): number {
|
|
return beatsPerMinute;
|
|
}
|
|
|
|
/**
|
|
* Change the tempo by the specified amount
|
|
* @param bpm The change in beats per minute to the tempo, eg: 20
|
|
*/
|
|
//% help=/functions/tempo weight=39
|
|
//% blockId=device_change_tempo block="change tempo by (bpm)|%value" blockGap=8
|
|
export function changeTempoBy(bpm: number): void {
|
|
setTempo(beatsPerMinute + bpm);
|
|
}
|
|
|
|
/**
|
|
* Sets the tempo to the specified amount
|
|
* @param bpm The new tempo in beats per minute, eg: 120
|
|
*/
|
|
//% help=/functions/tempo weight=38
|
|
//% blockId=device_set_tempo block="set tempo to (bpm)|%value"
|
|
export function setTempo(bpm: number): void {
|
|
if (bpm > 0) {
|
|
beatsPerMinute = Math.max(1, bpm);
|
|
}
|
|
}
|
|
}
|