Introduction

This manual provides detailed information on Cambrionix Intents, a set of predefined actions designed to control Cambrionix products through the Apple Shortcuts application. Apple Shortcuts is a powerful automation app available for macOS that enables users to create custom workflows, known as "shortcuts." These workflows can automate a variety of tasks, ranging from simple operations to complex sequences of actions.

What are Cambrionix Intents?

Cambrionix Intents are specialised actions that allow users to interact with Cambrionix devices through the Cambrionix API. These intents are built to integrate seamlessly with the Shortcuts app, making it easy to add and control features of your Cambrionix products within custom workflows.

Features and Capabilities

By using Cambrionix Intents in the Shortcuts app, users can automate and control various functions of their Cambrionix hubs, such as:

  • Port Control:

    Manage individual USB ports, including turning them on or off, resetting them, or configuring power levels.

  • LED Control:

    Adjust or change the status and colour of LED lights on supported hubs, providing visual feedback or notifications within your workflows.

  • Hub Status Monitoring:

    Gather real-time information about the hub, such as connected devices, power usage, and port activity.

How Cambrionix Intents Work

Cambrionix Intents act as a bridge between your Cambrionix devices and the Shortcuts app. Each intent corresponds to a specific function available in the Cambrionix API. For example, you can drag and drop an intent into a shortcut workflow to trigger actions like controlling USB ports or changing LED lights, making your automation smarter and more responsive.

Integration with Apple Shortcuts

The Shortcuts app allows users to combine multiple actions and commands, creating powerful automations across apps and devices. With Cambrionix Intents, users can now incorporate control over their USB hubs into these workflows. Whether you're setting up a workflow for charging management, data synchronisation, or visual indicators, Cambrionix Intents offer full control over your hub’s functionality.

Specific features and functions of the app may vary depending on the version of macOS you are using. For the best experience, ensure that your operating system and the Shortcuts app are up-to-date. For the latest information, it is recommended to check the official Apple website or refer to the macOS user guide.

Benefits of Using Cambrionix Intents
  • Streamlined Automation:

    Easily integrate control over your Cambrionix devices within broader workflows.

  • Customisation:

    Create workflows that combine Cambrionix actions with other apps, tasks, or system commands for a fully customised automation experience.

  • Increased Efficiency:

    Automate repetitive tasks like turning USB ports on/off, managing power distribution, or monitoring hub status, saving time and improving productivity.

By using Cambrionix Intents, users can unlock the full potential of their hubs, incorporating advanced functionality into their daily workflows while enjoying the convenience and power of Apple’s automation ecosystem.

Prerequisites

In order to use Cambrionix Intents with the Apple Shortcuts application you will require the following:

  • macOS Monterey (version 12) or later versions

  • Shortcuts App (this is pre installed on macOS Monterey and later versions)

Optionally if you wish to synchronise shortcuts across devices using iCloud an Apple ID is required. You will also require the Cambrionix software relevant to the actions 'Intents' you wish to use.

Cambrionix Hub API Use these API Intents to control the Cambrionix Hub and view information