Mike J. Chen d8dbdf7ead Add service/aah_timesrv
This is a common time service used by Tungsten for synchronizing
distributed playback.

This is a squashed merge from master-tungsten of the following changes:

commit 43be3231034ff8537fdd84422a7954780038671f
Author: John Grossman <johngro@google.com>
Date:   Mon Jun 27 18:59:12 2011 -0700

    Move libaah_rtp over from the vendor directory.

    Also move factor PipeEvent out into utils.

    Change-Id: Id3877c66efe22d771cf3ef4877107e431b828e37

commit a148e2674b1d3cb73289b82b85c333f0a66824a9
Author: John Grossman <johngro@google.com>
Date:   Mon Jun 20 17:02:24 2011 -0700

    Move the A@H time service into frameworks/base

    Change-Id: I5c570cde70e8931e205516cb33517585804ce841

commit 86c94c7d6780fcfa4e1146325706fb78bc30544c
Author: Jason Simmons <jsimmons@google.com>
Date:   Mon Jun 20 15:44:31 2011 -0700

    Update the service manager UID table to match the new name of the common clock service

    Change-Id: I5a65e84e8dff743c69d182e9851e58fc68791564

commit 6ab14c34be8c1b10b1258bdebbba1e52743ff5b9
Author: Jason Simmons <jsimmons@google.com>
Date:   Fri Jun 3 18:19:40 2011 -0700

    Add tungsten_timesrv to init.rc

    Change-Id: I851aa990612440e1df1af992ed6e4d64b54a4951

Change-Id: Id832a0a00d447aa562bb7476902799bfa5bbda8d
Signed-off-by: Mike J. Chen <mjchen@google.com>
Signed-off-by: John Grossman <johngro@google.com>
2011-10-28 10:14:48 -04:00

122 lines
3.7 KiB
C++

/*
* Copyright (C) 2011 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#ifndef __CLOCK_RECOVERY_H__
#define __CLOCK_RECOVERY_H__
#include <stdint.h>
#include <utils/LinearTransform.h>
#include <utils/threads.h>
#ifdef AAH_TSDEBUG
#include "diag_thread.h"
#endif
namespace android {
class CommonClock;
class LocalClock;
class ClockRecoveryLoop {
public:
ClockRecoveryLoop(LocalClock* local_clock, CommonClock* common_clock);
~ClockRecoveryLoop();
void reset(bool position, bool frequency);
bool pushDisciplineEvent(int64_t local_time,
int64_t nominal_common_time,
int64_t data_point_rtt);
private:
typedef struct {
// Limits for the correction factor supplied to set_counter_slew_rate.
// The controller will always clamp its output to the range expressed by
// correction_(min|max)
int32_t correction_min;
int32_t correction_max;
// Limits for the internal integration accumulator in the PID
// controller. The value of the accumulator is scaled by gain_I to
// produce the integral component of the PID controller output.
// Platforms can use these limits to prevent windup in the system
// if/when the correction factor needs to be driven to saturation for
// extended periods of time.
int32_t integrated_delta_min;
int32_t integrated_delta_max;
// Gain for the P, I and D components of the controller.
LinearTransform gain_P;
LinearTransform gain_I;
LinearTransform gain_D;
} PIDParams;
typedef struct {
int64_t local_time;
int64_t observed_common_time;
int64_t nominal_common_time;
int64_t rtt;
bool point_used;
} DisciplineDataPoint;
static uint32_t findMinRTTNdx(DisciplineDataPoint* data, uint32_t count);
void computePIDParams();
void reset_l(bool position, bool frequency);
static int32_t doGainScale(const LinearTransform& gain, int32_t val);
void applySlew();
// The local clock HW abstraction we use as the basis for common time.
LocalClock* local_clock_;
bool local_clock_can_slew_;
// The common clock we end up controlling along with the lock used to
// serialize operations.
CommonClock* common_clock_;
Mutex lock_;
// The parameters computed to be used for the PID Controller.
PIDParams pid_params_;
// The maximum allowed error (as indicated by a pushDisciplineEvent) before
// we panic.
int32_t panic_thresh_;
// parameters maintained while running and reset during a reset
// of the frequency correction.
bool last_delta_valid_;
int32_t last_delta_;
int32_t integrated_error_;
int32_t correction_cur_;
// State kept for filtering the discipline data.
static const uint32_t kFilterSize = 6;
DisciplineDataPoint filter_data_[kFilterSize];
uint32_t filter_wr_;
bool filter_full_;
static const uint32_t kStartupFilterSize = 4;
DisciplineDataPoint startup_filter_data_[kStartupFilterSize];
uint32_t startup_filter_wr_;
#ifdef AAH_TSDEBUG
sp<DiagThread> diag_thread_;
#endif
};
} // namespace android
#endif // __CLOCK_RECOVERY_H__