GP2Y0A21YK0F

GP2Y0A21YK0F is a distance measuring sensor IC (100mm to 800mm) made by Sharp. This posting will provide the OSS-ECAL(Open Source Software for Electronic Components Abstraction Layer) for GP2Y0A21YK0F.
MCU interface : ADC

CAUTION:Please be sure to refer to the latest version of the Datasheet prior to actual design.

GP2Y0A21YK0F

General description

GP2Y0A21YK0F is a distance measuring sensor unit,composed of an integrated combination of PSD(position sensitive detector) , IR-LED (infrared emitting diode) and signal processing circuit.The variety of the reflectivity of the object, the environmental temperature and the operating duration are not influenced easily to the distance detection because of adopting the triangulation method. This device outputs the voltage corresponding to the detection distance. So this sensor can also be used as a proximity sensor.

Feature
  • Distance measuring sensor is united with PSD,infrared LED and signal processing circuit
  • Distance measuring range : 10 to 80 cm
  • Compact size (29.5 × 13.0 × 13.5mm)
  • Analog output type
Application
  • Touch-less switch
  • Robot cleaner
  • Sensor for energy saving
  • Amusement equipment

OSS-ECAL specification

API Function

etSTS oGP2Y0A21YK0F( etCMD cmd, float32* rlt )

Return value
Parameter IN
Parameter OUT

etSTS
etCMD cmd
float32* rlt

OSS-ECAL status code
OSS-ECAL command code
Distance 100 to 800 [mm]

etCMD
eCMD_START


Feature :
Command to start AD conversion.

Process :
1. AD conversion start.

Command API function :
etSTS oGP2Y0A21YK0F_START( void )

Return value :
eSTS_FIN
eSTS_ERR_HAL_ADC
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_ADC_OBJECT

NOTE :
Arduino, Mbeb, ModusToolbox not supported.

eCMD_READ

Feature :
Command that reads the AD conversion value, converts the AD conversion value to a characteristic Distance, and stores the Distance in rlt.

Process :
1. Read AD conversion value.
2. Convert AD conversion value to Distance.
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Distance = ((voltage value – voltage offset value) / gain) + Distance offset value (Min, Max Limit)
3. Store Distance to rlt.

Command API function :
etSTS oGP2Y0A21YK0F_READ( float32* rlt )

Return value :
eSTS_FIN
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_ADC
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_ADC_OBJECT

NOTE :
Please execute this API function after starting AD conversion.
Arduino, Mbeb, ModusToolbox not supported.

eCMD_START_READ

Feature :
Command that starts AD conversion, waits for AD conversion to finish, reads out the AD conversion value, converts the AD conversion value to a characteristic Distance, and stores the Distance in rlt.

Process :
1. AD conversion start.
2. Wait until AD conversion is completed.
3. Read AD conversion value.
4. Convert AD conversion value to Distance.
Voltage value = (AD conversion value × VDD) / ( 2AD bit )
Distance = ((voltage value – voltage offset value) / gain) + Distance offset value (Min, Max Limit)
5. Store Distance to rlt.

Command API function :
etSTS oGP2Y0A21YK0F_START_READ( float32* rlt )

Return value :
eSTS_FIN
eSTS_ERR_MIN
eSTS_ERR_MAX
eSTS_ERR_HAL_ADC
eSTS_ERR_COMMAND_CODE
eSTS_ERR_OTHERS_RUN
eSTS_ERR_ADC_OBJECT

NOTE :

Files
Folder*Filesummary
GP2Y0A21YK0F_HALNAME/samplesample.c (.cpp)Sample Application Program
sample.hSample Application Header
GP2Y0A21YK0F_HALNAMEoGP2Y0A21YK0F.c (.cpp)OSS-ECAL Program for GP2Y0A21YK0F
oGP2Y0A21YK0F.hOSS-ECAL Header for GP2Y0A21YK0F
oss_ecal.hOSS-ECAL Common Header (Ver 01.00.00 or later)
user_setting.c (.cpp)Const and Table of User setting
user_setting.hHeader of User setting
readme.mdReadme
OSS-ECAL Terms of Use.txtOSS-ECAL Terms of Use

* For HALNAME, please refer to HAL Support.

HAL Support List
MCU/Board
manufacturer
HALMCU*Development environment*HALNAME
ArduinoArduino 1.8.6ATmega2560
ATmega328P
Mega 2560 Rev3
Arduino Pro Mini 3.3V
ARDUINO
ARMMbed 6.17.0STM32F401RETxSTM32 Nucleo-64 boardsMBED
InfineonModusToolbox HAL Cat1 2.4.3CYBLE-416045-02CY8CPROTO-063-BLE PSoC 6 BLE Prototyping KitModusToolbox
NXPMCUXpresso SDK
iMXRT1051B_1052B
ksdk2_0
CYBLE-416045-02IMXRT1050-EVKBiMXRT1051B1052B
RenesasSSP 2.4.0R7FS7G27H3A01CFCS7G2 SKSSP
STMSTM32Cube FW_F4 V1.27.1STM32F401RETxSTM32 Nucleo-64 boardsSTM32F4

* MCU and development environment at the time of development. Even if the same HAL is used, different MCUs and development environments may not work together.

Download

If you get “ABC.zip was blocked because this type of file can harm your device.” in Microsoft Edge.

If you are unable to download the File, please contact us and let us know the model number and HAL type. We will send you the file as an email attachment.

Built-in How to

How to incorporate OSS-ECAL into user programs

How to incorporate multiple OSS-ECALs in a user program (same MCU function)

How to incorporate multiple OSS-ECALs in a user program (different MCU function)

How to incorporate multiple identical electronic components into a user program

How to reduce the impact on user programs by replacing electronic components

OSS-ECAL English
error: Content is protected !!