Using the Studio
Included with Warsha BLE Studio for macOS
Using the macOS Workspace
Set up and run a target
Open Build and pick a target in the sidebar. Search covers your scripts, peripheral presets, and composed devices. Use the disclosure controls beside the group names to collapse groups you aren’t using.
Presets and composed devices have three views:
| View | What you can do |
|---|---|
| Setup | Set initial values and configure the target before running. Saved initial values apply to the next run. |
| Live Controls | Change writable values, trigger actions, and watch readings from the running peripheral. |
| GATT | Inspect declared services, characteristic UUIDs, and supported operations. During a run, select or copy available raw values from the characteristic rows. |
Choose a destination in Run on, then click Run. Start with Local simulation to try the controls without advertising. The app opens Live Controls when the target starts. For a numeric control, drag the slider or type an exact value. Return, Apply, or moving focus out of the field commits a valid value. An invalid value stays in the field with an error until you correct it. Run checks pending Setup values before starting. Switch back to Setup at any time to see your pending entries.
The bottom session strip names the running target and its destination. You can browse another target or switch to Explore while the peripheral runs. Click Show active session to return to its controls. In Explore, ⌘. stops scanning. Use Stop peripheral in either workspace to end the peripheral run. After a normal stop, Run Again starts another session from the open Live Controls view.
If a maintenance or required-update screen appears during a run, it still names the session and offers Stop peripheral. If cleanup fails, use Retry Stop on that screen. New runs remain unavailable while the operational block is active.
Inspect a run
Click Inspector in the toolbar or press ⌥⌘I to show Diagnostics. Expand Connections or Session events when available to inspect connected centrals, writes, and subscriptions. Drag the divider to adjust the pane’s width. When the window is too narrow for a separate pane, open Diagnostics within Live Controls. If timers are throttled, Live Controls shows a warning.
Click Console in the bottom strip or press ⌘J to see logs. You can search, filter by level, select individual lines, or click Copy Filtered Output. Drag the divider above Console to resize it. Scrolling back pauses Follow output so you can investigate older messages. Turn it back on or click New output — Follow to return to the latest entries.
Edit a script
Select a script in Build to open Code. During its run, a wide window shows the editor and live controls side by side. In a narrower window, switch between Code and Live Controls. You can adjust the companion pane by dragging its divider. For a selected script that is idle, Inspector shows its declared capabilities.
Edit → Format Script formats the current JavaScript or TypeScript file as an undoable edit. Undo and Redo follow the active field or editor. Each script file has its own editing history. Click Save to keep your changes. Change the code size in Settings → General → Code Editor or from the Code menu.
If another editor changes the script, use Edit → Reload Script… in Code to review the stored version. Reload asks before replacing unsaved changes.
For an app update, choose Help → Check for Updates….