Skip to content

Refresh landing page #308

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 28, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 0 additions & 33 deletions docs/firmware/hardware/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,39 +9,6 @@ The Hardware section includes a catalog of supported boards for the Golioth
platform. Additionally, there are quickstart guides and recommended boards for
common MCUs, such as the ESP32 and nRF91.

## Start Here

Golioth offers two device SDKs that support a wide range of hardware. Here is
some guidance on what to use when setting up a development environment for your
hardware.

### Platform Support

| Vendor | SDK | Quickstart | Note |
| ---------- | -------------------- | ---------- | ---- |
| Espressif | [Golioth Firmware SDK](https://github.com/golioth/golioth-firmware-sdk) | [ESP32 ESP-IDF Quickstart](/firmware/hardware/esp32/espidf-quickstart/set-up-espidf) | Use for ESP32 MCUs |
| Espressif | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [ESP32 Zephyr Quickstart](/firmware/hardware/esp32/zephyr-quickstart/set-up-zephyr) | Use for ESP32 MCUs |
| Infineon | [Golioth Firmware SDK](https://github.com/golioth/golioth-firmware-sdk) | ModusToolbox™ [Readme](https://github.com/golioth/golioth-firmware-sdk/tree/main/examples/modus_toolbox) / [Webinar](https://blog.golioth.io/a-recap-of-how-to-collect-data-from-iot-sensors-using-golioth-and-the-infineon-modustoolbox/) | Use for Infineon MCUs like PSoC6 |
| Nordic | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [nRF9160 Zephyr Quickstart](/firmware/hardware/nrf91/zephyr-quickstart/set-up-zephyr) | Use for Nordic MCUs like nRF9160 and nRF7002 |
| NXP | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [mimxrt1060evkb Zephyr Quickstart](/firmware/hardware/mimxrt1060_evkb/zephyr-quickstart/set-up-zephyr) | Use for NXP MCUs like i.MX RT1062 and i.MX RT1024 |
| Other Vendors | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [mimxrt1060evkb Zephyr Quickstart](/firmware/hardware/mimxrt1060_evkb/zephyr-quickstart/set-up-zephyr) | Many other MCUs are supported by Zephyr will work with Golioth! Follow this quickstart and substitute your board name in the build examples. |

:::info Don't see your hardware listed?

The Golioth Firmware SDK includes a [porting
guide](https://github.com/golioth/golioth-firmware-sdk/blob/main/docs/Porting_Guide.md)
that you can follow to add a port for your platform. If you are interested in
Golioth adding new platform support, please [contact
us](mailto:hello@golioth.io).

:::

### Beta Platform Support

| Vendor | SDK | Quickstart | Note |
| ---------- | -------------------- | ---------- | ---- |
| Zephyr | [Golioth Firmware SDK](https://github.com/golioth/golioth-firmware-sdk) | Golioth Firmware SDK: [Zephyr Beta Support Readme](https://github.com/golioth/golioth-firmware-sdk/tree/main/examples/zephyr) | The [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) already delivers support for Zephyr RTOS. We are actively working on Zephyr support in the Golioth Firmware SDK. The beta is currently open for testing. |

## Board Support Tiers

Golioth has three levels of board support: Continuously Verified, Verified,
Expand Down
1 change: 0 additions & 1 deletion docs/getting-started/1-overview.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
---
id: overview
title: Platform Overview
slug: /getting-started
---
Expand Down
74 changes: 64 additions & 10 deletions docs/landing_page.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,20 +9,74 @@ hide_title: true

---

Golioth is an IoT platform that provides cloud services for embedded devices. Colloquially, we hope to solve the “impedance mismatch between hardware and cloud engineering teams" (a phrase we learned from an early user). Golioth is purpose-built for you and the hardware you develop. Enable everything that your devices need from the cloud, including device messaging, security, updates, analytics, and more.
Golioth is an IoT platform that provides cloud services for embedded devices. We
think of our platform as a "universal connector". Golioth is purpose-built for
you and the hardware you develop. Golioth enables everything that your devices
need from the cloud, from establishing secure connections and providing
over-the-air updates, to managing data to/from your fleet and connecting that to
any cloud service you may need.

We chose the [the Zephyr Project™](https://www.zephyrproject.org), as the basis of our first embedded offering. Zephyr is an open-source, safe, secure, and flexible RTOS under the Linux Foundation. We offer the Golioth SDK--built on top of the Zephyr SDK--which you can use to quickly bootstrap an IoT application.
<iframe class="youtube-embed" src="https://www.youtube.com/embed/CgQg6ifrWfU?si=9MKtgs4jlCvQLWfz" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

## Get started today

To get started, check out the [Quickstart Guide](/getting-started/). That will get you set up with a Golioth account and help you to provision your first devices. Then you can choose which platform to try out using our [supported hardware](/firmware/hardware).
Our [Quickstart Guide](/getting-started/) gets you set up with a Golioth account
and walks through how to provision your first devices. From there you can run a
pre-compiled binary, or build your own samples from our device SDKs. Either way,
you will have an IoT test fleet connected and sending data to the cloud today.

## Navigation
## Using Golioth with your IoT Hardware

Golioth offers two device SDKs that support a wide range of hardware. Here is
some guidance on what to use when setting up a development environment for your
hardware.

### Platform Support

| Vendor | SDK | Quickstart | Note |
| ---------- | -------------------- | ---------- | ---- |
| Espressif | [Golioth Firmware SDK](https://github.com/golioth/golioth-firmware-sdk) | [ESP32 ESP-IDF Quickstart](/firmware/hardware/esp32/espidf-quickstart/set-up-espidf) | Use for ESP32 MCUs |
| Espressif | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [ESP32 Zephyr Quickstart](/firmware/hardware/esp32/zephyr-quickstart/set-up-zephyr) | Use for ESP32 MCUs |
| Infineon | [Golioth Firmware SDK](https://github.com/golioth/golioth-firmware-sdk) | ModusToolbox&trade; [Readme](https://github.com/golioth/golioth-firmware-sdk/tree/main/examples/modus_toolbox) / [Webinar](https://blog.golioth.io/a-recap-of-how-to-collect-data-from-iot-sensors-using-golioth-and-the-infineon-modustoolbox/) | Use for Infineon MCUs like PSoC6 |
| Nordic | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [nRF9160 Zephyr Quickstart](/firmware/hardware/nrf91/zephyr-quickstart/set-up-zephyr) | Use for Nordic MCUs like nRF9160 and nRF7002 |
| NXP | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [mimxrt1060evkb Zephyr Quickstart](/firmware/hardware/mimxrt1060_evkb/zephyr-quickstart/set-up-zephyr) | Use for NXP MCUs like i.MX RT1062 and i.MX RT1024 |
| Other Vendors | [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) | [mimxrt1060evkb Zephyr Quickstart](/firmware/hardware/mimxrt1060_evkb/zephyr-quickstart/set-up-zephyr) | Many other MCUs are supported by Zephyr will work with Golioth! Follow this quickstart and substitute your board name in the build examples. |

:::info Don't see your hardware listed?

There are 5 major sections on the Golioth Docs page:
The Golioth Firmware SDK includes a [porting
guide](https://github.com/golioth/golioth-firmware-sdk/blob/main/docs/Porting_Guide.md)
that you can follow to add a port for your platform. If you are interested in
Golioth adding new platform support, please [contact
us](mailto:hello@golioth.io).

:::

### Beta Platform Support

| Vendor | SDK | Quickstart | Note |
| ---------- | -------------------- | ---------- | ---- |
| Zephyr | [Golioth Firmware SDK](https://github.com/golioth/golioth-firmware-sdk) | Golioth Firmware SDK: [Zephyr Beta Support Readme](https://github.com/golioth/golioth-firmware-sdk/tree/main/examples/zephyr) | The [Golioth Zephyr SDK](https://github.com/golioth/golioth-zephyr-sdk) already delivers support for Zephyr RTOS. We are actively working on Zephyr support in the Golioth Firmware SDK. The beta is currently open for testing. |

## Navigation

- [Getting Started](/getting-started) - Start here! If you are confused at all, please [join our Discord](https://golioth.io/discord) or [let us know directly](mailto:devrel@golioth.io)
- [Hardware](/firmware/hardware) - This section details which device platforms are explicitly supported and how you can get started with them quickly. There is also a catalog of all hardware that works with Golioth and whether or not it has been verified by the Golioth team, the community, the Zephyr community, etc.
- [Firmware](/firmware) - This is the "device side" features of our offerings, including device Software Development Kets (SDKs). This section shows how to run the sample firmware that connects to the offerings in the Services section.
- [Cloud](/device-management) - This is the "server side" features of our offerings. Your embedded hardware will communicate with Golioth Services to push and pull information to the broader internet. This section details how to control and interact with each service, and also test the service without any hardware involved. This section also details how to interact with that data via webapps, mobile apps, and from anywhere else on the web. Make calls to the Golioth web API and display your users' data!
- [Reference](/reference) - All generated API documentation lives here, including for the web side API and the Zephyr API
- [Getting Started](/getting-started) - Start here! If you get stuck, please
post your questions on [the Golioth Forum](https://forum.golioth.io/) or [let
us know directly](mailto:devrel@golioth.io).
- [Firmware](/firmware) - These are the "device side" features of our offerings,
including device Software Development Kits (SDKs). This section shows how to
set up a build environment, run sample firmware, and use Golioth services on
your microcontroller-based IoT fleet.
- [Device Management](/device-management) - These are "server side" features of
the Golioth platform that deal with controlling your devices in the filed.
Here you will find details about rolling out over-the-air (OTA) firmware
updates, accessing device logs, changing device settings for your fleet, and
issuing remote procedure calls (RPC).
- [Data Handling](/data-management) - These are "server side" features of the
Golioth platform that deal with data moving to and from our IoT fleet. Here
you will find details about accessing stored data from your devices, and
options for routing that data to other platforms, whether that's your own
server, your database backend, or just about any other data service you can
imagine.
- [Reference](/reference) - All generated API documentation lives here,
including for the web side API and the Zephyr API
5 changes: 5 additions & 0 deletions src/css/custom.css
Original file line number Diff line number Diff line change
Expand Up @@ -146,3 +146,8 @@ html[data-theme="dark"] {
flex-direction: column;
}
}

iframe.youtube-embed {
width: 100%;
aspect-ratio: 16 / 9;
}