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
40The RAK11720 module configuration supports the following hardware features:
41
42+-----------+------------+----------------------+
43| Interface | Controller | Driver/Component     |
44+===========+============+======================+
45| MPU       | on-chip    | arch/arm             |
46+-----------+------------+----------------------+
47| NVIC      | on-chip    | arch/arm             |
48+-----------+------------+----------------------+
49| SYSTICK   | on-chip    | systick              |
50+-----------+------------+----------------------+
51| STIMER    | on-chip    | stimer               |
52+-----------+------------+----------------------+
53| GPIO      | on-chip    | gpio                 |
54+-----------+------------+----------------------+
55| UART      | on-chip    | serial               |
56+-----------+------------+----------------------+
57| WDT       | on-chip    | watchdog             |
58+-----------+------------+----------------------+
59| RADIO     | on-chip    | bluetooth            |
60+-----------+------------+----------------------+
61| RADIO     | on-board   | LoRa (SX1262)        |
62+-----------+------------+----------------------+
63
64The default configuration can be found in the defconfig file:
65``boards/rak/rak11720/rak11720_defconfig``.
66
67Programming and Debugging
68=========================
69
70The RAK11720 board shall be connected to a Segger Embedded Debugger Unit
71`J-Link OB <https://www.segger.com/jlink-ob.html>`_. This provides a debug
72interface to the Apollo3 Blue chip. You can use JLink to communicate with
73the Apollo3 Blue.
74
75Flashing an application
76-----------------------
77
78Connect your device to your host computer using the JLINK USB port.
79The sample application :zephyr:code-sample:`hello_world` is used for this example.
80Build the Zephyr kernel and application, then flash it to the device:
81
82.. zephyr-app-commands::
83   :zephyr-app: samples/hello_world
84   :board: rak11720
85   :goals: flash
86
87.. note::
88   ``west flash`` requires `SEGGER J-Link software`_ and `pylink`_ Python module
89   to be installed on you host computer.
90
91Open a serial terminal (minicom, putty, etc.) with the following settings:
92
93- Speed: 115200
94- Data: 8 bits
95- Parity: None
96- Stop bits: 1
97
98Reset the board and you should be able to see on the corresponding Serial Port
99the following message:
100
101.. code-block:: console
102
103   Hello World! rak11720/apollo3_blue
104
105.. _WisDuo RAK11720 Website:
106   https://docs.rakwireless.com/Product-Categories/WisDuo/RAK11720-Module/Overview/#product-description
107
108.. _WisBlock RAK11722 Website:
109   https://docs.rakwireless.com/Product-Categories/WisBlock/RAK11722/Overview/#product-description
110
111.. _SEGGER J-Link software:
112   https://www.segger.com/downloads/jlink
113
114.. _pylink:
115   https://github.com/Square/pylink
116