Skip to main content
W
Warsha Everything Mobile
Documentation / BLE Studio / macOS / Using the macOS Workspace
Browse documentation

Using the Studio

Included with Warsha BLE Studio for macOS

v1.4.0

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:

ViewWhat you can do
SetupSet initial values and configure the target before running. Saved initial values apply to the next run.
Live ControlsChange writable values, trigger actions, and watch readings from the running peripheral.
GATTInspect 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….