DFRobot_MatrixLidar

• 中文版

This is a user library for retrieving TOF sensor raw data and providing obstacle avoidance suggestions.

Product Link (https://www.dfrobot.com)

SKU:SEN0628

Table of Contents

• Summary
• Installation
• Methods
• Compatibility
• History
• Credits

Summary

This is a user library for retrieving TOF sensor raw data and providing obstacle avoidance suggestions.

Installation

To use this library, download the library file first, paste it into the \Arduino\libraries directory, then open the examples folder and run the demo in the folder.

Methods

    /**
     * @fn begin
     * @brief Initializes the sensor
     * @return NULL
     */
    uint8_t begin(void);

     /**
     * @fn setRangingMode
     * @brief Configures the retrieval of all data
     * @param matrix Configuration matrix for sensor sampling
     * @return Returns the configuration status
     * @retval 0 Success
     * @retval 1 Failure
     */
    uint8_t setRangingMode(eMatrix_t matrix);


    /**
     * @fn getAllData
     * @brief Retrieves all data
     * @param buf Buffer to store the data
     */
    uint8_t getAllData(void *buf);

    /**
     * @fn getFixedPointData
     * @brief Retrieves data for a specific point
     * @param x X coordinate
     * @param y Y coordinate
     * @return Returns the retrieved data
     */
    uint16_t getFixedPointData(uint8_t x, uint8_t y);

    /**
     * @fn getLineData
     * @brief Retrieves one row of matrix data
     * @param line Row index
     * @param buf Buffer to store the data
     * @return Returns the retrieved data
     */
    uint8_t getLineData(uint8_t line, void *buf);
    /**
     * @fn getListData
     * @brief Retrieves one column of matrix data
     * @param list Column index
     * @param buf Buffer to store the data
     * @return Returns the retrieved data
     */
    uint8_t getListData(uint8_t list, void *buf);

Compatibility

MCU	Work Well	Work Wrong	Untested	Remarks
Arduino uno	√
FireBeetle esp32	√
FireBeetle esp8266	√
FireBeetle m0	√
Leonardo	√
Microbit	√
Arduino MEGA2560	√

History

• data 2025-04-02
• version V1.0
• data 2026-0507
• version V1.0.1

Credits

Written by tangjie(jie.tang@dfrobot.com), 2026. (Welcome to our website)