AT_CellularBase.h

00001 /*
00002  * Copyright (c) 2017, Arm Limited and affiliates.
00003  * SPDX-License-Identifier: Apache-2.0
00004  *
00005  * Licensed under the Apache License, Version 2.0 (the "License");
00006  * you may not use this file except in compliance with the License.
00007  * You may obtain a copy of the License at
00008  *
00009  *     http://www.apache.org/licenses/LICENSE-2.0
00010  *
00011  * Unless required by applicable law or agreed to in writing, software
00012  * distributed under the License is distributed on an "AS IS" BASIS,
00013  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
00014  * See the License for the specific language governing permissions and
00015  * limitations under the License.
00016  */
00017 #ifndef AT_CELLULAR_BASE_H_
00018 #define AT_CELLULAR_BASE_H_
00019 
00020 #include "ATHandler.h"
00021 
00022 namespace mbed {
00023 
00024 /**
00025  *  Class AT_CellularBase
00026  *
00027  *  A base class for AT-classes.
00028  */
00029 class AT_CellularBase {
00030 public:
00031     AT_CellularBase(ATHandler &at);
00032     /** Getter for at handler. Common method for all AT-classes.
00033      *
00034      *  @return reference to ATHandler
00035      */
00036     ATHandler &get_at_handler();
00037 
00038     /** Gets the device error that happened when using AT commands/responses. This is at error
00039      *  returned by the device. Returned CME/CMS errors can be found from 3gpp documents 27007 and 27005.
00040      *
00041      *  @return at error (CME/CMS) while communicating with the device
00042      */
00043     device_err_t get_device_error() const;
00044 
00045     /** Cellular module need to define an array of unsupported features if any,
00046      *  by default all features are supported.
00047      *
00048      *  @param features Array of type SupportedFeature with last element FEATURE_END_MARK
00049      */
00050     enum SupportedFeature {
00051         AT_CGSN_WITH_TYPE, // AT+CGSN without type is likely always supported similar to AT+GSN
00052         AT_CGDATA, // alternative is to support only ATD*99***<cid>#
00053         AT_CGAUTH, // APN authentication AT commands supported
00054         SUPPORTED_FEATURE_END_MARK // must be last element in the array of features
00055     };
00056     static void set_unsupported_features(const SupportedFeature *unsupported_features);
00057 
00058 protected:
00059     ATHandler &_at;
00060 
00061     /** Check if some functionality is supported by a cellular module. For example,
00062      *  most of standard AT commands are optional and not implemented by all cellular modules.
00063      *
00064      *  @param feature  check for feature to support
00065      *  @return         true on supported, otherwise false
00066      */
00067     static const SupportedFeature *_unsupported_features;
00068     static bool is_supported(SupportedFeature feature);
00069 };
00070 
00071 } // namespace mbed
00072 
00073 #endif /* AT_CELLULAR_BASE_H_ */