mirror of
https://github.com/bluekitchen/btstack.git
synced 2025-01-01 00:28:18 +00:00
atwilc3000: updated docu and samv70-xplained port
This commit is contained in:
parent
0f165cea0c
commit
7d82eb501e
@ -46,6 +46,7 @@ No build server | [esp32](https://github.com/bluekitchen/btstack/tree/develop/po
|
||||
[<img src="http://buildbot.bluekitchen-gmbh.com/btstack/badge.png?builder=port-msp-exp430f5438-cc2564b-develop">](https://buildbot.bluekitchen-gmbh.com/btstack/builders/port-msp-exp430f5438-cc2564b-develop) | [msp-exp430f5438-cc2564b](https://github.com/bluekitchen/btstack/tree/develop/port/msp-exp430f5438-cc2564b) |[MSP430F5438 Experimenter Board for MSP430](http://www.ti.com/tool/msp-exp430f5438) with [Bluetooth CC2564 Module Evaluation Board](http://www.ti.com/tool/cc2564modnem)
|
||||
[<img src="http://buildbot.bluekitchen-gmbh.com/btstack/badge.png?builder=port-msp430f5229lp-cc2564b-develop">](https://buildbot.bluekitchen-gmbh.com/btstack/builders/port-msp430f5229lp-cc2564b-develop) | [msp430f5529lp-cc2564b](https://github.com/bluekitchen/btstack/tree/develop/port/msp430f5229lp-cc2564b) | [MSP-EXP430F5529LP LaunchPad](http://www.ti.com/ww/en/launchpad/launchpads-msp430-msp-exp430f5529lp.html#tabs) with [Bluetooth CC2564 Module Evaluation Board](http://www.ti.com/tool/cc2564modnem) and [EM Adapter BoosterPack](http://www.ti.com/tool/boost-ccemadapter) with additional 32768Hz quartz oscillator
|
||||
No build server | [max32630-fthr](https://github.com/bluekitchen/btstack/tree/develop/port/max32630-fthr) | [MAX32630FTHR ARM Cortex M4F Board](https://www.maximintegrated.com/en/products/digital/microcontrollers/MAX32630FTHR.html) with onboard [Panasonic PAN1326 module](https://na.industrial.panasonic.com/products/wireless-connectivity/bluetooth/multi-mode/series/pan13261316-series/CS467) containing [TI CC2564B Bluetooth controller](http://www.ti.com/product/cc2564)
|
||||
No build server | [samv71-xplained-atwilc3000](https://github.com/bluekitchen/btstack/tree/develop/port/samv71-xplained-atwilc3000) | [SAMV71 Ultra Xplained Ultra](http://www.atmel.com/tools/atsamv71-xult.aspx) evaluation kit with [ATWILC3000 SHIELD](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ATWILC3000-SHLD)
|
||||
[<img src="http://buildbot.bluekitchen-gmbh.com/btstack/badge.png?builder=port-stm32-f103rb-nucleo-develop">](https://buildbot.bluekitchen-gmbh.com/btstack/builders/port-stm32-f103rb-nucleo-develop) | [stm32-f103rb-nucleo](https://github.com/bluekitchen/btstack/tree/develop/port/stm32-f103rb-nucleo) | [STM32 Nucleo development board NUCLEO-F103RB](http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/LN1847/PF259875) with [Bluetooth CC2564 Module Evaluation Board](http://www.ti.com/tool/cc2564modnem) and [EM Adapter BoosterPack](http://www.ti.com/tool/boost-ccemadapter) with additional 32768Hz quartz oscillator
|
||||
No build Server | [stm32-f4discovery-cc2564b](https://github.com/bluekitchen/btstack/tree/develop/port/stm32-f4discovery-cc256x) | [STM32 F4 Discovery Board](http://www.st.com/en/evaluation-tools/stm32f4discovery.html) with [CC256xEM Bluetooth Adapter Kit for ST](https://store.ti.com/CC256XEM-STADAPT-CC256xEM-Bluetooth-Adapter-Kit-P45158.aspx) and [CC2564B Dual-mode Bluetooth® Controller Evaluation Module](https://store.ti.com/cc2564modnem.aspx)
|
||||
No build Server | [stm32-l053rb-em9304](https://github.com/bluekitchen/btstack/tree/develop/port/stm32-l053rb-em9304) | EM9304 DVK: [STM32 Nucleo development board NUCELO-L053R](http://www.st.com/en/evaluation-tools/nucleo-l053r8.html) with [EM9304 Bluetooth Controller](http://www.emmicroelectronic.com/products/wireless-rf/standard-protocols/em9304)
|
||||
@ -73,7 +74,7 @@ No build server | [freertos](https://github.com/bluekitchen/btstack/tree/develop
|
||||
|
||||
Chipset | Type | HCI Transport | SCO over HCI (2) | BTstack folder | Comment
|
||||
---------------------------- |-----------| ----------------|------------------|----------------|---------
|
||||
Atmel ATWILC3000 | Dual mode | H4 | Don't know | atwilc3000 | Required Bluetooth firmware is 270 kB
|
||||
Atmel ATWILC3000 | Dual mode | H4 | Don't know | atwilc3000 | Firmware size: 270 kB
|
||||
Broadcom UART | Dual mode | H4, H5 | Probably | bcm | Max UART baudrate 2 mbps
|
||||
Broadcom USB Dongles | Dual mode | USB | Yes | bcm |
|
||||
CSR UART | Dual mode | H4, H5, BCSP | No (didn't work) | csr |
|
||||
|
@ -53,7 +53,7 @@ CSR, which has been acquired by Qualcomm, provides all relevant information on t
|
||||
|
||||
Chipset | Type | HCI Transport | BD_ADDR (1) | SCO over HCI (2) | LE DLE | Multiple LE Roles | BTstack folder | Comment
|
||||
-------------------- |-----------| ---------------|--------------|------------------|--------|----------------------|----------------|---------
|
||||
Atmel ATWILC3000 | Dual mode | H4 | Yes | Don't know | No | No | atwilc3000 | Required Bluetooth firmware is 270 kB
|
||||
Atmel ATWILC3000 | Dual mode | H4 | Yes | Don't know | No | No | atwilc3000 | Firmware size: 270 kB
|
||||
Broadcom UART | Dual mode | H4, H5 | Rarely | Probably (2) | No | Maybe (3) | bcm | Max UART baudrate 2 mbps
|
||||
Broadcom USB Dongles | Dual mode | USB | Yes | Yes | No | No | bcm |
|
||||
CSR UART | Dual mode | H4, H5, BCSP | Rarely | No (didn't work) | No | No | csr |
|
||||
@ -82,7 +82,7 @@ nina2: 18:FE:34:6D:17:66
|
||||
|
||||
The ATILC3000 Bluetooth/Wifi combo controller has been used with Linux on embedded devices by Atmel/Microchip. Drivers and documentation are available from a [GitHub repository](https://github.com/atwilc3000). The ATWILC3000 has a basic HCI implementation stored in ROM and requires a firmware image to be uploaded before it can be used. Please note: the Bluetooth firmware is 270 kB.
|
||||
|
||||
**BD Addr** seems to be stored in the device. Bluetooth address can be updated via vendor-specific command. (Documentation will be updated after checking the BD Addr of a different board.)
|
||||
**BD Addr** can be set with vendor-specific command although all chipsets have an official address stored. The BD_ADDR lookup results in "Newport Media Inc." which was [acquired by Atmel](http://www.atmel.com/about/news/release.aspx?reference=tcm:26-62532) in 2014.
|
||||
|
||||
**Baud rate** can be set with a custom command.
|
||||
|
||||
|
@ -1,9 +1,23 @@
|
||||
# POSIX H4 Port for Atmel ATWILC3000
|
||||
|
||||
This port allows to use the ATWILC3000 connected via UART with BTstack running on a POSIX host system.
|
||||
This port allows to use the ATWILC3000 connected via UART with BTstack running on a POSIX host system, see test setup below (which lacks a proper RESET button).
|
||||
|
||||
It first downloads the hci_581_active_uart.hex firmware from the [GitHub atwilc3000/firmware](https://github.com/atwilc3000/firmware) repo, before BTstack starts up.
|
||||
# Compilation
|
||||
|
||||
Please note that it does not detect if the firmware has already been downloaded, so you need to reset the ATWILC3000 before starting an example.
|
||||
$ make
|
||||
|
||||
Tested with the official ATWILC3000 SHIELD on OS X.
|
||||
The Makefile downloads the wilc3000_bt_firmware.bin firmware from the [GitHub atwilc3000/firmware](https://github.com/atwilc3000/firmware) repo.
|
||||
|
||||
# Usage
|
||||
|
||||
Just run any of the provided examples, e.g.
|
||||
|
||||
$ ./le_counter
|
||||
|
||||
At start, the firmware file is first uploaded to the ATWILC3000, before BTstack start up.
|
||||
|
||||
Please note that it configures the ATWILC3000 for a higher baud rate it does not detect if the firmware has already been downloaded, so you need to reset the ATWILC3000 before starting an example.
|
||||
|
||||
Tested with the official [ATWILC3000 SHIELD](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ATWILC3000-SHLD) on OS X.
|
||||
|
||||
![ATWILC3000 Test Setup](ATWILC3000-Breakout.jpg)
|
||||
|
37
port/samv71-xplained-atwilc3000/README.md
Normal file
37
port/samv71-xplained-atwilc3000/README.md
Normal file
@ -0,0 +1,37 @@
|
||||
# BTstack port for SAMV71 Ultra Xplained with ATWILC3000 SHIELD
|
||||
|
||||
This port uses the [SAMV71 Ultra Xplained Ultra](http://www.atmel.com/tools/atsamv71-xult.aspx) evaluation kit with an [ATWILC3000 SHIELD](http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ATWILC3000-SHLD). The code is based on the Advanced Software Framework (ASF) (previously know as Atmel Software Framework). It uses the GCC Makefiles provided by the ASF. OpenOCD is used to upload the firmware to the device.
|
||||
|
||||
## Create Example Projects
|
||||
|
||||
To create all example projects in the example folder, you can run:
|
||||
|
||||
$ make
|
||||
|
||||
# Compile Example
|
||||
|
||||
In one of the example folders:
|
||||
|
||||
$ make
|
||||
|
||||
To upload the firmware:
|
||||
|
||||
$ make
|
||||
|
||||
You need to connect the the Debug USB to your computer.
|
||||
|
||||
## Debug output
|
||||
printf is routed to USART1, which is connected to the virtual serial port. To get the console output, open a terminal at 115200.
|
||||
|
||||
In btstack_config.h, additional debug information can be enabled by uncommenting ENABLE_LOG_INFO.
|
||||
|
||||
Also, the full packet log can be enabled in the main() function on main.c by uncommenting the hci_dump_open(..) line. The console output can then be converted into .pklg files for OS X PacketLogger or WireShark by running tool/create_packet_log.py
|
||||
|
||||
## TODOs
|
||||
- Implement hal_flash_sector.h to persist link keys
|
||||
- Implement hal_audio_dma.h for A2DP Audio Sink and HFP/HSP Demos
|
||||
- Figure out if/how SCO packets can be routed over HCI for HFP wide-band speech
|
||||
|
||||
## Issues
|
||||
- Bluetooth UART driver uses per-byte interrupts and doesn't work reliable at higher baud rates (921600 seems ok, 2 mbps already causes problems).
|
||||
- An older XDMA-based implementation only sends 0x00 bytes over the UART. It might be better to just read incoming data into two buffers, (e.g. using a two element linked list with XDMA), and raising RTS when one buffer is full.
|
Loading…
Reference in New Issue
Block a user