1.. zephyr:board:: rak11720
2
3The RAK11720 is a WisBlock Core module for RAK WisBlock.
4It is based on the powerful ultra-low power Apollo3 Blue SoC (AMA3B1KK-KBR-B0)
5from Ambiq together with a Semtech SX1262 LoRa® transceiver.
6
7The AMA3B1KK-KBR-B0 has an integrated Bluetooth Low Energy transceiver
8that enhances the communication capabilities. The RAK11720 stamp module
9comes in the same size and footprint as our RAK3172 module which gives
10you the opportunity to enhance your existing designs
11with BLE without designing a new PCB.
12
13Hardware
14********
15
16The easiset way to use a RAK11720, is the WisBlock Modular system.
17A WisBlock Base board (RAK19007) which provides the power
18supply and programming/debug interface is the base to plug a
19RAK11722 (WisBlock Core module with the RAK11720) in.
20
21- Apollo3 Blue SoC with up to 96 MHz operating frequency
22- ARM® Cortex® M4F core
23- 16 kB 2-way Associative/Direct-Mapped Cache per core
24- Up to 1 MB of flash memory for code/data
25- Up to 384 KB of low leakage / low power RAM for code/data
26- Integrated Bluetooth 5 Low-energy controller
27- Semtech SX1262 low power high range LoRa transceiver
28- iPEX connectors for the LORA antenna and BLE antenna.
29- 2 user LEDs on RAK19007 WisBlock Base board
30- Powered by either Micro USB, 3.7V rechargeable battery or a 5V Solar Panel Port
31
32For more information about the RAK11720 stamp module:
33
34- `WisDuo RAK11720 Website`_
35- `WisBlock RAK11722 Website`_
36
37Supported Features
38==================
39
40.. zephyr:board-supported-hw::
41
42Programming and Debugging
43=========================
44
45The RAK11720 board shall be connected to a Segger Embedded Debugger Unit
46`J-Link OB <https://www.segger.com/jlink-ob.html>`_. This provides a debug
47interface to the Apollo3 Blue chip. You can use JLink to communicate with
48the Apollo3 Blue.
49
50Flashing an application
51-----------------------
52
53Connect your device to your host computer using the JLINK USB port.
54The sample application :zephyr:code-sample:`hello_world` is used for this example.
55Build the Zephyr kernel and application, then flash it to the device:
56
57.. zephyr-app-commands::
58   :zephyr-app: samples/hello_world
59   :board: rak11720
60   :goals: flash
61
62.. note::
63   ``west flash`` requires `SEGGER J-Link software`_ and `pylink`_ Python module
64   to be installed on you host computer.
65
66Open a serial terminal (minicom, putty, etc.) with the following settings:
67
68- Speed: 115200
69- Data: 8 bits
70- Parity: None
71- Stop bits: 1
72
73Reset the board and you should be able to see on the corresponding Serial Port
74the following message:
75
76.. code-block:: console
77
78   Hello World! rak11720/apollo3_blue
79
80.. _WisDuo RAK11720 Website:
81   https://docs.rakwireless.com/Product-Categories/WisDuo/RAK11720-Module/Overview/#product-description
82
83.. _WisBlock RAK11722 Website:
84   https://docs.rakwireless.com/Product-Categories/WisBlock/RAK11722/Overview/#product-description
85
86.. _SEGGER J-Link software:
87   https://www.segger.com/downloads/jlink
88
89.. _pylink:
90   https://github.com/Square/pylink
91