#include <AT_CellularNetwork.h>

Inherits mbed::CellularNetwork, and mbed::AT_CellularBase.

Inherited by QUECTEL_BC95_CellularNetwork, QUECTEL_BG96_CellularNetwork, TELIT_HE910_CellularNetwork, UBLOX_PPP_CellularNetwork, and my_AT_CN.

Public Member Functions
virtual nsapi_error_t	set_credentials (const char apn, const char username=0, const char *password=0)
	Set the cellular network APN and credentials.
virtual nsapi_error_t	connect (const char apn, const char username=0, const char *password=0)
	Start the interface.
virtual nsapi_error_t	connect ()
	Start the interface.
virtual nsapi_error_t	disconnect ()
	User initiated disconnect.
virtual nsapi_error_t	init ()
	Does all the needed initializations that can fail.
virtual nsapi_error_t	activate_context ()
	Finds the correct PDP context and activates it.
virtual nsapi_error_t	set_registration (const char *plmn=0)
	Request registering to network.
virtual nsapi_error_t	get_network_registering_mode (NWRegisteringMode &mode)
	Get the current network registering mode.
virtual nsapi_error_t	get_attach (AttachStatus &status)
	Request attach status from network.
virtual nsapi_error_t	detach ()
	Request detach from a network.
virtual nsapi_error_t	get_rate_control (CellularNetwork::RateControlExceptionReports &reports, CellularNetwork::RateControlUplinkTimeUnit &time_unit, int &uplink_rate)
	Get APN rate control.
virtual nsapi_error_t	get_apn_backoff_timer (int &backoff_timer)
	Get backoff timer value.
virtual nsapi_connection_status_t	get_connection_status () const
	Get the connection status.
virtual nsapi_error_t	set_blocking (bool blocking)
	Set blocking status of connect() which by default should be blocking.
virtual nsapi_error_t	scan_plmn (operList_t &operators, int &ops_count)
	Scans for operators module can reach.
virtual nsapi_error_t	set_ciot_optimization_config (Supported_UE_Opt supported_opt, Preferred_UE_Opt preferred_opt)
	Set CIoT optimizations.
virtual nsapi_error_t	get_ciot_optimization_config (Supported_UE_Opt &supported_opt, Preferred_UE_Opt &preferred_opt)
	Get CIoT optimizations.
virtual nsapi_error_t	set_stack_type (nsapi_ip_stack_t stack_type)
	Set the pdn type to be used.
virtual nsapi_ip_stack_t	get_stack_type ()
	Get the pdn type in use.
virtual nsapi_error_t	get_pdpcontext_params (pdpContextList_t &params_list)
	Get the relevant information for an active non secondary PDP context.
virtual nsapi_error_t	get_extended_signal_quality (int &rxlev, int &ber, int &rscp, int &ecno, int &rsrq, int &rsrp)
	Get extended signal quality parameters.
virtual nsapi_error_t	get_signal_quality (int &rssi, int &ber)
	Get signal quality parameters.
virtual nsapi_error_t	get_cell_id (int &cell_id)
	Get cell id.
virtual int	get_3gpp_error ()
	Get the last 3GPP error code.
virtual nsapi_error_t	get_operator_params (int &format, operator_t &operator_params)
	Get the operator parameters.
virtual nsapi_error_t	set_registration_urc (RegistrationType type, bool on)
	Activate/deactivate listening of network events for the given RegistrationType.
virtual nsapi_error_t	get_operator_names (operator_names_list &op_names)
	Read operator names.
virtual nsapi_error_t	get_registration_status (RegistrationType type, RegistrationStatus &status)=0
	Gets the network registration status.
virtual nsapi_error_t	set_credentials (const char apn, AuthenticationType type, const char username=0, const char *password=0)=0
	Set the cellular network APN and credentials.
	MBED_DEPRECATED_SINCE ("mbed-os-5.9","Parameter timeout will be deprecated. Use mbed-os/features/cellular/framework/API/CellularDevice.h set_timeout instead.") virtual nsapi_error_t set_attach(int timeout
	Request attach to network.
virtual nsapi_error_t	set_access_technology (RadioAccessTechnology rat)=0
	Sets radio access technology.
virtual nsapi_error_t	get_access_technology (RadioAccessTechnology &rat)=0
	Get current radio access technology.
virtual void	attach (mbed::Callback< void(nsapi_event_t, intptr_t)> status_cb)=0
	Register callback for status reporting.
virtual const char *	get_mac_address ()
	Get the local MAC address.
virtual const char *	get_netmask ()
	Get the local network mask.
virtual const char *	get_gateway ()
	Get the local gateway.
virtual nsapi_error_t	set_network (const char ip_address, const char netmask, const char *gateway)
	Set a static IP address.
virtual nsapi_error_t	set_dhcp (bool dhcp)
	Enable or disable DHCP on the network.
virtual nsapi_error_t	gethostbyname (const char host, SocketAddress address, nsapi_version_t version=NSAPI_UNSPEC)
	Translates a hostname to an IP address with specific version.
virtual nsapi_error_t	add_dns_server (const SocketAddress &address)
	Add a domain name server to list of servers to query.
ATHandler &	get_at_handler ()
	Getter for at handler.
device_err_t	get_device_error () const
	Gets the device error that happened when using AT commands/responses.
Protected Member Functions
virtual bool	get_modem_stack_type (nsapi_ip_stack_t requested_stack)
	Check if modem supports the given stack type.
virtual bool	has_registration (RegistrationType reg_type)
	Check if modem supports given registration type.
virtual nsapi_error_t	set_access_technology_impl (RadioAccessTechnology op_rat)
	Sets access technology to be scanned.
Friends
class	Socket
class	UDPSocket
class	TCPSocket

Detailed Description

Class AT_CellularNetwork.

Class for connecting to a network and getting information from it.

Definition at line 34 of file AT_CellularNetwork.h.

Member Function Documentation

nsapi_error_t activate_context ( ) [virtual]

Finds the correct PDP context and activates it.

If correct PDP context is not found, one is created. Given APN (or not given) and stack type (IPv4/IPv6/dual) are influencing when finding the PDP context.

Returns:: zero on success

Implements CellularNetwork.

Definition at line 242 of file AT_CellularNetwork.cpp.

nsapi_error_t add_dns_server ( const SocketAddress & address ) [virtual, inherited]

Add a domain name server to list of servers to query.

Parameters:

address Destination for the host address

Returns:: 0 on success, negative error code on failure

Definition at line 60 of file NetworkInterface_stub.cpp.

virtual void attach ( mbed::Callback< void(nsapi_event_t, intptr_t)> status_cb ) [pure virtual, inherited]

Register callback for status reporting.

The specified status callback function will be called on status changes on the network. The parameters on the callback are the event type and event-type dependent reason parameter.

Parameters:

status_cb The callback for status changes

nsapi_error_t connect	(	const char *	apn,
		const char *	username = `0`,
		const char *	password = `0`
	)		`[virtual]`

Start the interface.

Attempts to connect to a cellular network.

Parameters:

apn	Optional name of the network to connect to
username	Optional username for your APN
password	Optional password for your APN

Returns:: 0 on success, negative error code on failure

Implements CellularNetwork.

Definition at line 213 of file AT_CellularNetwork.cpp.

nsapi_error_t connect ( ) [virtual]

Start the interface.

Attempts to connect to a cellular network.

Returns:: 0 on success, negative error code on failure

Implements CellularNetwork.

Definition at line 302 of file AT_CellularNetwork.cpp.

nsapi_error_t detach ( ) [virtual]

Request detach from a network.

Returns:: zero on success

Implements CellularNetwork.

Definition at line 807 of file AT_CellularNetwork.cpp.

nsapi_error_t disconnect ( ) [virtual]

User initiated disconnect.

Disconnects from PPP connection only and brings down the underlying network interface

Definition at line 371 of file AT_CellularNetwork.cpp.

int get_3gpp_error ( ) [virtual]

Get the last 3GPP error code.

Returns:: see 3GPP TS 27.007 error codes

Implements CellularNetwork.

Definition at line 1177 of file AT_CellularNetwork.cpp.

virtual nsapi_error_t get_access_technology ( RadioAccessTechnology & rat ) [pure virtual, inherited]

Get current radio access technology.

Parameters:

rat	Radio access technology

Returns:: zero on success

nsapi_error_t get_apn_backoff_timer ( int & backoff_timer ) [virtual]

Get backoff timer value.

Parameters:

backoff_timer Backoff timer value associated with PDP APN in seconds

Returns:: zero on success

Implements CellularNetwork.

Definition at line 820 of file AT_CellularNetwork.cpp.

ATHandler & get_at_handler ( ) [inherited]

Getter for at handler.

Common method for all AT-classes.

Returns:: reference to ATHandler

Definition at line 27 of file AT_CellularBase.cpp.

nsapi_error_t get_attach ( AttachStatus & status ) [virtual]

Request attach status from network.

Parameters:

status see AttachStatus values

Returns:: zero on success

Implements CellularNetwork.

Definition at line 790 of file AT_CellularNetwork.cpp.

nsapi_error_t get_cell_id ( int & cell_id ) [virtual]

Get cell id.

Parameters:

cell_id cell id

Returns:: NSAPI_ERROR_OK on success, negative error code on failure

Implements CellularNetwork.

Definition at line 758 of file AT_CellularNetwork.cpp.

nsapi_error_t get_ciot_optimization_config	(	Supported_UE_Opt &	supported_opt,
		Preferred_UE_Opt &	preferred_opt
	)		`[virtual]`

Get CIoT optimizations.

Parameters:

supported_opt	Supported CIoT EPS optimizations.
preferred_opt	Preferred CIoT EPS optimizations.

Returns:: zero on success

Implements CellularNetwork.

Definition at line 978 of file AT_CellularNetwork.cpp.

nsapi_connection_status_t get_connection_status ( ) const [virtual]

Get the connection status.

Returns:: The connection status according to ConnectionStatusType

Implements CellularNetwork.

Definition at line 398 of file AT_CellularNetwork.cpp.

device_err_t get_device_error ( ) const [inherited]

Gets the device error that happened when using AT commands/responses.

This is at error returned by the device. Returned CME/CMS errors can be found from 3gpp documents 27007 and 27005.

Returns:: at error (CME/CMS) while communicating with the device

Definition at line 32 of file AT_CellularBase.cpp.

nsapi_error_t get_extended_signal_quality	(	int &	rxlev,
		int &	ber,
		int &	rscp,
		int &	ecno,
		int &	rsrq,
		int &	rsrp
	)		`[virtual]`

Get extended signal quality parameters.

Parameters:

rxlev	signal strength level
ber	bit error rate
rscp	signal code power
ecno	ratio of the received energy per PN chip to the total received power spectral density
rsrq	signal received quality
rsrp	signal received power

Returns:: NSAPI_ERROR_OK on success, negative error code on failure

Implements CellularNetwork.

Definition at line 1132 of file AT_CellularNetwork.cpp.

const char * get_gateway ( ) [virtual, inherited]

Get the local gateway.

Returns:: Null-terminated representation of the local gateway or null if no network mask has been received

Definition at line 39 of file NetworkInterface_stub.cpp.

const char * get_mac_address ( ) [virtual, inherited]

Get the local MAC address.

Provided MAC address is intended for info or debug purposes and may not be provided if the underlying network interface does not provide a MAC address

Returns:: Null-terminated representation of the local MAC address or null if no MAC address is available

Definition at line 24 of file NetworkInterface_stub.cpp.

bool get_modem_stack_type ( nsapi_ip_stack_t requested_stack ) [protected, virtual]

Check if modem supports the given stack type.

Returns:: true if supported

Definition at line 881 of file AT_CellularNetwork.cpp.

const char * get_netmask ( ) [virtual, inherited]

Get the local network mask.

Returns:: Null-terminated representation of the local network mask or null if no network mask has been received

Definition at line 34 of file NetworkInterface_stub.cpp.

nsapi_error_t get_network_registering_mode ( NWRegisteringMode & mode ) [virtual]

Get the current network registering mode.

Parameters:

mode	on successful return contains the current network registering mode

Returns:: zero on success

Implements CellularNetwork.

Definition at line 652 of file AT_CellularNetwork.cpp.

nsapi_error_t get_operator_names ( operator_names_list & op_names ) [virtual]

Read operator names.

Parameters:

op_names on successful return will contain linked list of operator names.

Returns:: zero on success

Implements CellularNetwork.

Definition at line 1213 of file AT_CellularNetwork.cpp.

nsapi_error_t get_operator_params	(	int &	format,
		operator_t &	operator_params
	)		`[virtual]`

Get the operator parameters.

Parameters:

format	format of the operator field
operator_params	applicable operator param fields filled

Returns:: NSAPI_ERROR_OK on success, negative error code on failure

Implements CellularNetwork.

Definition at line 1182 of file AT_CellularNetwork.cpp.

nsapi_error_t get_pdpcontext_params ( pdpContextList_t & params_list ) [virtual]

Get the relevant information for an active non secondary PDP context.

Remarks:: optional params are not updated if not received from network.

Parameters:

params_list reference to linked list which is filled on successful call

Returns:: 0 on success, negative error code on failure

Implements CellularNetwork.

Definition at line 1042 of file AT_CellularNetwork.cpp.

nsapi_error_t get_rate_control	(	CellularNetwork::RateControlExceptionReports &	reports,
		CellularNetwork::RateControlUplinkTimeUnit &	time_unit,
		int &	uplink_rate
	)		`[virtual]`

Get APN rate control.

Remarks:: optional params are not updated if not received from network, so use good defaults

Parameters:

reports	Additional exception reports at maximum rate reached are allowed to be sent [optional]
time_unit	Uplink time unit with values 0=unrestricted, 1=minute, 2=hour, 3=day, 4=week [optional]
uplink_rate	Maximum number of messages per timeUnit [optional]

Returns:: zero on success

Implements CellularNetwork.

Definition at line 998 of file AT_CellularNetwork.cpp.

virtual nsapi_error_t get_registration_status	(	RegistrationType	type,
		RegistrationStatus &	status
	)		`[pure virtual, inherited]`

Gets the network registration status.

Parameters:

type	see RegistrationType values
status	see RegistrationStatus values

Returns:: zero on success

nsapi_error_t get_signal_quality	(	int &	rssi,
		int &	ber
	)		`[virtual]`

Get signal quality parameters.

Parameters:

rssi	signal strength level
ber	bit error rate

Returns:: NSAPI_ERROR_OK on success, negative error code on failure

Implements CellularNetwork.

Definition at line 1155 of file AT_CellularNetwork.cpp.

nsapi_ip_stack_t get_stack_type ( ) [virtual]

Get the pdn type in use.

Returns:: stack type

Implements CellularNetwork.

Definition at line 876 of file AT_CellularNetwork.cpp.

nsapi_error_t gethostbyname	(	const char *	host,
		SocketAddress *	address,
		nsapi_version_t	version = `NSAPI_UNSPEC`
	)		`[virtual, inherited]`

Translates a hostname to an IP address with specific version.

The hostname may be either a domain name or an IP address. If the hostname is an IP address, no network transactions will be performed.

If no stack-specific DNS resolution is provided, the hostname will be resolve using a UDP socket on the stack.

Parameters:

address	Destination for the host SocketAddress
host	Hostname to resolve
version	IP version of address to resolve, NSAPI_UNSPEC indicates version is chosen by the stack (defaults to NSAPI_UNSPEC)

Returns:: 0 on success, negative error code on failure

Definition at line 55 of file NetworkInterface_stub.cpp.

bool has_registration ( RegistrationType reg_type ) [protected, virtual]

Check if modem supports given registration type.

Parameters:

reg_type enum RegistrationType

Returns:: true if given registration type is supported by modem

Definition at line 764 of file AT_CellularNetwork.cpp.

nsapi_error_t init ( ) [virtual]

Does all the needed initializations that can fail.

Remarks:: must be called immediately after constructor.

Returns:: zero on success

Implements CellularNetwork.

Definition at line 67 of file AT_CellularNetwork.cpp.

MBED_DEPRECATED_SINCE	(	"mbed-os-5.9"	,
		"Parameter timeout will be deprecated. Use mbed-os/features/cellular/framework/API/CellularDevice.h set_timeout instead."
	)		`[inherited]`

Request attach to network.

Parameters:

timeout milliseconds to wait for attach response

Returns:: zero on success

nsapi_error_t scan_plmn	(	operList_t &	operators,
		int &	ops_count
	)		`[virtual]`

Scans for operators module can reach.

Parameters:

operators	Container of reachable operators and their access technologies
ops_count	Number of found operators

Returns:: zero on success

Implements CellularNetwork.

Definition at line 912 of file AT_CellularNetwork.cpp.

virtual nsapi_error_t set_access_technology ( RadioAccessTechnology rat ) [pure virtual, inherited]

Sets radio access technology.

Parameters:

rat	Radio access technology

Returns:: zero on success

virtual nsapi_error_t set_access_technology_impl ( RadioAccessTechnology op_rat ) [protected, virtual]

Sets access technology to be scanned.

Modem specific implementation.

Parameters:

op_rat Access technology

Returns:: zero on success

nsapi_error_t set_blocking ( bool blocking ) [virtual]

Set blocking status of connect() which by default should be blocking.

Parameters:

blocking true if connect is blocking

Returns:: 0 on success, negative error code on failure

Implements CellularNetwork.

Definition at line 403 of file AT_CellularNetwork.cpp.

nsapi_error_t set_ciot_optimization_config	(	Supported_UE_Opt	supported_opt,
		Preferred_UE_Opt	preferred_opt
	)		`[virtual]`

Set CIoT optimizations.

Parameters:

supported_opt	Supported CIoT EPS optimizations.
preferred_opt	Preferred CIoT EPS optimizations.

Returns:: zero on success

Implements CellularNetwork.

Definition at line 961 of file AT_CellularNetwork.cpp.

virtual nsapi_error_t set_credentials	(	const char *	apn,
		AuthenticationType	type,
		const char *	username = `0`,
		const char *	password = `0`
	)		`[pure virtual, inherited]`

Set the cellular network APN and credentials.

Parameters:

apn	Name of the network to connect to
type	Authentication type to use
username	Optional username for the APN
password	Optional password fot the APN

Returns:: 0 on success, negative error code on failure

nsapi_error_t set_credentials	(	const char *	apn,
		const char *	username = `0`,
		const char *	password = `0`
	)		`[virtual]`

Set the cellular network APN and credentials.

Parameters:

apn	Optional name of the network to connect to
username	Optional username for the APN
password	Optional password fot the APN

Returns:: 0 on success, negative error code on failure

Implements CellularNetwork.

Definition at line 166 of file AT_CellularNetwork.cpp.

nsapi_error_t set_dhcp ( bool dhcp ) [virtual, inherited]

Enable or disable DHCP on the network.

Enables DHCP on connecting the network. Defaults to enabled unless a static IP address has been assigned. Requires that the network is disconnected.

Parameters:

dhcp	True to enable DHCP

Returns:: 0 on success, negative error code on failure

Definition at line 49 of file NetworkInterface_stub.cpp.

nsapi_error_t set_network	(	const char *	ip_address,
		const char *	netmask,
		const char *	gateway
	)		`[virtual, inherited]`

Set a static IP address.

Configures this network interface to use a static IP address. Implicitly disables DHCP, which can be enabled in set_dhcp. Requires that the network is disconnected.

Parameters:

ip_address	Null-terminated representation of the local IP address
netmask	Null-terminated representation of the local network mask
gateway	Null-terminated representation of the local gateway

Returns:: 0 on success, negative error code on failure

Definition at line 44 of file NetworkInterface_stub.cpp.

nsapi_error_t set_registration ( const char * plmn = 0 ) [virtual]

Request registering to network.

Parameters:

plmn	format is in numeric format or 0 for automatic network registration

Returns:: zero on success

Implements CellularNetwork.

Definition at line 664 of file AT_CellularNetwork.cpp.

nsapi_error_t set_registration_urc	(	RegistrationType	type,
		bool	on
	)		`[virtual]`

Activate/deactivate listening of network events for the given RegistrationType.

This should be called after network class is created and ready to receive AT commands. After successful call network class starts to get information about network changes like registration statue, access technology, cell id...

Parameters:

type	RegistrationType to set urc on/off
on	Controls are urc' active or not

Returns:: zero on success

Implements CellularNetwork.

Definition at line 627 of file AT_CellularNetwork.cpp.

nsapi_error_t set_stack_type ( nsapi_ip_stack_t stack_type ) [virtual]

Set the pdn type to be used.

Parameters:

stack_type the stack type to be used.

Returns:: NSAPI_ERROR_OK on success

Implements CellularNetwork.

Definition at line 866 of file AT_CellularNetwork.cpp.

Type:	Program
Mbed OS support:	Mbed OS
Created:	14 May 2018
Imports:	0
Forks:	0
Commits:	1
Dependents:	0
Dependencies:	0
Followers:	3

Important changes to repositories hosted on mbed.com

AT_CellularNetwork Class Reference

Public Member Functions

Protected Member Functions

Friends

Detailed Description

Member Function Documentation

Repository toolbox

Repository details

Important Information for this Arm website

Important changes to repositories hosted on mbed.com

AT_CellularNetwork Class Reference

Public Member Functions

Protected Member Functions

Friends

Detailed Description

Member Function Documentation

Repository toolbox

Repository details

Important Information for this Arm website

Access Warning