2022-08-10 16:12:28 -04:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2022 Intel Corporation
|
2020-05-01 09:21:09 -07:00
|
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
|
|
*/
|
2022-08-10 16:12:28 -04:00
|
|
|
|
|
|
|
#include <zephyr/device.h>
|
|
|
|
#include <zephyr/init.h>
|
includes: prefer <zephyr/kernel.h> over <zephyr/zephyr.h>
As of today <zephyr/zephyr.h> is 100% equivalent to <zephyr/kernel.h>.
This patch proposes to then include <zephyr/kernel.h> instead of
<zephyr/zephyr.h> since it is more clear that you are including the
Kernel APIs and (probably) nothing else. <zephyr/zephyr.h> sounds like a
catch-all header that may be confusing. Most applications need to
include a bunch of other things to compile, e.g. driver headers or
subsystem headers like BT, logging, etc.
The idea of a catch-all header in Zephyr is probably not feasible
anyway. Reason is that Zephyr is not a library, like it could be for
example `libpython`. Zephyr provides many utilities nowadays: a kernel,
drivers, subsystems, etc and things will likely grow. A catch-all header
would be massive, difficult to keep up-to-date. It is also likely that
an application will only build a small subset. Note that subsystem-level
headers may use a catch-all approach to make things easier, though.
NOTE: This patch is **NOT** removing the header, just removing its usage
in-tree. I'd advocate for its deprecation (add a #warning on it), but I
understand many people will have concerns.
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-08-25 09:58:46 +02:00
|
|
|
#include <zephyr/kernel.h>
|
2022-08-09 20:31:37 -04:00
|
|
|
#include <zephyr/sys/winstream.h>
|
2024-07-23 12:01:03 +01:00
|
|
|
#include <zephyr/sys/printk-hooks.h>
|
2024-07-23 16:29:02 +01:00
|
|
|
#include <zephyr/sys/libc-hooks.h>
|
2022-08-10 16:12:28 -04:00
|
|
|
#include <zephyr/devicetree.h>
|
2024-01-24 21:20:26 -05:00
|
|
|
#include <zephyr/cache.h>
|
2022-08-10 16:12:28 -04:00
|
|
|
|
2025-01-08 08:57:42 -05:00
|
|
|
#ifdef CONFIG_SOC_FAMILY_INTEL_ADSP
|
2022-07-14 10:59:07 -04:00
|
|
|
#include <adsp_memory.h>
|
2022-08-09 20:31:37 -04:00
|
|
|
#include <mem_window.h>
|
2024-12-13 07:26:58 -08:00
|
|
|
#endif
|
2020-05-01 09:21:09 -07:00
|
|
|
|
2021-12-30 19:48:34 -08:00
|
|
|
struct k_spinlock trace_lock;
|
2020-05-01 09:21:09 -07:00
|
|
|
|
2021-12-30 19:48:34 -08:00
|
|
|
static struct sys_winstream *winstream;
|
2020-12-16 12:47:02 -08:00
|
|
|
|
2022-08-10 16:12:28 -04:00
|
|
|
void winstream_console_trace_out(int8_t *str, size_t len)
|
2020-05-01 09:21:09 -07:00
|
|
|
{
|
2020-12-16 12:47:02 -08:00
|
|
|
if (len == 0) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2021-12-14 20:28:30 -08:00
|
|
|
#ifdef CONFIG_ADSP_TRACE_SIMCALL
|
|
|
|
register int a2 __asm__("a2") = 4; /* SYS_write */
|
|
|
|
register int a3 __asm__("a3") = 1; /* fd 1 == stdout */
|
|
|
|
register int a4 __asm__("a4") = (int)str;
|
|
|
|
register int a5 __asm__("a5") = len;
|
|
|
|
|
2022-08-10 16:12:28 -04:00
|
|
|
__asm__ volatile("simcall" : "+r"(a2), "+r"(a3) : "r"(a4), "r"(a5) : "memory");
|
2021-12-14 20:28:30 -08:00
|
|
|
#endif
|
|
|
|
|
2021-12-30 19:48:34 -08:00
|
|
|
k_spinlock_key_t key = k_spin_lock(&trace_lock);
|
2020-05-01 09:21:09 -07:00
|
|
|
|
2021-12-30 19:48:34 -08:00
|
|
|
sys_winstream_write(winstream, str, len);
|
|
|
|
k_spin_unlock(&trace_lock, key);
|
2020-10-29 13:07:50 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
int arch_printk_char_out(int c)
|
|
|
|
{
|
|
|
|
int8_t s = c;
|
|
|
|
|
2022-08-10 16:12:28 -04:00
|
|
|
winstream_console_trace_out(&s, 1);
|
2020-05-01 09:21:09 -07:00
|
|
|
return 0;
|
|
|
|
}
|
2021-12-30 19:48:34 -08:00
|
|
|
|
2024-01-29 17:54:42 +00:00
|
|
|
static void winstream_console_hook_install(void)
|
|
|
|
{
|
2024-07-23 12:01:03 +01:00
|
|
|
#if defined(CONFIG_STDOUT_CONSOLE)
|
2024-01-29 17:54:42 +00:00
|
|
|
__stdout_hook_install(arch_printk_char_out);
|
2024-07-23 12:01:03 +01:00
|
|
|
#endif
|
|
|
|
#if defined(CONFIG_PRINTK)
|
2024-01-29 17:54:42 +00:00
|
|
|
__printk_hook_install(arch_printk_char_out);
|
2024-07-23 12:01:03 +01:00
|
|
|
#endif
|
2024-01-29 17:54:42 +00:00
|
|
|
}
|
|
|
|
|
2024-12-13 07:26:58 -08:00
|
|
|
/* This gets optionally defined by the platform layer as it needs (it
|
|
|
|
* might want to go in a special location to coordinate with linux
|
|
|
|
* userspace, etc...)
|
|
|
|
*/
|
|
|
|
extern char _winstream_console_buf[];
|
|
|
|
|
|
|
|
/* This descriptor with a 96-bit magic number gets linked into the
|
|
|
|
* binary when enabled so that external tooling can easily find it at
|
|
|
|
* runtime (e.g. by searching the binary image file, etc...)
|
|
|
|
*/
|
|
|
|
#define WINSTREAM_CONSOLE_MAGIC1 0xd06a5f74U
|
|
|
|
#define WINSTREAM_CONSOLE_MAGIC2 0x004fe279U
|
|
|
|
#define WINSTREAM_CONSOLE_MAGIC3 0xf9bdb8cdU
|
|
|
|
|
|
|
|
struct winstream_console_desc {
|
|
|
|
uint32_t magic1;
|
|
|
|
uint32_t magic2;
|
|
|
|
uint32_t magic3;
|
|
|
|
uint32_t buf_addr;
|
|
|
|
uint32_t size;
|
|
|
|
};
|
|
|
|
|
|
|
|
static const __used struct winstream_console_desc wsdesc = {
|
|
|
|
.magic1 = WINSTREAM_CONSOLE_MAGIC1,
|
|
|
|
.magic2 = WINSTREAM_CONSOLE_MAGIC2,
|
|
|
|
.magic3 = WINSTREAM_CONSOLE_MAGIC3,
|
|
|
|
.buf_addr = (uint32_t) &_winstream_console_buf,
|
|
|
|
.size = CONFIG_WINSTREAM_CONSOLE_STATIC_SIZE,
|
|
|
|
};
|
2024-01-29 17:54:42 +00:00
|
|
|
|
init: remove the need for a dummy device pointer in SYS_INIT functions
The init infrastructure, found in `init.h`, is currently used by:
- `SYS_INIT`: to call functions before `main`
- `DEVICE_*`: to initialize devices
They are all sorted according to an initialization level + a priority.
`SYS_INIT` calls are really orthogonal to devices, however, the required
function signature requires a `const struct device *dev` as a first
argument. The only reason for that is because the same init machinery is
used by devices, so we have something like:
```c
struct init_entry {
int (*init)(const struct device *dev);
/* only set by DEVICE_*, otherwise NULL */
const struct device *dev;
}
```
As a result, we end up with such weird/ugly pattern:
```c
static int my_init(const struct device *dev)
{
/* always NULL! add ARG_UNUSED to avoid compiler warning */
ARG_UNUSED(dev);
...
}
```
This is really a result of poor internals isolation. This patch proposes
a to make init entries more flexible so that they can accept sytem
initialization calls like this:
```c
static int my_init(void)
{
...
}
```
This is achieved using a union:
```c
union init_function {
/* for SYS_INIT, used when init_entry.dev == NULL */
int (*sys)(void);
/* for DEVICE*, used when init_entry.dev != NULL */
int (*dev)(const struct device *dev);
};
struct init_entry {
/* stores init function (either for SYS_INIT or DEVICE*)
union init_function init_fn;
/* stores device pointer for DEVICE*, NULL for SYS_INIT. Allows
* to know which union entry to call.
*/
const struct device *dev;
}
```
This solution **does not increase ROM usage**, and allows to offer clean
public APIs for both SYS_INIT and DEVICE*. Note that however, init
machinery keeps a coupling with devices.
**NOTE**: This is a breaking change! All `SYS_INIT` functions will need
to be converted to the new signature. See the script offered in the
following commit.
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
init: convert SYS_INIT functions to the new signature
Conversion scripted using scripts/utils/migrate_sys_init.py.
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
manifest: update projects for SYS_INIT changes
Update modules with updated SYS_INIT calls:
- hal_ti
- lvgl
- sof
- TraceRecorderSource
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
tests: devicetree: devices: adjust test
Adjust test according to the recently introduced SYS_INIT
infrastructure.
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
tests: kernel: threads: adjust SYS_INIT call
Adjust to the new signature: int (*init_fn)(void);
Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2022-10-19 09:33:44 +02:00
|
|
|
static int winstream_console_init(void)
|
2021-12-30 19:48:34 -08:00
|
|
|
{
|
2024-12-13 07:26:58 -08:00
|
|
|
void *buf = NULL;
|
|
|
|
size_t size = 0;
|
|
|
|
|
2025-01-08 08:57:42 -05:00
|
|
|
#ifdef CONFIG_SOC_FAMILY_INTEL_ADSP
|
2024-12-13 07:26:58 -08:00
|
|
|
/* These have a SOC-specific "mem_window" device. FIXME: The
|
|
|
|
* type handling is backwards here. We shouldn't be grabbing
|
|
|
|
* an arbitrary DTS alias and assuming it's a mem_window at
|
|
|
|
* runtime, that's not safe. The mem_window init code (which
|
|
|
|
* is typesafe by construction) should be detecting that it's
|
|
|
|
* supposed to be the console and starting the console hook
|
|
|
|
* registration process.
|
|
|
|
*/
|
2022-08-09 20:31:37 -04:00
|
|
|
const struct device *dev = DEVICE_DT_GET(DT_CHOSEN(zephyr_console));
|
2021-12-30 19:48:34 -08:00
|
|
|
|
2022-08-09 20:31:37 -04:00
|
|
|
if (!device_is_ready(dev)) {
|
|
|
|
return -ENODEV;
|
|
|
|
}
|
|
|
|
const struct mem_win_config *config = dev->config;
|
2024-12-13 07:26:58 -08:00
|
|
|
buf = sys_cache_uncached_ptr_get((__sparse_force void __sparse_cache *)config->mem_base);
|
|
|
|
size = config->size;
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#ifdef CONFIG_WINSTREAM_CONSOLE_STATIC
|
|
|
|
/* Dirty trick to prevent linker garbage collection */
|
|
|
|
_winstream_console_buf[0] = ((volatile char*) &wsdesc)[0];
|
|
|
|
|
|
|
|
buf = &_winstream_console_buf;
|
|
|
|
size = CONFIG_WINSTREAM_CONSOLE_STATIC_SIZE;
|
|
|
|
#endif
|
2022-08-09 20:31:37 -04:00
|
|
|
|
2024-12-13 07:26:58 -08:00
|
|
|
__ASSERT_NO_MSG(buf != NULL && size != 0);
|
|
|
|
winstream = sys_winstream_init(buf, size);
|
2024-01-29 17:54:42 +00:00
|
|
|
winstream_console_hook_install();
|
2022-08-10 16:12:28 -04:00
|
|
|
|
2022-08-09 20:31:37 -04:00
|
|
|
return 0;
|
2021-12-30 19:48:34 -08:00
|
|
|
}
|
2022-08-10 16:12:28 -04:00
|
|
|
|
2023-09-20 01:32:18 +00:00
|
|
|
SYS_INIT(winstream_console_init, PRE_KERNEL_1, CONFIG_CONSOLE_INIT_PRIORITY);
|