Entenda as APIs de E/S comuns do FreeRTOS - FreeRTOS

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Entenda as APIs de E/S comuns do FreeRTOS

As APIs de E/S comuns atuam como camadas de abstração de hardware (HAL) que fornecem uma interface comum entre drivers e código de aplicação de nível superior. As E/S comuns do FreeRTOS fornecem um conjunto de APIs padrão para acessar dispositivos seriais comuns em placas de referência compatíveis; as implementações dessas APIs não estão incluídas. Essas APIs comuns se comunicam e interagem com esses periféricos e permitem que seu código funcione entre plataformas. Sem as E/S comuns, escrever código para que funcione com dispositivos de baixo nível é uma tarefa específica do fornecedor Sillicon.

nota

O FreeRTOS não exige implementações das APIs de E/S comuns para funcionar, mas tentará usar as APIs de E/S comuns como uma forma de interagir com os periféricos específicos em uma placa baseada em microcontrolador, em vez de APIs específicas do fornecedor.

Em geral, os drivers de dispositivo são independentes do sistema operacional subjacente e são específicos de uma determinada configuração de hardware. A HAL abstrai os detalhes de como um driver específico funciona e fornece uma API uniforme para controlar esses dispositivos. Você pode usar as mesmas APIs para acessar vários drivers de dispositivo em placas de referência baseadas em múltiplos microcontroladores (MCU).

Bibliotecas

Atualmente, o FreeRTOS fornece duas bibliotecas de E/S comuns: a E/S comum - básica e a E/S comum - BLE.

E/S comum - básica

Visão geral

A E/S comum - básica fornece APIs que lidam com periféricos e funções básicas de E/S que você pode encontrar em placas baseadas em MCU. O repositório da E/S comum - básica está disponível no GitHub.

Periféricos compatíveis
  • ADC

  • GPIO

  • I2C

  • PWM

  • SPI

  • UART

  • WatchDog

  • Flash

  • RTC

  • EFUSE

  • Reinicializações

  • I2

  • Contador de desempenho

  • Informações sobre a plataforma de hardware

Recursos compatíveis
  • Leitura/gravação síncrona

    A função não retorna até que a quantidade solicitada de dados seja transferida.

  • Leitura/gravação assíncrona

    A função retorna imediatamente e a transferência de dados ocorre de forma assíncrona. Quando a ação for concluída, um retorno de chamada de usuário registrado é chamado.

Específico do periférico
  • I2C

    Combina várias operações em uma transação. Usado para realizar as ações de gravação e leitura em uma transação.

  • SPI

    Transfere dados entre primário e secundário, o que significa que a gravação e a leitura ocorrem simultaneamente.

Referência de API

Para obter uma referência completa de API, consulte a Referência de API de E/S comum - básica.

E/S comum - BLE

Visão geral

A E/S comum - BLE fornece abstração da pilha Bluetooth Low Energy do fabricante. Ela fornece as seguintes interfaces que podem ser usadas para controlar o dispositivo e realizar operações GAP e GATT. O repositório da E/S comum - BLE está disponível no GitHub.

Gerenciador de dispositivos Bluetooth:

Isso fornece uma interface para controlar o dispositivo Bluetooth, realizar operações de descoberta de dispositivos e outras tarefas relacionadas à conectividade.

Gerenciador de adaptadores BLE:

Isso fornece uma interface para as funções da API GAP que são específicas do BLE.

Gerenciador de adaptadores Bluetooth clássicos:

Isso fornece uma interface para controlar as funcionalidades clássicas de BT de um dispositivo.

Servidor GATT:

Isso fornece uma interface para usar o recurso de servidor Bluetooth GATT.

Cliente GATT:

Isso fornece uma interface para usar o recurso de cliente Bluetooth GATT.

Interface de conexão A2DP:

Isso fornece uma interface do perfil de origem A2DP para o dispositivo local.

Referência de API

Para obter uma referência completa de API, consulte a Referência de API de E/S comum - BLE.

E/S comum para o Amazon Common Software

As APIs de E/S comuns fazem parte das implementações exigidas pelo Amazon Common Software para dispositivos, especificamente para serem implementadas em um kit de portabilidade de dispositivos (DPK) do fornecedor.

O que é o ACS?

O Amazon Common Software (ACS) para dispositivos é um software que agiliza a integração de SDKs do Amazon Device em seus dispositivos. O ACS fornece uma camada de integração de API unificada, componentes pré-validados e com uso eficiente de memória para funções comuns, como conectividade, kit de portabilidade de dispositivos (DPK) e pacotes de testes de várias camadas.

Programa de qualificação

O programa de qualificação do Amazon Common Software para dispositivos verifica se uma versão DPK (kit de portabilidade de dispositivos) do ACS que é executada em uma placa de desenvolvimento específica baseada em microcontrolador é compatível com as práticas recomendadas publicadas pelo programa e se ela é robusta o suficiente para passar nos testes exigidos pelo ACS especificados pelo programa de qualificação.

Os fornecedores qualificados neste programa estão listados na página Fornecedores de chipsets do ACS.

Para obter mais informações sobre a qualificação do dispositivo, consulte Dispositivos para o ACS.