open-audiovisual
搜尋 GitHub

KORG

Korg nanoKONTROL2

Korg nanoKONTROL2 是 KORG 的 MIDI 硬體控制器:8 顆旋鈕、8 支推桿、35 顆按鈕。

它在 頻道 1 送出 CC,設定檔引用了 4 份出處。 沒有任何控制項被標為未確認。

  • 原廠文件
  • 社群整理
  • LED 回饋
類型
硬體裝置
廠牌
KORG
控制項
51 個控制項
訊息種類
CC
MIDI 頻道
1
LED 回饋
有,燈光由 MIDI 控制
訊號
midi/nano2/…
埠名稱比對
/nanokontrol\s*2/i
NANOKONTROL2◀▶Set◀▶◀◀▶▶■▶●12345678SMR1SMR2SMR3SMR4SMR5SMR6SMR7SMR8

在畫面上彈 Korg nanoKONTROL2 全螢幕 ↗ 原始 JSON ↗ 全部控制器

拖曳旋鈕和推桿 · 點打擊墊和琴鍵 · 或接上真機按「接上」。除非你加了 MIDI 輸出,否則什麼都不會送出去。

MIDI 實作表

Korg nanoKONTROL2 每個控制項送出什麼

直接從設定檔產生,跟畫面上彈的是同一張表。頻道是 1–16,編號是真正的 MIDI 編號。

Korg nanoKONTROL2 的 MIDI 實作表
控制項類型訊息頻道編號訊號LED 回饋已確認
1 k1 旋鈕 CC 1 16 midi/nano2/k1 — 是
2 k2 旋鈕 CC 1 17 midi/nano2/k2 — 是
3 k3 旋鈕 CC 1 18 midi/nano2/k3 — 是
4 k4 旋鈕 CC 1 19 midi/nano2/k4 — 是
5 k5 旋鈕 CC 1 20 midi/nano2/k5 — 是
6 k6 旋鈕 CC 1 21 midi/nano2/k6 — 是
7 k7 旋鈕 CC 1 22 midi/nano2/k7 — 是
8 k8 旋鈕 CC 1 23 midi/nano2/k8 — 是
1 f1 推桿 CC 1 0 midi/nano2/f1 — 是
2 f2 推桿 CC 1 1 midi/nano2/f2 — 是
3 f3 推桿 CC 1 2 midi/nano2/f3 — 是
4 f4 推桿 CC 1 3 midi/nano2/f4 — 是
5 f5 推桿 CC 1 4 midi/nano2/f5 — 是
6 f6 推桿 CC 1 5 midi/nano2/f6 — 是
7 f7 推桿 CC 1 6 midi/nano2/f7 — 是
8 f8 推桿 CC 1 7 midi/nano2/f8 — 是
S s1 按鈕 CC · 按住 1 32 midi/nano2/s1 CC 32 · 亮 127 / 暗 0 是
S s2 按鈕 CC · 按住 1 33 midi/nano2/s2 CC 33 · 亮 127 / 暗 0 是
S s3 按鈕 CC · 按住 1 34 midi/nano2/s3 CC 34 · 亮 127 / 暗 0 是
S s4 按鈕 CC · 按住 1 35 midi/nano2/s4 CC 35 · 亮 127 / 暗 0 是
S s5 按鈕 CC · 按住 1 36 midi/nano2/s5 CC 36 · 亮 127 / 暗 0 是
S s6 按鈕 CC · 按住 1 37 midi/nano2/s6 CC 37 · 亮 127 / 暗 0 是
S s7 按鈕 CC · 按住 1 38 midi/nano2/s7 CC 38 · 亮 127 / 暗 0 是
S s8 按鈕 CC · 按住 1 39 midi/nano2/s8 CC 39 · 亮 127 / 暗 0 是
M m1 按鈕 CC · 按住 1 48 midi/nano2/m1 CC 48 · 亮 127 / 暗 0 是
M m2 按鈕 CC · 按住 1 49 midi/nano2/m2 CC 49 · 亮 127 / 暗 0 是
M m3 按鈕 CC · 按住 1 50 midi/nano2/m3 CC 50 · 亮 127 / 暗 0 是
M m4 按鈕 CC · 按住 1 51 midi/nano2/m4 CC 51 · 亮 127 / 暗 0 是
M m5 按鈕 CC · 按住 1 52 midi/nano2/m5 CC 52 · 亮 127 / 暗 0 是
M m6 按鈕 CC · 按住 1 53 midi/nano2/m6 CC 53 · 亮 127 / 暗 0 是
M m7 按鈕 CC · 按住 1 54 midi/nano2/m7 CC 54 · 亮 127 / 暗 0 是
M m8 按鈕 CC · 按住 1 55 midi/nano2/m8 CC 55 · 亮 127 / 暗 0 是
R r1 按鈕 CC · 按住 1 64 midi/nano2/r1 CC 64 · 亮 127 / 暗 0 是
R r2 按鈕 CC · 按住 1 65 midi/nano2/r2 CC 65 · 亮 127 / 暗 0 是
R r3 按鈕 CC · 按住 1 66 midi/nano2/r3 CC 66 · 亮 127 / 暗 0 是
R r4 按鈕 CC · 按住 1 67 midi/nano2/r4 CC 67 · 亮 127 / 暗 0 是
R r5 按鈕 CC · 按住 1 68 midi/nano2/r5 CC 68 · 亮 127 / 暗 0 是
R r6 按鈕 CC · 按住 1 69 midi/nano2/r6 CC 69 · 亮 127 / 暗 0 是
R r7 按鈕 CC · 按住 1 70 midi/nano2/r7 CC 70 · 亮 127 / 暗 0 是
R r8 按鈕 CC · 按住 1 71 midi/nano2/r8 CC 71 · 亮 127 / 暗 0 是
◀ trackprev 按鈕 CC · 按住 1 58 midi/nano2/trackprev CC 58 · 亮 127 / 暗 0 是
▶ tracknext 按鈕 CC · 按住 1 59 midi/nano2/tracknext CC 59 · 亮 127 / 暗 0 是
Cycle cycle 按鈕 CC · 按住 1 46 midi/nano2/cycle CC 46 · 亮 127 / 暗 0 是
Set markerset 按鈕 CC · 按住 1 60 midi/nano2/markerset CC 60 · 亮 127 / 暗 0 是
◀ markerprev 按鈕 CC · 按住 1 61 midi/nano2/markerprev CC 61 · 亮 127 / 暗 0 是
▶ markernext 按鈕 CC · 按住 1 62 midi/nano2/markernext CC 62 · 亮 127 / 暗 0 是
◀◀ rew 按鈕 CC · 按住 1 43 midi/nano2/rew CC 43 · 亮 127 / 暗 0 是
▶▶ ff 按鈕 CC · 按住 1 44 midi/nano2/ff CC 44 · 亮 127 / 暗 0 是
■ stop 按鈕 CC · 按住 1 42 midi/nano2/stop CC 42 · 亮 127 / 暗 0 是
▶ play 按鈕 CC · 按住 1 41 midi/nano2/play CC 41 · 亮 127 / 暗 0 是
● rec 按鈕 CC · 按住 1 45 midi/nano2/rec CC 45 · 亮 127 / 暗 0 是

這一台有 35 個控制項寫了 LED 回饋,上面表格的 LED 欄就是讓它亮的訊息。

出處

說明

Factory scene, CC mode, global channel 1. LED feedback reaches the buttons only when LED mode is set to External in the KORG KONTROL Editor (default Internal: the unit lights its own buttons).

認得的埠名稱

比對
/nanokontrol\s*2/i
優先
/slider/i /knob/i /ctrl/i

訊號

每個控制項都會發出 midi/nano2/<控制項>(0..1)和 /raw。打擊墊多一個 /hit,無段旋鈕多 /delta,琴鍵有 /on、/off 和 n<音高>。最後動到的那個控制項是 midi/nano2/last。

用起來

把 Korg nanoKONTROL2 用在你的作品裡

  1. 一行嵌入

    不用 import map,也不用建置。可以改 layout,加上 hardware="ask" 就有「接上」按鈕。

    html
    <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
    <oav-controller profile="korg-nanokontrol2" readout></oav-controller>
  2. 或用 iframe

    給只能貼 iframe 的地方。每個事件都以 postMessage 傳回來。

    html
    <iframe src="https://openaudiovisual.com/embed/controller/?profile=korg-nanokontrol2&readout"
            width="720" height="216" style="border:0;max-width:100%" allow="midi"
            title="Korg nanoKONTROL2"></iframe>
    <script>
      // every control the visitor plays arrives here
      addEventListener('message', (e) => {
        if (e.data?.source !== 'openav' || e.data.type !== 'control') return;
        console.log(e.data.detail.signal, e.data.detail.value);
      });
    </script>
  3. 送進 Ableton、TouchDesigner、Resolume

    你在畫面上彈的,會變成真正的 MIDI,從 macOS 的 IAC 匯流排或 Windows 的 loopMIDI 埠送出。步驟在圖鑑頁。

    html
    <!-- what you play on this controller → the IAC bus (macOS) → Ableton, TouchDesigner, Resolume -->
    <script type="module" src="https://openaudiovisual.com/packages/midi/element.js"></script>
    <oav-controller profile="korg-nanokontrol2" midi-out="IAC" readout></oav-controller>
    <!-- Windows: midi-out="loopMIDI" · let the visitor pick a port: midi-out="ask" -->

    macOS:音訊 MIDI 設定 → MIDI 工作室 → IAC 驅動程式 → 勾「裝置在線上」。Windows 11:內建的 Windows MIDI Services 有 loopback(我們沒有實測);舊版 Windows:安裝 loopMIDI、新增一個埠,用 midi-out="loopMIDI"。

在 p5.js 裡,只要一行

一行注入會依這份設定檔裡的順序(也就是上面表格的順序)替旋鈕、推桿和打擊墊編號。網址加上 ?profile=korg-nanokontrol2,畫面上的控制器就是這一台;真的 Korg nanoKONTROL2 接上時,會依埠名稱自動認出來。

javascript
document.head.prepend(Object.assign(document.createElement('script'), { src: 'https://openaudiovisual.com/p5/oav-p5.js?profile=korg-nanokontrol2' }));
在草稿裡控制項訊息
knob11 k1CC 16 · 頻道 1
knob22 k2CC 17 · 頻道 1
knob33 k3CC 18 · 頻道 1
knob44 k4CC 19 · 頻道 1
knob55 k5CC 20 · 頻道 1
knob66 k6CC 21 · 頻道 1
knob77 k7CC 22 · 頻道 1
knob88 k8CC 23 · 頻道 1
fader11 f1CC 0 · 頻道 1
fader22 f2CC 1 · 頻道 1
fader33 f3CC 2 · 頻道 1
fader44 f4CC 3 · 頻道 1
fader55 f5CC 4 · 頻道 1
fader66 f6CC 5 · 頻道 1
fader77 f7CC 6 · 頻道 1
fader88 f8CC 7 · 頻道 1
p5.js 草稿
function draw() {
  background(knob1 * 255);   // 1 · CC 16
  circle(width / 2, height / 2, 50 + knob2 * 300);   // 2 · CC 17
}

無段旋鈕、按鈕、滾輪和觸控條沒有編號:用 midi.cc[編號] 讀(編號見上面的表),或寫 controlChange(cc, value, ch) 接。

p5.js 完整說明 →

找不到

沒有你那台?

開一張 issue,寫廠牌型號、手上有沒有這台、手冊的連結。也可以自己寫設定檔,它就是一個 JSON 檔。

GitHub

這台的資料有錯嗎?

這一頁的每個數字都來自一個 JSON 檔。如果跟你的機器或手冊對不上,告訴我們你查的是哪個韌體版本,我們就改檔案。