Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents


The Osepp driver for proximity measurement is used in conjunction with the Osepp proximity sensor to detect an object's proximity in relation to the sensor. The OSEPP IR Proximity Sensor Module measures whether an object is close to it or not. It utilizes the Sharp GP2Y0D805Z0F measuring sensor unit which is composed of an integrated combination of photo diode, infrared emitting diode and a signal processor. The digital value from the proximity sensor is read out on the I²C bus.

Driver Parameters

The OSEPP proximity driver for the Osepp sensor has one parameter that needs to be configured:

I2C Address

This is the address the device is being referenced by on the I2C bus. The Osepp proximity can have an I2C hex address of 0x20, 0x22, 0x24 or 0x26. The address can be adjusted via dip switches on the bottom of the sensor.



The SDA and SCL pins are connected between the Osepp sensor and the Builder base. The GND and 3.3V pins from the Builder Base are then connected to the GND and VIN pins on the Osepp sensor.




Used Pins

Used Pins



The Serial Data Line


The Serial Clock Line


This pin provides the power


This pin provides the GND

How to write an App

Navigate to the App Builder and create a new application. You can find the “Proximity” code object under the “Hardware” Tab in the object drop down menu on the left, or you can also use the search bar.



Drag the “Proximity” Object onto the canvas.

Next, locate the “Text” Object under the Interface tab and drag it onto the canvas.


Finally, connect the “State” port from the Motion Sensor Object block to the “State” port on the Switch block and save your application.


How to create a firmware

Navigate to the Firmware Builder and create a new firmware file.

Click the “+ Add Hardware” button which will open a modal window. Scroll down in the list to find the “Sensor” section and select the “Proximity” hardware option.

Give your device a name, and click “Add Device”



Next, select the “Osepp Proximity” driver under the driver dropdown menu.



For this example we select:

  • I2C Address: 0x20


You may now save your firmware file and upload it to one of your clients.



Supported Hardware

  • Osepp Proximity



View file
nameProximity App.json


View file
nameProximity Firmware.json