1.. zephyr:board:: ronoth_lodev
2
3========
4Overview
5========
6
7The Ronoth_ LoDev_ is a small open source board containing a `AcSIP S76S`_  SiP from AcSIP_.
8The `full LoDev design details`_ are available on GitHub.  The LoDev_ board can be purchased
9from Ronoth_ or from CrowdSupply_.
10
11The S76S contains an STMicro STM32L073RZ MCU, a `Semtech SX1276`_ LoRaWAN transceiver,
12and a +20 dBm power amplifier.  Refer to `AcSIP S76S Product Information Brief`_ for details.
13
14Zephyr applications may use the **ronoth_lodev** configuration to run on this board.
15
16`Board design files`_ are available on GitHub.
17
18================
19Device Resources
20================
21
22The embedded STMicro STM32L073RZ has some GPIOs and SPI2 internally committed to the LoRaWAN
23transceiver operation.  See `internally dedicated ports`_ for a list of resources committed to this function.
24
25=========
26Debugging
27=========
28
29Programming and debugging uses the SWD port, as on any STM32 processor.  An ST-LINK/V2 adapter
30may be used with the appropriate software (*st-utils* package on Linux).
31
32=================
33Connector Pin-Out
34=================
35
36The LoDev has two rows of headers.  Pin 1 on both connectors is closest to the micro-USB connector on the board,
37furthest from the RF (antenna) connector.
38
39When viewed from the top (component) side of the board, with the micro-USB connector closest and RF (antenna)
40connector furthest away, the CN6_ connector is on the left, the CN7_ connector is on the right.
41
42UART1 on the S76S SiP is connected to a USB-to-UART device connected to the micro USB connector, so generally
43PA9 and PA10 are unavailable for I/Os.
44
45A helpful silkscreen legend is provided on the board.
46
47.. figure:: img/pinout.jpg
48     :align: center
49     :alt: Ronoth LoDev sketch with pinout
50
51     Ronth LoDev Pinout
52
53.. _CN6:
54
55-----------
56CN6 Pin-Out
57-----------
58
59=== ======== ======================================================
60Pin Function Note
61=== ======== ======================================================
621   3.3V     Output 500 mA max
632   GND
643   PC1
654   PC0
665   PB8
676   BOOT0
687   PB7
698   PB6
709   PB5
7110  PD2
7211  PC12
7312  PC11
7413  PC10
7514  PA14     SWCLK
7615  PA13     SWDIO
7716  PA12
7817  PA11
7918  PA9      USB serial Tx drives this pin (input) for UART1
8019  PA10     USB serial Rx is driven by this pin (output) for UART1
8120  PA8
82=== ======== ======================================================
83
84.. _CN7:
85
86-----------
87CN7 Pin-Out
88-----------
89
90=== ======== ============================
91Pin Function Note
92=== ======== ============================
931   PC2
942   PC3
953   nRESET
964   PA0
975   PA2
986   PA3
997   PA4
1008   PA5
1019   PA6
10210  PA7
10311  PC4
10412  PC5
10513  PB0
10614  PB1
10715  PC6
10816  PC7
10917  PC8
11018  PC9
11119  GND
11220  PA1      Used in S76S as “RF FEM CPS”
113=== ======== ============================
114
115.. _internally dedicated ports:
116
117--------------------------
118Internally Dedicated Ports
119--------------------------
120
121======== ======== ============= ==== =========================
122Pin name Pin Type I/O Structure Note Function
123======== ======== ============= ==== =========================
124PA15     I/O      FT            -    INTERNAL SX1276 D5
125PB3      I/O      FTf           -    INTERNAL SX1276 D4
126PB4      I/O      FTf           -    INTERNAL SX1276 D3
127PB9      I/O      FTf           -    INTERNAL SX1276 D2
128PB10     I/O      FT            -    INTERNAL SX1276 Reset
129PB11     I/O      FT            -    INTERNAL SX1276 D0
130PB12     I/O      FT            -    INTERNAL SX1276 SPI nCS
131PB13     I/O      FTf           -    INTERNAL SX1276 SPI2_SCK
132PB14     I/O      FTf           -    INTERNAL SX1276 SPI2_MISO
133PB15     I/O      FT            -    INTERNAL SX1276 SPI2_MOSI
134PC13     I/O      FT            -    INTERNAL SX1276 D1
135======== ======== ============= ==== =========================
136
137==========
138References
139==========
140
141.. _Ronoth: https://ronoth.com/
142
143.. _LoDev: https://ronoth.com/products/lodev-s76s-lora-soc-development-board?variant=31608819417220
144
145.. _AcSIP: http://www.acsip.com.tw
146
147.. _AcSIP S76S: http://www.acsip.com.tw/index.php?action=products-detail&fid1=11&fid2=29&fid3=27&id=79&lang=3
148
149.. _AcSIP S76S Product Information Brief: https://www.acsip.com.tw/index.php?action=download_pro&perm=d&id=365
150
151.. _CrowdSupply: https://www.crowdsupply.com/ronoth/lodev
152
153.. _full LoDev design details: https://github.com/ronoth/LoDev
154
155.. _Board design files: https://github.com/ronoth/LoDev
156
157.. _posted on MBed by Steve Osborn: https://os.mbed.com/users/steve918/
158
159.. _Semtech SX1276: https://www.semtech.com/products/wireless-rf/lora-transceivers/sx1276
160
161=======
162License
163=======
164
165This document Copyright (c) 2021 Dean Weiten <dmw@weiten.com>
166
167SPDX-License-Identifier: Apache-2.0
168