From dd4e0d95679beb0d5586af19f68904f25569bf98 Mon Sep 17 00:00:00 2001
From: Merlinov <64584348+Merlinov@users.noreply.github.com>
Date: Wed, 8 Feb 2023 22:01:58 +0300
Subject: [PATCH] Add files via upload

---
 docs/docs/behaviors/mouse-emulation.md | 69 ++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 docs/docs/behaviors/mouse-emulation.md

diff --git a/docs/docs/behaviors/mouse-emulation.md b/docs/docs/behaviors/mouse-emulation.md
new file mode 100644
index 00000000..fec7e2c6
--- /dev/null
+++ b/docs/docs/behaviors/mouse-emulation.md
@@ -0,0 +1,69 @@
+---
+title: Mouse Emulation Behaviors
+sidebar_label: Mouse Emulation
+---
+
+## Summary
+
+Mouse emulation behaviors send mouse movements, button presses or scroll actions.
+
+Please view [`dt-bindings/zmk/mouse.h`](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/mouse.h) for a comprehensive list of signals.
+
+## Keycode Defines
+
+To make it easier to encode the HID keycode numeric values, most keymaps include
+the [`dt-bindings/zmk/mouse.h`](https://github.com/zmkfirmware/zmk/blob/main/app/include/dt-bindings/zmk/mouse.h) header
+provided by ZMK near the top:
+
+```
+#include <dt-bindings/zmk/mouse.h>
+```
+
+Doing so allows using a set of defines such as `MOVE_UP`, `MOVE_DOWN`, `LCLK` and `SCROLL_UP` with these behaviors.
+
+## Mouse Button Press
+
+This behavior can press/release up to 16 mouse buttons.
+
+### Behavior Binding
+
+- Reference: `&mkp`
+- Parameter: A `uint16` with each bit referring to a button.
+
+Example:
+
+```
+&mkp LCLK
+```
+
+## Mouse Movement
+
+This behavior is used to manipulate the cursor.
+
+### Behavior Binding
+
+- Reference: `&mmv`
+- Parameter: A `uint32` with the first 16 bits relating to horizontal movement
+  and the last 16 - to vertical movement.
+
+Example:
+
+```
+&mmv MOVE_UP
+```
+
+## Mouse Wheel
+
+This behaviour is used to scroll, both horizontally and vertically.
+
+### Behavior Binding
+
+- Reference: `&mwh`
+- Parameter: A `uint16` with the first 8 bits relating to horizontal movement
+  and the last 8 - to vertical movement.
+
+Example:
+
+```
+&mwh SCROLL_UP
+```