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 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.jpg
20     :align: center
21     :alt: Image of Ronoth LoDev open source development board containing S76S system on a chip
22
23     Ronoth LoDev
24
25`Board design files`_ are available on GitHub.
26
27================
28Device Resources
29================
30
31The embedded STMicro STM32L073RZ has some GPIOs and SPI2 internally committed to the LoRaWAN
32transceiver operation.  See `internally dedicated ports`_ for a list of resources committed to this function.
33
34=========
35Debugging
36=========
37
38Programming and debugging uses the SWD port, as on any STM32 processor.  An ST-LINK/V2 adapter
39may be used with the appropriate software (*st-utils* package on Linux).
40
41=================
42Connector Pin-Out
43=================
44
45The LoDev has two rows of headers.  Pin 1 on both connectors is closest to the micro-USB connector on the board,
46furthest from the RF (antenna) connector.
47
48When viewed from the top (component) side of the board, with the micro-USB connector closest and RF (antenna)
49connector furthest away, the CN6_ connector is on the left, the CN7_ connector is on the right.
50
51UART1 on the S76S SiP is connected to a USB-to-UART device connected to the micro USB connector, so generally
52PA9 and PA10 are unavailable for I/Os.
53
54A helpful silkscreen legend is provided on the board.
55
56.. figure:: img/pinout.jpg
57     :align: center
58     :alt: Ronoth LoDev sketch with pinout
59
60     Ronth LoDev Pinout
61
62.. _CN6:
63
64-----------
65CN6 Pin-Out
66-----------
67
68=== ======== ======================================================
69Pin Function Note
70=== ======== ======================================================
711   3.3V     Output 500 mA max
722   GND
733   PC1
744   PC0
755   PB8
766   BOOT0
777   PB7
788   PB6
799   PB5
8010  PD2
8111  PC12
8212  PC11
8313  PC10
8414  PA14     SWCLK
8515  PA13     SWDIO
8616  PA12
8717  PA11
8818  PA9      USB serial Tx drives this pin (input) for UART1
8919  PA10     USB serial Rx is driven by this pin (output) for UART1
9020  PA8
91=== ======== ======================================================
92
93.. _CN7:
94
95-----------
96CN7 Pin-Out
97-----------
98
99=== ======== ============================
100Pin Function Note
101=== ======== ============================
1021   PC2
1032   PC3
1043   nRESET
1054   PA0
1065   PA2
1076   PA3
1087   PA4
1098   PA5
1109   PA6
11110  PA7
11211  PC4
11312  PC5
11413  PB0
11514  PB1
11615  PC6
11716  PC7
11817  PC8
11918  PC9
12019  GND
12120  PA1      Used in S76S as “RF FEM CPS”
122=== ======== ============================
123
124.. _internally dedicated ports:
125
126--------------------------
127Internally Dedicated Ports
128--------------------------
129
130======== ======== ============= ==== =========================
131Pin name Pin Type I/O Structure Note Function
132======== ======== ============= ==== =========================
133PA15     I/O      FT            -    INTERNAL SX1276 D5
134PB3      I/O      FTf           -    INTERNAL SX1276 D4
135PB4      I/O      FTf           -    INTERNAL SX1276 D3
136PB9      I/O      FTf           -    INTERNAL SX1276 D2
137PB10     I/O      FT            -    INTERNAL SX1276 Reset
138PB11     I/O      FT            -    INTERNAL SX1276 D0
139PB12     I/O      FT            -    INTERNAL SX1276 SPI nCS
140PB13     I/O      FTf           -    INTERNAL SX1276 SPI2_SCK
141PB14     I/O      FTf           -    INTERNAL SX1276 SPI2_MISO
142PB15     I/O      FT            -    INTERNAL SX1276 SPI2_MOSI
143PC13     I/O      FT            -    INTERNAL SX1276 D1
144======== ======== ============= ==== =========================
145
146==========
147References
148==========
149
150.. _Ronoth: https://ronoth.com/
151
152.. _LoDev: https://ronoth.com/products/lodev-s76s-lora-soc-development-board?variant=31608819417220
153
154.. _AcSIP: http://www.acsip.com.tw
155
156.. _AcSIP S76S: http://www.acsip.com.tw/index.php?action=products-detail&fid1=11&fid2=29&fid3=27&id=79&lang=3
157
158.. _AcSIP S76S Product Information Brief: https://www.acsip.com.tw/index.php?action=download_pro&perm=d&id=365
159
160.. _CrowdSupply: https://www.crowdsupply.com/ronoth/lodev
161
162.. _full LoDev design details: https://github.com/ronoth/LoDev
163
164.. _Board design files: https://github.com/ronoth/LoDev
165
166.. _posted on MBed by Steve Osborn: https://os.mbed.com/users/steve918/
167
168.. _Semtech SX1276: https://www.semtech.com/products/wireless-rf/lora-transceivers/sx1276
169
170=======
171License
172=======
173
174This document Copyright (c) 2021 Dean Weiten <dmw@weiten.com>
175
176SPDX-License-Identifier: Apache-2.0
177