Hosting custom DSP blocks

​Building custom processing blocks is available for everyone but has to be self-hosted. If you want to host it on Edge Impulse infrastructures, you can do that within your organization interface.
In this tutorial, you'll learn how to use Edge Impulse CLI to push your custom DSP block to your organisation and how to make this processing block available in the Studio for all users in the organization.
The Custom Processing block we are using for this tutorial can be found here: https://github.com/edgeimpulse/edge-detection-processing-block. It is written in Python. Please note that one of the beauties with custom blocks is that you can write them in any language as we will host a Docker container and we are not tied to a specific runtime.
Only available for enterprise customers
Organizational features are only available for enterprise customers. View our pricing for more information.
Prerequisites
You'll need:
The Edge Impulse CLI. If you receive any warnings that's fine. Run edge-impulse-blocks afterwards to verify that the CLI was installed correctly.
​Docker desktop installed on your machine. Custom blocks use Docker containers, a virtualization technique which lets developers package up an application with all dependencies in a single package. If you want to test your blocks locally you'll also need (this is not a requirement):
A Custom Processing block running with Docker.
Init and upload your custom DSP block
Inside your Custom DSP block folder, run the following command:
1
edge-impulse-blocks init --clean
Copied!
The output will look like this:
1
? What is your user name or e-mail address (edgeimpulse.com)? 
2
? What is your password? [hidden]
3
Edge Impulse Blocks v1.14.3
4
Attaching block to organization 'Demo Team'
5
​
6
? Choose a type of block 
7
  Transformation block 
8
  Deployment block 
9
❯ DSP block 
10
  Transfer learning block 
11
​
12
? Enter the name of your block Edge: Detection
13
​
14
? Enter the description of your block: Edge Detection processing block using Canny filters in images
15
​
16
Creating block with config: {
17
  version: 1,
18
  config: {
19
    'edgeimpulse.com': {
20
      name: 'Edge Detection',
21
      type: 'dsp',
22
      description: 'Edge Detection processing block using Canny filters in images',
23
      organizationId: XXX,
24
      operatesOn: undefined,
25
      tlObjectDetectionLastLayer: undefined,
26
      tlOperatesOn: undefined
27
    }
28
  }
29
}
30
Your new block 'Edge Detection' has been created in '<PATH>'.
31
When you have finished building your dsp block, run 'edge-impulse-blocks push' to update the block in Edge Impulse.
Copied!
Modify or update your custom code if needed and run the following command:
1
edge-impulse-blocks push            
Copied!
The output will look similar to this:
1
Edge Impulse Blocks v1.14.3
2
? What port is your block listening on? 4446
3
​
4
Archiving 'edge-detection-processing-block'...
5
Archiving 'edge-detection-processing-block' OK (476 KB) /var/folders/7f/pfcmh61s3hg9c59qd0dkkw5w0000gn/T/ei-dsp-block-c729b4a3ff761b64629617c869e9d934.tar.gz
6
​
7
Uploading block 'Edge Detection' to organization 'Demo Team'...
8
Uploading block 'Edge Detection' to organization 'Demo Team' OK
9
​
10
Building dsp block 'Edge Detection'...
11
Job started
12
...
13
Building dsp block 'Edge Detection' OK
Copied!
That's it, now your custom DSP block is hosted on your organization. To make sure it is up and running, in your organisation, go to Custom blocks->DSP and you will see the following screen:
DSP Blocks in organization
Use your custom hosted DSP block in your projects
To use your DSP block, simply add it as a processing block in the Create impulse view:
Custom processing block available in your organization's projects
Other resources
Full instruction on how to build processing blocks: Building custom processing blocks​
Blog post: Utilize Custom Processing Blocks in Your Image ML Pipelines​

Deployment metadata spec

Adding custom learning blocks

Last modified 2mo ago

Export as PDF

Copy link

Contents

Prerequisites

Init and upload your custom DSP block

Use your custom hosted DSP block in your projects

Other resources