> ## Documentation Index
> Fetch the complete documentation index at: https://docs.embedder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# कॉमन वर्कफ़्लोज़

यह पेज setup, hardware interaction, firmware development, debugging, और session management के practical workflows देता है।

## नया प्रोजेक्ट शुरू करें

<Steps>
  <Step title="प्रोजेक्ट बनाएं या चुनें">
    ```txt embedder theme={"system"}
    /project
    ```

    <Frame caption="Project selection interface">
      <img src="https://mintcdn.com/embedder/4y2q1agcuRz3fRND/images/select-project.png?fit=max&auto=format&n=4y2q1agcuRz3fRND&q=85&s=a9be00239cea81ce0616f63c85ec8a36" alt="project selection dialog" width="1992" height="1656" data-path="images/select-project.png" />
    </Frame>
  </Step>

  <Step title="प्लेटफ़ॉर्म चुनें">
    अपनी hardware platform चुनें या custom platform जोड़ें।

    <Frame caption="Platform selection interface">
      <img src="https://mintcdn.com/embedder/ujO4-sDifSwa2qo6/images/select-platform.png?fit=max&auto=format&n=ujO4-sDifSwa2qo6&q=85&s=a6c3fc150ba41632be86d7a8f4b7f876" alt="platform selection dialog" width="1980" height="1636" data-path="images/select-platform.png" />
    </Frame>
  </Step>

  <Step title="पेरिफेरल जोड़ें">
    ज़रूरी peripherals चुनें (I2C, SPI, UART, आदि)।

    <Frame caption="Peripheral selection interface">
      <img src="https://mintcdn.com/embedder/ujO4-sDifSwa2qo6/images/select-peripherals.png?fit=max&auto=format&n=ujO4-sDifSwa2qo6&q=85&s=5bf9421145a180e0648c9072b476478c" alt="peripheral selection dialog" width="1990" height="1646" data-path="images/select-peripherals.png" />
    </Frame>

    बाद में `/peripheral` दोबारा चलाकर config बदल सकते हैं।
  </Step>

  <Step title="EMBEDDER.md generate करें">
    ```txt embedder theme={"system"}
    /init
    ```

    इससे project context file बनती है।
  </Step>
</Steps>

## Hardware interaction

### Serial monitor

```txt Embedder theme={"system"}
/serial
```

या shortcut `` Ctrl+` `` इस्तेमाल करें।

Auto-connect बंद करने के लिए:

```txt Embedder theme={"system"}
> don't auto-connect to serial after flashing
```

Serial output filter के लिए toolbar में `[Filter]` का उपयोग करें।

<Frame>
  <img src="https://mintcdn.com/embedder/feqpp7Csqgb6FFzf/images/serial_filter.png?fit=max&auto=format&n=feqpp7Csqgb6FFzf&q=85&s=5e518da4c96ca100e44ea8ce95769018" alt="serial filter interface" style={{ maxWidth:"200px" }} width="688" height="1254" data-path="images/serial_filter.png" />
</Frame>

## Firmware development

### Driver लिखना

```txt Embedder theme={"system"}
> write an I2C driver for the BME280 sensor on I2C1 (SDA=PB7, SCL=PB6).
> include functions for reading temperature, humidity, and pressure.
```

```txt Embedder theme={"system"}
> create a UART driver for GPS module on UART2 at 9600 baud.
> implement a ring buffer for RX and parse NMEA sentences.
```

### Build और flash

<Steps>
  <Step title="Dependencies install करें">
    ```txt Embedder theme={"system"}
    > help me install the dependencies for this project
    ```
  </Step>

  <Step title="Project build करें">
    ```txt Embedder theme={"system"}
    > build the project
    ```
  </Step>

  <Step title="Firmware flash करें">
    ```txt Embedder theme={"system"}
    > flash the firmware to the device
    ```
  </Step>

  <Step title="Build + flash + monitor">
    ```txt Embedder theme={"system"}
    > build and flash, then show me the serial output
    ```
  </Step>
</Steps>

## Serial debug

```txt Embedder theme={"system"}
> what's causing this error in the serial output?
```

```txt Embedder theme={"system"}
> the device keeps resetting, analyze the crash dump
```

## Plan vs Act mode

* **Act mode**: read/write/execute
* **Plan mode**: read-only analysis

Switch:

* `Shift+Tab`
* `/plan`
* `/act`

## Documentation और context

अतिरिक्त docs `/console` से अपलोड करें।

<Frame caption="Documentation upload interface">
  <img src="https://mintcdn.com/embedder/4y2q1agcuRz3fRND/images/console-docs.png?fit=max&auto=format&n=4y2q1agcuRz3fRND&q=85&s=3e8e4a0ae841d2d936c8f3a2c5de982a" alt="documentation upload screen" width="3016" height="2152" data-path="images/console-docs.png" />
</Frame>

## Bash mode

```bash theme={"system"}
!ls -la
!make clean
!git status
```

## Serial send mode

```txt embedder theme={"system"}
~help
~reset
~get status
```

## `@` से file/dir reference

```txt Embedder theme={"system"}
> explain the logic in @src/main.c
```

```txt Embedder theme={"system"}
> what's in @src/drivers/?
```

## Session management

```txt Embedder theme={"system"}
/project
/history
/compress
```

## Quick reference

| Workflow          | Command/Shortcut                       |
| ----------------- | -------------------------------------- |
| New project setup | `/project` -> `/peripheral` -> `/init` |
| Serial monitor    | `/serial` या `` Ctrl+` ``              |
| Mode switch       | `Shift+Tab` या `/plan` `/act`          |
| Add peripheral    | `/peripheral`                          |
| File reference    | `@filename`                            |
| Bash mode         | `!command`                             |
| Serial send       | `~message`                             |
| Undo              | `/undo` या `Ctrl+Z`                    |
| Rewind            | `/rewind` या `Ctrl+Z (2x)`             |
| Help              | `/help`                                |