summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/modding_your_keyboard.md22
-rw-r--r--keyboards/planck/keymaps/default/keymap.c4
-rw-r--r--keyboards/preonic/keymaps/default/keymap.c4
-rw-r--r--quantum/audio/audio.c5
4 files changed, 19 insertions, 16 deletions
diff --git a/docs/modding_your_keyboard.md b/docs/modding_your_keyboard.md
index 30ff4f91af..29b0b3b0fb 100644
--- a/docs/modding_your_keyboard.md
+++ b/docs/modding_your_keyboard.md
@@ -1,12 +1,23 @@
## Audio output from a speaker
-Your keyboard can make sounds! If you've got a Planck, Preonic, or basically any keyboard that allows access to the C6 or B5 port (`#define C6_AUDIO` and `#define B5_AUDIO`), you can hook up a simple speaker and make it beep. You can use those beeps to indicate layer transitions, modifiers, special keys, or just to play some funky 8bit tunes.
+Your keyboard can make sounds! If you've got a Planck, Preonic, or basically any keyboard that allows access to the C6 or B5 port (`#define C6_AUDIO` and/or `#define B5_AUDIO`), you can hook up a simple speaker and make it beep. You can use those beeps to indicate layer transitions, modifiers, special keys, or just to play some funky 8bit tunes.
-The audio code lives in [quantum/audio/audio.h](https://github.com/qmk/qmk_firmware/blob/master/quantum/audio/audio.h) and in the other files in the audio directory. It's enabled by default on the Planck [stock keymap](https://github.com/qmk/qmk_firmware/blob/master/keyboards/planck/keymaps/default/keymap.c). Here are the important bits:
+If you add this to your `rules.mk`:
```
-#include "audio.h"
+AUDIO_ENABLE = yes
+```
+
+there's a couple different sounds that will automatically be enabled without any other configuration:
+
+
+If you want to implement something custom, you can
+
+```
+#ifdef AUDIO_ENABLE
+ #include "audio.h"
+#endif
```
Then, lower down the file:
@@ -41,14 +52,11 @@ Wherein we bind predefined songs (from [quantum/audio/song_list.h](https://githu
So now you have something called `tone_plover` for example. How do you make it play the Plover tune, then? If you look further down the keymap, you'll see this:
```
-PLAY_NOTE_ARRAY(tone_plover, false, LEGATO); // song name, repeat, rest style
-PLAY_SONG(tone_plover); // song name (repeat is false, rest is STACCATO)
+PLAY_SONG(tone_plover); // song name
```
This is inside one of the macros. So when that macro executes, your keyboard plays that particular chime.
-"Rest style" in the method signature above (the last parameter) specifies if there's a rest (a moment of silence) between the notes.
-
## Music mode
The music mode maps your columns to a chromatic scale, and your rows to octaves. This works best with ortholinear keyboards, but can be made to work with others. All keycodes less than `0xFF` get blocked, so you won't type while playing notes - if you have special keys/mods, those will still work. A work-around for this is to jump to a different layer with KC_NOs before (or after) enabling music mode.
diff --git a/keyboards/planck/keymaps/default/keymap.c b/keyboards/planck/keymaps/default/keymap.c
index ddb93c8857..34a011b0c9 100644
--- a/keyboards/planck/keymaps/default/keymap.c
+++ b/keyboards/planck/keymaps/default/keymap.c
@@ -16,10 +16,6 @@
#include "planck.h"
#include "action_layer.h"
-#include "eeconfig.h"
-#ifdef AUDIO_ENABLE
- #include "audio.h"
-#endif
extern keymap_config_t keymap_config;
diff --git a/keyboards/preonic/keymaps/default/keymap.c b/keyboards/preonic/keymaps/default/keymap.c
index a05117c9e6..491f4ae850 100644
--- a/keyboards/preonic/keymaps/default/keymap.c
+++ b/keyboards/preonic/keymaps/default/keymap.c
@@ -16,10 +16,6 @@
#include "preonic.h"
#include "action_layer.h"
-#include "eeconfig.h"
-#ifdef AUDIO_ENABLE
- #include "audio.h"
-#endif
enum preonic_layers {
_QWERTY,
diff --git a/quantum/audio/audio.c b/quantum/audio/audio.c
index baa364eec2..8e8570d26c 100644
--- a/quantum/audio/audio.c
+++ b/quantum/audio/audio.c
@@ -555,7 +555,10 @@ ISR(TIMER1_COMPA_vect)
note_position++;
bool end_of_note = false;
if (TIMER_1_PERIOD > 0) {
- end_of_note = (note_position >= (note_length / TIMER_1_PERIOD * 0xFFFF - 1));
+ if (!note_resting)
+ end_of_note = (note_position >= (note_length / TIMER_1_PERIOD * 0xFFFF - 1));
+ else
+ end_of_note = (note_position >= (note_length));
} else {
end_of_note = (note_position >= (note_length));
}