Home | History | Annotate | Download | only in include 
      1 /*
      2  * Copyright (C) 2015 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #pragma once
     18 
     19 #include "DeviceDescriptor.h"
     20 #include "AudioRoute.h"
     21 #include <utils/RefBase.h>
     22 #include <utils/String8.h>
     23 #include <utils/Errors.h>
     24 #include <utils/Vector.h>
     25 #include <system/audio.h>
     26 #include <cutils/config_utils.h>
     27 #include <string>
     28 
     29 namespace android {
     30 
     31 class IOProfile;
     32 class InputProfile;
     33 class OutputProfile;
     34 
     35 typedef Vector<sp<IOProfile> > InputProfileCollection;
     36 typedef Vector<sp<IOProfile> > OutputProfileCollection;
     37 typedef Vector<sp<IOProfile> > IOProfileCollection;
     38 
     39 class HwModule : public RefBase
     40 {
     41 public:
     42     explicit HwModule(const char *name, uint32_t halVersionMajor = 0, uint32_t halVersionMinor = 0);
     43     ~HwModule();
     44 
     45     const char *getName() const { return mName.string(); }
     46 
     47     const DeviceVector &getDeclaredDevices() const { return mDeclaredDevices; }
     48     void setDeclaredDevices(const DeviceVector &devices);
     49 
     50     const InputProfileCollection &getInputProfiles() const { return mInputProfiles; }
     51     const OutputProfileCollection &getOutputProfiles() const { return mOutputProfiles; }
     52 
     53     void setProfiles(const IOProfileCollection &profiles);
     54 
     55     void setHalVersion(uint32_t major, uint32_t minor) {
     56         mHalVersion = (major << 8) | (minor & 0xff);
     57     }
     58     uint32_t getHalVersionMajor() const { return mHalVersion >> 8; }
     59     uint32_t getHalVersionMinor() const { return mHalVersion & 0xff; }
     60 
     61     sp<DeviceDescriptor> getRouteSinkDevice(const sp<AudioRoute> &route) const;
     62     DeviceVector getRouteSourceDevices(const sp<AudioRoute> &route) const;
     63     void setRoutes(const AudioRouteVector &routes);
     64 
     65     status_t addOutputProfile(const sp<IOProfile> &profile);
     66     status_t addInputProfile(const sp<IOProfile> &profile);
     67     status_t addProfile(const sp<IOProfile> &profile);
     68 
     69     status_t addOutputProfile(const String8& name, const audio_config_t *config,
     70             audio_devices_t device, const String8& address);
     71     status_t removeOutputProfile(const String8& name);
     72     status_t addInputProfile(const String8& name, const audio_config_t *config,
     73             audio_devices_t device, const String8& address);
     74     status_t removeInputProfile(const String8& name);
     75 
     76     audio_module_handle_t getHandle() const { return mHandle; }
     77     void setHandle(audio_module_handle_t handle);
     78 
     79     sp<AudioPort> findPortByTagName(const String8 &tagName) const
     80     {
     81         return mPorts.findByTagName(tagName);
     82     }
     83 
     84     // TODO remove from here (split serialization)
     85     void dump(int fd);
     86 
     87 private:
     88     void refreshSupportedDevices();
     89 
     90     const String8 mName; // base name of the audio HW module (primary, a2dp ...)
     91     audio_module_handle_t mHandle;
     92     OutputProfileCollection mOutputProfiles; // output profiles exposed by this module
     93     InputProfileCollection mInputProfiles;  // input profiles exposed by this module
     94     uint32_t mHalVersion; // audio HAL API version
     95     DeviceVector mDeclaredDevices; // devices declared in audio_policy configuration file.
     96     AudioRouteVector mRoutes;
     97     AudioPortVector mPorts;
     98 };
     99 
    100 class HwModuleCollection : public Vector<sp<HwModule> >
    101 {
    102 public:
    103     sp<HwModule> getModuleFromName(const char *name) const;
    104 
    105     sp<HwModule> getModuleForDevice(audio_devices_t device) const;
    106 
    107     sp<DeviceDescriptor> getDeviceDescriptor(const audio_devices_t device,
    108                                              const char *device_address,
    109                                              const char *device_name,
    110                                              bool matchAdress = true) const;
    111 
    112     status_t dump(int fd) const;
    113 };
    114 
    115 } // namespace android
    116