NFC Adapter

Интерфейс Adapter предназначен для управления NFC-адаптером, установленным на устройстве. Подробнее…

Шина:	системная
Служба:	org.sailfishos.nfc.daemon
Объект:	/{nfc0, nfc1, ...}
Интерфейс:	org.sailfishos.nfc.Adapter

Сигналы

• EnabledChanged(bool &enabled)
• ModeChanged(uint &mode)
• PoweredChanged(bool &powered)
• TagsChanged(const QStringList &tags)
• TargetPresentChanged(bool &targetPresent)

Методы

• GetAll(int &version, bool &enabled, bool &powered, uint &supported_modes, uint &mode, bool &target_present, vector<ObjectPath> &tags)
• GetEnabled(bool &enabled)
• GetInterfaceVersion(int &version)
• GetMode(uint32 &mode)
• GetPowered(bool &powered)
• GetSupportedModes(uint32 &mode)
• GetTags(vector<ObjectPath> &tags)
• GetTargetPresent(bool &target_present)

Подробное описание

Объекты типа Adapter создаются службой org.sailfishos.nfc.daemon, приложение получает доступ к этим объектам, обращаясь к методам интерфейса daemon: GetAdapters, GetAll, GetAll2, и GetAll3.

Интерфейс Adapter реализует:

• методы, проверяющие статус адаптера, наличие подключённых меток и их идентификаторы;
• метод, возвращающий версию интерфейса;
• сигналы, сообщающие приложениям об изменении состояния адаптера, количества и типа подключённых меток.

Примеры использования:

• NfcUseCases/submodules/nfcdhandler/src/dbus/nfcdconstants.cpp
• QmlReact/src/nfcadapterinterface.h

Описание сигналов

EnabledChanged(bool enabled)

Испускается при изменении состояния активности адаптера.

ModeChanged(uint mode)

Испускается при изменении режима работы адаптера.

PoweredChanged(bool powered)

Испускается при изменении состояния питания адаптера.

TagsChanged(const QStringList &tags)

Испускается при изменении списка меток, подключённых к адаптеру.

TargetPresentChanged(bool targetPresent)

Испускается при изменении состояния подключения метки.

Описание методов

GetAll(int &version, bool &enabled, bool &powered, uint &supported_modes, uint &mode, bool &target_present, vector<ObjectPath> &tags)

Возвращает:

• version — версию интерфейса;
• enabled — статус активности адаптера;
• powered — статус наличия питания на адаптере;
• supported_modes — поддерживаемые режимы работы (см. GetMode);
• mode — текущий режим работы;
• target_present — флаг наличия подключённых меток;
• tags — список меток, подключённых к адаптеру.

GetEnabled(bool &enabled)

Возвращает флаг активности адаптера.

GetInterfaceVersion(int &version)

Возвращает версию интерфейса.

GetMode(uint32 &mode)

Возвращает текущий режим работы.

Возможные варианты:

• 0x01 — P2PInitiator;
• 0x02 — ReaderWriter;
• 0x04 — P2PTarget;
• 0x08 — CardEmulation.

GetPowered(bool &powered)

Возвращает статус наличия питания на адаптере.

GetSupportedModes(uint32 &mode)

Возвращает поддерживаемые режимы работы (см. GetMode).

GetTags(vector<ObjectPath> &tags)

Возвращает идентификаторы подключённых в данный момент тегов (например, если вывести информацию без приложенного в данный момент тега к устройству, то список будет пуст, если же с поднесённым, то нет).

GetTargetPresent(bool &target_present)

Возвращает информацию о наличии подключённой метки.