1.. _ronoth_lodev:
2
3Ronoth LoDev
4############
5
6========
7Overview
8========
9
10The Ronoth_ LoDev_ is a small open source board containing a `AcSIP S76S`_  SiP from AcSIP_.
11The `full LoDev design details`_ are available on on GitHub.  The LoDev_ board can be purchased
12from Ronoth_ or from CrowdSupply_.
13
14The S76S contains an `STMicro STM32L073RZ`_ MCU, a `Semtech SX1276`_ LoRaWAN transceiver,
15and a +20 dBm power amplifier.  Refer to `AcSIP S76S Product Information Brief`_ for details.
16
17Zephyr applications may use the **ronoth_lodev** configuration to run on this board.
18
19.. figure:: img/lodev.png
20     :width: 291px
21     :align: center
22     :height: 217px
23     :alt: Image of Ronoth LoDev open source development board containing S76S system on a chip
24
25     Ronoth LoDev
26
27`Board design files`_ are available on GitHub.
28
29================
30Device Resources
31================
32
33The embedded `STMicro STM32L073RZ`_ has some GPIOs and SPI2 internally committed to the LoRaWAN
34transceiver operation.  See `internally dedicated ports`_ for a list of resources committed to this function.
35
36=========
37Debugging
38=========
39
40Programming and debugging uses the SWD port, as on any STM32 processor.  An ST-LINK/V2 adapter
41may be used with the appropriate software (*st-utils* package on Linux).
42
43=================
44Connector Pin-Out
45=================
46
47The LoDev has two rows of headers.  Pin 1 on both connectors is closest to the micro-USB connector on the board,
48furthest from the RF (antenna) connector.
49
50When viewed from the top (component) side of the board, with the micro-USB connector closest and RF (antenna)
51connector furthest away, the CN6_ connector is on the left, the CN7_ connector is on the right.
52
53UART1 on the S76S SiP is connected to a USB-to-UART device connected to the micro USB connector, so generally
54PA9 and PA10 are unavailable for I/Os.
55
56A helpful silkscreen legend is provided on the board.
57
58.. figure:: img/pinout.png
59     :width: 600px
60     :align: center
61     :alt: Ronoth LoDev sketch with pinout
62
63     Ronth LoDev Pinout
64
65.. _CN6:
66
67-----------
68CN6 Pin-Out
69-----------
70
71=== ======== ======================================================
72Pin Function Note
73=== ======== ======================================================
741   3.3V     Output 500 mA max
752   GND
763   PC1
774   PC0
785   PB8
796   BOOT0
807   PB7
818   PB6
829   PB5
8310  PD2
8411  PC12
8512  PC11
8613  PC10
8714  PA14     SWCLK
8815  PA13     SWDIO
8916  PA12
9017  PA11
9118  PA9      USB serial Tx drives this pin (input) for UART1
9219  PA10     USB serial Rx is driven by this pin (output) for UART1
9320  PA8
94=== ======== ======================================================
95
96.. _CN7:
97
98-----------
99CN7 Pin-Out
100-----------
101
102=== ======== ============================
103Pin Function Note
104=== ======== ============================
1051   PC2
1062   PC3
1073   nRESET
1084   PA0
1095   PA2
1106   PA3
1117   PA4
1128   PA5
1139   PA6
11410  PA7
11511  PC4
11612  PC5
11713  PB0
11814  PB1
11915  PC6
12016  PC7
12117  PC8
12218  PC9
12319  GND
12420  PA1      Used in S76S as “RF FEM CPS”
125=== ======== ============================
126
127.. _internally dedicated ports:
128
129--------------------------
130Internally Dedicated Ports
131--------------------------
132
133======== ======== ============= ==== =========================
134Pin name Pin Type I/O Structure Note Function
135======== ======== ============= ==== =========================
136PA15     I/O      FT            -    INTERNAL SX1276 D5
137PB3      I/O      FTf           -    INTERNAL SX1276 D4
138PB4      I/O      FTf           -    INTERNAL SX1276 D3
139PB9      I/O      FTf           -    INTERNAL SX1276 D2
140PB10     I/O      FT            -    INTERNAL SX1276 Reset
141PB11     I/O      FT            -    INTERNAL SX1276 D0
142PB12     I/O      FT            -    INTERNAL SX1276 SPI nCS
143PB13     I/O      FTf           -    INTERNAL SX1276 SPI2_SCK
144PB14     I/O      FTf           -    INTERNAL SX1276 SPI2_MISO
145PB15     I/O      FT            -    INTERNAL SX1276 SPI2_MOSI
146PC13     I/O      FT            -    INTERNAL SX1276 D1
147======== ======== ============= ==== =========================
148
149==========
150References
151==========
152
153.. _Ronoth: https://ronoth.com/
154
155.. _LoDev: https://ronoth.com/products/lodev-s76s-lora-soc-development-board?variant=31608819417220
156
157.. _AcSIP: http://www.acsip.com.tw
158
159.. _AcSIP S76S: http://www.acsip.com.tw/index.php?action=products-detail&fid1=11&fid2=29&fid3=27&id=79&lang=3
160
161.. _AcSIP S76S Product Information Brief: http://www.acsip.com.tw/upload/product_attach/S76S_Brief_ver02.pdf
162
163.. _CrowdSupply: https://www.crowdsupply.com/ronoth/lodev
164
165.. _full LoDev design details: https://github.com/ronoth/LoDev
166
167.. _Board design files: https://github.com/ronoth/LoDev
168
169.. _posted on MBed by Steve Osborn: https://os.mbed.com/users/steve918/
170
171.. _STMicro STM32L073RZ: STMicro STM32L073RZ
172
173.. _Semtech SX1276: https://www.semtech.com/products/wireless-rf/lora-transceivers/sx1276
174
175=======
176License
177=======
178
179This document Copyright (c) 2021 Dean Weiten <dmw@weiten.com>
180
181SPDX-License-Identifier: Apache-2.0
182