1.. _acsip_s76s:
2
3AcSIP S76S
4##########
5
6========
7Overview
8========
9
10The `AcSIP S76S`_  is an SiP from AcSIP_ containing an `STMicro STM32L073RZ`_ MCU,
11a `Semtech SX1276`_ LoRaWAN transceiver, and a +20 dBm power amplifier.  Refer to the
12`AcSIP S76S Product Information Brief`_ for details.  Further information is available
13from the `AcSIP Product Data Download`_ site (may need login). The parts are `available through TechShip`_.
14
15Zephyr applications may use the **acsip_s76s** configuration to use this SiP.
16
17.. figure:: img/acsip_s76s.png
18     :width: 189px
19     :align: center
20     :height: 115px
21     :alt: AcSIP S76S system on a chip, containing STMicro STM32L073RZ and Semtech SX1276
22
23     AcSIP S76S
24
25================
26Device Resources
27================
28
29The embedded `STMicro STM32L073RZ`_ has some GPIOs and SPI2 internally committed to the LoRaWAN
30transceiver operation.  See `internally committed table`_ for a list of resources committed to this function.
31
32As a result, some functions, ports and features of the `STMicro STM32L073RZ`_ are not available.
33See `unavailable table`_ for a list of resources not available due to a lack of pin-out.
34
35Available pinned-out resources are listed in `this table`_.  The actual `S76S pinout table`_ is below.
36
37These tables are STM32L07x generic - some pinned-out resources may be unavailable due to limitations
38on the `STMicro STM32L073RZ`_ processor itself.  Consult with the `STMicro STM32L073RZ`_ documentation.
39
40===========
41Development
42===========
43
44The Ronoth_ LoDev_ board is an open source development board, see its board description files.
45
46=========
47Debugging
48=========
49
50Programming and debugging uses the SWD port, as on any STM32 processor.  An ST-LINK/V2 adapter
51may be used with the appropriate software (*st-utils* package on Linux).
52
53.. _S76S pinout table:
54
55==================================
56Pin Assignments and Available Pins
57==================================
58
59-------------------
60S76S Pin Assignment
61-------------------
62
63=== ================ === ================
64Pin Function         Pin Function
65=== ================ === ================
661   NC               32  GND
672   GND              33  RF_ANT
683   GND              34  GND
694   PC1              35  GND
705   PC2              36  PA1\_RF\_FEM_CPS
716   PC3              37  GND
727   NC               38  NC
738   NC               39  GND
749   NC               40  NC
7510  NC               41  GND
7611  NC               42  NC
7712  nReset           43  VDD
7813  PA0              44  VDD
7914  GND              45  PA8\_USART1\_CK
8015  GND              46  PA10\_USART1\_RX
8116  PA2\_TxD\_A      47  PA9\_USART1\_TX
8217  PA3\_RxD\_A      48  PA11\_USART1\_CTS
8318  PA4\_SPI1\_NSS   49  PA12\_USART1\_RTS
8419  PA5\_SPI1\_SCK   50  PA13_SWDIO
8520  PA6\_SPI1\_MISO  51  PA14_SWCLK
8621  PA7\_SPI1\_MOSI  52  PC10
8722  PC4              53  PC11
8823  PC5              54  PC12
8924  PB0\_IO\_INT1    55  PD2
9025  PB1\_IO\_INT2    56  PB5
9126  PC6              57  PB6_SCL
9227  PC7              58  PB7_SDA
9328  PC8              59  BOOT0
9429  PC9              60  PB8\_IO\_LED_FCT
9530  RXTX/RFMOD       61  GND
9631  GND              62  GND
97=== ================ === ================
98
99.. _this table:
100
101--------------------------------
102Ports Connected to External Pins
103--------------------------------
104
105======== ======== ============= ==== ========================================================================================================== =======================================
106Pin name Pin Type I/O Structure Note Alternate functions                                                                                        Additional functions
107======== ======== ============= ==== ========================================================================================================== =======================================
108BOOT0    I                      -    -                                                                                                          -
109NRST     I/O      -             -    -                                                                                                          -
110PA0      I/O      TC            -    TIM2_CH1, TSC_G1_IO1, USART2_CTS, TIM2_ETR, USART4_TX, COMP1_OUT                                           COMP1_INM, ADC_IN0, RTC_TAMP2/WKUP1
111PA1      I/O      FT            -    EVENTOUT, LCD_SEG0, TIM2_CH2, TSC_G1_IO2, USART2_RTS/USART2_DE, TIM21_ETR, USART4_RX                       COMP1_INP, ADC_IN1
112PA2      I/O      FT            -    TIM21_CH1, LCD_SEG1, TIM2_CH3, TSC_G1_IO3, USART2_TX, LPUART1_TX, COMP2_OUT                                COMP2_INM, ADC_IN2
113PA3      I/O      FT            -    TIM21_CH2, LCD_SEG2, TIM2_CH4, TSC_G1_IO4, USART2_RX, LPUART1_RX                                           COMP2_INP, ADC_IN3
114PA4      I/O      TC            (1)  SPI1_NSS, TSC_G2_IO1, USART2_CK, TIM22_ETR                                                                 COMP1_INM, COMP2_INM, ADC_IN4, DAC_OUT1
115PA5      I/O      TC            -    SPI1_SCK, TIM2_ETR, TSC_G2_IO2, TIM2_CH1                                                                   COMP1_INM, COMP2_INM, ADC_IN5, DAC_OUT2
116PA6      I/O      FT            -    SPI1_MISO, LCD_SEG3, TIM3_CH1, TSC_G2_IO3, LPUART1_CTS, TIM22_CH1, EVENTOUT, COMP1_OUT                     ADC_IN6
117PA7      I/O      FT            -    SPI1_MOSI, LCD_SEG4, TIM3_CH2, TSC_G2_IO4, TIM22_CH2, EVENTOUT, COMP2_OUT                                  ADC_IN7
118PA8      I/O      FTf           -    MCO, LCD_COM0, USB_CRS_SYNC, EVENTOUT, USART1_CK, I2C3_SCL                                                 -
119PA9      I/O      FTf           -    MCO, LCD_COM1, TSC_G4_IO1, USART1_TX, I2C1_SCL, I2C3_SMBA                                                  -
120PA10     I/O      FTf           -    LCD_COM2, TSC_G4_IO2, USART1_RX, I2C1_SDA                                                                  -
121PA11     I/O      FT            (2)  SPI1_MISO, EVENTOUT, TSC_G4_IO3, USART1_CTS, COMP1_OUT                                                     USB_DM
122PA12     I/O      FT            (2)  SPI1_MOSI, EVENTOUT, TSC_G4_IO4, USART1_RTS/USART1_DE, COMP2_OUT                                           USB_DP
123PA13     I/O      FT            -    SWDIO, USB_NOE, LPUART1_RX                                                                                 -
124PA14     I/O      FT            -    SWCLK, USART2_TX, LPUART1_TX                                                                               -
125PB0      I/O      FT            -    EVENTOUT, LCD_SEG5, TIM3_CH3, TSC_G3_IO2                                                                   LCD_VLCD3, ADC_IN8, VREF_OUT
126PB1      I/O      FT            -    LCD_SEG6, TIM3_CH4, TSC_G3_IO3, LPUART1_RTS/LPUART1_DE                                                     ADC_IN9, VREF_OUT
127PB5      I/O      FT            -    SPI1_MOSI, LCD_SEG9, LPTIM1_IN1, I2C1_SMBA, TIM3_CH2/TIM22_CH2, USART1_CK, USART5_CK, USART5_RTS/USART5_DE COMP2_INP
128PB6      I/O      FTf           -    USART1_TX, I2C1_SCL, LPTIM1_ETR, TSC_G5_IO3                                                                COMP2_INP
129PB7      I/O      FTf           -    USART1_RX, I2C1_SDA, LPTIM1_IN2, TSC_G5_IO4, USART4_CTS                                                    COMP2_INP, PVD_IN
130PB8      I/O      FTf           -    LCD_SEG16, TSC_SYNC, I2C1_SCL                                                                              -
131PC1      I/O      FTf           -    LPTIM1_OUT, LCD_SEG19, EVENTOUT, TSC_G7_IO2, LPUART1_TX, I2C3_SDA                                          ADC_IN11
132PC2      I/O      FTf           -    LPTIM1_IN2, LCD_SEG20, SPI2_MISO/I2S2_MCK, TSC_G7_IO3                                                      ADC_IN12
133PC3      I/O      FT            -    LPTIM1_ETR, LCD_SEG21, SPI2_MOSI/I2S2_SD, TSC_G7_IO4                                                       ADC_IN13
134PC4      I/O      FT            -    EVENTOUT, LCD_SEG22, LPUART1_TX                                                                            ADC_IN14
135PC5      I/O      FT            -    LCD_SEG23, LPUART1_RX, TSC_G3_IO1                                                                          ADC_IN15
136PC6      I/O      FT            -    TIM22_CH1, LCD_SEG24, TIM3_CH1, TSC_G8_IO1                                                                 -
137PC7      I/O      FT            -    TIM22_CH2, LCD_SEG25, TIM3_CH2, TSC_G8_IO2                                                                 -
138PC8      I/O      FT            -    TIM22_ETR, LCD_SEG26, TIM3_CH3, TSC_G8_IO3                                                                 -
139PC9      I/O      FTf           -    TIM21_ETR, LCD_SEG27, USB_NOE/TIM3_CH4, TSC_G8_IO4, I2C3_SDA                                               -
140PC10     I/O      FT            -    LPUART1_TX, LCD_COM4/LCD_SEG2 8/LCD_SEG48, USART4_TX                                                       -
141PC11     I/O      FT            -    LPUART1_RX, LCD_COM5/LCD_SEG2 9/LCD_SEG49, USART4_RX                                                       -
142PC12     I/O      FT            -    LCD_COM6/LCD_SEG3 0/LCD_SEG50, USART5_TX, USART4_CK                                                        -
143PD2      I/O      FT            -    LPUART1_RTS/LPUART1_DE, LCD_COM7/LCD_SEG3 1/LCD_SEG51, TIM3_ETR, USART5_RX                                 -
144======== ======== ============= ==== ========================================================================================================== =======================================
145
146Notes:
147
1481. PA4 offers a reduced touch sensing sensitivity. It is thus recommended to use it as sampling capacitor I/O.
1492. These pins are powered by VDD_USB. For all characteristics that refer to VDD, VDD_USB must be used instead.
150
151.. _internally committed table:
152
153--------------------------
154Internally Dedicated Ports
155--------------------------
156
157======== ======== ============= ==== =========================
158Pin name Pin Type I/O Structure Note Function
159======== ======== ============= ==== =========================
160PA15     I/O      FT            -    INTERNAL SX1276 D5
161PB3      I/O      FTf           -    INTERNAL SX1276 D4
162PB4      I/O      FTf           -    INTERNAL SX1276 D3
163PB9      I/O      FTf           -    INTERNAL SX1276 D2
164PB10     I/O      FT            -    INTERNAL SX1276 Reset
165PB11     I/O      FT            -    INTERNAL SX1276 D0
166PB12     I/O      FT            -    INTERNAL SX1276 SPI nCS
167PB13     I/O      FTf           -    INTERNAL SX1276 SPI2_SCK
168PB14     I/O      FTf           -    INTERNAL SX1276 SPI2_MISO
169PB15     I/O      FT            -    INTERNAL SX1276 SPI2_MOSI
170PC13     I/O      FT            -    INTERNAL SX1276 D1
171======== ======== ============= ==== =========================
172
173.. _unavailable table:
174
175-----------------------------------
176Ports Not Available / Not Connected
177-----------------------------------
178
179====================== ======== ============= ==== ================================================================= ====================
180Pin name               Pin Type I/O Structure Note Alternate functions                                               Additional functions
181====================== ======== ============= ==== ================================================================= ====================
182PC0                    I/O      FTf           -    LPTIM1_IN1, LCD_SEG18, EVENTOUT, TSC_G7_IO1, LPUART1_RX, I2C3_SCL ADC_IN10
183PC14- OSC32_IN (PC14)  I/O      FT            -    -                                                                 OSC32_IN
184PC15- OSC32_OUT (PC15) I/O      TC            -    -                                                                 OSC32_OUT
185PD0                    I/O      FT            -    TIM21_CH1, SPI2_NSS/I2S2_WS                                       -
186PD1                    I/O      FT            -    SPI2_SCK/I2S2_CK                                                  -
187PD3                    I/O      FT            -    USART2_CTS, LCD_SEG44, SPI2_MISO/I2S2_MCK                         -
188PD4                    I/O      FT            -    USART2_RTS/USART2_DE, SPI2_MOSI/I2S2_SD                           -
189PD5                    I/O      FT            -    USART2_TX                                                         -
190PD6                    I/O      FT            -    USART2_RX                                                         -
191PD7                    I/O      FT            -    USART2_CK, TIM21_CH2                                              -
192PD8                    I/O      FT            -    LPUART1_TX, LCD_SEG28                                             -
193PD9                    I/O      FT            -    LPUART1_RX, LCD_SEG29                                             -
194PD10                   I/O      FT            -    LCD_SEG30                                                         -
195PD11                   I/O      FT            -    LPUART1_CTS, LCD_SEG31                                            -
196PD12                   I/O      FT            -    LPUART1_RTS/LPUART1_DE, LCD_SEG32                                 -
197PD13                   I/O      FT            -    LCD_SEG33                                                         -
198PD14                   I/O      FT            -    LCD_SEG34                                                         -
199PD15                   I/O      FT            -    USB_CRS_SYNC, LCD_SEG35                                           -
200PE0                    I/O      FT            -    LCD_SEG36, EVENTOUT                                               -
201PE1                    I/O      FT            -    LCD_SEG37, EVENTOUT                                               -
202PE2                    I/O      FT            -    LCD_SEG38, TIM3_ETR                                               -
203PE3                    I/O      FT            -    TIM22_CH1, LCD_SEG39, TIM3_CH1                                    -
204PE4                    I/O      FT            -    TIM22_CH2, TIM3_CH2                                               -
205PE5                    I/O      FT            -    TIM21_CH1, TIM3_CH3                                               -
206PE6                    I/O      FT            -    TIM21_CH2, TIM3_CH4                                               RTC_TAMP3/WKUP3
207PE7                    I/O      FT            -    LCD_SEG45, USART5_CK/USART5_RTS/USART5_DE                         -
208PE8                    I/O      FT            -    LCD_SEG46, USART4_TX                                              -
209PE9                    I/O      FT            -    TIM2_CH1, LCD_SEG47, TIM2_ETR, USART4_RX                          -
210PE10                   I/O      FT            -    TIM2_CH2, LCD_SEG40, USART5_TX                                    -
211PE11                   I/O      FT            -    TIM2_CH3, USART5_RX                                               LCD_VLCD1
212PE12                   I/O      FT            -    TIM2_CH4, SPI1_NSS                                                LCD_VLCD3
213PE13                   I/O      FT            -    LCD_SEG41, SPI1_SCK                                               -
214PE14                   I/O      FT            -    LCD_SEG42, SPI1_MISO                                              -
215PE15                   I/O      FT            -    LCD_SEG43, SPI1_MOSI                                              -
216PH0-OSC_IN (PH0)       I/O      TC            -    USB_CRS_SYNC                                                      OSC_IN
217PH1- OSC_OUT (PH1)     I/O      TC            -    -                                                                 OSC_OUT
218PH9                    I/O      FT            -    -                                                                 -
219PH10                   I/O      FT            -    -                                                                 -
220VDD_USB                S                      -    -                                                                 -
221VDDA                   S        -             -    -                                                                 -
222VLCD                   S                      -    -
223VREF-                  S        -             -    -                                                                 -
224VREF+                  S        -             -    -                                                                 -
225VSSA                   S        -             -    -                                                                 -
226====================== ======== ============= ==== ================================================================= ====================
227
228==========
229References
230==========
231
232.. _AcSIP: http://www.acsip.com.tw
233
234.. _AcSIP S76S: http://www.acsip.com.tw/index.php?action=products-detail&fid1=11&fid2=29&fid3=27&id=79&lang=3
235
236.. _AcSIP S76S Product Information Brief: http://www.acsip.com.tw/upload/product_attach/S76S_Brief_ver02.pdf
237
238.. _AcSIP Product Data Download: http://www.acsip.com.tw/index.php?action=technical
239
240.. _available through TechShip: https://techship.com/products/acsip-lorawan-module-s76s/
241
242.. _Ronoth: https://ronoth.com/
243
244.. _LoDev: https://ronoth.com/products/lodev-s76s-lora-soc-development-board?variant=31608819417220
245
246.. _STMicro STM32L073RZ: STMicro STM32L073RZ
247
248.. _Semtech SX1276: https://www.semtech.com/products/wireless-rf/lora-transceivers/sx1276
249
250=======
251License
252=======
253
254This document Copyright (c) 2021 Dean Weiten <dmw@weiten.com>
255
256SPDX-License-Identifier: Apache-2.0
257