28b8dc9996
Current pi servo steps clock without any condition on start. This patch adds a new servo option "configured_pi_f_offset". The option is similar to configured_pi_offset but only affects in the first clock update. Therefore, if this option is set as 0.0, we can prevent clock step on start. The new servo option can be specified from phc2sys by using -F option. This feature is usefull when we need to restart phc2sys without system clock jump. Restarting phc2sys is needed to change its configuration. changes since v2: - manual page fix. - also apply max_offset along with max_f_offset in servo step1. - add a variable to check if first update is done. changes since v1:(http://sourceforge.net/mailarchive/message.php?msg_id=31039874) - remake as a new servo option. Signed-off-by: Ken ICHIKAWA <ichikawa.ken@jp.fujitsu.com>
63 lines
2.0 KiB
C
63 lines
2.0 KiB
C
/**
|
|
* @file pi.h
|
|
* @note Copyright (C) 2011 Richard Cochran <richardcochran@gmail.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*/
|
|
#ifndef HAVE_PI_H
|
|
#define HAVE_PI_H
|
|
|
|
#include "servo.h"
|
|
|
|
/**
|
|
* When set to a non-zero value, this variable determines the
|
|
* proportional constant for the PI controller.
|
|
*/
|
|
extern double configured_pi_kp;
|
|
|
|
/**
|
|
* When set to a non-zero value, this variable determines the
|
|
* integral constant for the PI controller.
|
|
*/
|
|
extern double configured_pi_ki;
|
|
|
|
/**
|
|
* When set to a non-zero value, this variable controls the maximum allowed
|
|
* offset before a clock jump occurs instead of the default clock-slewing
|
|
* mechanism.
|
|
*
|
|
* Note that this variable is measured in seconds, and allows fractional values.
|
|
*/
|
|
extern double configured_pi_offset;
|
|
|
|
/**
|
|
* When set to zero, the clock is not stepped on start. When set to a non-zero
|
|
* value, the value bahaves as a threshold and the clock is stepped on start if
|
|
* the offset is bigger than the threshold.
|
|
*
|
|
* Note that this variable is measured in seconds, and allows fractional values.
|
|
*/
|
|
extern double configured_pi_f_offset;
|
|
|
|
/**
|
|
* When set to a non-zero value, this variable sets an additional limit for
|
|
* the frequency adjustment of the clock. It's in ppb.
|
|
*/
|
|
extern int configured_pi_max_freq;
|
|
|
|
struct servo *pi_servo_create(int fadj, int max_ppb, int sw_ts);
|
|
|
|
#endif
|