9d1c98c891
* Added right vs left specific pin assignments for dip switch * Update feature_dip_switch.md * Ran formatting tools
115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# DIP スイッチ
|
|
|
|
<!---
|
|
original document: 0.9.43:docs/feature_dip_switch.md
|
|
git diff 0.9.43 HEAD -- docs/feature_dip_switch.md | cat
|
|
-->
|
|
|
|
DIP スイッチは、以下を `rules.mk` に追加することでサポートされます:
|
|
|
|
DIP_SWITCH_ENABLE = yes
|
|
|
|
さらに、以下を `config.h` に追加します:
|
|
|
|
```c
|
|
// Connects each switch in the dip switch to the GPIO pin of the MCU
|
|
#define DIP_SWITCH_PINS { B14, A15, A10, B9 }
|
|
// For split keyboards, you can separately define the right side pins
|
|
#define DIP_SWITCH_PINS_RIGHT { ... }
|
|
```
|
|
|
|
あるいは
|
|
|
|
```c
|
|
// Connect each switch in the DIP switch to an unused intersections in the key matrix.
|
|
#define DIP_SWITCH_MATRIX_GRID { {0,6}, {1,6}, {2,6} } // List of row and col pairs
|
|
```
|
|
|
|
## コールバック
|
|
|
|
コールバック関数を `<keyboard>.c` に記述することができます:
|
|
|
|
```c
|
|
bool dip_switch_update_kb(uint8_t index, bool active) {
|
|
if !(dip_switch_update_user(index, active)) { return false; }
|
|
return true;
|
|
}
|
|
```
|
|
|
|
|
|
あるいは `keymap.c` に記述することもできます:
|
|
|
|
```c
|
|
bool dip_switch_update_user(uint8_t index, bool active) {
|
|
switch (index) {
|
|
case 0:
|
|
if(active) { audio_on(); } else { audio_off(); }
|
|
break;
|
|
case 1:
|
|
if(active) { clicky_on(); } else { clicky_off(); }
|
|
break;
|
|
case 2:
|
|
if(active) { music_on(); } else { music_off(); }
|
|
break;
|
|
case 3:
|
|
if (active) {
|
|
#ifdef AUDIO_ENABLE
|
|
PLAY_SONG(plover_song);
|
|
#endif
|
|
layer_on(_PLOVER);
|
|
} else {
|
|
#ifdef AUDIO_ENABLE
|
|
PLAY_SONG(plover_gb_song);
|
|
#endif
|
|
layer_off(_PLOVER);
|
|
}
|
|
break;
|
|
}
|
|
return true;
|
|
}
|
|
```
|
|
|
|
更に、より複雑な処理ができるビットマスク関数をサポートします。
|
|
|
|
|
|
```c
|
|
bool dip_switch_update_mask_kb(uint32_t state) {
|
|
if (!dip_switch_update_mask_user(state)) { return false; }
|
|
return true;
|
|
}
|
|
```
|
|
|
|
|
|
あるいは `keymap.c` に記述することもできます:
|
|
|
|
```c
|
|
bool dip_switch_update_mask_user(uint32_t state) {
|
|
if (state & (1UL<<0) && state & (1UL<<1)) {
|
|
layer_on(_ADJUST); // C on esc
|
|
} else {
|
|
layer_off(_ADJUST);
|
|
}
|
|
if (state & (1UL<<0)) {
|
|
layer_on(_TEST_A); // A on ESC
|
|
} else {
|
|
layer_off(_TEST_A);
|
|
}
|
|
if (state & (1UL<<1)) {
|
|
layer_on(_TEST_B); // B on esc
|
|
} else {
|
|
layer_off(_TEST_B);
|
|
}
|
|
return true;
|
|
}
|
|
```
|
|
|
|
|
|
## ハードウェア
|
|
|
|
### DIP スイッチの各スイッチを MCU の GPIO ピンに接続する
|
|
|
|
DIP スイッチの片側は MCU のピンへ直接配線し、もう一方の側はグラウンドに配線する必要があります。機能的に同じであるため、どちら側がどちらに接続されているかは問題にはならないはずです。
|
|
|
|
### DIP スイッチの各スイッチをキーマトリクスの未使用の交点に接続する
|
|
|
|
キースイッチと同じように、ダイオードと DIP スイッチが ROW 線と COL 線に接続します。
|