towards getting started

Author: pelikhan

jacs/samples/pico-pressure-button.ts

@@ -0,0 +1,2 @@
+const sensor = roles.airPressure()
+const mouse = roles.hidMouse()

website/docs/getting-started/_category_.json

@@ -0,0 +1,5 @@
+{
+    "label": "Getting Started",
+    "position": 1.5,
+    "collapsible": true
+}

website/docs/getting-started/index.md

@@ -0,0 +1,10 @@
+# Getting Started
+
+This section contains various guides to get started with DeviceScript on different micro-controllers.
+The guides don't assume any deep embedded development knowledge.
+
+## Pico Pressure Button
+
+In this guide, you'll use a Raspberry Pi Pico and a pressure sensor to create a mouse button actionable with the mouse.
+
+* [Start guide](/getting-started/pico-pressure-button)

website/docs/getting-started/pico-pressure-button.md

@@ -0,0 +1,19 @@
+# Pico Pressure Button
+
+In this guide, you'll use a Raspberry Pi Pico and a pressure sensor to create a mouse button actionable with the mouse.
+
+:::tip
+Don't worry about the necessary hardware yet, you can use DeviceScript simulator get started without it.
+:::
+
+## Roles
+
+In DeviceScript, all access to sensors, actuators or other hardware components is abstracted through [Jacdac](https://aka.ms/jacdac) services.
+To interact with Jacdac services, you define **roles** for each service you need.
+
+In this scenario, we will need to measure air pressure and send HID mouse commands. Therefore, we declare a `airPressure` role and a `hidMouse` role.
+
+```ts
+const sensor = roles.airPressure()
+const mouse = roles.hidMouse()
+```