Omi DevKit 2 Setup - Omi

The Omi DevKit 2 is designed for developers who want to build, test, and customize their Omi experience.

Quick Setup

<Steps> <Step title="Power On Your DevKit" icon="power-off"> The DevKit 2 has multiple power options:

- **Switch method**: Use the physical switch if available on your version
- **Button method**: Press and hold the center button for 3 seconds
- **USB-C**: Can be powered directly via USB-C connection

Look for the LED indicator to confirm the device is powered on.

</Step> <Step title="Flash Firmware (If Needed)" icon="microchip"> DevKits may not come with firmware pre-installed:

1. Check if your device shows any LED activity when powered
2. If no activity, [flash the firmware here](/doc/get_started/Flash_device)
3. Follow the [DevKit 2 testing guide](/doc/developer/DevKit2Testing)

<Warning>
If you see no LED activity at all, firmware installation is required before the device will function.
</Warning>

</Step> <Step title="Download the Omi App" icon="mobile"> <CardGroup cols={2}> <Card title="App Store" icon="apple" href="https://apps.apple.com/fi/app/omi-ai-smart-meeting-notes/id6502156163"> Download for iOS </Card> <Card title="Play Store" icon="google-play" href="https://play.google.com/store/apps/details?id=com.friend.ios&hl=en_US&pli=1"> Download for Android </Card> </CardGroup> </Step> <Step title="Pair with App" icon="bluetooth"> 1. Open the Omi app 2. Follow pairing instructions 3. The DevKit should appear as a discoverable device 4. Test transcription by speaking near the device </Step> </Steps>

Button Controls

<CardGroup cols={2}> <Card title="Single Press" icon="hand-pointer"> **Turn On/Off**

Single press to power the device on or off

</Card> <Card title="Long Press" icon="hand"> **Voice Questions**

1. Press and hold until you feel a vibration
2. Keep pressed and ask your question
3. Release when you're done speaking
4. Get your answer in Omi chat or as a notification

</Card> </CardGroup>

Light Indicators

Color	Status
🔴 Red	Device is on but disconnected from your phone
🔵 Blue	Device is on and connected to your phone
🟠 Orange	Device is charging and disconnected
🟢 Teal	Device is charging and connected

Developer Features

<CardGroup cols={3}> <Card title="Firmware Customization" icon="wrench"> Modify and flash custom firmware </Card> <Card title="Testing Tools" icon="flask"> Built-in development testing </Card> <Card title="Audio Streaming API" icon="microphone"> Access raw audio data </Card> <Card title="Local Storage" icon="hard-drive"> On-device data access </Card> <Card title="GPIO Access" icon="plug"> Hardware pin control </Card> <Card title="Protocol Testing" icon="network-wired"> Debug communications </Card> </CardGroup>

Development Resources

<AccordionGroup> <Accordion title="Building Custom Apps" icon="puzzle-piece"> Learn how to build your own Omi apps with our [comprehensive guide](/doc/developer/apps/Introduction). You can create apps in just 2 minutes! </Accordion> <Accordion title="Backend Integration" icon="server"> Understand how to integrate with the Omi backend: [Backend Setup Guide](/doc/developer/backend/Backend_Setup) </Accordion> <Accordion title="Audio Streaming" icon="wave-square"> Access real-time audio data: [Audio Streaming Documentation](/doc/developer/apps/AudioStreaming) </Accordion> <Accordion title="Firmware Development" icon="microchip"> Customize the device firmware: [Firmware Compilation Guide](/doc/developer/firmware/Compile_firmware) </Accordion> <Accordion title="App Setup" icon="mobile"> Set up the Flutter development environment: [App Setup Guide](/doc/developer/AppSetup) </Accordion> </AccordionGroup>

Testing Your DevKit

<Steps> <Step title="LED Test" icon="lightbulb"> Device should show LED activity when powered </Step> <Step title="Bluetooth Test" icon="bluetooth"> Should appear in Bluetooth discoverable devices </Step> <Step title="Audio Test" icon="microphone"> Speak near the device and check for transcription </Step> <Step title="App Connection" icon="link"> Should maintain stable connection with the app </Step> </Steps>

Troubleshooting

<AccordionGroup> <Accordion title="No LED activity" icon="circle-xmark"> - Check power connection (USB-C or battery) - Try different power methods (switch vs button) - Flash firmware if device is completely unresponsive - Check if battery is charged </Accordion> <Accordion title="Firmware flashing issues" icon="microchip"> - Ensure device is in DFU mode (double-click reset button) - Check USB-C cable and connection (some cables are charge-only) - Follow the [detailed flashing guide](/doc/get_started/Flash_device) - Try a different USB port </Accordion> <Accordion title="Development environment issues" icon="code"> - Review [development setup guide](/doc/developer/AppSetup) - Check [contribution guidelines](/doc/developer/Contribution) - Ensure all dependencies are installed - Ask for help in our [Discord](http://discord.omi.me) </Accordion> <Accordion title="Bluetooth connection drops" icon="bluetooth"> - Keep the app running in the foreground initially - Check for interference from other Bluetooth devices - Update to the latest firmware - Restart both the device and phone </Accordion> </AccordionGroup>

Community & Support

<CardGroup cols={2}> <Card title="Developer Discord" icon="discord" href="http://discord.omi.me"> Join development discussions </Card> <Card title="GitHub" icon="github" href="https://github.com/BasedHardware/omi/issues"> Contribute and report issues </Card> <Card title="Documentation" icon="book" href="https://docs.omi.me"> Full developer documentation </Card> <Card title="Email Support" icon="envelope" href="mailto:[email protected]"> Contact [email protected] </Card> </CardGroup>

<Card title="← Back to device selection" icon="arrow-left" href="/getstartedwithomi"> Choose a different device </Card>