Skip to content

Commit 639e6b2

Browse files
committed
Sync dev-platforms
1 parent af6575e commit 639e6b2

33 files changed

+2118
-6
lines changed
Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
1+
.. Copyright (c) 2014-present PlatformIO <contact@platformio.org>
2+
Licensed under the Apache License, Version 2.0 (the "License");
3+
you may not use this file except in compliance with the License.
4+
You may obtain a copy of the License at
5+
http://www.apache.org/licenses/LICENSE-2.0
6+
Unless required by applicable law or agreed to in writing, software
7+
distributed under the License is distributed on an "AS IS" BASIS,
8+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
9+
See the License for the specific language governing permissions and
10+
limitations under the License.
11+
12+
.. _board_atmelsam_adafruit_blm_badge:
13+
14+
Adafruit BLM Badge
15+
==================
16+
17+
.. contents::
18+
19+
Hardware
20+
--------
21+
22+
Platform :ref:`platform_atmelsam`: Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
23+
24+
.. list-table::
25+
26+
* - **Microcontroller**
27+
- SAMD21E18A
28+
* - **Frequency**
29+
- 48MHz
30+
* - **Flash**
31+
- 256KB
32+
* - **RAM**
33+
- 32KB
34+
* - **Vendor**
35+
- `Adafruit <https://www.adafruit.com/blacklivesmatter?utm_source=platformio.org&utm_medium=docs>`__
36+
37+
38+
Configuration
39+
-------------
40+
41+
Please use ``adafruit_blm_badge`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`:
42+
43+
.. code-block:: ini
44+
45+
[env:adafruit_blm_badge]
46+
platform = atmelsam
47+
board = adafruit_blm_badge
48+
49+
You can override default Adafruit BLM Badge settings per build environment using
50+
``board_***`` option, where ``***`` is a JSON object path from
51+
board manifest `adafruit_blm_badge.json <https://github.com/platformio/platform-atmelsam/blob/master/boards/adafruit_blm_badge.json>`_. For example,
52+
``board_build.mcu``, ``board_build.f_cpu``, etc.
53+
54+
.. code-block:: ini
55+
56+
[env:adafruit_blm_badge]
57+
platform = atmelsam
58+
board = adafruit_blm_badge
59+
60+
; change microcontroller
61+
board_build.mcu = samd21e18a
62+
63+
; change MCU frequency
64+
board_build.f_cpu = 48000000L
65+
66+
67+
Uploading
68+
---------
69+
Adafruit BLM Badge supports the next uploading protocols:
70+
71+
* ``atmel-ice``
72+
* ``blackmagic``
73+
* ``jlink``
74+
* ``sam-ba``
75+
76+
Default protocol is ``sam-ba``
77+
78+
You can change upload protocol using :ref:`projectconf_upload_protocol` option:
79+
80+
.. code-block:: ini
81+
82+
[env:adafruit_blm_badge]
83+
platform = atmelsam
84+
board = adafruit_blm_badge
85+
86+
upload_protocol = sam-ba
87+
88+
Debugging
89+
---------
90+
91+
:ref:`piodebug` - "1-click" solution for debugging with a zero configuration.
92+
93+
.. warning::
94+
You will need to install debug tool drivers depending on your system.
95+
Please click on compatible debug tool below for the further
96+
instructions and configuration information.
97+
98+
You can switch between debugging :ref:`debugging_tools` using
99+
:ref:`projectconf_debug_tool` option in :ref:`projectconf`.
100+
101+
Adafruit BLM Badge does not have on-board debug probe and **IS NOT READY** for debugging. You will need to use/buy one of external probe listed below.
102+
103+
.. list-table::
104+
:header-rows: 1
105+
106+
* - Compatible Tools
107+
- On-board
108+
- Default
109+
* - :ref:`debugging_tool_atmel-ice`
110+
-
111+
- Yes
112+
* - :ref:`debugging_tool_blackmagic`
113+
-
114+
-
115+
* - :ref:`debugging_tool_jlink`
116+
-
117+
-
118+
119+
Frameworks
120+
----------
121+
.. list-table::
122+
:header-rows: 1
123+
124+
* - Name
125+
- Description
126+
127+
* - :ref:`framework_arduino`
128+
- Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences
Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
.. Copyright (c) 2014-present PlatformIO <contact@platformio.org>
2+
Licensed under the Apache License, Version 2.0 (the "License");
3+
you may not use this file except in compliance with the License.
4+
You may obtain a copy of the License at
5+
http://www.apache.org/licenses/LICENSE-2.0
6+
Unless required by applicable law or agreed to in writing, software
7+
distributed under the License is distributed on an "AS IS" BASIS,
8+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
9+
See the License for the specific language governing permissions and
10+
limitations under the License.
11+
12+
.. _board_atmelsam_adafruit_feather_m4_can:
13+
14+
Adafruit Feather M4 CAN
15+
=======================
16+
17+
.. contents::
18+
19+
Hardware
20+
--------
21+
22+
Platform :ref:`platform_atmelsam`: Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
23+
24+
.. list-table::
25+
26+
* - **Microcontroller**
27+
- SAME51J19A
28+
* - **Frequency**
29+
- 120MHz
30+
* - **Flash**
31+
- 496KB
32+
* - **RAM**
33+
- 192KB
34+
* - **Vendor**
35+
- `Adafruit <https://www.adafruit.com/product/4759?utm_source=platformio.org&utm_medium=docs>`__
36+
37+
38+
Configuration
39+
-------------
40+
41+
Please use ``adafruit_feather_m4_can`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`:
42+
43+
.. code-block:: ini
44+
45+
[env:adafruit_feather_m4_can]
46+
platform = atmelsam
47+
board = adafruit_feather_m4_can
48+
49+
You can override default Adafruit Feather M4 CAN settings per build environment using
50+
``board_***`` option, where ``***`` is a JSON object path from
51+
board manifest `adafruit_feather_m4_can.json <https://github.com/platformio/platform-atmelsam/blob/master/boards/adafruit_feather_m4_can.json>`_. For example,
52+
``board_build.mcu``, ``board_build.f_cpu``, etc.
53+
54+
.. code-block:: ini
55+
56+
[env:adafruit_feather_m4_can]
57+
platform = atmelsam
58+
board = adafruit_feather_m4_can
59+
60+
; change microcontroller
61+
board_build.mcu = same51j19a
62+
63+
; change MCU frequency
64+
board_build.f_cpu = 120000000L
65+
66+
67+
Uploading
68+
---------
69+
Adafruit Feather M4 CAN supports the next uploading protocols:
70+
71+
* ``atmel-ice``
72+
* ``jlink``
73+
* ``sam-ba``
74+
75+
Default protocol is ``sam-ba``
76+
77+
You can change upload protocol using :ref:`projectconf_upload_protocol` option:
78+
79+
.. code-block:: ini
80+
81+
[env:adafruit_feather_m4_can]
82+
platform = atmelsam
83+
board = adafruit_feather_m4_can
84+
85+
upload_protocol = sam-ba
86+
87+
Debugging
88+
---------
89+
90+
:ref:`piodebug` - "1-click" solution for debugging with a zero configuration.
91+
92+
.. warning::
93+
You will need to install debug tool drivers depending on your system.
94+
Please click on compatible debug tool below for the further
95+
instructions and configuration information.
96+
97+
You can switch between debugging :ref:`debugging_tools` using
98+
:ref:`projectconf_debug_tool` option in :ref:`projectconf`.
99+
100+
Adafruit Feather M4 CAN does not have on-board debug probe and **IS NOT READY** for debugging. You will need to use/buy one of external probe listed below.
101+
102+
.. list-table::
103+
:header-rows: 1
104+
105+
* - Compatible Tools
106+
- On-board
107+
- Default
108+
* - :ref:`debugging_tool_atmel-ice`
109+
-
110+
- Yes
111+
* - :ref:`debugging_tool_jlink`
112+
-
113+
-
114+
115+
Frameworks
116+
----------
117+
.. list-table::
118+
:header-rows: 1
119+
120+
* - Name
121+
- Description
122+
123+
* - :ref:`framework_arduino`
124+
- Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences
Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
.. Copyright (c) 2014-present PlatformIO <contact@platformio.org>
2+
Licensed under the Apache License, Version 2.0 (the "License");
3+
you may not use this file except in compliance with the License.
4+
You may obtain a copy of the License at
5+
http://www.apache.org/licenses/LICENSE-2.0
6+
Unless required by applicable law or agreed to in writing, software
7+
distributed under the License is distributed on an "AS IS" BASIS,
8+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
9+
See the License for the specific language governing permissions and
10+
limitations under the License.
11+
12+
.. _board_atmelsam_adafruit_matrix_portal_m4:
13+
14+
Adafruit Matrix Portal M4
15+
=========================
16+
17+
.. contents::
18+
19+
Hardware
20+
--------
21+
22+
Platform :ref:`platform_atmelsam`: Atmel | SMART offers Flash- based ARM products based on the ARM Cortex-M0+, Cortex-M3 and Cortex-M4 architectures, ranging from 8KB to 2MB of Flash including a rich peripheral and feature mix.
23+
24+
.. list-table::
25+
26+
* - **Microcontroller**
27+
- SAMD51J19A
28+
* - **Frequency**
29+
- 120MHz
30+
* - **Flash**
31+
- 496KB
32+
* - **RAM**
33+
- 192KB
34+
* - **Vendor**
35+
- `Adafruit <https://www.adafruit.com/product/4745?utm_source=platformio.org&utm_medium=docs>`__
36+
37+
38+
Configuration
39+
-------------
40+
41+
Please use ``adafruit_matrix_portal_m4`` ID for :ref:`projectconf_env_board` option in :ref:`projectconf`:
42+
43+
.. code-block:: ini
44+
45+
[env:adafruit_matrix_portal_m4]
46+
platform = atmelsam
47+
board = adafruit_matrix_portal_m4
48+
49+
You can override default Adafruit Matrix Portal M4 settings per build environment using
50+
``board_***`` option, where ``***`` is a JSON object path from
51+
board manifest `adafruit_matrix_portal_m4.json <https://github.com/platformio/platform-atmelsam/blob/master/boards/adafruit_matrix_portal_m4.json>`_. For example,
52+
``board_build.mcu``, ``board_build.f_cpu``, etc.
53+
54+
.. code-block:: ini
55+
56+
[env:adafruit_matrix_portal_m4]
57+
platform = atmelsam
58+
board = adafruit_matrix_portal_m4
59+
60+
; change microcontroller
61+
board_build.mcu = samd51j19a
62+
63+
; change MCU frequency
64+
board_build.f_cpu = 120000000L
65+
66+
67+
Uploading
68+
---------
69+
Adafruit Matrix Portal M4 supports the next uploading protocols:
70+
71+
* ``atmel-ice``
72+
* ``jlink``
73+
* ``sam-ba``
74+
75+
Default protocol is ``sam-ba``
76+
77+
You can change upload protocol using :ref:`projectconf_upload_protocol` option:
78+
79+
.. code-block:: ini
80+
81+
[env:adafruit_matrix_portal_m4]
82+
platform = atmelsam
83+
board = adafruit_matrix_portal_m4
84+
85+
upload_protocol = sam-ba
86+
87+
Debugging
88+
---------
89+
90+
:ref:`piodebug` - "1-click" solution for debugging with a zero configuration.
91+
92+
.. warning::
93+
You will need to install debug tool drivers depending on your system.
94+
Please click on compatible debug tool below for the further
95+
instructions and configuration information.
96+
97+
You can switch between debugging :ref:`debugging_tools` using
98+
:ref:`projectconf_debug_tool` option in :ref:`projectconf`.
99+
100+
Adafruit Matrix Portal M4 does not have on-board debug probe and **IS NOT READY** for debugging. You will need to use/buy one of external probe listed below.
101+
102+
.. list-table::
103+
:header-rows: 1
104+
105+
* - Compatible Tools
106+
- On-board
107+
- Default
108+
* - :ref:`debugging_tool_atmel-ice`
109+
-
110+
- Yes
111+
* - :ref:`debugging_tool_jlink`
112+
-
113+
-
114+
115+
Frameworks
116+
----------
117+
.. list-table::
118+
:header-rows: 1
119+
120+
* - Name
121+
- Description
122+
123+
* - :ref:`framework_arduino`
124+
- Arduino Wiring-based Framework allows writing cross-platform software to control devices attached to a wide range of Arduino boards to create all kinds of creative coding, interactive objects, spaces or physical experiences

0 commit comments

Comments
 (0)