1.. _ganymed_bob:
2
3Ganymed Break-Out-Board (BOB)
4#############################
5
6Overview
7********
8
9.. note::
10
11   All software for the Ganymed Break-Out-Board (BOB) is experimental and hardware availability
12   is restricted to the participants in the limited sampling program.
13
14The Ganymed board hardware provides support for the Ganymed sy1xx series IoT multicore
15RISC-V SoC with optional sensor level.
16
17The SoC has the following core features:
18
19* 32-Bit RSIC-V 1+8-core processor, up to 500MHz
20
21  * 1x Data Acquisition Unit
22  * 8x Data Processing Unit
23  * Event Bus
24  * MicroDMA
25
26* 4096 KB Global SRAM
27* 64 KB Secure SRAM
28* 512 KB Global MRAM
29* 512 KB Secure MRAM
30* CLOCK
31* RAM
32* :abbr:`32x GPIO (General Purpose Input Output)`
33* :abbr:`4x TWIM (I2C-compatible two-wire interface with MicroDMA)`
34* 4x I2S
35* :abbr:`7x SPI (Serial Peripheral Interface with MicroDMA)`
36* :abbr:`3x UART (Universal receiver-transmitter with MicroDMA)`
37* :abbr:`1x TSN (Time sensitive networking ethernet MAC with MicroDMA)`
38* 1x CAN-FD
39* 3x ADC
40
41.. figure:: img/ganymed_bob_sy120_gbm.webp
42     :align: center
43     :alt: Ganymed Break-Out-Board (BOB) equipped with SY120 GBM
44
45     Ganymed Break-Out-Board (BOB) equipped with SY120 GBM (Credit: Sensry)
46
47.. figure:: img/ganymed_bob_sy120_gen1.webp
48     :align: center
49     :alt: Ganymed Break-Out-Board (BOB) equipped with SY120 GEN1
50
51     Ganymed Break-Out-Board (BOB) equipped with SY120 GEN1 (Credit: Sensry)
52
53Hardware
54********
55
56The Ganymed BOB has:
57
58* Assembly options for the SoC include
59
60  * SY120-GBM - Generic Base Module without top level sensors
61  * SY120-GEN1 - Generic Module type 1 with top level sensors (Bosch BME680 - SPI1 , Bosch BMA456 - SPI0, Bosch BMG250 - SPI2, STMicro MIS2DH - I2C0)
62
63* power section for on-board power generation and power measurement (selectable)
64* 40-pin JTAG connector (compatible to Olimex ARM-JTAG-OCD-H)
65* USB over FTDI (connected to UART0)
66* Header for I/Os and additional configuration
67
68Supported Features
69==================
70
71The ``ganymed-bob/sy120-gbm`` board supports the following hardware features:
72
73+-----------+------------+----------------------+
74| Interface | Controller | Driver/Component     |
75+===========+============+======================+
76| SAADC     | on-chip    | adc                  |
77+-----------+------------+----------------------+
78| CLOCK     | on-chip    | clock_control        |
79+-----------+------------+----------------------+
80| MRAM      | on-chip    | flash                |
81+-----------+------------+----------------------+
82| GPIO      | on-chip    | gpio                 |
83+-----------+------------+----------------------+
84| TWIM      | on-chip    | i2c                  |
85+-----------+------------+----------------------+
86| PWM       | on-chip    | pwm                  |
87+-----------+------------+----------------------+
88| GRTC      | on-chip    | counter              |
89+-----------+------------+----------------------+
90| RTT       | Segger     | console              |
91+-----------+------------+----------------------+
92| SPI(M/S)  | on-chip    | spi                  |
93+-----------+------------+----------------------+
94| SPU       | on-chip    | system protection    |
95+-----------+------------+----------------------+
96| UART      | on-chip    | serial               |
97+-----------+------------+----------------------+
98| TSN       | on-chip    | ethernet MAC         |
99+-----------+------------+----------------------+
100| CAN       | on-chip    | CAN                  |
101+-----------+------------+----------------------+
102
103Other hardware features have not been enabled yet for this board.
104
105The ``ganymed-bob/sy120-gen1`` board includes all hardware features of the ``ganymed-bob/sy120-gbm`` board and comes additionally
106with these features:
107
108+-----------+------------+----------------------+
109| Interface | Controller | Driver/Component     |
110+===========+============+======================+
111| BME680    | on-chip    | environment sensor   |
112+-----------+------------+----------------------+
113| BMA456    | on-chip    | acceleration sensor  |
114+-----------+------------+----------------------+
115| BMG250    | on-chip    | gyrosope sensor      |
116+-----------+------------+----------------------+
117| MIS2DH    | on-chip    | vibration sensor     |
118+-----------+------------+----------------------+
119
120Other hardware features have not been enabled yet for this board.
121
122Power
123*****
124
125* USB type-C
126* external 5V power source
127
128Programming and Debugging
129*************************
130
131Applications for the ``ganymed-bob/sy120-gbm`` board can be
132built, flashed, and debugged in the usual way. See
133:ref:`build_an_application` and :ref:`application_run` for more details on
134building and running.
135
136Testing the Ganymed BreakOut Board
137**********************************
138
139Test the Ganymed with a :zephyr:code-sample:`blinky` sample.
140The sample output should be:
141
142.. code-block:: console
143
144    Hello World! ganymed-bob/sy120-gbm
145