This project forks TizenRT from SamsungARTIK, the ARTIK 05x-focused fork of TizenRT 1.0 from SamsungOpenSource.
TizenRT is a lightweight RTOS-based platform to support low-end IoT devices. It is largely based on NuttX. TizenRT didn't bring all of the device drivers or any of the NX graphics subsystem from NuttX. This project adds RA8875 support back into TizenRT over an SPI bus, and adds back the graphics subsystem.
(Maybe this is a bad idea, but early indications are that it might kinda work!)
- Intro
- Artik Platform
- Setup Environment
- Development
- Directory Structure about Source Code
- Configuration Sets
- How to Build
- How to program a binary
- How to clear flashed content on a board
- How to use JTAG equiqments
- GPIO Mapping
- SERIAL Mapping
- How to enable Secure shell
- How to save/restore wifi info
- How to enable the ARTIK SDK
- How to test OCF certification
- How to enable SLIP
- Thumb Mode Build
- Crash Dump Analysis Tool
- ADB(Artik Debug Bridge)
- Support Tool
- ETC
- Training
I picked up an EastRising ER-TFTM043-3 from BuyDisplay. It has a 4.3" display with options for things like bus interfaces and touch screens. Right now this project is targeted to the SPI 4-wire, 3.3V option. Touch is a future goal.
All wiring is between the Artik 053 dev kit CON703 and ER-TFTM043-3 display JP1/CON1 headers. I'm using male-female ribbon jumper cables from Amazon but of course use whatever you want.
| Signal | Artik name | Artik pin | Display pin | Display name |
|---|---|---|---|---|
| 3.3V | VCC_EXT3P3 | 2 | 3 | VDD |
| 3.3V | VCC_EXT3P3 | 14 | 4 | VDD |
| GND | GND | 12 | 1 | GND |
| GND | GND | 24 | 2 | GND |
| MOSI | XSPI0_CLK | 16 | 8 | SCLK |
| MOSI | XSPI0_CS | 18 | 5 | /SCS |
| MISO | XSPI0_MISO | 20 | 6 | SDO |
| MOSI | XSPI0_MOSI | 22 | 7 | SDI |
The ra8875_spi bridge between the RA8875 LCD and SPI drivers took a bit of experimentation to get right. Here are the main things that I needed to do that seem to contradict other sources (including the RA8875 datasheet):
- Configured SPI to Mode 0. Maybe I have a bizarro RA8875 chip, or they changed the behavior without changing the docs, or my bus timing is totally wack. Everything I've read says it's Mode 3.
- Disabled software reset of the at driver initialization time. I think I was able to recover normal functionality when poking registers manually, but when run by the driver routines the SPI interface would freeze every time.
- SYSR color depth setting (bits 3,2) needs to be set to b10 instead of b11. Setting to b11 seems to transfer only the low-order byte as an 8-bit color to the display.
There's a lot of insight into the chip at https://github.com/sumotoy/RA8875/wiki, with the above caveats. In particular, it validated my thought that the R1/R2/R3 pullups and C1/C2 caps are pretty useless and are possibly detrimental to high-speed SPI operation.
The artik053/ra8875 configuration set is preconfigured for the ER-TFTM043-3 over SPI. I haven't written up a proper example program to run through the display routines, so there's not much to see at the moment.
- Change to /os/tools
- Configure the build environment with
./configure.sh artik053/ra8875 - Change to /os
- Run
make menuconfigand change options as required. The RA8875 bits are in Device Drivers -> LCD Driver Support. - Build with
make
Lots more hints:
- https://developer.artik.io/documentation/artik-05x/getting-started/ and
- https://github.com/kimvsparrow/ARTIK-05x-RA8875/blob/artik/build/configs/artik05x/README.md
If your goal is to build an SDK to export into the Artik IDE, that's a whole rigamarole that I'm probably not going to get into here.
Everything below here ought to be from the forked TizenRT project.
- Homepage : https://www.artik.io/modules/artik-05x/
Wi-Fi®-based IoT module with built-in hardware security for single-function “things”.
ARTIK 05x series Smart IoT Modules bring Wi-Fi to things that need compactness and connectivity, but without sacrificing hardware-based security. ARTIK053s and ARTIK055s have built-in, enterprise-grade security for a strong root of trust with Samsung Public Key Infrastructure (PKI) and mutual authentication to ARTIK cloud services.
Each Samsung ARTIK IoT module is a true System on Module (SoM), with CPUs, networking, wireless radios, and full system software stack, all build onto a single, easy-to-integrate package.
The ARTIK 05x family runs Tizen RT, a platform that includes a compact RTOS with built-in TCP/IP stack and support for Lightweight Machine-to-machine (LWM2M) protocol. This also means you can develop for ARTIK 05x using free tools like ARTIK IDE, GCC C/C++ compilers, and OpenOCD.
- 32-bit ARM® Cortex® R4 @ 320MHz for applications
- 29 dedicated GPIO ports, 2 SPI, 4 UART (2-pin), 4 ADC, 1 JTAG, 2 I2C
- Input voltage: 3.3VDC (ARTIK055s), 5-12VDC (ARTIK053/053s)
- Completely integrated security subsystem
- Secure communication with unique, per-device key for authentication
- Secure boot to make sure only authorized software can run
- Secure storage protected by physically unclonable function (PUF)
- TizenRT with RTOS, Wi-Fi and networking middleware
- API interface to simplify development process
- LWM2M support for device management
- Mobile reference app to add modules to ARTIK cloud services easily
- Manage devices, including OTA updates, with ARTIK cloud services
Install the most basic packages for using TizenRT.
$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install build-essential openocd git gcc-arm-none-eabi gdb-arm-none-eabi minicomGet the build in binaries and libraries, gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2
Untar the archive file.
$ mv gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2 /opt/.
$ cd /opt
$ tar -xvf gcc-arm-none-eabi-4_9-2015q3-20150921-linux.tar.bz2
$ tee -a ~/.bashrc << __EOF__
# cross compiler
export CROSS_COMPILE="/opt/gcc-arm-none-eabi-4_9-2015q3/bin"
export PATH="${CROSS_COMPILE}:${PATH}"
__EOF__
and export the path like.
export PATH=<Your Toolchain PATH>:$PATHThis package is used by the TizenRT to configure the build. You can change build environment, what is enabled as peripherals from the SoC and from the board.
$ sudo apt-get install gperf libncurses5-dev flex bison
$ git clone https://bitbucket.org/nuttx/tools.git tools
$ cd tools/kconfig-frontends
$ ./configure --enable-mconf --disable-gconf --disable-qconf --prefix=/usr
$ make
$ sudo make installThe main branch is artik.
$ git clone https://github.com/SamsungARTIK/TizenRT.git
$ cd TizenRTSince then, TizenRT means the path where the source was cloned.
OpenOCD is used to program and debug.
OpenOCD v0.10.0 is recommended and can be installed like below, but pre-built OpenOCD binaray on TizenRT/build/tools/openocd/linux64(or 32) can be used without installing.
$ sudo apt-get build-dep openocd
$ git clone --depth 1 -b v0.10.0 https://git.code.sf.net/p/openocd/code openocd-code
$ cd openocd-code
$ ./bootstrap
$ ./configure
$ make
$ sudo make installThis project has the following directory structure.
TizenRT
├── apps : Application Directory
├── build : Build Environment & Output
├── external : External Application
├── framework : External APIs
├── lib : Library (libc, libxx)
├── os : Main Kernel & BSP(Build Support Package)
└── tools : Useful Tools
To build a TizenRT application, use the default configuration files named defconfig under TizenRT/build/configs/<board>/ folder.
After configuration, you can add/remove the configuration you want via menuconfig. If you want to run menuconfig, you need to install kconfig-frontends.
$ cd os
$ make menuconfigThis is the basic configuration of ARTIK05x products. You can set and build the following:
$ cd os
$ ./config.sh artik053/nettestThis is the configuration for the production phase of ARTIK05x product. When you download it to the board, the artik_onboarding app will start automatically when it boots.
$ cd os
$ ./config.sh artik053/onboardThe following environment settings are divided into three stages and used in advance. The details are as follows.
- minimal
$ cd os
$ ./config.sh artik053/minimal
- OS kernel
- Customized C Library
- Security(TLS)
- BSP(boot loader)
- Power
- Networking support (LWIP, DHCP Client, Wi-Fi)
- typical
$ cd os
$ ./config.sh artik053/typical
- OS kernel
- Customized C Library
- Security(TLS)
- BSP(boot loader)
- Power
- Networking support(LWIP, DHCP Client, DHCP Server, Wi-Fi)
- Watchdog
- ARTIK-SDK
- JSON
- Tash
- I2S
- DMA
- System IO(I2C, UART, GPIO, PWM, SPI)
- Network Utilities(FTP Client, Websock, Webclient, Webserver, NTP Client)
- extra
$ cd os
$ ./config.sh artik053/extra
- OS kernel
- Customized C Library
- Security(TLS)
- BSP(boot loader)
- Power
- Networking support (LWIP, DHCP Client, DHCP Server, Wi-Fi)
- Watchdog
- ARTIK-SDK
- JSON
- Tash
- I2S
- DMA
- System IO(I2C, UART, GPIO, PWM, SPI)
- Network Utilities(FTP Client, Websock, Webclient, Webserver, NTP Client, CoAP, MQTT)
Configure the build from TizenRT/os/tools directory
$ cd os
$ ./config.sh <board>/<configuration_set>For list of boards and configuration set supported, refer belows.
Above copies the canned configuration-set for the particular board, into the TizenRT/os directory.
Configuration can be modified through make menuconfig from TizenRT/os.
$ cd os
$ make menuconfigFinally, initiate build by make from TizenRT/os.
$ cd os
$ makeBuilt binaries are in TizenRT/build/output/bin.
$ cd build/output/bin
$ ls
System.map tinyara tinyara.bin tinyara_head.bin tinyara.map tinyara_memstats.txtAfter building TizenRT, follow below steps at TizenRT/os folder.
This makes complete set of binaries programmed. make download ALL
$ cd os
$ make download ALLIf you want to download only the necessary binaries, use make download <partition_name> as follows.
$ cd os
$ make download os$ cd os
$ make download bl2You can refer to the partition_map.cfg file for the partition name.
You can also delete the binaries on the board. You can clean the board with the following command. make download erase ALL
$ cd os
$ make download erase ALLYou can also erase only specific areas. This is especially useful for refreshing the user area (smartfs area). make download erase <partition_name>
$ cd os
$ make download erase os$ cd os
$ make download erase user
If you are using the Starter Kit, you can use the JTAG pin(CON707).
If you are using only the ARTIK05x module, you can connect it using the JTAG pin output from the module.
The GPIO PAD name on the schematic differs from the GPIO name of the device. Please refer to the table below.
| XGPIO0 | XGPIO1 | XGPIO2 | XGPIO3 | XGPIO4 | XGPIO5 | XGPIO6 | XGPIO7 |
|---|---|---|---|---|---|---|---|
| /dev/gpio29 | /dev/gpio30 | /dev/gpio31 | /dev/gpio32 | /dev/gpio33 | /dev/gpio34 | /dev/gpio35 | /dev/gpio36 |
| XGPIO8 | XGPIO9 | XGPIO10 | XGPIO11 | XGPIO12 | XGPIO13 | XGPIO14 | XGPIO15 |
|---|---|---|---|---|---|---|---|
| /dev/gpio37 | /dev/gpio38 | /dev/gpio39 | /dev/gpio40 | /dev/gpio41 | /dev/gpio42 | /dev/gpio43 | /dev/gpio44 |
| XGPIO16 | XGPIO17 | XGPIO18 | XGPIO19 | XGPIO20 | XGPIO21 | XGPIO22 | XGPIO23 |
|---|---|---|---|---|---|---|---|
| /dev/gpio45 | /dev/gpio46 | /dev/gpio47 | /dev/gpio48 | /dev/gpio49 | /dev/gpio50 | /dev/gpio51 | /dev/gpio52 |
| XGPIO24 | XGPIO25 | XGPIO26 | XGPIO27 | XGPIO28 | XEINT0 | XEINT1 | XEINT2 |
|---|---|---|---|---|---|---|---|
| /dev/gpio53 | /dev/gpio54 | /dev/gpio55 | /dev/gpio56 | /dev/gpio20 | /dev/gpio57 | /dev/gpio58 | /dev/gpio59 |
You need the following settings in menuconfig.
- Device Drivers > Serial Driver Support > Serial console
The mapping for the UART changes depending on the selection of the serial console. The default setting for the serial console is UART4. At this time, the device is set as follows.
| XUART4 | XUART0 | XUART1 | XUART2 | XUART3 |
|---|---|---|---|---|
| /dev/ttyS0 | /dev/ttyS1 | /dev/ttyS2 | /dev/ttyS3 | /dev/ttyS4 |
If you change the serial console to UART3, the mapping of the other device changes as follows.
| XUART3 | XUART0 | XUART1 | XUART2 | XUART4 |
|---|---|---|---|---|
| /dev/ttyS0 | /dev/ttyS1 | /dev/ttyS2 | /dev/ttyS3 | /dev/ttyS4 |
After booting TizenRT, you can put the TASH shell invisible to the user. We call this "Secure Shell". If you want to use this feature, do the following in menuconfig.
- Application Configuration > Enable Shell > Enable Secure shell
You can specify the password that the user must enter. Use sha256sum command to extract sha value as follows.
$ echo -n TizenRT | sha256sum
436890f31fcd6b154a0e49df9f190bd8b1dcd4b917a7a80b2d928452c22901f7Enter the sha value extracted above from menuconfig.
- Application Configuration > Enable Shell > SHA256 encrypted password
When you boot TizenRT, you must enter TizenRT to see the TASH shell.
PASSWORD>>******* // TizenRT
TASH>>
Only in case that file system is available, it stores information as file /mnt/wifi/slsiwifi.conf. You need the following settings in menuconfig.
- Application Configuration > Network Utilities > SLSI Wi-Fi API > Enable "Support filesystem"
TASH>> wifi startsta
TASH>> wifi join <ssid> <key> <security>
TASH>>
TASH>> wifi saveconfig # save wifi information
TASH>> cat /mnt/wifi/slsiwifi.conf # check wifi information
TASH>>
TASH>> reboot
TASH>>
TASH>> wifi startsta # restore wifi connect
TASH>>
If you want to use the ARTIK SDK, you need the following settings in menuconfig.
- External Functions > Enable "ARTIK SDK"
- Save and exit
- Launch the build
If you enable ARTIK SDK and then build it, it will automatically download the ARTIK SDK sources from github and build it. You do not need to download additional files.
In addition, to enable the ARTIK SDK examples, set the following in menuconfig:
- Application Configuration > Examples > Enable "ARTIK SDK examples"
- Press Enter then select all the examples you want to include in the image
Samsung ARTIK05x becomes the first family of IoT systems-on-module to be certified under Open Connectivity Foundation 1.3 standards. If you want to test OCF certification, you need the following setting in menuconfig.
- External Functions > IOTIVITY Config Parameters > Enable "enable / disable iotivity stack"
- Check "iotivity stack version" value to
1.3-rel- Change "Default pthread stack size for the receive-handler thread" value to
32768- Enable "enable iotivity security"
- Iotivity uses
scons. You have to installsconsto compile Iotivity.
$ sudo apt-get install sconsFor more information on OCF certification, click here.
ARTIK05x supports SLIP (Serial Line IP) interface. To test your SLIP interface, you need to make the following menuconfig changes:
- Device Drivers > Network Device/PHY Support > Enable "SLIP (serial line) support"
- Networking Support > LwIP options > Enable "Support serial line IP interface"
The following is the default setting of the ARTIK05x IP to "10.0.0.2". The Linux PC as the host is set to "10.0.0.1" as an example.
TASH>>ifconfig
sl2 Link encap: 00:00:00:00:00:00 RUNNING: DOWN MTU: 1500
inet addr: 10.0.0.2 Mask: 255.255.255.0
wl1 Link encap: 00:00:00:00:00:00 RUNNING: DOWN MTU: 1500
inet addr: 0.0.0.0 Mask: 255.255.255.255
lo0 Link encap: 00:00:00:00:00:00 RUNNING: DOWN MTU: 0
inet addr: 127.0.0.1 Mask: 255.0.0.0
inet6 addr: ::1
A new device named sl2 has been set up as above. It is set to use /dev/ttyS4 device (default: XUART3) as SLIP. Connect LinuxPC and ARTIK05x with SLIP.
In the Starter Kit, pins 8 and 10 of CON704 are XUART3.
5 |_|_| 6
7 |_|_| 8 XUART3_RXD
9 |_|_| 10 XUART3_TXD
11 |_|_| 12
On a Linux PC, you can start SLIP with the slattach command.
$ sudo slattach -p slip -s 115200 -d -L /dev/ttyUSB2
slattach: tty_open: looking for lock
slattach: tty_open: trying to open /dev/ttyUSB2
slattach: tty_open: /dev/ttyUSB2 (fd=3) slattach: tty_set_speed: 115200
slattach: tty_set_databits: 8
slattach: tty_set_stopbits: 1
slattach: tty_set_parity: N
slip started on /dev/ttyUSB2 interface sl0$ sudo ifconfig sl0 10.0.0.1/24 up
$ ifconfig
sl0 Link encap:Serial Line IP
inet addr:10.0.0.1 P-t-P:10.0.0.1 Mask:255.255.255.0
UP POINTOPOINT RUNNING NOARP MULTICAST MTU:296 Metric:1
RX packets:75 errors:0 dropped:0 overruns:0 frame:0
TX packets:105 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:10
RX bytes:6060 (6.0 KB) TX bytes:10052 (10.0 KB)You will be able to test the SLIP interface with a simple PING test on Linux PC and ARTIK05x respectively.
$ ping 10.0.0.2
PING 10.0.0.2 (10.0.0.2) 56(84) bytes of data.
64 bytes from 10.0.0.2: icmp_seq=1 ttl=255 time=15.8 ms
64 bytes from 10.0.0.2: icmp_seq=2 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=3 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=4 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=5 ttl=255 time=15.6 ms
64 bytes from 10.0.0.2: icmp_seq=6 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=7 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=8 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=9 ttl=255 time=15.5 ms
64 bytes from 10.0.0.2: icmp_seq=10 ttl=255 time=15.5 ms
...TASH>>ping 10.0.0.1
PING 10.0.0.1 (10.0.0.1) 32 bytes of data. count(10)
40 bytes from 10.0.0.1: icmp_seq=1 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=2 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=3 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=4 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=5 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=6 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=7 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=8 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=9 ttl=255 time=10ms
40 bytes from 10.0.0.1: icmp_seq=10 ttl=255 time=10ms
--- 10.0.0.1 ping statistics ---
10 packets transmitted, 10 received, 0% packet loss,
"TizenRT for ARTIK" can build THUMB mode. This feature can reduce the binary size and improve performance. However, there is no guarantee that performance will increase as you expect for all features. If you want to know more about THUMB mode in contrast to ARM mode, check out the ARM documentation.
You can enable THUMB mode by setting it in menuconfig as follows.
- Chip Selection > Enable "Thumb instruction set support"
In your development with ARTIK05x, you may experience CRASH. You do not need to be embarrassed.
So we prepared you to do RAMDUMP and DEBUGGING in the following way.
To do RAMDUMP and DEBUGGING, you must first set it in menuconfig as follows.
- Board Selection > Enable "Enable Board level logging of crash dumps"
- Board Selection > ARTIK05X crash dump configuration > Enable All Items [Recommands]
The following is a forced CRASH. (For Example)
$ make crashdump ota dump.bin
Open On-Chip Debugger 0.10.0-dirty (2017-09-02-08:32)
Licensed under GNU GPL v2
For bug reports, read
http://openocd.org/doc/doxygen/bugs.html
adapter speed: 2000 kHz
Info : auto-selecting first available session transport "jtag". To override use 'transport select <transport>'.
force hard breakpoints
trst_and_srst separate srst_gates_jtag trst_push_pull srst_push_pull connect_deassert_srst
adapter_nsrst_assert_width: 50
adapter_nsrst_delay: 100
debug_level: 0
target halted in ARM state due to debug-request, current mode: Supervisor
cpsr: 0x200001d3 pc: 0x040239f8
D-Cache: disabled, I-Cache: enabled
Read OTA download to /TizenRT/build/configs/artik05x/../../output/bin/dump.bin
dumped 1572864 bytes in 29.090637s (52.800 KiB/s)
================fault information================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/dump_info.txt
Dump Present Flag : 0x0000003e
DFAR : 0x00000000
DFSR : 0x00000000
================binary information================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/dump_info.txt
commit : 51203fcf2c4c128baddcb57578d3fff5b3fd630f
build_time : 2018-03-08 14:36:13
file_name : http.c
line : 154
================register dump================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/reg.cmm
R0 0x020264e8
R1 0x00000000
R2 0x80180000
R3 0x020264e8
R4 0x020264e8
R5 0x02021ae0
R6 0x020265e0
R7 0x0000009a
R8 0x041cb660
R9 0x020265c8
R10 0x0205eee0
R11 0x02063f68
R12 0x00000000
R13 0x02063ee8
R14 0x040c9748
PC 0x040c9558
SPSR 0x60000053
CPSR 0x60000053
R13_USR 0x4e820501
R14_USR 0x8005a402
R8_FIQ 0x05425598
R9_FIQ 0x2d02654f
R10_FIQ 0x80b68608
R11_FIQ 0x45605065
R12_FIQ 0x8883aa2f
R13_FIQ 0x0210ca72
R14_FIQ 0x0920bcc2
SPSR_FIQ 0x0800381c
R13_IRQ 0x02020400
R14_IRQ 0x600000d3
SPSR_IRQ 0x60000053
R13_ABT 0x2440042c
R14_ABT 0x00204806
SPSR_ABT 0x1402c058
R13_UND 0x500c1553
R14_UND 0xf9121008
SPSR_UND 0x8a0ae243
================stack dump================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/dump_info.txt
0x020265c8 0x040c9938 0x041cb660 0x020265c8 0x0205eee0 0x02063f68 0x00000000 0x02063ee8
0x040c9748 0x040c9558 0x00000026 0x04160c94 0x00000001 0x00000007 0x00000001 0xffffffff
0xdeadbeef 0x00000010 0x00000000 0x00000000 0xdeadbe01 0x00000012 0x00000005 0x00000000
0x00000000 0x000186a0 0xc3c00210 0x0701a8c0 0x00000000 0x00000000 0x0000000a 0x00000008
0x00000007 0x00000000 0x00000013 0x00000012 0x00000014 0x00000015 0x00000016 0x00000017
0x00000018 0x00000019 0x0000001a 0x0000001b 0x0000001c 0x0000001d 0x0000001e 0x0000001f
0x00000020 0x00000021 0x00000022 0x00000023 0x00000024 0x00000025 0x0205d2a0 0x02055c50
0x0205d3c0 0x0205eee0 0x0205d3cc 0x00000000 0x00000000 0x00000000 0x00000000 0x041774d0
0x00000000 0x00000000 0x00000000 0x00000000 0x00000000 0x00000000
================task information================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/dump_info.txt
pid name sch_pri bas_pri state errno stk_size stk_used
0 Idle Task 0 0 ready to run -22 0 0
1 hpwork 224 224 wait_sig 4 2028 636
2 lpwork 176 176 wait_sig 0 2028 596
3 LWIP_TCP/IP 110 110 wait_sem 0 4068 940
5 tash 125 125 wait_sem 0 4076 1628
7 WPA Supplicant 100 100 wait_sem 0 4036 1748
8 WLAN Driver mxmgmt 100 100 wait_sem 0 2044 220
9 Wi-Fi API callback 100 100 wait_mq_emty 0 2044 772
10 WPA Ctrl Iface FIFO 100 100 wait_sem 0 2044 532
11 Wi-Fi API monitor 100 100 wait_sem 0 2044 556
13 listening webserver 100 100 running 0 4092 876
14 client handler 100 100 wait_mq_emty 0 8188 3260
15 listening webserver 100 100 wait_sem 0 4092 732
16 client handler 100 100 wait_mq_emty 0 4092 676
================ram dump data================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/ramdump_0x02020400--0x215FFFF.bin
================make archive================
outfile : /TizenRT/build/configs/artik05x/../../output/bin/crash_dump.zip
include files : ['tinyara', 'dump_info.txt', 'reg.cmm', 'ramdump_0x02020400--0x215FFFF.bin']- Download : simarm.zip from below website
- Load Register
- Excute CMM : ../build/output/bin/reg.cmm
- Load RAM data
- d.load.binary ramdump_0x02020400--0x215FFFF.bin D:0x02020400--0x215FFFF /long /noclear
- Load ELF
- d.load.elf tinyara
You can see call stack : Menu -> View -> Stack frame with local
ADB(Android Debug Bridge) is a command-line utility included with Google’s Android SDK. ADB can control your device over USB from a computer, copy files back and forth, install and uninstall apps, run shell commands, and more. Our ADB(Artik Debug Bridge) is compatible to original ADB(Android Debug Bridge) to communicate with a device on TizenRT.Unlike android, our ADB is only accessed by network connection. (Unfortunately our ARTIK05x doesn't have USB interface)
Our artik05x series is adb device, can connect adb server over WIFI or SLIP(Serial Line IP). Basically Android ADB is normally working with USB interface, can notice device is being connected or not. But connection over WIFI can't notice device is connected or alive, That's why we should connect device by enforce. For more specific says, after artik05x has been booted, adb device is waiting for connection. And next, Linux, Win or MAC's adb clients can connect device over WIFI.
ADB is not enabled by default, you should enable feature. ADB server port is default port by android, if you change port, you should enter correct port number while connecting adb.
ADB shell stack size is related to executed command, if stack size is too short, it can be occurred stack overflow.
Adb usually communicates with the device over USB, but Artik05x can't support USB interface, so you should use adb over Wi-Fi or SLIP.
- Set the target device to listen for a TCP/IP connection on port 5555.
TASH>> adb
- Connect to the device by its IP address. (If ADB port is 5555, port number can be passed)
TASH>> adb connect device_ip_address
- Confirm that your host computer is connected to the target device:
$ adb devices
List of devices attached
device_ip_address:5555 deviceYou're now good to go!
If the adb connection is ever lost:
- Make sure that your host is still connected to the same Wi-Fi network your Android device is.
- Reconnect by executing the adb connect step again.
- Or if that doesn't work, reset your adb host:
$ adb kill-serveror
$ adb disconnector
$ adb disconnect device_ip_addressThen start over from the beginning.
Before issuing adb commands, it is helpful to know what device instances are connected to the adb server. You can generate a list of attached devices using the devices command.
$ adb devices -lIn response, adb prints this status information for each device:
- Serial number: A string created by adb to uniquely identify the device by its port number. Here's an example ip address: 10.0.0.2:5555
- State: The connection state of the device can be one of the following:
- offline: The device is not connected to adb or is not responding.
- device: The device is now connected to the adb server. Note that this state does not imply that the Android system is fully booted and operational because the device connects to adb while the system is still booting. However, after boot-up, this is the normal operational state of an device.
- no device: There is no device connected.
- Description: If you include the -l option, the devices command tells you what the device is. This information is helpful when you have multiple devices connected so that you can tell them apart.
The following example shows the
devices -lcommand and its output.
$ adb devices -l
List of devices attached
10.0.0.2:5555 device product:ARTIK model:ARTIK053 device:1.0.11Use the pull and push commands to copy files to and from an device. The pull and push commands let you copy arbitrary directories and files to any location in a device.
To copy a file or directory and its sub-directories from the device, do the following:
$ adb pull remote localTo copy a file or directory and its sub-directories to the device, do the following:
$ adb push local remoteReplace local and remote with the paths to the target files/directory on your development machine (local) and on the device (remote). For example:
# Host(foo.txt) → TizenRT(/mnt/foo.txt)
$ ls -al foo.txt
-rw-r--r-- 1 bt.cho bt.cho 26199 Mar 8 19:28 foo.txt
$ adb push foo.txt /mnt/foo.txt
9 KB/s (26199 bytes in 2.747s)
$ adb shell ls -l /mnt
/mnt:
-rw-rw-rw- 26199 foo.txt
# TizenRT(/mnt/foo.txt) → Host(bar.txt)
$ adb pull /mnt/foo.txt bar.txt
200 KB/s (26199 bytes in 0.127s)
# Check file
$ diff foo.txt bar.txtYou can use the shell command to issue device commands through adb, with or without entering the adb remote shell on the device. To issue a single command without entering a remote shell, use the shell command like this:
# adb shell shell_command
$ adb shell ls
/:
dev/
mnt/
proc/
var/
$ adb shell cd mnt
$ adb shell ls
/mnt:Or enter a remote shell on a device like this:
$ adb shell
TASH>> ls
/:
dev/
mnt/
proc/
var/
TASH>> cd proc
TASH>> ls
/proc:
0/
1/
2/
3/
4/
6/
8/
9/
10/
11/
12/
fs/
mtd
partitions
uptime
version
TASH>> cat version
Board: ARTIK053
Version: 1.0.11
Commit Hash: 928ba17fd2f117bc3de307f43e608942a0dc41b8
Build User: root@testbed
Build Time: 2018-03-14 19:34:37
TASH>> exitWhen you are ready to exit the remote shell, press Control + D or type exit.
In some cases, you might need to terminate the adb server process and then restart it to resolve the problem (e.g., if adb does not respond to a command).
To stop the adb server, use the adb kill-server command. You can then restart the server by issuing any other adb command.
$ adb kill-serverAnother advanced feature of Debugger for the embedded systems development world is the ability to load different target components, which implements the interface with target systems. The TRACE32 Development System is introduced in this document. The TRACE32 is a product from Lauterbach Datentechnik GmbH.
This is how to connect with ARTIK05x Starter Kit using TRACE32. The following is a script for ATTACH used by TRACE32.
// T32 Attach Script
SYStem.Option ResBreak OFF ; Halt the core after reset
SYStem.Option WaitReset 100.ms ; Wait with JTAG activities after deasserting reset
SYStem.Option EnReset OFF ; Allow the debugger to drive nRESET (nSRST)
SYStem.Option IMASKASM ON ; Disable interrupts while single stepping
SYStem.Option IMASKHLL ON ; Disable interrupts while HLL single stepping
SYStem.JtagClock 5Mhz ; Define JTAG frequency
SYStem.CPU CORTEXR4 ; Select the used CPU
; Configure debugger according to target topology
SYStem.CONFIG.COREBASE 0x801E0000
SYStem.CONFIG AXIACCESSPORT 0.
SYStem.CONFIG DEBUGACCESSPORT 1.
SYStem.CONFIG MEMORYACCESSPORT 5.
; Establish the communication with the target
SYStem.Mode Attach
; Load the program
Data.LOAD.Elf "Z:\TizenRT\build\output\bin\tinyara" /NoCODE
You can connect TRACE32 debug cable and ARTIK05x CON707. The following accessories are required.
- JTAG (2x10 2.54mm) to SWD (2x5 1.27mm) Cable Adapter Board
- 10-pin 2x5 Socket-Socket 1.27mm IDC (SWD) Cable
To make debugging easier, you can change the compilation options for TizenRT in menuconfig.
- Build Setup > Optimization Level > Suppress Optimization
SEGGER J-Links are the most widely used line of debug probes available today. They've proven their worth for more than 10 years. This popularity stems from the unparalleled performance, extensive feature set, large number of supported CPUs, and compatibility with all popular development environments.
- J-Link Software and Documentation Pack J-link
- The J-Link Debugger Ozone
- Real-time Analysis and Visualization SystemView
First, connect J-Link and ARTIK05X. To connect, a debug cable is required. The required cables are as follows.
- JTAG (2x10 2.54mm) to SWD (2x5 1.27mm) Cable Adapter Board
- 10-pin 2x5 Socket-Socket 1.27mm IDC (SWD) Cable
Then, run the Ozone program that you installed. Connect in the following order.
- File > New > New Project Wizard
- Target Device > Device > Select "ARTIK05X"
And attach it to the target module. If it is properly attached, you can check the console log.
Sometimes Ozone does not find few file paths correctly. In the ozone program, press f1 to view the user manual pdf file. Refer to Section 6.4 for more precise routing.
We can debug using the Ozone, but can not fusing new TizenRT Binary. If you want to fuse binaries, please use an IDE or type “make download $(partition)” in Linux shell.
First, copy the support file so that SystemView can recognize TizenRT.
- From TizenRT: $(TOPDIR)/external/sysview/SYSVIEW_TizenRT.txt
- To SystemView: C:\Program Files (x86)\SEGGER\SystemView_V252a\Description
You enable SystemView in menuconfig in the following order:
- External Functions > Select "SystemView"
- Chip Selection > S5J Peripheral Support > Enable "TIMER2"
You can choose your preferences in SystemView.
ARTIK05x now supports Single-Shot Recording only. SEGGER will support Continuous Recording in April 2018.
Enter the RTT address value to be output at boot time.
If the connection is successful, you can check it using the SystemView tool as follows.
If you can not boot normally, you can change os to the initial version. This is possible if there is an initialization binary in memory.
You compress the compiled firmware and download it to the board.
$ cd os
$ make image factory$ cd os
$ make download factoryWhen you press the RESET button (SW700) to reboot the Starter Kit, press and hold the ARDUINO RESET button (SW701) for 10 seconds. Enter initialization mode as follows.
.....
Factory reset.
Erasing boot partitions...
....................................e
Erased 600 sectors
Flashing factory image...
Uncompressed size: 1258496 = 0x133400
resetting ...
.....
You can use the OTA feature when updating the OS binaries externally.
Compress the compiled firmware and add the CRC information for the OTA.
$ cd os
$ make image ota$ cd os
$ make download otaU-BOOT > erase 0x044A0000 +0x15E000 # erase ota area
Erased 350 sectors
U-BOOT > loady 0x044A0000 # load ymodem
## Ready for binary (ymodem) download to 0x044A0000 at 115200 bps...
# ctrl-A Z S ymodem
xyzModem - Cksum mode, 4728(SOH)/0(STX)/0(CAN) packets, 17 retries
## Total Size = 0x00093ad1 = 604881 Bytes
U-BOOT > reset # reboot
You need the following settings in menuconfig.
- Application Configuration > Examples > OTA downloader
TASH>> ota http://192.168.1.10/ota.bin /dev/mtdblock7
TASH>> reboot
- Prepare a device type in ARTIK Cloud
Log into ARTIK Cloud and go to the developer portal. Under the Device Types section, create a new device type (or reuse an existing one) that will be used for testing Device Management and OTA from a device manufacturer's point of view. Make sure the device type has properties enabled by clicking the Device Management tab of the device type.
- Configure the board
In order for the services running on the A05x to be properly configured to connect to ARTIK Cloud, a few parameters need to be changed. This needs to be done only once as parameters will be stored and reused across reboots. Type the commands below to specify the ARTIK Cloud Device Type ID that you chose for the device (the one that has properties enabled), then configure the address of a NTP server that operates well in your region.
TASH>> onboard dtid <device type ID>
TASH>> onboard ntp <NTP server address>
TASH>> onboard config
- Onboard the board to ARTIK Cloud
Use a mobile application (available on iOS and Android) to onboard the device to ARTIK Cloud, scan its QR code then follow the instructions until the device is properly created in ARTIK Cloud. After onboarding, the board should successfully connect to ARTIK Cloud.
- Upload the package to ARTIK Cloud
In ARTIK Cloud's developer portal, go to the Device Management tab of the relevant device type, then click the OTA Updates subtab, then click the Upload new image button.
- Trigger the update
Go to ARTIK Cloud's developer portal, and browse to the device type's Device Management pane. In the devices list, identify the currently connected board by its device ID.
Check the device (or devices) you want to update, click Execute then OTA update.
In the next window, you can select a date to schedule the update, or leave empty to launch the update right now. Click Perform OTA Update when ready.
CRC32 for 044a1000 ... 0453a3a8 ==> 3cf5a5b1
Found an update image downloaded.
....................................e
Erased 600 sectors
Updating boot partition...
Uncompressed size: 1256448 = 0x132C00
....................................e
Erased 384 sectors
Done
resetting ...
8MB is allocated to the SPI Flash area. 1280 KB is prepared for operation in SRAM.
The following is the memory map of ARTIK05x.
ADDRESS CONTENTS NOTE
0xFFFFFFFF +---------------+
| iRAM mirror |
| (64KB) |
0xFFFF0000 +---------------+
0x8FFFFFFF +---------------+
| SFR REGION | Peripheral Area. (CR4) strongly-ordered
| (256MB) | (s5j_memorymap.h)
0x80000000 +---------------+
0x60FFFFFF +---------------+
| NOR FLASH | SFLASH Mirror area to be read only
| mirror |
| (16MB) |
0x60000000 +---------------+
0x04FFFFFF +---------------+
| NOR FLASH | FLASH area, default to set WBWA
| (16MB) |
| |
0x04000000 +---------------+
0x0231FFFF +---------------+
| iRAM shared |
| (128KB) |
0x02300000 +---------------+
0x0215FFFF +---------------+
| iRAM |
| (1280KB) |
0x02020000 +---------------+
0x0000FFFF +---------------+
| iROM |
| (64KB) |
0x00000000 +---------------+
8MB is allocated to the SPI Flash area. After building TizenRT, refer to the following areas when downloading to the board.
ADDRESS CONTENTS NOTE
0x047FFFFF +---------------+
| SSS R/W | Secure Storage R/W
| (512KB) |
| |
0x04780000 +---------------+
| WiFi NVRAM | WiFi RAM
| (8KB) |
0x0477E000 +---------------+
| User R/W | SmartFS
| (1400KB) |
| |
0x04620000 +---------------+
| OTA download | OTA image
| (1536KB) | $ make image ota
| | (build/configs/artik053/bin/ota.bin)
0x044A0000 +---------------+
| Factory Reset | Factory Reset OS image
| (1536KB) | $ make image factory
| | (build/configs/artik053/bin/factory.bin)
0x04320000 +---------------+
| OS AREA | TizenRT
| (TizenRT) | (build/output/bin/tinyara_head.bin)
| (2400KB) |
| |
| |
| |
| |
| |
| |
0x040C8000 +---------------+
| WiFi F/W | WiFi Firmware
| (512KB) | (build/configs/artik053/bin/wlanfw.bin)
| |
0x04048000 +---------------+
| SSS F/W | Secure Firmware
| (32KB) | (build/configs/artik053/bin/sssfw.bin)
0x04040000 +---------------+
| BL2 | 2nd stage bootloader
| (192KB) | (build/configs/artik053/bin/bl2.bin)
0x04010000 +---------------+
| SSS R/O | Secure Storage R/O
| (48KB) |
0x04004000 +---------------+
| BL1 | 1st stage bootloader
| (16KB) | (build/configs/artik053/bin/bl1.bin)
0x04000000 +---------------+
Actually, BL1, OS and WiFi firmware are operated in iRAM.
**Before OS Boot** **After OS Boot**
ADDRESS CONTENTS ADDRESS CONTENTS
0x02160000 +---------------+ 0x02160000 +---------------+
| BL2 | | WiFi |
| Code & Data | | (320KB) |
| (1266KB) | | |
| | | |
| | | |
| | 0x02110000 +---------------+
| | | User Data |
| | | (OS) |
| | | (959KB) |
| | | |
| | | |
| | | |
| | => | |
| | => | |
| | | |
| | | |
| | | |
0x02023800 +---------------+ | |
| BL1 | | |
| (8KB) | | |
0x02021800 +---------------+ | |
| Reserved | | |
| (2KB) | | |
0x02021000 +---------------+ 0x02020400 +---------------+
| Vector Table | | Vector Table |
| (4KB) | | (1KB) |
0x02020000 +---------------+ 0x02020000 +---------------+
- You can refer to the following link.
git clone --depth=50 --branch=artik-05x https://github.com/SamsungARTIK/u-boot-artik.gitInstall and configure USB drivers, so OpenOCD is able to communicate with JTAG interface on ARTIK05x board as well as with UART interface used to upload application for flash. Follow steps below specific to your operating system.
- Using standard micro USB B cable connect ARTIK05x Starter Kit to the computer.
- Wait until ARTIK05x Board is recognized by Windows and drives are installed. If it do not install automatically, then then download Zadig tool (Zadig_X.X.exe) from http://zadig.akeo.ie/ and run it.
- In Zadig tool go to "Options" and check "List All Devices".
- Check the list of devices that should contain two ARTIK05x specific USB entries: "Dual RS232-HS (Interface 0)" and "Dual RS232-HS (Interface 1)". The driver name would be "FTDIBUS (vxxxx)" and USB ID: 0403 6010.
- Using standard micro USB B cable connect ARTIK05x Starter Kit to the computer.
- Open a terminal, enter
ls -l /dev/ttyUSB*command and check, if board's USB ports are recognized by the OS. You are looking for similar result:
$ ls -l /dev/ttyUSB*
crw-rw---- 1 root dialout 188, 0 Oct 25 13:42 /dev/ttyUSB0
crw-rw---- 1 root dialout 188, 1 Oct 25 13:42 /dev/ttyUSB1- The
/dev/ttyUSBninterface with lower number is used for JTAG communication. The other interface is routed to ARTIK05x's serial port (UART) used for upload of application to ARTIK05x's flash.
In this ARTIK training video, we show how to sign up for an ARTIK Cloud account. This is a prerequisite for any activities involving ARTIK Cloud.
In this ARTIK training video, we show how to connect your ARTIK053 developer kit to ARTIK Cloud using the ARTIK mobile app. We call this "onboarding".
You can quickly and easily create a templete of examples. We prepared mksampleapp.sh.
$ cd apps/tools
$ sh mksampleapp.sh awesome_test
$ cd ../examples/awesome_testEnjoy!