mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2024-12-29 04:50:03 +01:00
Documentation: Renaming OS X to macOS
This commit is contained in:
parent
1fba8d3d76
commit
1231807bab
2
.github/ISSUE_TEMPLATE/bug_report.md
vendored
2
.github/ISSUE_TEMPLATE/bug_report.md
vendored
@ -38,7 +38,7 @@ Please paste or specifically describe the actual output.
|
||||
|
||||
#### Versions
|
||||
<!--
|
||||
Operating system: Mac OSX, Linux, Vagrant VM
|
||||
Operating system: macOS, Linux, Vagrant VM
|
||||
Build environment: GCC, CLang versions (you can run the following command from
|
||||
the RIOT base directory: make print-versions).
|
||||
-->
|
||||
|
@ -77,6 +77,10 @@ JLinkExe tool, then specify `PROGRAMMER=jlink` when flashing:
|
||||
Be prevented that you'll need to disable Apple's System Integrity Protection
|
||||
to allow FTDI unsigned drivers to be loaded on your Mac.
|
||||
|
||||
@warning Caution, turning off the SIP may compromise your systems security and integrity.
|
||||
See [developer.apple.com](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) for details.
|
||||
|
||||
|
||||
To do this, reboot in recovery mode, by pressing simultaneously `cmd + R`
|
||||
while booting.
|
||||
Then, on the recovery mode go to Utilities/Terminal and type:
|
||||
|
@ -70,7 +70,7 @@ On Linux, there's an application called
|
||||
[Uniflash](https://www.ti.com/tool/uniflash). Sadly, you'll have to install the
|
||||
whole IDE just to get the scripting interface :-[
|
||||
|
||||
No idea about MacOSX.
|
||||
No idea about macOS.
|
||||
|
||||
In order to flash the CC2650STK you need to plug the XDS110 probe through the
|
||||
JTAG and so-called "DevPack" connectors. Note that the back of the SensorTag
|
||||
|
@ -85,7 +85,7 @@ The Firefly has built-in support for USB 2.0 USB, Vendor and Product IDs are the
|
||||
* VID 0x0451
|
||||
* PID 0x16C8
|
||||
|
||||
On Linux and OS X this is straightforward, on windows you need to install the following driver:
|
||||
On Linux and macOS this is straightforward, on windows you need to install the following driver:
|
||||
|
||||
<https://github.com/alignan/lufa/blob/remote-zongle/LUFA/CodeTemplates/WindowsINF/LUFA%20CDC-ACM.inf>
|
||||
|
||||
@ -100,7 +100,7 @@ On windows, devices will appear as a virtual `COM` port.
|
||||
|
||||
On Linux, devices will appear under `/dev/`.
|
||||
|
||||
On OS X, `/dev/tty.SLAB_USBtoUARTx`.
|
||||
On macOS, `/dev/tty.SLAB_USBtoUARTx`.
|
||||
|
||||
On Linux:
|
||||
|
||||
|
@ -158,7 +158,7 @@ Bash
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
For terminal output on OS X (`make term`) you need to install a driver:
|
||||
For terminal output on macOS (`make term`) you need to install a driver:
|
||||
http://www.ftdichip.com/Drivers/VCP.htm
|
||||
http://www.ftdichip.com/Drivers/VCP.htm
|
||||
*/
|
||||
|
@ -58,7 +58,7 @@ tool. Once you have this in place, you can simply flash by calling
|
||||
|
||||
from your application folder.
|
||||
|
||||
Mac OS users may experiment a command line expecting `connect`. Just type it
|
||||
macOS users may experiment a command line expecting `connect`. Just type it
|
||||
and the process will continue.
|
||||
|
||||
### Debugging
|
||||
|
@ -56,6 +56,6 @@ tool. Once you have this in place, you can simply flash by calling
|
||||
|
||||
from your application folder.
|
||||
|
||||
Mac OS users may experiment a command line expecting `connect`. Just type it
|
||||
macOS users may experiment a command line expecting `connect`. Just type it
|
||||
and the process will continue.
|
||||
*/
|
||||
|
@ -83,7 +83,7 @@ The Re-Mote has built-in support for USB 2.0 USB, Vendor and Product IDs are the
|
||||
* VID 0x0451
|
||||
* PID 0x16C8
|
||||
|
||||
On Linux and OS X this is straightforward, on windows you need to install the following driver:
|
||||
On Linux and macOS this is straightforward, on windows you need to install the following driver:
|
||||
|
||||
<https://github.com/alignan/lufa/blob/remote-zongle/LUFA/CodeTemplates/WindowsINF/LUFA%20CDC-ACM.inf>
|
||||
|
||||
@ -96,9 +96,9 @@ Once all drivers have been installed correctly:
|
||||
|
||||
On windows, devices will appear as a virtual `COM` port.
|
||||
|
||||
On Linux and OS X, devices will appear under `/dev/`.
|
||||
On Linux and macOS, devices will appear under `/dev/`.
|
||||
|
||||
On OS X:
|
||||
On macOS:
|
||||
|
||||
* XDS backchannel: `tty.usbserial-<serial number>`
|
||||
* EM in CDC-ACM: `tty.usbmodemf<X><ABC>` (X a letter, ABC a number e.g. `tty.usbmodemfd121`)
|
||||
|
@ -76,7 +76,7 @@ The RE-Mote has built-in support for USB 2.0 USB, Vendor and Product IDs are the
|
||||
* VID 0x0451
|
||||
* PID 0x16C8
|
||||
|
||||
On Linux and OS X this is straightforward, on windows you need to install the following driver:
|
||||
On Linux and macOS this is straightforward, on windows you need to install the following driver:
|
||||
|
||||
<https://github.com/alignan/lufa/blob/remote-zongle/LUFA/CodeTemplates/WindowsINF/LUFA%20CDC-ACM.inf>
|
||||
|
||||
@ -91,7 +91,7 @@ On windows, devices will appear as a virtual `COM` port.
|
||||
|
||||
On Linux, devices will appear under `/dev/`.
|
||||
|
||||
On OS X, `/dev/tty.SLAB_USBtoUARTx`.
|
||||
On macOS, `/dev/tty.SLAB_USBtoUARTx`.
|
||||
|
||||
On Linux:
|
||||
|
||||
|
@ -82,7 +82,7 @@ The RE-Mote has built-in support for USB 2.0 USB, Vendor and Product IDs are the
|
||||
* VID 0x0451
|
||||
* PID 0x16C8
|
||||
|
||||
On Linux and OS X this is straightforward, on windows you need to install the following driver:
|
||||
On Linux and macOS this is straightforward, on windows you need to install the following driver:
|
||||
|
||||
<https://github.com/alignan/lufa/blob/remote-zongle/LUFA/CodeTemplates/WindowsINF/LUFA%20CDC-ACM.inf>
|
||||
|
||||
@ -97,7 +97,7 @@ On windows, devices will appear as a virtual `COM` port.
|
||||
|
||||
On Linux, devices will appear under `/dev/`.
|
||||
|
||||
On OS X, `/dev/tty.SLAB_USBtoUARTx`.
|
||||
On macOS, `/dev/tty.SLAB_USBtoUARTx`.
|
||||
|
||||
On Linux:
|
||||
|
||||
|
@ -205,10 +205,10 @@ clock configuration or low power modes. In this case you can use
|
||||
instructions to build it and run `./edbg -e` to erase the flash. Then press the
|
||||
reset button and you're able to program via OpenOCD again.
|
||||
|
||||
### Flashing might not work in Virtual Box with Mac OS X as host
|
||||
### Flashing might not work in Virtual Box with macOS as host
|
||||
It might happen that flashing through OpenOCD works once inside Virtual Box.
|
||||
But when you try to flash again, you could get a CMSIS-DAP related error. It
|
||||
seems to only happen with USB 3.0 ports. You can take a look at
|
||||
[Vagrant](http://en.wikipedia.org/wiki/Vagrant_%28software%29) and use a virtual
|
||||
Linux to run the virtual RIOT, and flash from OS X.
|
||||
Linux to run the virtual RIOT, and flash from macOS.
|
||||
*/
|
||||
|
@ -183,7 +183,7 @@ time, the internal pull-up resistors are not sufficient for stable bus
|
||||
operation. You probably have to connect external pull-ups to both bus lines. 10K
|
||||
is a good value to start with.
|
||||
|
||||
### OS X & make term
|
||||
### macOS & make term
|
||||
If you want the terminal to work using `make term` command and get a message
|
||||
about missing tty device install the driver from
|
||||
https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers .
|
||||
|
@ -55,14 +55,14 @@ To create a bridge and two (or count at your option) tap interfaces:
|
||||
|
||||
sudo ../../dist/tools/tapsetup/tapsetup [-c [<count>]]
|
||||
|
||||
On OSX you need to start the RIOT instance at some point during the script's
|
||||
On macOS you need to start the RIOT instance at some point during the script's
|
||||
execution. The script will instruct you when to do that.
|
||||
|
||||
To delete the bridge and all tap interfaces:
|
||||
|
||||
sudo ../../dist/tools/tapsetup/tapsetup -d
|
||||
|
||||
For OSX you **have** to run this after killing your RIOT instance and rerun
|
||||
For macOS you **have** to run this after killing your RIOT instance and rerun
|
||||
`sudo ../../dist/tools/tapsetup [-c [<count>]]` before restarting.
|
||||
|
||||
**Please note:** If you want to communicate between RIOT and your host
|
||||
|
@ -85,7 +85,7 @@ void native_async_read_add_handler(int fd, void *arg, native_async_read_callback
|
||||
|
||||
_add_handler(fd, arg, handler);
|
||||
|
||||
/* tuntap signalled IO is not working in OSX,
|
||||
/* tuntap signalled IO is not working in macOS,
|
||||
* * check http://sourceforge.net/p/tuntaposx/bugs/18/ */
|
||||
#ifdef __MACH__
|
||||
_sigio_child(_next_index);
|
||||
@ -98,7 +98,7 @@ void native_async_read_add_handler(int fd, void *arg, native_async_read_callback
|
||||
if (real_fcntl(fd, F_SETFL, O_NONBLOCK | O_ASYNC) == -1) {
|
||||
err(EXIT_FAILURE, "native_async_read_add_handler(): fcntl(F_SETFL)");
|
||||
}
|
||||
#endif /* not OSX */
|
||||
#endif /* not macOS */
|
||||
|
||||
_next_index++;
|
||||
}
|
||||
|
@ -1,5 +1,5 @@
|
||||
/*
|
||||
* clang_compat.h Undefines macros of clang on OSX to use RIOT's macros
|
||||
* clang_compat.h Undefines macros of clang on macOS to use RIOT's macros
|
||||
*
|
||||
* Copyright (C) 2014 Thomas Eichinger <thomas.eichinger@fu-berlin.de>
|
||||
*
|
||||
|
@ -27,7 +27,7 @@ extern "C" {
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
#ifdef __MACH__ /* OSX */
|
||||
#ifdef __MACH__ /* macOS */
|
||||
#ifndef THREAD_STACKSIZE_DEFAULT
|
||||
#define THREAD_STACKSIZE_DEFAULT (163840)
|
||||
#endif
|
||||
|
@ -340,7 +340,7 @@ static int _init(netdev_t *netdev)
|
||||
}
|
||||
|
||||
char *name = dev->tap_name;
|
||||
#ifdef __MACH__ /* OSX */
|
||||
#ifdef __MACH__ /* macOS */
|
||||
char clonedev[255] = "/dev/"; /* XXX bad size */
|
||||
strncpy(clonedev + 5, name, 250);
|
||||
#elif defined(__FreeBSD__)
|
||||
@ -356,7 +356,7 @@ static int _init(netdev_t *netdev)
|
||||
if ((dev->tap_fd = real_open(clonedev, O_RDWR | O_NONBLOCK)) == -1) {
|
||||
err(EXIT_FAILURE, "open(%s)", clonedev);
|
||||
}
|
||||
#if (defined(__MACH__) || defined(__FreeBSD__)) /* OSX/FreeBSD */
|
||||
#if (defined(__MACH__) || defined(__FreeBSD__)) /* macOS/FreeBSD */
|
||||
struct ifaddrs *iflist;
|
||||
if (real_getifaddrs(&iflist) == 0) {
|
||||
for (struct ifaddrs *cur = iflist; cur; cur = cur->ifa_next) {
|
||||
|
@ -9,7 +9,7 @@
|
||||
/**
|
||||
* @ingroup cpu_native
|
||||
*
|
||||
* @brief Malloc header for use with native on OSX since there is no
|
||||
* @brief Malloc header for use with native on macOS since there is no
|
||||
* malloc.h file in the standard include path.
|
||||
*
|
||||
* @{
|
||||
|
@ -24,7 +24,7 @@
|
||||
#include <mach/mach_init.h>
|
||||
#include <mach/mach_port.h>
|
||||
#include <mach/mach_host.h>
|
||||
/* Both OS X and RIOT typedef thread_t. timer.c does not use either thread_t. */
|
||||
/* Both macOS and RIOT typedef thread_t. timer.c does not use either thread_t. */
|
||||
#define thread_t riot_thread_t
|
||||
#endif
|
||||
|
||||
|
@ -31,7 +31,7 @@
|
||||
#include <mach/mach_init.h>
|
||||
#include <mach/mach_port.h>
|
||||
#include <mach/mach_host.h>
|
||||
/* Both OS X and RIOT typedef thread_t. timer.c does not use either thread_t. */
|
||||
/* Both macOS and RIOT typedef thread_t. timer.c does not use either thread_t. */
|
||||
#define thread_t riot_thread_t
|
||||
#endif
|
||||
|
||||
|
@ -29,10 +29,10 @@ A set of common tools and a toolchain for the hardware you target needs to be in
|
||||
### Choosing an Operating System for the Development PC
|
||||
|
||||
Most of the RIOT OS developers are using Linux on their development PCs, so you can expect the
|
||||
most streamlined experience here. Other POSIX-compliant OSes such as current versions of Mac OS or
|
||||
most streamlined experience here. Other POSIX-compliant OSes such as current versions of macOS or
|
||||
the various BSD flavours will also be fine - however, we rely on users to report bugs regarding
|
||||
tooling incompatibilities here. So expect occasional issues for the development branch and please
|
||||
help testing during the feature freeze period, if you develop on Mac OS or BSD.
|
||||
help testing during the feature freeze period, if you develop on macOS or BSD.
|
||||
|
||||
Native development on Windows machines is not officially supported. What works well is using Linux
|
||||
in a virtual machine, but at much lower performance than running Linux natively. For development
|
||||
@ -144,8 +144,7 @@ For example, in Ubuntu the above tools can be installed with the following comma
|
||||
headers
|
||||
* Alternatively: Compile with `BUILD_IN_DOCKER=1`. Note that for running the executable you
|
||||
still need a multilib system (or 32 bit Linux) with glibc a standard C library.
|
||||
* A C library supporting the deprecated POSIX.1-2001 ucontext library (e.g. glibc, FreeBSD's libc,
|
||||
Mac OS's libc)
|
||||
* A C library supporting the deprecated POSIX.1-2001 ucontext library (e.g. glibc, FreeBSD's libc)
|
||||
* Optional: GDB for debugging. (Prefer the multiarch version, this will also work for other boards)
|
||||
|
||||
The build system {#the-build-system}
|
||||
|
@ -50,7 +50,7 @@ RIOT is developed by an open community that anyone is welcome to join:
|
||||
The quickest start {#the-quickest-start}
|
||||
==================
|
||||
You can run RIOT on most IoT devices, on open-access testbed hardware (e.g.
|
||||
IoT-lab), and also directly as a process on your Linux/FreeBSD/OSX machine (we
|
||||
IoT-lab), and also directly as a process on your Linux/FreeBSD/macOS machine (we
|
||||
call this the `native` port). Try it right now in your terminal window:
|
||||
|
||||
~~~~~~~{.sh}
|
||||
|
@ -62,7 +62,7 @@ sudo ./RIOTDIR/dist/tools/tapsetup/tapsetup
|
||||
```
|
||||
|
||||
2. Assign a site-global prefix to the `tapbr0` interface (the name could be
|
||||
different on OSX etc):
|
||||
different on macOS etc):
|
||||
```
|
||||
sudo ip a a fec0:affe::1/64 dev tapbr0
|
||||
```
|
||||
|
@ -46,7 +46,7 @@ to using `esp_now` for the downstream interface.
|
||||
|
||||
## Requirements
|
||||
This functionality works only on Linux machines.
|
||||
Mac OSX support will be added in the future (lack of native `tap` interface).
|
||||
macOS support will be added in the future (lack of native `tap` interface).
|
||||
|
||||
If you want to use DHCPv6, you also need a DHCPv6 server configured for prefix
|
||||
delegation from the interface facing the border router. With the [KEA] DHCPv6
|
||||
|
@ -707,7 +707,7 @@ static void test_fib_16_prefix_match(void)
|
||||
*/
|
||||
static void test_fib_17_get_entry_set(void)
|
||||
{
|
||||
/* FIXME: init as enum to fix folding-constant compiler error on OS X */
|
||||
/* FIXME: init as enum to fix folding-constant compiler error on macOS */
|
||||
enum { addr_buf_size = 16 };
|
||||
char addr_dst[addr_buf_size];
|
||||
char addr_nxt[addr_buf_size];
|
||||
|
Loading…
Reference in New Issue
Block a user