/**************************************************************************** * * Copyright (c) 2014-2019 PX4 Development Team. All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * 3. Neither the name PX4 nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * ****************************************************************************/ #include "SF0X.hpp" #include /* Configuration Constants */ #define SF0X_TAKE_RANGE_REG 'd' SF0X::SF0X(const char *port, uint8_t rotation) : ScheduledWorkItem(MODULE_NAME, px4::serial_port_to_wq(port)), _px4_rangefinder(0 /* device id not yet used */, ORB_PRIO_DEFAULT, rotation), _sample_perf(perf_alloc(PC_ELAPSED, MODULE_NAME": read")), _comms_errors(perf_alloc(PC_COUNT, MODULE_NAME": com_err")) { /* store port name */ strncpy(_port, port, sizeof(_port) - 1); /* enforce null termination */ _port[sizeof(_port) - 1] = '\0'; } SF0X::~SF0X() { stop(); perf_free(_sample_perf); perf_free(_comms_errors); } int SF0X::init() { int32_t hw_model = 0; param_get(param_find("SENS_EN_SF0X"), &hw_model); switch (hw_model) { case 1: /* SF02 (40m, 12 Hz)*/ _px4_rangefinder.set_min_distance(0.30f); _px4_rangefinder.set_max_distance(40.0f); _interval = 83334; break; case 2: /* SF10/a (25m 32Hz) */ _px4_rangefinder.set_min_distance(0.01f); _px4_rangefinder.set_max_distance(25.0f); _interval = 31250; break; case 3: /* SF10/b (50m 32Hz) */ _px4_rangefinder.set_min_distance(0.01f); _px4_rangefinder.set_max_distance(50.0f); _interval = 31250; break; case 4: /* SF10/c (100m 16Hz) */ _px4_rangefinder.set_min_distance(0.01f); _px4_rangefinder.set_max_distance(100.0f); _interval = 62500; break; case 5: /* SF11/c (120m 20Hz) */ _px4_rangefinder.set_min_distance(0.01f); _px4_rangefinder.set_max_distance(120.0f); _interval = 50000; break; default: PX4_ERR("invalid HW model %d.", hw_model); return -1; } start(); return PX4_OK; } int SF0X::measure() { // Send the command to begin a measurement. char cmd = SF0X_TAKE_RANGE_REG; int ret = ::write(_fd, &cmd, 1); if (ret != sizeof(cmd)) { perf_count(_comms_errors); PX4_DEBUG("write fail %d", ret); return ret; } return PX4_OK; } int SF0X::collect() { perf_begin(_sample_perf); /* clear buffer if last read was too long ago */ int64_t read_elapsed = hrt_elapsed_time(&_last_read); /* the buffer for read chars is buflen minus null termination */ char readbuf[sizeof(_linebuf)]; unsigned readlen = sizeof(readbuf) - 1; /* read from the sensor (uart buffer) */ const hrt_abstime timestamp_sample = hrt_absolute_time(); int ret = ::read(_fd, &readbuf[0], readlen); if (ret < 0) { PX4_DEBUG("read err: %d", ret); perf_count(_comms_errors); perf_end(_sample_perf); /* only throw an error if we time out */ if (read_elapsed > (_interval * 2)) { return ret; } else { return -EAGAIN; } } else if (ret == 0) { return -EAGAIN; } _last_read = hrt_absolute_time(); float distance_m = -1.0f; bool valid = false; for (int i = 0; i < ret; i++) { if (OK == sf0x_parser(readbuf[i], _linebuf, &_linebuf_index, &_parse_state, &distance_m)) { valid = true; } } if (!valid) { return -EAGAIN; } PX4_DEBUG("val (float): %8.4f, raw: %s, valid: %s", (double)distance_m, _linebuf, ((valid) ? "OK" : "NO")); _px4_rangefinder.update(timestamp_sample, distance_m); perf_end(_sample_perf); return PX4_OK; } void SF0X::start() { /* reset the report ring and state machine */ _collect_phase = false; /* schedule a cycle to start things */ ScheduleNow(); } void SF0X::stop() { ScheduleClear(); } void SF0X::Run() { /* fds initialized? */ if (_fd < 0) { /* open fd */ _fd = ::open(_port, O_RDWR | O_NOCTTY | O_NONBLOCK); if (_fd < 0) { PX4_ERR("open failed (%i)", errno); return; } struct termios uart_config; int termios_state; /* fill the struct for the new configuration */ tcgetattr(_fd, &uart_config); /* clear ONLCR flag (which appends a CR for every LF) */ uart_config.c_oflag &= ~ONLCR; /* no parity, one stop bit */ uart_config.c_cflag &= ~(CSTOPB | PARENB); /* if distance sensor model is SF11/C, then set baudrate 115200, else 9600 */ int32_t hw_model = 0; param_get(param_find("SENS_EN_SF0X"), &hw_model); unsigned speed; if (hw_model == 5) { speed = B115200; } else { speed = B9600; } /* set baud rate */ if ((termios_state = cfsetispeed(&uart_config, speed)) < 0) { PX4_ERR("CFG: %d ISPD", termios_state); } if ((termios_state = cfsetospeed(&uart_config, speed)) < 0) { PX4_ERR("CFG: %d OSPD", termios_state); } if ((termios_state = tcsetattr(_fd, TCSANOW, &uart_config)) < 0) { PX4_ERR("baud %d ATTR", termios_state); } } /* collection phase? */ if (_collect_phase) { /* perform collection */ int collect_ret = collect(); if (collect_ret == -EAGAIN) { /* reschedule to grab the missing bits, time to transmit 8 bytes @ 9600 bps */ ScheduleDelayed(1042 * 8); return; } if (OK != collect_ret) { /* we know the sensor needs about four seconds to initialize */ if (hrt_absolute_time() > 5 * 1000 * 1000LL && _consecutive_fail_count < 5) { PX4_ERR("collection error #%u", _consecutive_fail_count); } _consecutive_fail_count++; /* restart the measurement state machine */ start(); return; } else { /* apparently success */ _consecutive_fail_count = 0; } /* next phase is measurement */ _collect_phase = false; } /* measurement phase */ if (OK != measure()) { PX4_DEBUG("measure error"); } /* next phase is collection */ _collect_phase = true; /* schedule a fresh cycle call when the measurement is done */ ScheduleDelayed(_interval); } void SF0X::print_info() { perf_print_counter(_sample_perf); perf_print_counter(_comms_errors); _px4_rangefinder.print_status(); }